# 模块功能文档

## 一、聊天

家庭群聊模块，支持 WebSocket 实时通讯。

### 消息类型

| 类型 | 说明 |
|------|------|
| 文字 | 普通文本消息 |
| 图片 | 支持拍照/相册上传 |
| 文件 | 附件上传 |
| 系统消息 | 由 `useModuleChatNotifier` 自动生成的操作通知 |

### 附件

- 聊天附件存入 `b_chat_file`，关联消息 ID
- 加载消息时按 `target_id` 批量查询附件

### 操作记录

各子模块的增/改/删操作通过 `useModuleChatNotifier` 自动推送一条系统消息到聊天中，格式如「张三 创建了任务 倒垃圾」。

---

## 二、记账

家庭记账模块，记录日常收支。

### 核心功能

| 功能 | 说明 |
|------|------|
| 记账 | 支出/收入，关联分类，支持备注 |
| 分类管理 | 支出/收入分类，支持自定义图标 |
| 筛选 | 按日期范围、分类、关键词筛选 |
| 统计 | 支出/收入/结余汇总，按月/日分组展示 |
| 编辑/删除 | 长按账单弹出菜单 |

### 自动记账

| 功能 | 说明 |
|------|------|
| 规则设置 | 长按账单 →「自动记账」→ 选择重复频率 |
| 频率 | 每天 / 每周（选周几） / 每月 / 每季度 / 每年 |
| 自动执行 | 进入首页自动检查规则，根据 `last_run` 补回漏掉的记录 |

### 分类图标

- 使用自定义 IconFont 组件（`IconFinance*`）
- 支出/收入各有一套图标

---

## 三、衣服搭配

家庭成员的衣服管理和穿搭组合。

### 衣服管理

| 功能 | 说明 |
|------|------|
| 新增/编辑 | 名称、图片、品牌、备注 |
| 分类 | 自定义分类（如上衣、裤子） |
| 标签 | 父子结构标签（颜色 + 名称） |
| 所属 | 标注衣服属于哪个成员 |
| 排序 | 拖拽排序 |

### 搭配

| 功能 | 说明 |
|------|------|
| 画布编辑 | 从衣橱选择衣服，拖拽/缩放排列 |
| 层级 | 置顶/置底 |
| 封面 | 自动截图生成搭配封面 |
| 分类/标签/所属 | 同衣服 |
| 筛选 | 选衣服时支持分类、标签、所属过滤 |

---

## 四、餐食

家庭菜品库与餐食安排。

### 菜品库

| 功能 | 说明 |
|------|------|
| 菜品管理 | 名称、图片、分类、烹饪时间、难度 |
| 食材 | 每条菜品可添加多个食材（名称+数量+单位） |
| 步骤 | 烹饪步骤（文字+图片） |
| 标签 | 父子结构标签 |

### 餐食安排

| 功能 | 说明 |
|------|------|
| 创建菜单 | 选择日期 + 餐段（早餐/午餐/晚餐） |
| 添加菜品 | 从菜品库添加，支持搜索+分类/标签筛选 |
| 确认/完成 | 菜单确认后不可修改，完成后锁定 |
| 做饭人 | 指定或选择做饭成员 |
| 时间轴 | 记录所有操作：创建、加菜、移除、备注、设置做饭人 |

---

## 五、家庭待办

家庭任务分配与跟踪。

### 任务管理

| 功能 | 说明 |
|------|------|
| 创建 | 名称、描述、优先级（普通/重要/紧急） |
| 指派 | 指定负责人，或留空待认领 |
| 认领/拒绝 | 成员主动认领或拒绝任务 |
| 转交 | 任务转给其他成员 |
| 截止时间 | 可选，超时自动显示为「已超时」 |
| 重复 | 每天/每周/每月自动创建下一个实例 |
| 提醒 | 本地通知提醒 |
| 备注 | 评论区 |

### 评分

| 功能 | 说明 |
|------|------|
| 五星评分 | 任务完成后其他人打分 |
| 评语 | 附带文字评价 |
| 一人一评 | 每人每任务只能评一次 |
| 平均分 | 任务列表和详情展示平均分 |

### 完成

| 功能 | 说明 |
|------|------|
| 完成备注 | 完成任务时可填备注 |
| 附件 | 完成任务时可上传图片 |

### 时间轴

详情页展示任务完整生命周期：创建→指派→认领→完成→评价，含头像和时间。

---

## 六、购物清单 🚧 待做

家庭共享购物清单，买了就勾掉并自动记账。

### 计划功能

| 功能 | 说明 |
|------|------|
| 清单管理 | 创建多个清单（如「周末采购」「宜家」） |
| 条目 | 物品名称、数量、分类 |
| 勾选完成 | 勾掉后可选联动记账（金额+分类） |
| 多人协作 | 家人看到同一清单，各自勾选 |
| 模板 | 常用清单保存为模板 |

---

## 七、家庭相册 🚧 待做

家人照片共享与浏览。

### 计划功能

| 功能 | 说明 |
|------|------|
| 上传 | 拍照/相册上传 |
| 时间线 | 按日期分组浏览 |
| 标签 | 人物/场景/事件标签 |
| 共享 | 全家可见，通过 `family_id` 隔离 |

---

## 八、纪念日

生日、纪念日提醒。

### 计划功能

| 功能 | 说明 |
|------|------|
| 添加 | 名称、日期、类型（生日/纪念日/自定义） |
| 提醒 | 复用 todo 的本地通知机制，提前提醒 |
| 倒计时 | 首页展示最近的纪念日倒计时 |
| 祝福 | 纪念日当天自动推送到聊天 |

---

## 通用功能

| 功能 | 说明 |
|------|------|
| 家庭/空间 | 多家庭隔离，通过 `family_id` 过滤 |
| 家庭成员 | 邀请码加入，角色管理 |
| 聊天通知 | 操作自动推送到家庭聊天 |
| 文件上传 | S3 存储，统一 `s3UploadFileApi` |
| 通用数据 API | 5 个接口：`loadData` / `loadDataPage` / `loadDataBySql` / `saveData` / `getUniqueId` |