猫猫鱼记账

猫猫鱼记账小程序说明

猫猫鱼记账是一款面向多人出游、聚会和共同消费场景的微信小程序。它帮助同行成员创建出游队伍、邀请伙伴加入、各自记录垫付账单，并在活动结束后自动计算每只“猫猫”的分摊金额、基金抵扣、预收款退补和最终转账建议。

它不是简单的单人账本，而是围绕真实多人协作设计：每个成员都有独立身份，邀请加入需要校验口令，账单编辑受权限控制，队伍归档后会保存结算快照，方便后续查看历史记录。

适用场景

• 朋友结伴旅行：多人轮流垫付住宿、交通、门票、餐饮等费用。
• 情侣或家庭同行：可以把多位成员合并为“猫猫家庭”，最终按家庭统一结算。
• 聚餐、露营、周末短途活动：活动中随手记账，结束后一键看转账建议。
• 有公共基金或预收款的出行：支持猫猫基金抵扣，也支持每人预收款的多退少补。
• 管理员提前建队：管理员可以预置成员，同行者收到邀请后认领自己的身份。

核心功能

1. 创建出游队伍

用户可以创建一个新的猫猫组队，并填写：

• 队伍标题
• 活动日期
• 地点或备注
• 管理员昵称与头像
• 猫猫基金金额
• 每只猫猫预收金额
• 是否允许普通成员管理猫猫家庭
• 是否允许被邀请人创建新身份
• 是否要求成员上传头像

创建队伍时，管理员也可以提前添加同行成员，方便后续邀请成员直接认领身份。

2. 邀请成员加入

队伍支持通过微信原生分享卡片邀请成员加入。

邀请链接会携带队伍 ID 和邀请口令，只有链接完整、口令正确、队伍未归档且邀请开启时，成员才能加入。

被邀请人可以：

• 认领管理员预置的未绑定身份
• 在允许的情况下创建自己的新身份
• 填写昵称
• 主动选择微信头像并上传保存

3. 成员与权限管理

管理员可以在成员管理页维护队伍成员：

• 新增成员
• 修改成员昵称
• 清除成员认领状态
• 禁用或恢复成员记账权限
• 移出未被账单或家庭引用的成员
• 开启或关闭邀请入口

普通成员可以查看队伍成员信息，并在权限允许时管理猫猫家庭。

4. 账单记录

成员可以记录活动中的共同消费账单，包括：

• 账单标题
• 金额
• 垫付成员
• 参与分摊成员

有记账权限的普通成员可以新增账单，并编辑或删除自己创建的账单。管理员可以编辑或删除队伍内任意账单。

队伍归档后，账单只能查看，不能再新增、修改或删除。

5. 猫猫基金

猫猫基金适合处理公共补贴、集体红包、活动基金等费用。

结算时，系统会将猫猫基金优先用于抵扣总支出，并按成员人头公平分摊抵扣额度。基金没有用完时不会超过实际总支出，基金抵扣结果会自动合并进最终转账建议。

6. 猫猫预收款

如果出行前每个人都先交了一笔公共预收款，可以在队伍设置中填写“每只猫猫预收金额”。

系统会在结算时把预收款计入每只猫猫的已付款，并结合实际账单生成多退少补结果。中途追加预收款时，可以直接把金额改为累计预收金额。

7. 猫猫家庭结算

猫猫家庭用于把多位成员合并为一个最终转账主体。

例如情侣、亲友或同一家庭一起出行时，可以把他们组成一个家庭，最终结算会显示为“某某家”，由家庭整体参与收款或付款，减少成员之间不必要的内部转账。

8. 自动结算与转账建议

系统会根据账单、成员、基金、预收款和家庭分组自动计算最终结果。

结算内容包括：

• 总支出金额
• 基金抵扣金额
• 实际分摊金额
• 每只猫猫的垫付金额
• 每只猫猫的应分摊金额
• 每只猫猫的预收款情况
• 家庭合并后的余额
• 最终转账建议

金额按“分”进行整数计算，避免浮点误差，最终结果保留到一分钱。

9. 分享结算结果

账本页支持生成结算结果图片，便于在群聊中分享最终转账建议。

结算图会展示关键金额、转账路径和必要的结算摘要，让同行成员快速确认谁需要转给谁。

10. 队伍归档

当大家完成线下转账后，管理员可以归档队伍。

归档后：

• 保存当前结算快照
• 队伍变为只读状态
• 不能再修改账单、成员、邀请、家庭或设置
• 历史账本优先展示归档时的结算结果

这可以避免后续算法变化或成员信息变化影响历史结算。

页面结构

• 首页：展示最近队伍、创建队伍入口、全部队伍入口。
• 创建队伍页：填写队伍信息、管理员资料、预置成员和协作权限。
• 全部队伍页：查看我创建或我加入的队伍，支持进行中和已归档筛选。
• 邀请加入页：通过好友分享卡片进入，认领身份或创建身份。
• 组队主页：展示队伍概览、成员摘要、家庭摘要、最近账单和邀请入口。
• 成员管理页：管理成员、邀请状态、记账权限和猫猫家庭。
• 账本详情页：包含账单、结算、设置三个任务区。
• 关于页：展示产品说明与鸣谢信息。

产品特点

• 面向真实多人协作，不使用虚假身份或演示入口。
• 所有业务读写通过云函数处理，前端不直接操作数据库。
• 邀请加入必须校验队伍 ID 和邀请口令。
• 微信头像和昵称由用户主动授权或填写，不静默获取。
• 管理员和普通成员权限分离，云端会再次校验写操作权限。
• 支持账单、基金、预收款、家庭合并和最终转账建议的一体化结算。
• 归档队伍保存历史快照，适合真实出游后的长期留存。