### 开发环境说明
- 多八多云端开发容器环境
- Node.js 20.19.2
- PostgresSQL 17 (默认数据库: postgres) 
- Redis 7
- MinIO(默认存储桶: d8dai)
- 所有服务使用默认参数连接，正式环境参数相同
- 默认开放8080端口供外网访问

- ### Claude Code
- use pnpm
- 数据库在同一容器组的另一个容器中，需要运行 psql -h 127.0.0.1 -U postgres 来访问
- vitest中，只有console.debug会显示，其他的都屏蔽了
- vitest中，用import 来配合 vi.mocked，而不是require
- e2e测试平常只运行 pnpm test:e2e:chromium 就行
- e2e测试失败时先查看页面结构 test-results/**/error-context.md
- 前端是 hono/client  hc  rpc 的，不是直接fetch
- bmad-core dir is in .bmad-core
- 必须用中文回答
- **git提交**: 当遇到git锁文件冲突时，使用单条命令：`rm -f /mnt/code/184-172-template-6/.git/index.lock && git add <文件> && git commit -m "提交信息"`
- **测试调试**: 使用 `pnpm test --testNamePattern "测试名称"` 来运行特定测试查看详细信息 (mini使用Jest，其他包使用Vitest)
  - **Vitest**: 支持 `-t` 或 `--testNamePattern`
  - **Jest**: 只支持 `--testNamePattern`，mini是Jest
  - **Mini测试**: 需要先进入mini目录再运行 `pnpm test --testNamePattern "测试名称"`
- **表单调试**: 表单提交失败时，在表单form onsubmit=form.handleSubmit的第二个参数中加console.debug来看表单验证错误，例如：`form.handleSubmit(handleSubmit, (errors) => console.debug('表单验证错误:', errors))`
- 类型检查 可以用 pnpm typecheck 加 grep来过滤要检查的 指定文件