fix(knowledge): 将 category 存储到 fault_source 字段
## 问题
数据库表 api_document 没有独立的 category 字段，导致 frontmatter 的 category 信息无法正确存储。
### 表结构分析
```sql
CREATE TABLE api_document (
fault_category VARCHAR(32) DEFAULT 'EXTERNAL_API', -- 固定枚举，不合适存储自定义分类
fault_source VARCHAR(128), -- 可以存储自定义分类
...
)
```
## 解决方案
使用 `fault_source` 字段存储 frontmatter 的 category：
```java
// 保存时
document.setFaultSource(category); // api, infrastructure, domain, troubleshooting
// 统计时
Map<String, Long> categoryCount = apiDocumentRepository.findAll().stream()
.collect(Collectors.groupingBy(
doc -> doc.getFaultSource() != null ? doc.getFaultSource() : "general",
Collectors.counting()
));
```
## 字段映射关系
| Frontmatter | 数据库字段 | 示例值 |
|-------------|-----------|--------|
| `title` | `api_name` | "支付网关错误码定义" |
| `category` | `fault_source` | "api" / "infrastructure" |
| `keywords` | `metadata` (JSON) | ["ERR_TIMEOUT","超时"] |
| `summary` | `metadata` (JSON) | "记录了..." |
## 优势
1. **充分利用现有字段**：fault_source (VARCHAR 128) 足够存储分类
2. **避免枚举限制**：不受 FaultCategory 枚举约束
3. **查询方便**：直接通过 fault_source 字段查询和统计
4. **向后兼容**：metadata 中仍保留完整的 frontmatter 信息
## 验证
```bash
# 初始化
curl -X POST http://localhost:9900/api/knowledge/init
# 查询统计
curl http://localhost:9900/api/knowledge/stats
# 响应
{
"categories": {
"api": 1,
"infrastructure": 3,
"domain": 1,
"troubleshooting": 1
}
}
```
## 数据库查询
```sql
-- 按分类统计
SELECT fault_source, COUNT(*)
FROM api_document
GROUP BY fault_source;
-- 结果
api | 1
infrastructure | 3
domain | 1
troubleshooting | 1
```
zhuyongxin
4e3502a51b