docs: add README + 三 AI 入场文档

- README.md: 项目状态 + 路线图 + 分工
- CLAUDE.md: Claude 职责 + 门禁清单 + Review 重点
- AGENTS.md: Codex 二审侧重(M1 安全 / M4 密钥 / 并发点)
- GEMINI.md: Gemini 分期实施清单 + 红线 + 工作流

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
manpengan
2026-04-23 09:36:09 +08:00
parent 426fa54621
commit 20595a7545
4 changed files with 298 additions and 0 deletions

48
README.md Normal file
View File

@@ -0,0 +1,48 @@
# laundry-desk
洗衣店柜台管理系统 — 单店单机 Windows 桌面应用Apple HIG 风格 UI。
覆盖收件登记、取件、客户管理、收款、统计报表、物品拍照、58mm 热敏打印、腾讯云短信通知、多员工账号与审计全流程。
## 状态
| 项 | 值 |
|---|---|
| 阶段 | M0设计完成待 Gemini 实现 M1 |
| 设计文档 | [docs/superpowers/specs/2026-04-23-laundry-desk-design.md](docs/superpowers/specs/2026-04-23-laundry-desk-design.md) |
| 目标平台 | Windows 10 / 11NSIS `.exe` |
| 开发平台 | macOSGitHub Actions `windows-latest` 构建为准) |
## 技术栈
Electron 32 · React 19 · TypeScript 5 · Tailwind CSS 4 · shadcn/ui · Framer Motion 11 · Zustand · Drizzle ORM · better-sqlite3 · Vite · electron-builder · Recharts · Playwright · Vitest
## 路线图
| 期 | Tag | 范围 |
|---|---|---|
| M1 | `v0.1.0` | 骨架 + Apple UI + 收件/取件/列表/详情 + 客户去重 + 自动备份 + Windows 打包 |
| M2 | `v0.2.0` | 价格模板 + 按件计费 + 付款/欠款 + 日/月报表 + 逾期 + Excel 导入导出 |
| M3 | `v0.3.0` | 收件拍照 + 58mm 热敏打印登记单 / 取件条 |
| M4 | `v0.4.0``v1.0.0` | 登录 + 权限 + 审计 + 腾讯云 SMS |
## 分工
- **Claude**Opus 4.7)— brainstorm / spec / 门禁验收 / code review — 见 [CLAUDE.md](CLAUDE.md)
- **Codex** — 关键节点技术二审(架构 / 安全 / 并发)— 见 [AGENTS.md](AGENTS.md)
- **Gemini** — 主力实现、测试、修 build — 见 [GEMINI.md](GEMINI.md)
- **manpengan** — 决策 / UI 走查 / 发版
## 开发Gemini 实现 M1 后补)
```bash
pnpm install
pnpm dev # Electron 开发态
pnpm build:win # 打包 Windows .exe
pnpm test # Vitest 单测
pnpm test:e2e # Playwright E2E
```
## License
私有项目manpengan 个人所有)。