大海
65 lines
2.6 KiB
Markdown
65 lines
2.6 KiB
Markdown
# Backend Semantic Fix Report
|
||
|
||
> 2026-06-05T19:10:00Z
|
||
|
||
## Summary
|
||
|
||
三轮修复，彻底解决后端 schema 语义问题。
|
||
|
||
## Fix 1: singularize 函数修复
|
||
|
||
**问题:** `reading_status` → `reading_statu`（去掉尾部 s 时误伤）
|
||
|
||
**修复:** `backend-builder-agent.mjs` + `fullstack-composer-agent.mjs` 添加 `SINGULAR_EXCEPTIONS` 集合，识别 `status/bus/campus/focus` 等 s 为词根的词。复合词（`reading_status`）按最后一段检查。
|
||
|
||
## Fix 2: 领域特有字段
|
||
|
||
**问题:** `deriveTableFromFeature()` 对所有表只生成 `title/description/status/data` 通用字段。
|
||
|
||
**修复:** `architecture-agent.mjs` 新增 `FIELD_TEMPLATES` 系统，40+ 关键词匹配规则，覆盖：
|
||
- 书籍/阅读：author, isbn, cover_url, publisher, genre, book_id, rating, percentage
|
||
- 任务/看板：board_id, priority, due_date, assignee_id, role
|
||
- CRM：email, phone, company, source, stage, amount, probability
|
||
- 库存：quantity, warehouse, min_stock, supplier
|
||
- 教育：instructor, course_id, sort_order, duration_min, max_score
|
||
- 宠物：species, breed, birth_date, weight_kg
|
||
- 文章/媒体：content, excerpt, cover_url, mime_type, size_bytes
|
||
- 等等...
|
||
|
||
匹配失败时 fallback 到通用字段。
|
||
|
||
## Fix 3: 移除域模板残留
|
||
|
||
**问题:** `domainSchemas[domain]` 盲目补充域模板表（如 note 域的 tags/note_tags），与 features 派生的表冲突。
|
||
|
||
**修复:** 删除整个 `domainSchemas` 体系。tables 100% 从 features 和 API paths 派生，不再有域模板补充。
|
||
|
||
## 验证结果
|
||
|
||
### Benchmark
|
||
| 测试 | 结果 |
|
||
|------|------|
|
||
| 10/10 领域 E2E | ✅ PASS |
|
||
| 170/170 回归测试 | ✅ PASS |
|
||
|
||
### 真实需求语义验证
|
||
| 需求 | Tables | 中文标识符 | 域模板污染 |
|
||
|------|--------|-----------|-----------|
|
||
| BookShelf | users/books/reading_status/reading_progress/reviews/stats | ✅ None | ✅ None |
|
||
| TeamFlow | users/boards/tasks/members/activity_logs | ✅ None | ✅ None |
|
||
| MealPrep | users/foods/customers/meal_plans/nutrition | ✅ None | ✅ None |
|
||
|
||
### 字段质量验证
|
||
| 需求 | 特有字段示例 |
|
||
|------|------------|
|
||
| BookShelf | books: author/isbn/cover_url/publisher/publish_date/genre |
|
||
| BookShelf | reviews: book_id/rating/content |
|
||
| TeamFlow | tasks: board_id/priority/due_date/assignee_id |
|
||
| MealPrep | foods: calories_per_100g/protein_g/fat_g/carb_g |
|
||
|
||
## 改动文件
|
||
|
||
- `scripts/architecture-agent.mjs` — FIELD_TEMPLATES + getDomainFields + 去重逻辑 + 删除 domainSchemas
|
||
- `scripts/backend-builder-agent.mjs` — SINGULAR_EXCEPTIONS
|
||
- `scripts/fullstack-composer-agent.mjs` — SINGULAR_EXCEPTIONS
|