zhaoyuxi/patbond-doc
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
48 Commits 1 Branch 1 Tag
main
Commit Graph

48 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
lixi 38d9e97174 docs: M3.5 收口报告 + 暴露面清单补全（文档站/处置记录/凭证纪律）
CI / docs-build (push) Successful in 2m58s
Details 
- 06 M3.5 收口：6 项用户反馈处置结果、迁移预估被审计推翻的教训、
  关键语义定型（/me 不回退、PATCH 三态、头像权限按字段定档、昵称按码点计）、
  实现期 4 项发现、契约 v1.4.0 纯增量承诺、遗留 5 项
- server-exposure.md 补：patbond-doc 文档站（漏记）、2026-09-11 处置记录、
  纪律 6「凭证不进任何可留存介质」与纪律 7「配置备份不留配置目录」

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-11 18:05:12 +08:00
lixi f9b1358b37 docs: 2026-09-11 安全事件复盘 + 新建服务器暴露面清单 + M3.5 报告 03/04/05 入档
CI / docs-build (push) Successful in 1m59s
Details 
安全事件（已闭环，服务恢复）：
- 根因链：Gitea 3000 对公网开放 → 外部调用 /api/internal/manager/add-logger
  注入 gitconfig 的 uploadpack.packObjectsHook → 指向不存在的脚本 →
  upload-pack 发 NAK 后无法产出 pack → 全仓 HTTPS clone 失败（CI 全挂）
- 攻击未达成代码执行（hook 目标脚本不存在）；三仓 ref 与本地逐一核对未被篡改；
  无系统层入侵（无陌生 key/crontab/挖矿进程/陌生登录）
- 新建常设「服务器暴露面清单」：补上服务器侧「决策变了环境没跟上」的核对机制
  （Nacos 在 ADR-002 移除后仍暴露公网近两个月）
- CI Runner 手册排障表增三条：CI 秒失败先在本机复现 checkout、跨仓比 CI
  须核对时间戳、clone 坏而 push 正常时查 packObjectsHook 注入

M3.5 交付报告：03 后端资料与头像（api 334→379）、04 契约冻结 v1.4.0
（31→32 路径、矩阵 173→181 格、11 格红转绿）、05 资料页与头像 UI（flutter 526→597）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-11 17:45:35 +08:00
lixi 5f02909af6 docs(api): M3.5 契约冻结 v1.4.0——用户资料与头像
CI / docs-build (push) Failing after 1s
Details 
按 iteration-3.5/03 号报告定型表冻结第一波后端交付，相对 v1.3.0 纯增量
（无字段删改、无类型变更、无必填收紧），v1.3.0 客户端无需改动：

- GET /api/v1/me 响应补 nickname（DB 原值、不做 username 回退）与
  avatarUrl（时效性预签名 GET，会过期、客户端不得持久化），两者键恒在值可空
- 新增 PATCH /api/v1/me：三态部分更新（键缺省=不改 / 显式 null=清空 /
  给值=设置），空 patch 与纯空白昵称 400/40000，无乐观锁无幂等键
- Pet 补 avatarUrl（列表/详情/创建/更新四处统一）；PATCH /api/v1/pets/{petId}
  收三态 avatarAssetId，补 404/40405 与 422/42203 两格，权限按本次触及字段
  定档（仅头像 WRITE、触及资料 MANAGE、混合取更严）
- 新增 GET /api/v1/me/community-stats：receivedLikeCount/publishedPostCount
  （int64，空数据 0，永不 404），聚合口径逐条进描述
- 两处均不外露 avatarAssetId（只写不读，"有头像"等价 avatarUrl != null）
- 媒体 purpose 白名单枚举追加 user_avatar/pet_avatar
- 零新增错误码：复用 40000/40101/40300/40400/40401/40405/40902/42203，
  错误码表只补语义（40300/40405/42203 三行）

