DIP1 技术开发子项目发布区（dip1/）¶
子目录编号：PUB-D1 创建日期：2026-08-09 维护人：DT / TL 源文件位置：
dip1/docs/（10 份自包含文档） 代码位置：dip1/（纳入 Git 版本管理，暂不纳入发布 PDF） 关联文档：发布目录总索引、DIP1 目录索引、PJM §3.4 DIP1 子项目管理
一、定位¶
本子目录（发布/dip1/）是 DIP1 独立技术开发子项目的文档成品发布区，发布对象：
| 受众 | 关注点 | 推荐文档 |
|---|---|---|
| SPO（曾总）/ BO（洪哥） | 进度评估、里程碑审批、交付物质量 | 👉 DIP1-IMP-Code-Agent实施指南 §7.1 交付物状态跟踪矩阵（唯一真值，无需看其他 9 份） |
| TL（司徒总） | 架构评审、代码实施、部署验收 | DIP1-ARC（架构）→ DIP1-SPEC（需求）→ DIP1-API（接口）→ DIP1-Schema（DB）→ DIP1-IMP（实施） |
| DIP1 Code Agent（独立） | 实施依据、验收标准、Git 规范 | 10 份文档全部自包含，脱离主仓其他文档即可执行（按 DIP1-README §4.1 顺序阅读） |
| 外部评审/投资方（技术侧） | 子项目概览、技术方案可行性、交付进度 | DIP1-README 索引 → DIP1-ARC → DIP1-SPEC → DIP1-IMP §7.1 跟踪矩阵 |
⚠ 代码发布说明：
dip1/目录下的代码（后端 Python FastAPI + 前端 Monorepo：opr-admin Web + wkr-app RN + cst-app RN + 脚本）当前阶段暂不纳入本发布目录。代码通过 Git 主仓dev分支版本管理，正式发布后由 CI/CD（含 EAS Build）生成部署包，后续将在本目录下追加changelog/与release-notes/。
二、发布文档清单（10 份，源文件 → 发布成品映射）¶
生成方式：按 PMG「AI 特定行为 #1 文档汇总输出」将
dip1/docs/下 10 份 MD/YAML/Python 源文件，顺序汇总为单一 PDF（Mermaid 流程图转 PNG 内嵌，代码块保留高亮），文件命名：DIP1技术设计文档汇总-V2.0.pdf。 同时保留每份文档的独立 HTML 版本（便于快速跳转阅读）。
| # | 发布成品 | 格式 | 源文件（dip1/docs/） | 说明 | 状态 |
|---|---|---|---|---|---|
| 1 | DIP1-00-目录索引-V1.3 | HTML + 汇总PDF | README.md V1.3 | DIP1 文档导航 · 10 份文档关系图 · 两种阅读顺序（Code Agent 独立跳过 P1 / 人类背景）· V1.3 同步原生 App 方案 | 🟢 源文件已就绪 |
| 2 | DIP1-01-架构设计-V2.0 | HTML + 汇总PDF | DIP1-ARC-架构设计.md V2.0 | DDD 四层分层 · C4 容器图（双 RN App）· 13 条 ADR（含 RN/Expo/NativeWind/EAS 决策）· NFR 指标 · 架构演进 | 🟢 源文件已就绪 |
| 3 | DIP1-02-P1飞书对接设计-V1.1 ⏸ | HTML + 汇总PDF | DIP1-P1-MVP-FS飞书对接设计.md V1.1 | ⏸ 暂不实施（ADR-008）——Feishu SDK 封装 + 双轨同步层保留待未来启动；Code Agent 跳过本文档 | 🟢 源文件已就绪（暂不实施） |
| 4 | DIP1-03-P2一线操作系统-V2.0 | HTML + 汇总PDF | DIP1-P2-一线操作系统设计.md V2.0 | QSV/CPT/MDS/OPS/DSP/PAY + CST 客户端 · 65 REST API · 22 表 SQL · RBAC + RLS · 移动认证 + 推送服务 | 🟢 源文件已就绪 |
| 5 | DIP1-04-P3技术基础设施-V1.1 | HTML + 汇总PDF | DIP1-P3-技术基础设施.md V1.1 | 开发环境初始化（含 Expo/EAS）· Git Flow Lite · CI/CD + EAS Build/Submit/Update · 测试金字塔（含 Detox RN E2E）· 香港双 AZ + App Store/Google Play + OTA · Sentry RN | 🟢 源文件已就绪 |
| 6 | DIP1-05-SPEC需求规格-V2.0 | HTML + 汇总PDF | DIP1-SPEC-需求规格说明书.md V2.0 | 自包含核心：6 角色 × 12 域 × 193+ 功能点（含 CST 客户端）· 20+ 用户故事 · 14 项 NFR（含移动端）· 错误码表 · MVP 裁剪表 | 🟢 源文件已就绪 |
| 7 | DIP1-06-PROTO功能原型-V2.0 | HTML + 汇总PDF | DIP1-PROTO-功能原型设计.md V2.0 | 运营后台 15+ 页（Web）· 师傅端 RN 8 页 · 客户端 RN 8 页 · NativeWind 主题 Token · 10 条交互流 Mermaid · 响应式规范 | 🟢 源文件已就绪 |
| 8 | DIP1-07-OpenAPI规格-V2.0 | YAML 原文件 + HTML Swagger UI | DIP1-API-OpenAPI规格.yaml V2.0 | 65 端点完整定义（认证/移动认证/QSV/CPT/MDS/OPS/DSP/CST/推送/系统）· 可直接导入 Swagger/Apifox/Postman · 含错误码与分页规范 | 🟢 源文件已就绪 |
| 9 | DIP1-08-Schema数据库设计-V2.0 | HTML + 汇总PDF | DIP1-Schema数据库详细设计.md V2.0 | ER 图（Mermaid）· 22 业务表（新增 4 表：CST/移动会话/推送设备/推送记录）· 30 枚举 · 5 RLS 策略 · 索引优化建议 | 🟢 源文件已就绪 |
| 10 | DIP1-09-IMP-CodeAgent实施指南-V2.0 | HTML + 汇总PDF | DIP1-IMP-Code-Agent实施指南.md V2.0 | SPO/BO 进度入口：Git 仓信息 · 105 人天 4 阶段实施甘特（跳过 P1）· §7.1 交付物状态跟踪矩阵（3 组 24 项红黄绿） · 三级验收 Checklist · §十 反馈状态机 | 🟢 源文件已就绪 |
| 11 | DIP1-10-Alembic迁移脚本-V2.0 | .py 原文件（代码高亮 HTML 版） | 0001 + 0002 V2.0 | 与 DIP1-08 同步：0001（18 表）+ 0002（4 表：CST/移动会话/推送设备/推送记录） · upgrade()/downgrade() 双向 · PG 扩展/ULID 函数/updated_at 触发器 | 🟢 源文件已就绪 |
汇总 PDF 生成（由听写助手触发，AI 特定行为 #1）：顺序 1→2→3→4→5→6→7→8→9→10→11，每篇以「篇 N / 11」封面分隔，Mermaid 图批量转 PNG，代码块保留语法高亮，输出到
发布/dip1/DIP1技术设计文档汇总-V2.0.pdf。
三、文档与代码版本对应关系（便于追溯）¶
| DIP1 文档包版本 | 对应 Git 分支/Tag | 对应代码状态 | 说明 |
|---|---|---|---|
| V2.0（当前） | dev 分支，dip1-v2.0-doc 标签 |
骨架占位（50+ 文件）· 未实现功能逻辑 | 原生 App 方案设计阶段交付：10 份文档全部 🟢 V2.0（跳过 P1 飞书对接 ADR-008），代码待 DIP1 Code Agent 启动 |
| V2.1（§0 环境基建 + §2 后端完成后） | dip1-v2.1-be 里程碑 Tag |
Expo/EAS 工具链 + 5+1 大领域 + 65 API + 22 表 + RBAC + 移动认证 + 推送（49+9 人天） | 后端业务验收后发布，更新 DIP1-IMP §7.1 矩阵 |
| V2.2（§3 前端完成后） | dip1-v2.2-fe 里程碑 Tag |
OPR Web + WKR RN + CST RN 双端 + 原生模块 + 前后端联调（32 人天） | 前端三端验收后发布 |
| V2.3（§3 移动端基建完成后） | dip1-v2.3-mobile 里程碑 Tag |
EAS Build 4 artifact + App Store/Google Play 提审 + OTA 配置（5 人天） | 移动端上架就绪 |
| V3.0（正式上线） | v3.0.0（合并到 main） |
生产部署 + 蓝绿切换 + RPO/RTO 验证 + App 上架 | OL UAT 通过 + SPO 审批后发布 |
每版本发布后，本目录追加对应版本的
CHANGELOG-Vx.y.md，详细列出文档与代码变更点，由 TL + DT 维护。
四、交付物状态快速一览（与 DIP1-IMP §7.1 同步）¶
| 分组 | 数量 | 当前状态 | 加权占比 |
|---|---|---|---|
| 文档（D-01 ~ D-10） | 10 份 | 🟢 100% V2.0 全部交付（原生 App 方案） | 权重 10% |
| 代码（C-00 ~ C-13，105 人天） | 14 里程碑 | 🟡 0% 待 DIP1 Code Agent 启动（§0 环境基建 9 + §2 后端 49 + §3 前端 32 + §3 移动基建 5 + §4 部署 10） | 权重 60% |
| 部署/UAT/发布（DPL-01 ~ 04） | 4 项 | 🟡 0% 待代码完成（EAS Build + App Store/Google Play + OTA + 蓝绿部署） | 权重 30% |
| 综合加权完成度 | — | 10%（文档 V2.0 完成，代码待启动） | 100% |
SPO/BO 直接点击 DIP1-09 IMP §7.1 跟踪矩阵 查看 3 组 24 项红黄绿详情，无需进入代码或其他业务文档。
五、修订记录¶
| 版本 | 日期 | 维护人 | 修订内容 |
|---|---|---|---|
| V1.0 | 2026-08-09 | DT | 初始化 DIP1 发布子目录；注册 11 份发布成品（10 份文档 + 1 Alembic 脚本）；明确汇总 PDF 生成规则与版本追溯机制；与 DIP1-IMP §7.1 交付物状态矩阵同步 |
| V1.1 | 2026-08-09 | DT | 源文件路径同步：DIP1 文档从 docs/技术文档/dip1/ 迁移至 dip1/docs/（代码目录内，自包含）；所有源文件链接路径同步更新；关联文档 DIP1 目录索引链接更新至 ../../dip1/docs/README.md |
| V1.2 | 2026-08-09 | DT | 原生 App 方案升级（对齐 DIP1-ARC V2.0 ADR-008）：① §二 发布文档清单 11 份全面同步 V2.0 版本号（DIP1-00 V1.3 / DIP1-01 V2.0 / DIP1-02 V1.1 ⏸ / DIP1-03 V2.0 / DIP1-04 V1.1 / DIP1-05 V2.0 / DIP1-06 V2.0 / DIP1-07 V2.0 / DIP1-08 V2.0 / DIP1-09 V2.0 / DIP1-10 V2.0）；② §三 版本对应表重构为 4 阶段（V2.0 当前 → V2.1 后端 → V2.2 前端 → V2.3 移动基建 → V3.0 上线），对齐 105 人天 4 阶段实施计划；③ §四 状态矩阵代码 85→105 人天、里程碑 12→14、部署新增 EAS Build/App Store/Google Play/OTA；④ 汇总 PDF 文件名 V1.0→V2.0；⑤ 代码发布说明新增 Monorepo 三端 + EAS Build；⑥ 技术栈对齐 React Native + Expo + NativeWind |
本子目录为 DIP1 子项目专属发布区，源文件见 dip1/docs/，代码见 dip1/（暂不纳入发布），项目管理见 PJM §3.4。