nex_docus/docs/README.md

文档地图

本目录是 NexDocus 文档的唯一入口。仓库根目录只保留 README.md（项目总览），其余文档全部在此。

按角色导航

你是谁 / 想做什么	从这里开始
第一次跑起来	quickstart.md
部署到服务器（Docker）	deploy/README.md
查表结构、写 SQL、排查数据	database.md
给使用者介绍功能	manual/user-guide.md
写代码前先对齐设计	sdd/README.md
查某个版本改了什么	sdd/releases/ · deploy/changelog.md
找运维/开发脚本	../scripts/README.md
翻历史方案（已与现状不符）	archive/README.md

目录结构

docs/
├── README.md              # 本文（文档地图）
├── quickstart.md          # 开发环境快速上手
├── database.md            # 数据库设计：18 张表 + 初始化/迁移链路
├── deploy/
│   ├── README.md          # Docker Compose 部署、升级、备份恢复
│   └── changelog.md       # 部署相关变更记录（端口、存储、脚本迁移等）
├── manual/
│   └── user-guide.md      # 面向最终使用者的功能手册
├── sdd/                   # 规格驱动开发（SDD）体系：愿景/架构/ADR/DV 规格/发布
└── archive/               # 历史文档归档，只作背景，不作为实现依据

文档维护约定

1. 新增文档只能落在 docs/ 下，根目录不再新增 *.md（README.md 除外）。
2. 文档内互链一律用相对路径，跨目录引用要能点击跳转；不要写"参见根目录 XXX.md"这类口头引用。
3. 涉及命令的段落必须与 scripts/ 的实际行为一致（例如统一写 ./scripts/deploy.sh，不是 ./deploy.sh）。
4. 严禁在文档中写入真实环境的地址、账号、口令。示例一律使用 change_me 之类的占位值。
5. 代码行为变更时，同一批改动里更新对应文档；做不到就在 sdd/releases/ 的发布记录里登记待办。
6. 数据库结构以 backend/app/models/ 为准，database.md 是其可读镜像；两者冲突时以模型为准并回头修文档。