# 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 / 11（NSIS `.exe`）                                                                                       |
| 开发平台 | macOS（GitHub 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 个人所有）。