听写助手对话记录 65¶
记录编号：DLG-20260809-65 日期：2026-08-09 智能体：听写（DT） 参与方：用户、DT 沟通渠道：AI 助手对话 主题：DIP1 前端方案升级为原生 App（React Native）+ 跳过阶段 1 直接实施阶段 2
一、用户需求¶
用户在详细检查 DIP1 子项目文档后，发现前端方案用户体验不足，提出重大架构调整要求：
- 前端方案升级：将师傅端（wkr-app）从 Next.js PWA 升级为 React Native 原生 App（iOS + Android）
- 新增客户端 App：新增客户端（cst-app）使用 React Native 原生 App（iOS + Android）
- 跳过阶段 1：不实施飞书对接（DIP1-P1），Code Agent 直接实施阶段 2 目标
- 全栈交付：DIP1 Code Agent 实施全栈开发（后端 + 前端三端），达成阶段 2 目标
用户原话："刚才再详细检查了 DIP1，发现前端方案用户体验不足，请按照原生 app 方案，将整体方案重新升级编写，我希望交给 dip1 项目 code agent 的工作任务直接实现阶段 2 的目标。"
二、工作过程记录¶
步骤 1：制定升级重写总计划¶
DT 制定 DIP1-原生App方案升级重写计划.md，分 5 批共 14 项任务系统化升级：
| 批次 | 任务范围 | 文档数 |
|---|---|---|
| 第一批 | 核心架构与阶段设计（ARC/P1/P2/P3） | 4 份 |
| 第二批 | 详细设计规格（SPEC/PROTO/API/Schema） | 4 份 |
| 第三批 | 实施指南与数据库迁移（IMP/Alembic 0002） | 2 份 |
| 第四批 | 子项目索引（dip1/docs/README） | 1 份 |
| 第五批 | 主仓集成（PJM/AGENTS/发布/WLG） | 4 份 |
步骤 2：第一批 - 核心架构与阶段设计升级¶
| 文档 | 版本变更 | 核心升级内容 |
|---|---|---|
| DIP1-ARC 架构设计 | V1.0→V2.0 | C4 容器图扩展双 RN App（wkr-app + cst-app）；新增 ADR-008（跳过 P1 决策）/ADR-009（React Native 选型）/ADR-010（Expo managed workflow）/ADR-011（NativeWind）/ADR-012（EAS Build）/ADR-013（移动端认证 refresh token 轮换），共 13 条 ADR |
| DIP1-P1 飞书对接 | V1.0→V1.1 | 顶部新增「⏸ 暂不实施」醒目告警，标注 ADR-008 决策依据、跳过理由、未来启动条件、Code Agent 行为约束 |
| DIP1-P2 一线操作系统 | V1.0→V2.0 | 新增 CST 客户端限界上下文；REST API 端点 52→65（+12 CST + 3 移动认证 + 2 推送）；数据库表 18→22（+4 表：cst_customers/mobile_sessions/push_devices/push_notifications）；新增移动认证（refresh token 轮换/设备管理）+ 推送服务（FCM/APNs via Expo Notifications） |
| DIP1-P3 技术基础设施 | V1.0→V1.1 | 工具链新增 Expo CLI/EAS CLI/watchman/Xcode/Android Studio；CI/CD 新增 EAS Build/Submit/Update 三 Job + 移动端流水线子图；测试金字塔新增 Detox RN E2E + Jest RN 单测；部署架构新增 App Store Connect/Google Play Console + Expo Updates OTA；可观测新增 Sentry RN SDK + 移动端 APM |
步骤 3：第二批 - 详细设计规格升级¶
| 文档 | 版本变更 | 核心升级内容 |
|---|---|---|
| DIP1-SPEC 需求规格 | V1.0→V2.0 | 新增 CST 客户端 App 功能点（首页/品类/询价/订单/评价/推荐/我的 7 大模块）；新增移动端 NFR（启动 <2s/崩溃率 <0.1%/离线可用/推送送达率 ≥95%）；功能点总数 193→193+ |
| DIP1-PROTO 功能原型 | V1.0→V2.0 | WKR 师傅端从 Next.js PWA 8 页重写为 React Native 8 页（原生相机/推送/离线）；新增 CST 客户端 React Native 8 页；主题 Token 从 shadcn/ui 扩展为 NativeWind（Web + RN 统一）；交互流从 10 条扩展覆盖三端 |
| DIP1-API OpenAPI | V1.0→V2.0 | 端点数 52→65：新增移动认证 3 端点（OTP 发送/登录/刷新）+ CST 客户端 12 端点（品类/询价/订单/评价/推荐）+ 推送 2 端点（注册/发送） |
| DIP1-Schema 数据库 | V1.0→V2.0 | 表数 18→22：新增 cst_customers（客户账号）/ mobile_sessions（移动会话）/ push_devices（推送设备）/ push_notifications（推送记录）；RLS 策略扩展至客户数据隔离 |
步骤 4：第三批 - 实施指南与数据库迁移¶
| 文档/脚本 | 版本变更 | 核心升级内容 |
|---|---|---|
| DIP1-IMP Code Agent 实施指南 | V1.2→V2.0 | 工作量 85→105 人天（+20：新增 CST + 移动基建 - 飞书）；4 阶段实施计划（§0 环境基建 9 + §2 后端 49 + §3 前端 32 + §3 移动基建 5 + §4 部署 10）；角色定义更新；Git 分支策略同步；§7.1 状态跟踪矩阵更新 |
| Alembic 0002 迁移脚本 | 新建 V1.0 | 0002_cst_mobile_push.py：新增 4 表（cst_customers/mobile_sessions/push_devices/push_notifications）+ 索引 + 外键；含 upgrade()/downgrade() 双向迁移 |
步骤 5：第四批 - 子项目索引更新¶
| 文档 | 版本变更 | 核心升级内容 |
|---|---|---|
| dip1/docs/README.md | V1.2→V1.3 | 文档索引表 10 份全面同步 V2.0 版本号；文档关系图各节点标注版本与状态（P1 标注⏸）；§4.1 阅读顺序调整：Code Agent 跳过 P1 直接实施 P2；新增 WKR/CST RN 前端阅读路径 |
步骤 6：第五批 - 主仓集成同步¶
| 文档 | 版本变更 | 核心升级内容 |
|---|---|---|
| PJM 项目管理 | V2.4→V2.5 | §3.4 定位从「阶段 1+2」改为「阶段 2 原生 App 方案（跳过阶段 1）」；§3.4.1 关系图 D_CODE 新增三端 Monorepo、D_DOC 标注 V2.0、F1 标注⏸、F2 18→22 表；§3.4.2 RACI 表架构决策 10→13 ADR、飞书对接/数据迁移行标注⏸ 跳过、新增移动端 RN + CST 行、85→105 人天；§3.4.3 跟踪矩阵 V1.0→V2.0、代码 85→105 人天 4 阶段拆分；§3.4.5 + §4.4.5 TL 同步触发条件 6→8 项；§2.3 + §4.3.1 同步 |
| AGENTS.md | V8.6→V8.7 | 导航表 DIP1 区块 12 条目全面同步 V2.0 版本号；发布文档表 DIP1 汇总 PDF V1.0→V2.0、状态矩阵 85→105 人天；Mermaid 目录树 PUB_D1PDF 节点更新；DIP1 定位改为「阶段 2 原生 App 方案」 |
| 发布/dip1/README | V1.1→V1.2 | §二 发布清单 11 份同步 V2.0；§三 版本对应表重构为 4 阶段（V2.0→V2.1→V2.2→V2.3→V3.0）；§四 状态矩阵 85→105 人天、里程碑 12→14、部署新增 EAS Build/App Store/Google Play/OTA；汇总 PDF 文件名 V1.0→V2.0 |
| DLG-65 工作日志 | 新建 | 本文件，记录升级全过程 |
三、结论与产出¶
本次对话产出物清单¶
| 序号 | 产出物 | 位置 | 版本变更 | 状态 |
|---|---|---|---|---|
| 1 | DIP1-ARC 架构设计 | dip1/docs/DIP1-ARC-架构设计.md |
V1.0→V2.0 | 已完成 |
| 2 | DIP1-P1 飞书对接设计 | dip1/docs/DIP1-P1-MVP-FS飞书对接设计.md |
V1.0→V1.1 ⏸ | 已完成 |
| 3 | DIP1-P2 一线操作系统 | dip1/docs/DIP1-P2-一线操作系统设计.md |
V1.0→V2.0 | 已完成 |
| 4 | DIP1-P3 技术基础设施 | dip1/docs/DIP1-P3-技术基础设施.md |
V1.0→V1.1 | 已完成 |
| 5 | DIP1-SPEC 需求规格 | dip1/docs/DIP1-SPEC-需求规格说明书.md |
V1.0→V2.0 | 已完成 |
| 6 | DIP1-PROTO 功能原型 | dip1/docs/DIP1-PROTO-功能原型设计.md |
V1.0→V2.0 | 已完成 |
| 7 | DIP1-API OpenAPI 规格 | dip1/docs/DIP1-API-OpenAPI规格.yaml |
V1.0→V2.0 | 已完成 |
| 8 | DIP1-Schema 数据库设计 | dip1/docs/DIP1-Schema数据库详细设计.md |
V1.0→V2.0 | 已完成 |
| 9 | DIP1-IMP Code Agent 实施指南 | dip1/docs/DIP1-IMP-Code-Agent实施指南.md |
V1.2→V2.0 | 已完成 |
| 10 | Alembic 0002 迁移脚本 | dip1/backend/alembic/versions/0002_cst_mobile_push.py |
新建 V1.0 | 已完成 |
| 11 | DIP1 文档索引 | dip1/docs/README.md |
V1.2→V1.3 | 已完成 |
| 12 | PJM 项目管理 | docs/项目管理.md |
V2.4→V2.5 | 已完成 |
| 13 | AGENTS.md 人机协作指南 | AGENTS.md |
V8.6→V8.7 | 已完成 |
| 14 | 发布/dip1/README | 发布/dip1/README.md |
V1.1→V1.2 | 已完成 |
| 15 | DLG-65 工作日志 | docs/工作日志/对话记录/20260809_听写助手对话记录65_DIP1原生App方案升级.md |
新建 | 已完成 |
关键决策与说明¶
-
跳过阶段 1 飞书对接（ADR-008）：TL + SPO 决策，理由有三：① 飞书方案（阶段 0 MVP-FS）实际运行情况待观察；② 直接做原生 App 避免飞书 SDK 投入打水漂；③ Code Agent 全栈聚焦阶段 2 目标。P1 文档保留为「⏸ 暂不实施」，未来视飞书方案运行 ≥3 个月后评估是否启动。
-
React Native + Expo managed workflow 选型（ADR-009/010）：相比裸 RN，Expo managed workflow 提供：① EAS Build 云端构建（免本地 Xcode/Android Studio）；② OTA 热更新（JS Bundle 变更无需重新提审）；③ 统一推送（Expo Notifications 屏蔽 APNs/FCM 差异）；④ 原生模块按需 eject（expo-camera/expo-image-picker 等满足 90% 需求）。
-
NativeWind 跨端样式统一（ADR-011）：Web（opr-admin Next.js）与 RN（wkr-app/cst-app）共享 Tailwind CSS 语法，设计 Token 单一来源，避免双套样式维护成本。
-
工作量 85→105 人天（+20）：新增客户端 App（+12）+ 移动端基建 EAS/提审/OTA（+5）+ 后端移动认证与推送（+3）- 飞书对接（-12）+ 环境基建 Expo 工具链（+2）+ WKR PWA→RN 重写（+3）= 净增 20 人天。
-
数据库表 18→22（+4）：cst_customers（客户账号，区别于 CPT 中的客户线索）/ mobile_sessions（refresh token 轮换 + 设备管理）/ push_devices（多设备推送 token）/ push_notifications（推送记录与送达状态）。
-
API 端点 52→65（+13）：移动认证 3（OTP/登录/刷新）+ CST 客户端 12（品类浏览/询价/订单/评价/推荐）+ 推送 2（设备注册/发送），其中部分原 CPT 端点扩展为 CST 可调用。
后续行动项¶
| 序号 | 行动项 | 责任人 | 优先级 | 备注 |
|---|---|---|---|---|
| 1 | Git 提交本次 15 份文档变更并推送至 dev 分支 | TL | 高 | 用户明确指令后执行（PMG AI 特定行为 #3） |
| 2 | 公开文档同步至 hk2026-docs + MkDocs 站点部署 | TL | 中 | 用户明确指令后执行（PMG AI 特定行为 #4） |
| 3 | DIP1 汇总 PDF V2.0 生成 | DT | 中 | 用户明确指令后执行（PMG AI 特定行为 #1） |
| 4 | Code Agent 启动 §0 环境基建（9 人天） | DIP1 Code Agent | — | 待 TL 触发，需先提供 Expo 账号/App Store/Google Play 凭据 |
四、版本影响范围¶
本次升级涉及 DIP1 子项目全部 10 份技术文档 + 1 份 Alembic 脚本 + 4 份主仓集成文档，共 15 份文档版本变更：
- DIP1 子项目文档：10 份（ARC/P1/P2/P3/SPEC/PROTO/API/Schema/IMP/README）全部升级至 V2.0 或对应新版本
- 主仓集成文档：PJM V2.5 / AGENTS V8.7 / 发布-dip1 V1.2 / WLG DLG-65
- 代码资产：新增
0002_cst_mobile_push.pyAlembic 迁移脚本
DIP1 子项目加权完成度维持 10%（文档 10/10 🟢 V2.0 已交付，代码 105 人天 🟡 待 Code Agent 启动）。
本记录由听写助手（DT）于 2026-08-09 整理，对齐 PJM §三 记录规范与 §四 整理要求。