Commit Graph

15 Commits

Author SHA1 Message Date
lixi 5de9f397cb docs(architecture): 新增后端模块结构与职责速览页
CI / docs-build (push) Successful in 33s
四模块(common/auth/user/pet)职责、端口、单迁移链纪律、
演进方向(微服务化/M5 FK 补回/media 域)一页速览,
挂「架构」导航首位,作为后端结构唯一权威入口。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-09-07 17:25:55 +08:00
lixi b04e93ca6e docs: M2 第一波正式收口(方案 A:真机补验不阻塞第二波)
CI / docs-build (push) Successful in 32s
- 12 号收口报告:A 线埋点修复 + B 线后端地基全交付,4.5/5 放行条件闭环
- 收口期热修 5 项(Platform API 降级、+86 前缀、events 端口接线、
  flushNow 冲刷时机、毒丸批次)已随 flutter dev@1afec6a 入库
- E2E 脚本 7/7 + 桌面端埋点全链路验证通过;真机联调待设备到位补验

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-09-07 16:53:56 +08:00
lixi 60258324e4 docs: M2 第一波收口——报告 09/10/11 入档挂导航
CI / docs-build (push) Successful in 2m3s
- 09 契约补录 events(关闭 D-1/放行条件②,另含实现与旧规范 5 处出入记录)
- 10 Flutter 埋点修复(接线+三偏差+SessionTracker+page_viewed,34→51 测试,12/12 验收)
- 11 后端地基(V3/V4 迁移 8 表+种子、4 条跨 schema FK 剥离、patbond-pet 骨架、ADR-013 执行,82→95 测试)
- mkdocs build --strict 通过

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-09-07 14:54:19 +08:00
lixi 1891d9b7b4 docs: M2 开工前分析 10 份报告入档 + ADR-009~015 拍板决策
CI / docs-build (push) Successful in 1m3s
- iteration-2 报告 01-08(PM 拆解/后端/Flutter 评估/现实核查/UI 规范/埋点规划/证据基线/Git 规划),04、06 已由正式角色复核定稿
- mkdocs 挂「第二迭代」导航,build --strict 通过
- ADR-009 新建 patbond-pet 模块、ADR-010 照片剪出 M2、ADR-011 dev 主干/master 发布、ADR-012 北极星与 H1-H4、ADR-013 废弃 health_record_action、ADR-014 DEBT-1 随 M2、ADR-015 照护人邀请后置

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-09-07 13:54:35 +08:00
lixi 8e0e1c5c42 docs: 第一迭代收官——进展看板/功能清单更新 + 迭代总结
第一迭代已完成(2026-09-03 → 2026-09-04):
- 后端:82 测试(JWT 会话、compose 编排、埋点系统)
- 前端:34 测试(登录纵切、埋点模块)
- 真机联调 E2E 7/7 通过,契约偏差 0 个
- OpenAPI 契约正式化,ADR-001~008 落地
- 报告 18(E2E)、19(埋点)、20(迭代总结)入档
- 进展看板标注「第一迭代已完成」+ 交付总结
- 功能清单更新:compose 、联调 、测试数 82/34

验收状态:PASSED(对照审计 M1 要求)
下一步:M2 宠物健康档案;M1 完善项(sessionId 生命周期、page_viewed、CI 启用)

门禁:mkdocs build --strict 通过
2026-09-04 17:31:15 +08:00
lixi 2de63f8911 docs: 增加 Gitea Actions CI Runner 部署手册
- 开启 Actions、注册 act_runner、Testcontainers 所需的 docker.sock 挂载、常见问题对照
- 门禁:mkdocs build --strict 通过
2026-09-04 15:01:20 +08:00
lixi 8e27976a95 docs: 增加功能完成清单并同步 Flutter 第三波状态
- 六大块功能项挂测试类名,附针对性测试速查与手动 curl 冒烟
- Flutter 登录纵切三项更新为已完成(8d890c0/da25804,30 测试),新增联调待办项
- 门禁:mkdocs build --strict 通过
2026-09-04 14:34:29 +08:00
lixi 273064c10d docs: 第三波交付收口——认证契约与两端实现报告入档
- 新增 API 契约:docs/api/openapi.yaml(T6a 正式化)与契约说明页(契约先行原则)
- 入档报告 16(后端 JWT 会话,37→73 测试)与 17(Flutter 登录纵切,7→30 测试)
- 进展看板更新至第三波完成,第四波为联调 E2E → CI → 编排 → 埋点
- 门禁:mkdocs build --strict 通过
2026-09-04 12:18:29 +08:00
lixi 209021e7d2 docs: 迁入第一迭代过程报告并建立进展看板
- 新增 development/iterations/iteration-1/:15 份角色报告 + 进展看板(已完成/未闭环/下一步),作为双人协作的进度事实来源
- 新增 ADR-006:测试与交付容器化策略(Testcontainers / 交付 Docker 包 / 本机库仅个人联调)
- Git 工作流规范补充:敏感信息只进忽略文件或 sample、测试数据不入库、测试代码限标准测试目录
- 门禁:mkdocs build --strict 通过(零警告)
2026-09-04 10:45:05 +08:00
lixi 027876ae00 docs: 增加 Git 工作流规范
- 三仓分支模型(api/flutter 以 dev 为集成分支、doc 直接 main)、feature 分支时机
- 固化中文语义前缀提交约定:正文写验收证据、引用 ADR 编号
- 禁止事项:敏感配置/构建产物不入库、共享分支不 force push、已推送 Flyway 迁移不可变(呼应开发计划 4.3)
- 按仓库分列提交前本地门禁命令清单,作为未来 CI 门禁蓝本
- 门禁:mkdocs build --strict 通过(零 warning)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-09-04 10:36:34 +08:00
lixi ca8cb72554 完善开发文档 2026-09-03 18:00:52 +08:00
lixi bef6a93f68 完善开发文档 2026-09-03 16:03:20 +08:00
nmbh1122@126.com 59396e879d theme to readthedocs 2026-07-10 17:26:17 +08:00
nmbh1122@126.com 99c2a1875b theme to material 2026-07-10 17:25:04 +08:00
nmbh1122@126.com 524c1d3fcf first commit 2026-07-10 17:14:01 +08:00