Differences

This shows you the differences between two versions of the page.

--- 家庭管理系统h5:冷启动文件 [2026/10/11 02:25] – 4.57 工资只读开放 172.17.0.1
+++ 家庭管理系统h5:冷启动文件 [2026/10/18 01:18] (current) – 4.58 新增成长记录模块 172.17.0.1
@@ Line 426: / Line 426: @@
 | 后端 POST | **403 无权限** ✅ |
 | 管理员 | 增删改一切正常 ✅（验证用测试记录已清理）|
+====== 4.58 新增「成长记录」模块（身高/体重/脚长）（2026-10-16） ======
+**需求**：家庭管理增加模块，记录 **姓名 / 时间 / 身高 / 体重 / 脚长**；每个人按**固定时间间隔**记录一次。
+===== 数据表（family.db） =====
+<code>
+CREATE TABLE growth(id INTEGER PK, name TEXT, date TEXT,
+                    height REAL, weight REAL, foot REAL,
+                    note TEXT DEFAULT '', created TEXT DEFAULT '');
+CREATE TABLE growth_cfg(name TEXT PRIMARY KEY, days INTEGER DEFAULT 30, created TEXT DEFAULT '');
+</code>
+===== 接口（family_api.py） =====
+| 接口 | 方法 | 说明 |
+|---|---|---|
+| `/api/family/growth` | GET | 返回 `records`（按日期倒序）+ `people`（每人：间隔天数/上次日期/距今天数/下次日期/超期天数/has）+ `cfg` |
+| `/api/family/growth` | POST | 新增记录；**同一人同一天重复提交 → 覆盖**（不产生重复行）；传 `id` 则更新该条 |
+| `/api/family/growth?id=` | DELETE | 删除一条（仅管理员）|
+| `/api/family/growth/cfg` | POST | 设置某人的记录间隔天数（默认 30）|
+**权限**：普通用户 **GET 放行（只读）**，POST/DELETE/cfg **403 仅管理员**（`_guard` 白名单新增一行）。
+===== 前端（family.html） =====
+- 新增 tab **「📏 成长」**（`ALL_TABS` 管理员 / `USER_TABS` 家人只读）
+- 每人一张卡片：`每 N 天` + 状态（⏳ 还没有记录 ／ ✅ 下次 YYYY-MM-DD ／ ⚠️ 已超期 N 天）+ 上次数据（身高/体重/脚长 + N 天前）
+- 管理员卡片右侧：`⚙️ 间隔`（prompt 设置天数）、`＋ 记录`；右下 FAB 也可新增
+- 「历史数据」区：日期 + 姓名 + 身高/体重/脚长 + 备注，管理员可 ✕ 删除
+- 新增表单（底部弹出 sheet）：姓名下拉（来自 members）、日期（默认今天）、身高/体重/脚长（数字，至少填一项）、备注
+===== 验证 =====
+| 项 | 结果 |
+|---|---|
+| 建表 | ✅ growth / growth_cfg 自动创建 |
+| GET（空库）| ✅ people 自动从 members 生成（席子初、席子恩），间隔默认 30 |
+| POST 录入 | ✅ 返回 id；同人同日重复提交覆盖 |
+| 状态计算 | ✅ 录入 2026-10-16 → 「2 天前」、下次 2026-11-15（30 天档）|
+| 改间隔 | ✅ 席子恩设为 90 天 → 下次变 2027-01-14 |
+| 权限 | 普通用户 GET **200** ／ POST **403** ／ DELETE **403** ✅ |
+| 管理员视图 | ✅ 标题/两人卡片/数据/按钮/删除全部正常，无 JS 错误 |
+| 普通用户视图 | ✅ tab 可见、数据可见、**无 新增/间隔/删除** 入口 |
+| 收尾 | 测试数据已清理（growth 0 条、cfg 空，回到默认 30 天）|
+⚠️ 注意：`family_api.py` 是 Blueprint，新增路由必须用 `@bp.route`。
 ====== 5. 排障速查 ======