# 技术文档导航

本文档目录按“长期职责”组织，避免架构、代码蓝图、开发计划和字段合同混在一起。

## 1. 架构设计

路径：`架构设计/`

用途：说明 ContentFindAgent 为什么这样分模块、各模块 owner、写入边界、核心运行链路、规则包与游走策略边界、关键 ADR。

不承担：字段清单、DB schema、阶段开发顺序。

## 2. 工程落地

路径：`工程落地/`

用途：说明 V1 代码结构、P0 DB 与 Service 边界、待决策总台账、阶段开发计划和阶段验收清单。

不承担：长期架构原则、字段合同。

## 3. 数据接口与来源

路径：`数据接口与来源/`

用途：说明 DemandAgent、平台、外部接口和数据来源如何进入 CFA。

机器可读入口：`数据接口与来源/external_data_sources_registry.json`，用于按外部数据源查询接入状态、环境变量名、输入输出、runtime / DB 落点和当前缺口。

不承担：Pattern 回扣全链路细节。

## 4. Pattern 回扣与分类树

路径：`Pattern回扣与分类树/`

用途：说明 PG Pattern V2 exact mode、分类树反查、CFA 发现内容回扣、前置坑和 FAQ。

不承担：普通接口总览或代码阶段计划。

## 5. 数据库字段总览

路径：`数据库字段总览/`

用途：统一登记 DB 表、字段、runtime 文件、raw payload、字段晋升规则和 registry 校验。

## 6. 命名规范

路径：`命名规范/`

用途：统一标准名、禁用旧词、允许例外和命名检查规则。

## 权威来源

- 字段命名以 `命名规范/` 为准。
- DB 表、字段、runtime 和 raw payload 以 `数据库字段总览/` 为准。
- 架构原则以 `架构设计/` 为准。
- 代码结构和阶段执行以 `工程落地/` 为准。