# 团队文档中心（docs/）

> 前后端统一架构、编码标准、接口契约与 agent 协作边界的**单一权威来源**。
> 对应仓库：`abacus-static-framework`（Vue 前端底座）· `abacus.springboot.example`（Spring Boot 微服务模板）

## 文档导航

| 文档 | 内容 | 读者 |
|---|---|---|
| **coding-standards.md** | ★ 前后端开发约束规范（权威）：架构边界、APP_NAME 四处一致、前端规范、后端规范、接口契约、AI 生成检查清单 | 全体成员 + AI |
| architecture.md | 动静分离架构总览、技术栈、交付链路、治理体系 | 新成员 onboarding |
| agent-guide.md | AI 生成代码工作流（界面→代码提示词协议）、联调纪律、Vibe Coding 协作约定 | 全体成员 + AI |
| README.md（本文件） | 文档中心索引与交叉引用映射表 | 所有人 |

## 交叉引用映射表（单源化）

> 共享约束**只允许存在于 docs/**；各仓库 `.project.agents/docs/context/` 只写指针与仓库特有内容，禁止复制正文。维护共享内容时**先改 docs/，再同步各仓库指针**。

| 主题 | 权威位置 | 被引用于 |
|---|---|---|
| 前后端共享约束（命名/契约/工作流） | `docs/coding-standards.md` | 前端/后端 `CONVENTIONS.md`、`CLAUDE.md` |
| 动静分离架构链路 | `docs/architecture.md` | 前端/后端 `ARCHITECTURE.md` |
| AI 协作与界面→代码协议 | `docs/agent-guide.md` | 前端/后端 `VIBECODING_GUIDE.md`、`AGENTS.md` |
| 前端特有约定（标准件清单/页面模式） | 前端 `.project.agents/docs/context/CONVENTIONS.md` | 前端开发 |
| 后端特有约定（分层模板/SQL/打包） | 后端 `.project.agents/docs/context/CONVENTIONS.md` | 后端开发 |
| 升级日志 | 后端 `src/main/resources/doc/升级日志.md` | 发布记录 |

## 快速上手（新成员 / 新任务）

1. 读 `architecture.md` 了解整体形态。
2. 开发前通读 `coding-standards.md`（尤其 §3 APP_NAME 与 §6 接口契约）。
3. 由 AI 生成代码时，按 `agent-guide.md §2` 提供界面与业务说明，AI 遵循 §7 工作流并回附交付说明。
