kindergarten_java/.claude/CLAUDE.md

Claude 开发规范

每次开始开发任务前，请先阅读本文档。

---

文档规范

开发日志

• 位置: /docs/dev-logs/
• 命名: YYYY-MM-DD.md（如 2026-02-22.md）
• 创建时机: 每天开始开发时，先检查当天日志是否存在，不存在则创建
• 更新时机: 开发过程中及时记录进展，结束时总结

测试记录

• 位置: /docs/test-logs/
• 目录结构:
  • admin/ - 超管端测试记录
  • school/ - 学校端测试记录
  • teacher/ - 教师端测试记录
  • parent/ - 家长端测试记录
• 命名: YYYY-MM-DD.md
• 创建时机: 每次进行功能测试时，在对应端目录下创建当天记录
• 更新时机: 测试过程中实时记录，发现问题及时更新

设计文档

• 位置: /docs/design/
• 索引: /docs/design/README.md

变更日志

• 位置: /docs/CHANGELOG.md
• 更新时机: 完成重要功能或修复时更新

---

项目结构

ccProgram/
├── docs/                      # 📁 项目文档（统一位置）
│   ├── README.md              # 项目说明
│   ├── CHANGELOG.md           # 变更日志
│   ├── dev-logs/              # 开发日志
│   ├── test-logs/             # 测试记录
│   │   ├── admin/             # 超管端测试
│   │   ├── school/            # 学校端测试
│   │   ├── teacher/           # 教师端测试
│   │   └── parent/            # 家长端测试
│   └── design/                # 设计文档
├── reading-platform-frontend/ # 前端项目
├── reading-platform-backend/  # 后端项目
├── start-all.sh               # 统一启动
└── stop-all.sh                # 统一停止

---

每日开发流程

1. 读取 /docs/dev-logs/ 下最新的日志，了解进度
2. 检查当天日志是否存在，不存在则创建
3. 开始开发任务
4. 结束时更新日志和 CHANGELOG

---

功能测试流程

1. 启动前后端服务
2. 在 /docs/test-logs/{端}/ 下创建当天测试记录
3. 按功能模块逐一测试，记录结果
4. 发现问题立即记录，标明优先级
5. 修复问题后在测试记录中更新状态
6. 测试结束后汇总统计

---

测试账号

角色	账号	密码
超管	admin	admin123
学校	school1	123456
教师	teacher1	123456
家长	parent1	123456
家长	parent2	123456

---

服务启动

cd /Users/retirado/ccProgram
./start-all.sh

---

UI 设计规范

禁止使用 Emoji 图标: 本项目严禁在前端界面中使用任何 Emoji 表情符号（如 👦 👧 📚 等）。请始终使用 Ant Design Vue 提供的图标组件（如 @ant-design/icons-vue）来代替。

---

本规范创建于 2026-02-22 最后更新于 2026-02-23