规模 31→32 路径 / 43→45 操作 / 72→75 schemas（UpdateMeRequest、
CommunityStats、CommunityStatsEnvelope——后者为与全 API「每个 200 响应引一个
XxxEnvelope」的既有形态保持一致，故比 03 号报告预估多一个）。
校验：yaml 解析通过、96 处 $ref 全解析、45 个 operationId 无重复、
零未引用 schema、mkdocs build --strict 通过。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-11 10:19:19 +08:00
lixi 6e1ab8ebf1 docs(architecture): ADR-022 M3.5 范围与关键决策拍板
CI / docs-build (push) Failing after 2s
Details 
首页 demo 仅做问候语、昵称允许重名、注册不加昵称输入、宠物头像 WRITE 档、
本迭代零迁移（列均已存在 + purpose 白名单是配置项）、获赞走读侧聚合新端点；
交付按 v0.4.0 发布。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-11 09:30:44 +08:00
lixi 95976ae2c3 docs: M3.5 体验补齐——任务拆解与第一批客户端修复报告入档
CI / docs-build (push) Failing after 1s
Details 
- 01 任务拆解：用户实测 6 项反馈的分类与处置；**数据模型审计推翻迁移预估**
  （nickname/avatar_asset_id 列 V1/V3 早已存在、purpose 白名单是配置项）→ 本批零迁移
- 02 第一批已交付：中文本地化 + 日期录入收口 + 花费卡月份（flutter 502→526）
- 6 项待拍板（首页 demo 裁剪范围、获赞端点形态、头像写权限档等）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-11 09:27:17 +08:00
lixi 1bcfe444c6 docs: 补记 v0.3.0 分支保护实配与后续发布流程变更
CI / docs-build (push) Successful in 1m14s
Details 
- checklist 第 6 步执行记录：api/flutter 的 main 已保护（经 Gitea API 核实
  protected=true、禁直推、状态检查上下文显式填写），dev 保持直推流
- 说明状态检查上下文为何显式填写而非留空（留空时空集为真会反而放行）
- ⚠️ 明确后续发布姿势变更：main 禁直推后，dev→main 须走 PR + CI 门禁，
  首次发布用的直推写法仅适用于保护启用前；checklist 第 4 步相应作废

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-10 16:16:26 +08:00
lixi efdfe59a41 docs: v0.3.0 发布记录与发布前 E2E 回归门禁报告
CI / docs-build (push) Successful in 1m0s
Details 
- 新建常设「发布记录」页（挂开发文档导航），首条 v0.3.0 M3 社区
- 30 号报告：M2 11/11 + M3 14/14 同环境各连跑 3 轮零 flake、契约偏差 0；
  附契约向后兼容结构化比对（removed/changed 均 NONE）与共享代码面回归分析
- 记录首次发布的一次性操作：api main 孤儿历史重建（方案 A）、flutter 快进推法改进

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
v0.3.0 		2026-09-10 15:46:57 +08:00
lixi 3ebe562ab7 docs: M3 收官——E2E 报告与收官总结入档，验收 PASSED
CI / docs-build (push) Successful in 38s
Details 
- 28 E2E 烟囱：14/14 场景、契约偏差 0、M3 四条验收标准逐条取证
  （两次不同 limit 全量翻页有序 id 逐位相等、删除前后差集验证、psql 库层互证）
- 29 收官总结：终态对照开工基线（测试 191/272→334/502、契约 18→31 路径冻结、
  ADR 001~021、四容器→六容器 + MinIO）、遗留清单与 M4 方向输入
- iteration-3/index.md 进展看板补建；feature-checklist 新增 M3 第 10~12 节
- 另登记 2 项 E2E 观察项：widthPx/heightPx 恒 null、eventVersion 口径未定型

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-10 15:13:18 +08:00
lixi f5457c2f4c docs: M3 第三波收口——报告 21~27 入档挂导航
CI / docs-build (push) Successful in 2m2s
Details 
- 21~26 Flutter 社区接入五单 + 字典 v3 白名单（flutter 286→502、api 325→334）
- 27 收口总表：社区 demo 三页消亡、M3 四条验收标准逐条取证、
  乐观更新与媒体链路端到端、实现期修正记录
