CodeBuddy

Hy3 preview

## 26年蒸蚌特权准备中...

26年蒸蚌特权准备中，顶级组织自由创建暂时关闭，节后放开，好好过节

电商 mini 演示项目 + .codebuddy 框架（rules/skills/feedback）— 沉淀了 Spring Boot 3 + Vue 3 全栈开发的规则与经验教训

anta-workshopdemo

合并来自 feature/scaffold-demo-stack-go-echo-sqlx 的合并请求 #27

docs(scaffold): SKILL.md + LESSONS 资产清单同步 go-echo-sqlx 活样板

PR-URL: #27


docs(checkpoint): 建立 CHECKPOINT.md 轨迹档案 + 2026-05 基线快照

test(scaffold): 补 13 个测试消除 #12 覆盖率退步（94%→98%）+ 棘轮阈值上调

新增测试类：

ModuleSpecValidationTests（4 个测试，覆盖 types.py 67-70）：
- test_valid_spec_passes
- test_empty_module_name_raises
- test_invalid_field_in_spec_propagates（for 循环向上抛异常分支）
- test_empty_fields_list_is_valid

GoRendererImportHelperTests（8 个测试，覆盖 go_echo_sqlx 107/109-110/138→141）：
- test_stdlib_only_fields          → 覆盖 107: stdlib.add(pkg)
- test_third_party_only_fields     → 第三方分组验证
- test_no_fields_returns_empty     → for 循环 0 次路径
- test_extra_stdlib_added          → 109-110: if extra + stdlib
- test_extra_third_party_added     → 109-110: if extra + third
- test_extra_mixed_stdlib_and_third
- test_deduplication_across_fields_and_extra
- test_entity_with_datetime_field_dedups_time_import     → 138→141 分支
- test_entity_without_datetime_still_imports_time        → 138 补加路径

测试数 32 → 45（+13），零实现代码改动。

棘轮阈值同步上调（scripts/ci/check-coverage.sh）：
  LINE_MIN   87 → 88
  BRANCH_MIN 84 → 86
  CORE_MIN   94 → 98

实测值与保底完全对齐：
  #10 行覆盖率      88%
  #11 行+分支      86%
  #12 核心业务     98%（从 94%⚠️ 推回，超过长期目标 95%）
  renderers/types.py         80% → 100%
  renderers/go_echo_sqlx.py  95% → 100%

双解释器（bash 严格 + dash POSIX）验证 7/7 脚本全绿。

派生自 meta-principles.md §原则 3（棘轮质量阈值——本 commit 是
'补测试→上调阈值'的一次完整演绎）+ §原则 2（可执行测试的负价值原则
反向演练——本轮修复的 go_echo_sqlx 覆盖率漏洞正是 PR #27 没贯彻
此原则的遗留）

Refs: CHECKPOINT §五 T-01（闭环）、§四 轮次 6


test(scaffold): 补 13 个测试消除 #12 覆盖率退步（94%→98%）+ 棘轮阈值上调

docs(rules): 新增 backend-go.md——Go + Echo + sqlx + goose 参考实现

关闭 CHECKPOINT §五 T-08。PR #27 给 scaffold 加了 go-echo-sqlx 栈作为
"活样板"（LESSONS §二 B4 反模式防御），但对应的 rules/backend-go.md
一直缺位——这是 PR #36 冷启动迁移演练的摩擦点 #3 发现的"栈扩展不对称"。

本文件按 backend-core.md §附录 的 5 步法生成，与
skills/scaffold/scripts/renderers/go_echo_sqlx.py 形成双事实源。

结构（对照 Java 参考实现的组织方式，保留硬约束的编号与语义）：
- §一 分层架构（Handler/Service/Repository + Wire() 显式装配）
- §二 边界对象（UpdateRequest 必须指针字段的硬约束 + validator 映射）
- §三 API 设计（APIResponse 响应壳 + 错误码常量化 + kebab-case 复数）
- §四 Service 层（ctx.Context 第一参数强制 + 接口注入 + 事务/幂等/状态机）
- §五 错误哲学（显式 error 非 panic + 哨兵错误 + %w 链路 + Echo 全局处理）
- §六 配置与密钥（fail-fast + envconfig/viper/koanf 选型）
- §七 日志（强烈推荐 log/slog 标准库）
- §八 并发（sync 原语 + goroutine recover + race 检测）
- §九 安全（fmt.Sprintf SQL 硬禁止 + 例外规则 + bcrypt + JWT 非对称）
- §十 测试（testcontainers-go/compose 真实 PG，禁 SQLite 方言差异）
- §十一 代码风格（gofmt + goimports + golangci-lint）
- §十二 Go 栈特有：sqlx NamedExec + goose YYYYMMDDHHMMSS 命名 + Up/Down 双段

规则写作前做了"产物反向核查"：先读 go_echo_sqlx.py 389 行，再写规则
每一节，确保"规则说的"与"产物做的"字面一致。关键三处已验证落实：
- §1.3 module.go + Wire() ✅
- §2.3 UpdateRequest 指针字段 ✅
- §9 fmt.Sprintf SQL 例外（列名白名单拼接）✅

派生自：meta-principles.md §原则 5（契约优先——工具层产出必须有对应
规则层契约）+ §原则 4（抽象化——core 骨架 + stack 特化的分层模式）。

Refs: CHECKPOINT §五 T-08, PR #27 scaffold go-echo-sqlx, PR #36 摩擦点 #3


与前一 commit 配套的文档更新：

- SKILL.md §内置栈渲染器：新增 go-echo-sqlx 一行
- SKILL.md §新增栈的 5 步落地：加一段"活样板"说明，指向
  renderers/go_echo_sqlx.py 作为照抄结构
- LESSONS §三 资产清单：scaffold 描述补上第三个内置栈

Successfully merged and closed