文档状态:有效
适用范围:文档分类、权威来源与阅读导航
文档先按用途分类,再按前后端领域细分。这里的“当前实现”是与代码同批维护的事实说明,不代表自动生成或已通过所有环境验收。
| 要回答的问题 | 入口 | 负责内容 |
|---|---|---|
| 接下来改变什么、怎样验收? | plans | 活动方案、剩余任务、验收和退出条件 |
| 为什么这样设计、哪些约束不能破坏? | architecture | 已接受的职责、依赖、不变量与取舍 |
| 代码现在怎样运行、证据到哪里? | implementation | 实际入口、接线、数据流、能力和验证边界 |
| 修改和验证必须遵守什么? | rules | 文档、工具环境、本地测试等项目规则 |
| 主题 | 唯一完整维护位置 |
|---|---|
| 系统边界 | 系统设计 |
| 后端跨模块设计 / 模块契约 | 后端总览 / 模块索引 |
| 前端分层 / Management 安全设计 | 前端设计 / Management 设计 |
| 配置字段、默认值、路径和运行支持 | 配置参考,与 model、resolve、validate 同步 |
| Management API 字段与状态码 | v2 OpenAPI;对应生成类型不人工维护 |
| 后端与前端实际接线 | 后端实现 / 前端实现 |
| 构建、启动与发布脚本行为 | 交付实现;版本与命令以 manifest 和脚本为准 |
| WebUI Windows 联合验收与平台边界 | WebUI 联合验收,复现规则见 本地测试 |
| 文档分类、状态与维护流程 | 文档维护规则 |
源码、schema、配置和实际输出证明现状;架构记录接受的设计。两者冲突时记录差距并进入活动计划,不能靠改文档把缺陷变成契约。其他入口只给摘要和链接,不重复维护整套事实。
- 使用与开发:项目 README、前端工程 README。
- 开始变更:AGENTS.md 与对应领域文档。
- 临时日志、个人配置和运行记录放入
_fluxdns/,不进入长期文档;历史版本交由 Git 追溯。