🎉 init: 小龙的工作空间

2026-06-06 10:40:48 +08:00
commit a188ee1426
3201 changed files with 231817 additions and 0 deletions
@@ -0,0 +1,64 @@
+# 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