文档地图
English version: Documentation Map
本手册采用分批收编的方式构建。下表先列出手册自身的章节，再列出仍位于仓库中的 文档位置，使所有文档都能从同一入口访问。
手册章节
| 章节 | 内容 |
|---|---|
| 概述 | 项目简介、核心能力与服务模型 |
| 核心术语与概念 | AAA 术语、认证请求流转与密码协议 |
| 快速开始 | 安装、初始化、首个用户与调试 |
| 厂商对接指南 | MikroTik、华为、Cisco、H3C、中兴、爱快等对接案例 |
| Portal / Hotspot 对接边界 | 铁律：ToughRADIUS 是 RADIUS AAA 后端，不托管 Captive Portal 登录页 |
| 场景实战手册 | 端到端运维场景（五段式）：MikroTik PPPoE / Hotspot / CoA；华为 BRAS 分级套餐 / 线路绑定 / CoA；H3C / 中兴 / 爱快 / Cisco 差异速查 |
| 管理系统用户手册 | 管理控制台逐页说明 |
| 运维指南 | 配置参考、证书、监控、备份与命令行工具 |
| LDAP / AD 认证后端 | 针对 LDAP/AD 目录校验口令（仅 PAP 族）：bind 模式、TLS、安全、指标 |
| 常见问题解答 | 按主题分组的常见问题 |
| 协议与 RFC 索引 | 协议标准与代码的对应关系 |
| 安全策略 | 安全公告与升级指引 |
| Agent 开发指南 | 面向贡献者的 AI-agent 工作流、质量门禁与自动委托循环摘要 |
仓库内文档
| 文档 | 说明 | 当前位置 |
|---|---|---|
| README | 项目介绍、特性与快速上手 | README.md |
| Agent 指南 | AI Agent 开发指南与协作规则 | Agent 开发指南（手册摘要） · AGENT.md（权威） |
| 安全策略 | 安全公告与升级指引 | 安全策略（权威） · SECURITY.md（指针） |
| 功能清单 | 功能范围基线（TR-F 编号） | docs/feature-checklist.md · English |
| 路线图 | 长期路线图与里程碑 | docs/roadmap.zh.md |
| RFC 索引 | 项目使用的协议标准索引 | 协议与 RFC 索引（权威） · docs/rfcs/README.md（原始目录） |
迁移计划。 手册现已覆盖 README 中面向用户的内容（概述、快速开始、厂商 对接、管理手册、运维、FAQ）；README 继续作为 GitHub 首页并链接到这里。 Agent 指南现已新增手册摘要章节，指向权威的
AGENT.md； 由于 agent 工具链直接引用，AGENT.md仍保留在仓库根目录。功能清单与路线图是 由专门流程维护的活文档，保持在docs/中并以链接方式纳入。