文档发布目录（Publish）
目录编号：PUB
创建日期：2026-08-06
维护人：DT / OL
关联文档：PMG、WLG
一、目录定位
本目录是项目的文档发布区，存放面向不同受众的文档成品（PDF/HTML），区别于代码发布。
| 维度 |
文档发布（本目录） |
代码发布 |
| 内容 |
PDF / HTML 文档成品 |
可执行代码 / 部署包 |
| 受众 |
团队内部 / 投资方 / 客户 / 合作方 |
开发团队 / 运维 |
| 来源 |
由 docs/ 目录下的 MD 源文件生成 |
由开发团队编码产出 |
| 版本 |
跟随源文件版本，文件名含版本号 |
Git tag / release |
二、发布文档清单
2.1 介绍类
| 文档 |
格式 |
大小 |
受众 |
说明 |
| 投资方介绍 |
PDF + HTML |
2.7MB |
投资方 |
项目介绍、商业模式、市场机会 |
| 团队内部介绍 |
PDF + HTML |
4.2MB |
团队内部 |
项目全景、服务架构、运营策略 |
2.2 架构文档类
| 文档 |
格式 |
大小 |
受众 |
说明 |
| 业务设计架构文档汇总 |
PDF |
8.6MB |
技术团队 / 管理层 |
19 篇业务设计文档汇总（含 27 张 Mermaid 图） |
2.3 MVP 方案类（m0 子目录）
MVP 双路径（MVP-FS 飞书版 / MVP-WX 小程序版）交付物独立成区，详见 m0/ 子目录索引
| 文档 |
格式 |
受众 |
说明 |
| m0/MVP-FS 启动辅助工具 |
HTML |
OL / ML / TL |
字段清单 · 报价计算器 · 8 阶段 Checklist · 协作规范 · 脚本速查 |
| m0/MVP-FS 飞书操作培训手册 |
HTML（PPT） |
OL / 师傅 / 全员 |
11 页兼具操作手册：飞书零基础入门 → 8 阶段逐段详解 → FAQ 速查表 |
| m0/MVP-FS 飞书管理员操作手册 |
HTML（PPT） |
OL / TL / ML（管理员角色） |
11 页管理员专属 V1.1：双管理员职责矩阵 · 工作台搭建 · 字段与公式 · 视图仪表盘 · 6 角色权限矩阵 + 师傅行级 · 3 条自动化 · 日常运维节奏 · 周报脚本与表单迭代治理 · 10 问 FAQ + 12 项上线 Checklist；V1.1 新增各章「DT 一键执行」小节 + 附录 A 自动化能力清单（飞书 CLI/API，自动化率 90%） |
| m0/MVP-FS Week1 开发准备清单 |
HTML |
TL / OL / BO |
配置周 13 项任务分解 · 6 表字段详情 · 种子数据 · 验收 Checklist |
| m0/MVP-WX 启动辅助工具 |
HTML |
TL / 开发 |
云开发配置 · DB 脚本 · 核心云函数模板 · 4 周冲刺计划 · 审核清单 |
| m0/MVP-WX 三端页面原型草图 |
HTML（模拟器） |
PO / TL / BO |
客户端 8 / 师傅端 6 / 管理端 8 = 22 页原型 · Tab 切换三端 |
| m0/MVP 实施方案（旧版 PDF 归档） |
PDF |
— |
V1.0 单路径旧版，已拆分升级为 MVP-FS V1.2 + MVP-WX V1.0 双路径 |
2.4 DIP1 技术开发子项目类（dip1 子目录）
DIP1 = 阶段 1（飞书工作台对接）+ 阶段 2（一线操作系统）独立代码实施子项目。10 份文档自包含，脱离主仓其他文档即可由独立 Code Agent 执行；代码暂不纳入发布 PDF。详见 dip1/ 子目录索引。
| 文档 |
格式 |
受众 |
说明 |
| dip1/DIP1技术设计文档汇总-V1.0 |
单一 PDF（由 AI 特定行为 #1 生成） |
TL / DIP1 Code Agent / 评审 |
11 篇顺序汇总：DIP1-00 索引 + 01 ARC + 02 P1 + 03 P2 + 04 P3 + 05 SPEC 193 功能点 + 06 PROTO 15+8 原型 + 07 OpenAPI 52 端点 + 08 Schema 18 表 + 09 IMP 实施指南 + 10 Alembic 脚本 |
| dip1/DIP1-09 交付物状态跟踪矩阵 |
README HTML 入口 |
SPO / BO 直接看这里 |
3 组 24 项红黄绿矩阵（文档10/10🟢 / 代码85人天🟡 / 部署UAT🟡），加权完成度 10%；无需打开其他文档即可评估子项目状态 |
| dip1/DIP1-07 OpenAPI 3.0 规格 |
YAML + Swagger UI HTML |
TL / FE / BE / DIP1 Code Agent |
52 端点完整定义，可直接导入 Swagger / Postman / Apifox，前后端契约唯一真值 |
2.5 服务设计类
| 文档 |
格式 |
大小 |
受众 |
说明 |
| 客户项目跟踪服务设计v1.0 |
PDF |
1.0MB |
技术团队 / 运营团队 |
CPT-D 8 阶段生命周期、跟踪池、采集物 |
| 现场工作登记表v1.0 |
PDF |
1.5MB |
运营团队 / 师傅 |
CPT-F 23 子表 183 字段电子表单 |
三、文档生成方式
| 文档 |
源文件 |
生成方式 |
| 投资方介绍 |
— |
独立制作（HTML PPT） |
| 团队内部介绍 |
— |
独立制作（HTML PPT） |
| 业务设计架构文档汇总 |
docs/ 下 19 篇 MD |
Python + Mermaid CLI + Chrome headless 汇总 |
| MVP-FS / MVP-WX 发布物 |
docs/技术文档/m0/ 下 MVP-FS / MVP-WX 方案 |
DT 独立生成 HTML 工具/PPT/原型 |
| DIP1 技术设计文档汇总 V1.0（11 篇） |
dip1/docs/ 下 10 份 MD + 1 YAML + 1 Python 脚本（DIP1-00~10） |
PMG AI 特定行为 #1 文档汇总输出：顺序 1→11 汇总为单一 PDF，Mermaid 图批量转 PNG 内嵌，代码块保留语法高亮；每篇以「篇 N / 11」封面分隔；同时保留单篇 HTML 独立版本 |
| DIP1 子目录索引 README |
无（独立撰写） |
DT 手工编写，登记 11 份发布成品清单与版本追溯矩阵 |
| 客户项目跟踪服务设计v1.0 |
docs/客户项目跟踪服务/客户项目跟踪服务设计.md |
MD 转 PDF |
| 现场工作登记表v1.0 |
docs/客户项目跟踪服务/现场工作登记表.md |
MD 转 PDF |
四、版本管理
- 发布文档跟随源文件版本，文件名含版本号（如
v1.0）
- 源文件变更后重新生成发布文档，替换旧版本
- 历史版本不保留在此目录（归档至
docs/归档/）
- MVP 方案类文档按 Phase 0/0X/1 节奏迭代，独立维护在
m0/ 子目录
五、修订记录
| 日期 |
维护人 |
修订内容 |
| 2026-08-06 |
DT |
创建发布目录；转入 8 份文档（4 PDF + 2 HTML + 2 CPT PDF） |
| 2026-08-07 |
DT |
新增 m0/ 子目录（MVP 方案专属发布区）；迁移 6 份 MVP-FS/MVP-WX 交付物；新增 11 页 MVP-FS 飞书操作培训手册；发布文档从 8 份扩充至 9 份（含子目录共 14 份） |
| 2026-08-07 |
DT |
新增 11 页 MVP-FS 飞书管理员操作手册（OL/TL/ML 管理员角色专属：搭建·配置·运维·治理·迭代）；同步更新 m0/README.md 与发布/README.md 索引；发布文档（含子目录共 15 份） |
| 2026-08-07 |
DT |
管理员手册 V1.0→V1.1：各章新增「DT 一键执行」小节 + 附录 A「DT 自动化能力清单」（飞书 CLI/API，自动化率 90%）；MVP-FS 实施方案 V1.1→V1.2（新增自动化通道+DT 一键搭建路径）；旧版 PDF 归档说明版本号同步 V1.1→V1.2 |
| 2026-08-09 |
DT |
新增 dip1/ 子目录（DIP1 技术开发子项目发布区）：注册 11 份发布成品（10 份文档 + 1 Alembic 脚本）；发布文档表新增「2.4 DIP1 技术开发子项目类」区块；文档生成方式新增 DIP1 汇总 PDF 规则（PMG AI 特定行为 #1）；新增 SPO/BO 进度快速入口（DIP1-09 §7.1 红黄绿矩阵，加权完成度 10%）；发布目录含子目录共 26 份 |
本目录为文档发布区，源文件见 docs/ 目录，项目管理见 PMG。