# 文档索引

本目录只保留当前项目仍有维护价值的文档入口。文档口径必须服务当前项目真相：企业/团队私有化交付、NAS / Linux 部署、浏览器使用、许可证控制、低维护验收。

## 1. 必看入口

- `../README.md`
  仓库总说明，先看这里确认项目定位、目录结构、参考源码边界和常用入口。
- `../AGENTS.md`
  项目规则入口，定义参考源码目录、修改边界和目标环境。
- `当前工作流.md`
  当前开发、验证、部署和文档维护的基本流程。

## 2. 部署与交付

- `deployment/部署说明.md`
  主应用标准部署、快速步骤、部署前检查、验证和回滚说明。
- `deployment/多品牌 NAS 与 Linux 交付差异清单.md`
  面向不同 NAS / Linux 客户现场的部署前采集清单。
- `初次部署与出厂设置指南.md`
  从零安装、系统初始化和恢复出厂流程。
- `新手用户上手指引.md`
  给普通使用者看的基础操作指引。

## 3. 许可证与授权

- `许可证服务接入说明.md`
  当前主应用接入 `license-server` 的项目编码、公开接口和联调方式。
- `其他项目接入许可证系统说明.md`
  给其他项目负责人使用的许可证系统接入说明。

## 4. 功能与 API

- `api/模板系统API文档.md`
  上传模板、字段和模板系统相关 API。
- `user-guide/模板系统用户手册.md`
  模板系统的使用说明。
- `项目目标与目标环境.md`
  项目最终目标、目标客户和部署环境结论。

## 5. 内部参考资料

- `参考源码功能吸收整理_20260513.md`
  只在需要核对旧参考源码能力边界时阅读；它不是当前产品功能清单，也不是搬旧功能的依据。
- `商业化地基排查问题清单_20260524.md`
  内部整改跟踪清单，混有已完成项、待整改项和审计痕迹；只在追问题和核对状态时查看，不作为部署、接入或普通使用手册。
- `许可证链路安全评估_20260312.md`
  历史安全评估快照，部分条目已被后续代码和部署配置修正；保留作溯源参考，不作为当前整改入口。

## 6. 使用原则

1. 判断当前项目事实，先看 `../README.md`、`../AGENTS.md` 和当前代码。
2. 做部署和验收，先看 `deployment/部署说明.md`。
3. 做 NAS / Linux 私有化交付，先看 `deployment/多品牌 NAS 与 Linux 交付差异清单.md`。
4. 做许可证联调，先看 `许可证服务接入说明.md`。
5. 做参考源码功能吸收，先看 `参考源码功能吸收整理_20260513.md`，不要直接搬旧源码。
6. 旧报告、旧交付材料、旧交接文档和一次性排障记录不作为当前默认入口；内部整改清单只在追问题和核对状态时查看。