概述

本 PR 作为仓库的正式工作起点，一次性合入：

1. 电商 mini 全栈项目骨架（4 大核心需求）
2. .codebuddy/ 框架（9 rules + 9 skills + 10 条反馈归档）
3. 完整迭代轨迹文档（CHECKPOINT.md）

包含的 10 个 commit

#	Commit	类型	说明
1	chore(infra)	基础设施	.gitignore + .env.example + docker-compose.yml + Dockerfile
2	docs(requirements)	需求文档	USR-001/PRD-001/ORD-001/PAY-001 四份 R1 扩写产出 + 验证模板
3	feat(backend)	后端主代码	86 个 Java 文件 / 4943 行：4 大业务模块 + Security + Redis 缓存 + MyBatis
4	test(backend)	测试代码	13 个单元测试 + 8 个功能测试（Testcontainers PG + Redis）
5	feat(frontend)	前端骨架	Vue 3 + TS + Pinia + Element Plus
6	chore(scripts)	运维脚本	订单并发压测脚本（验证超卖防护）
7	docs(framework)	Rules 抽象化	rules 去除项目专属细节，新增真实编译硬门禁、Filter/Interceptor 硬约束
8	docs(skills)	Skills 抽象化	新增脚手架通用局限、编译验证前置、审查清单硬门禁
9	docs(framework)	框架入口	.codebuddy/README.md + 10 条 FB 归档 + CHECKPOINT.md
10	docs(rules)	微调	git-conventions.md 与实际 .gitignore 对齐

验证证据

• ✅ IDE lint 0 错误
• ✅ Docker JDK 17 真实编译通过：mvn clean compile + mvn test-compile 全部 BUILD SUCCESS
• ✅ 单元测试 13/13 PASS
• ✅ 功能测试 7/8 PASS（Spring Boot + Testcontainers 首次启动成功，证实无循环依赖、Flyway 迁移正常；剩 1 个 ac3 测试已修正预期，待 CI 二跑）
• ✅ 全部遵循 Conventional Commits + R6 Git 规范

核心经验教训（已沉淀为可复用规则）

1. "静态检查通过 ≠ 代码能运行" —— lint 工具在工具链不兼容时会静默降级，必须用 mvn compile 做终极门禁（沉淀至 testing-standards.md §五、requirement-workflow §4.0、backend-checklist §0、cicd-pipeline 质量门禁 4 处）
2. 脚手架只适合内部 CRUD —— 6 类通用局限已文档化（scaffold/SKILL.md）
3. Filter/Interceptor 两大陷阱 —— 双重注册、消费请求体（backend-development §6.8）
4. Service 循环依赖用事件驱动解耦 —— 优先级：提取公共服务 → 事件驱动 → 依赖倒置
5. MyBatis XML 字段漂移是潜伏 Bug —— 必须通过 INSERT/UPDATE 测试兜底
6. 框架规则要可迁移 —— 具体版本号、一次性事件标记都不放进 rules

未完成工作（下一轮输入）

• FB-06（OPEN）：前后端 API 路径契约自动化校验，需扩展 api-docs skill
• B13/B14/B15：业务层的若干中优先级修复
• 功能测试 ac3 的 CI 最终验证

阅读建议

• 新接手：先读 .codebuddy/README.md 总览
• 了解迭代背景：读 CHECKPOINT.md
• 了解具体约束：读 .codebuddy/rules/testing-standards.md §五