- device-verification.md 的 M3 四项真机步骤已由各单收口补全

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-10 14:48:33 +08:00
lixi a611acb358 docs: M3 第二波收口——报告 15~20 入档挂导航
CI / docs-build (push) Successful in 32s
Details 
- 15~17 社区后端纵切三单（帖子/Feed 作者链路/评论互动关注，226→310）
- 18 契约冻结 v1.3.0（31 路径/43 操作，26 项修正照单全收）
- 19 快照同步与全仓契约矩阵（173 格零漂移，修 allOf 校验盲区，→325）
- 20 收口总表：定型语义汇总（第三波接入依据）与质量事件记录

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-09 11:38:42 +08:00
lixi f848476c16 docs(api): M3 契约冻结 v1.3.0——community/media 域合入
CI / docs-build (push) Successful in 1m12s
Details 
按第二波定型表（iteration-3 报告 13/15/16/17）将 community/media 域草案
合入正典 openapi.yaml，1.2.0 → 1.3.0：

- 新增 13 路径 / 19 操作（媒体两步上传、帖子生命周期、公共 Feed、
  单层评论、点赞/收藏/关注最小接口），正典总量 31 路径 / 43 操作
- 新增 27 schemas / 4 参数 / 7 响应组件；错误码表补 9 码
  （40301/40403/40404/40405/40406/40905/42203/42204/42205）
- info 头新增「Community / Media 域约定」：Idempotency-Key 必带 +
  规范化 request_hash 比对（与 pets 域差异成文）、私有桶 + 时效性
  预签名 GET 读取语义、防枚举码族、互动面=帖子公开面
- 草案 10 处 TODO-FREEZE 全部回填删除；26 项草案→冻结修正照单全收
  （对照见 iteration-3/18 冻结报告，波末入档）
- index.md 端点清单同步；servers 增 :8084、tags 并入 6 个

api 侧字节级快照同步为硬依赖，由后续 api 侧工单执行。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-09 11:12:50 +08:00
lixi b3a4efd7e0 docs(architecture): 模块速览同步第一波终态——六容器/media 职责/pet 收官状态
CI / docs-build (push) Successful in 28s
Details 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-09 09:33:30 +08:00
lixi f17e6f1215 docs: M3 第一波收口——报告 09~14 与契约草案入档挂导航
CI / docs-build (push) Successful in 34s
Details 
- 09 V5+community 骨架（191→206）、10 埋点队列三项（272→286）、
  11 契约草案（13 路径/19 操作）、12 防泄漏三仓落地、
  13 media MinIO 闭环 + auth 契约测试（→226，抓修 1 漂移）、14 收口总表
- backend-modules.md 更新五模块/六容器口径
- 媒体凭据形态已定型（契约冻结输入），剩余待定型点在 T3-04/05

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-08 17:13:49 +08:00
lixi 8e1fe2f754 chore: 凭证防泄漏检查落地——脚本入库、CI 兜底 step、规范页启用说明（ADR-021）
CI / docs-build (push) Successful in 44s
Details 
- 新增 scripts/check-secrets.sh 与 scripts/hooks/pre-commit（与 api/flutter 同构，规则单一来源）
- ci.yml 在 checkout 后新增 Secret scan step；mkdocs build --strict 通过
- git-workflow.md 新增「凭证防泄漏检查」节：两层机制、启用命令、允许清单边界、真凭证轮换优先原则
- 验收：全仓 74 个已跟踪文件扫描零误报

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-08 16:28:04 +08:00
lixi 5ecb920c49 docs: 真机验证清单去除本机绝对路径
CI / docs-build (push) Successful in 1m0s
Details 
/home/lx/workspace/patbond 是单人本机工作区路径，另一位维护者检出位置不同；
常设操作文档一律参数化为「cd <你的工作区>/<仓名>」写法。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-08 16:15:22 +08:00
lixi 16579a41e2 docs: 真机验证清单提升为跨迭代常设文档
CI / docs-build (push) Successful in 1m2s
Details 
- 从 iteration-2/30 迁至 development/device-verification.md，挂「开发文档」
  一级导航（功能完成清单之后）
- 重构为按迭代分节：通用前置 + M2 挂起两项（含 09-21 出数日时限提醒）+
  M3 预登记四项（媒体弱网/乐观更新手感/Feed 图片/v3 事件落库，随工单收口补全）
- 原 30 号位置留迁移指引，保持报告序列完整可审计

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-08 16:11:24 +08:00
lixi d2867826d3 docs: M3 开工分析 8 份报告入档 + ADR-016~021 拍板决策
CI / docs-build (push) Successful in 55s
Details 
- iteration-3 报告 01-08（PM 拆解/后端/Flutter/RC 首个 CERTIFIED/UI/埋点/证据基线/Git）
- ADR-016 自托管 MinIO 起步预留迁云（用户确认现无云存储）、ADR-017 patbond-community
  :8084 + media 归 user + 作者信息跨 schema 只读、ADR-018 范围裁剪（话题剪出/单层评论）、
  ADR-019 幂等按域（PUT/DELETE + request_hash）、ADR-020 聚合 feed_viewed/字典 v3/
  北极星不变/队列三项升第一波、ADR-021 Git 修订（main 更正/PR 情形触发/首发布重建 main/
  防泄漏 grep 先行）
- mkdocs 挂「第三迭代」导航，build --strict 通过

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-08 16:02:53 +08:00
lixi e68b6553ca docs: 真机补验独立操作清单（30 号，M2 挂起项）
CI / docs-build (push) Successful in 29s
Details 
两项验证（Android 事件落库 + SessionTracker 30min 换会话）的完整操作步骤：
compose 起后端、三 base URL dart-define、逐步通过标准、psql 查证 SQL
（列名按 V2 实际 schema 核对为 client_ts）、巡检兜底、收尾清卷；
末尾留执行记录节，完成后同步 feature-checklist 第 9 节状态。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-08 14:51:52 +08:00
lixi fcac68daf2 docs: M2 收官——E2E 烟囱报告与收官总结入档，验收 PASSED
CI / docs-build (push) Successful in 51s
Details 
- 28 E2E 烟囱：11/11 场景全绿、契约偏差 0、四条验收标准全过（真机两项方案 A 挂起）
- 29 收官总结：终态对照开工基线（测试 82/34→191/272、契约 5→18 路径冻结、
  ADR 001~015、生产埋点从零到贯通）、遗留清单与 M3 方向输入
- 看板终态更新

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-08 14:47:29 +08:00
lixi 23ce404548 docs: T2-19 文档收口（E2E 前半）——迭代二看板 + 功能清单 M2 增补
CI / docs-build (push) Successful in 57s
Details 
- iteration-2/index.md 进展看板：三波交付纪年、测试与契约演进表、遗留清单
- feature-checklist 去掉「第一迭代」限定，新增第 7~9 节（宠物域后端 13 条/
  客户端 10 条/埋点体系 7 条），状态以 dev + 门禁全绿为准
- 待 E2E 收官后补：T2-18 证据归档与 M2 收官总结报告

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-08 14:27:21 +08:00
lixi b81c050e03 docs: M2 第三波收口——报告 22~27 入档挂导航
CI / docs-build (push) Successful in 58s
Details 
- 22~26 Flutter 接入五单报告（T2-11~14 + 白名单扩充，flutter 测试 64→272）
- 27 第三波收口总表：demo 数据消亡、四态纪律、埋点端到端贯通、DEBT-1 偿还
- 三次 compose 实测无契约偏差；波内 agent 中断续跑事故记录在案

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-08 14:10:36 +08:00
lixi 222990e587 docs: M2 第二波收口——报告 13~21 与契约草案入档挂导航
CI / docs-build (push) Successful in 1m19s
Details 
- 13~18 后端纵切六单报告（T2-03~08，测试 95→182）
- 14 + openapi-pets-draft.yaml 契约起草档案
- 19 契约冻结报告（v1.2.0，22 项草案修正对照）
- 20 契约一致性测试（快照机制 + 1 漂移修复）
- 21 第二波收口总表（定型语义汇总，第三波接入依据）
- mkdocs build --strict 通过

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-08 10:40:27 +08:00
lixi 511617be55 docs(api): M2 契约冻结 v1.2.0——pets 域 12 路径合入
CI / docs-build (push) Successful in 36s
Details 
openapi.yaml 1.1.0 → 1.2.0：宠物 CRUD、品种/疫苗目录、体重、疫苗、健康事件、
照护提醒、档案聚合摘要共 12 路径 / 18 操作 / 30 schema 合入正典，按 iteration-2
报告 13/16/17/18 定型表修正草案（响应主键裸 id、vaccineName、40904/42202 新码、
42200 不引入、PATCH 不支持清空回 null、cursor 分页正典、PetSummary 四聚合口径
逐字收录、tz 参数缺省 UTC、防枚举 40401/40402 语义定型）。错误码表 +8：
40300/40401/40402/40902/40903/40904/42201/42202。docs/api/index.md 端点清单同步。
冻结后任何字段变更须显著上报、两端同步。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-08 10:10:37 +08:00
lixi 5de9f397cb docs(architecture): 新增后端模块结构与职责速览页
CI / docs-build (push) Successful in 33s
Details 
四模块（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
Details 
- 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
Details 
- 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 2ceab6b296 docs(api): 契约补录 POST /api/v1/events（关闭 D-1）
CI / docs-build (push) Successful in 1m22s
Details 
以 AnalyticsController 实测行为为准补录埋点上报端点：批量 1-50、
202 逐条结果（accepted/duplicate/rejected + 4 种拒绝原因）、eventId
幂等、唯一允许匿名的写端点（带 Bearer 则完整校验 401/40101）、
400/40000 整批拒绝。info.version 1.0.0 -> 1.1.0（纯增量）；
index.md 端点清单同步为 6 端点。python yaml 解析 +
mkdocs build --strict 均通过。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-09-07 14:09:45 +08:00
lixi 1891d9b7b4 docs: M2 开工前分析 10 份报告入档 + ADR-009~015 拍板决策
CI / docs-build (push) Successful in 1m3s
Details 
- 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 5537f92227 fix: CI 改用 apt 安装 mkdocs（避免 PEP 668 externally-managed-environment）
CI / docs-build (push) Successful in 12m21s
Details
2026-09-04 18:25:19 +08:00
lixi f267141334 chore: 新增文档 CI 门禁工作流并同步功能清单
CI / docs-build (push) Failing after 2s
Details 
- mkdocs build --strict，与本地门禁同一命令，pip 走腾讯云镜像
- 功能清单 CI 项更新为三仓全覆盖
 2026-09-04 18:20:57 +08:00
lixi 64521bf284 docs: CI 载体上线收官——功能清单/看板/迭代总结同步 ✅ 
- Gitea Actions runner 部署完成（域名注册 + docker.sock 挂载）
- 工作流零 GitHub 依赖（本实例手动克隆 + apt 装 JDK17），ci.yml #6 全绿 3m18s
- 第一迭代所有工程化项闭环
- 门禁：mkdocs build --strict 通过
 2026-09-04 18:18:26 +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 b26b2af089 docs: CI Runner 手册补充国内网络问题修法并同步清单状态 
- 镜像加速、DEFAULT_ACTIONS_URL、runner 重注册清残留等实操要点
- 门禁：mkdocs build --strict 通过
 2026-09-04 16:35:08 +08:00
lixi 3ac756fa14 docs: 功能清单同步会话清理任务交付（75 测试） 
- auth_sessions 清理任务 ✅（patbond-api@6528a06，保留期即重用检测窗口的设计说明随注释入库）
- 门禁：mkdocs build --strict 通过
 2026-09-04 15:47:07 +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 b6b8e774e7 docs: 功能清单同步后端追加交付与 phone 修复状态 
- compose 编排/信封严格化/deviceId/Gitea CI 状态、74 测试数、跨端核对发现由后端线更新
- UserProfile.phone 可空修复标记完成（patbond-flutter@845e92f）
- 门禁：mkdocs build --strict 通过
 2026-09-04 14:56:06 +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 18746ce6fc docs: 增加 ADR-008 将 PostgreSQL 版本基线定为 18 
- 零数据窗口期定版：与本机开发库 18.6 对齐，Testcontainers/编排/交付统一 postgres:18
- 切换当日 37 测试于 postgres:18 全绿，Flyway V1 兼容
- 同步开发计划 5.1/M0/CI 门禁与进展看板的版本表述
- 门禁：mkdocs build --strict 通过
 2026-09-04 11:33:58 +08:00
lixi b747e09af8 docs: 增加 ADR-007 部署形态决策 
- 容器化无状态应用 + MVP 用 compose 数据库挂 volume 加每日备份，规模化后迁云托管数据库
- 连接信息经环境变量注入，保证换库应用层零改动
- 门禁：mkdocs build --strict 通过
 2026-09-04 11:30:18 +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
lixi b302f162e6 update database doc 2026-08-14 17:09:15 +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