# PRD: 酒店前台财务流程自动化工具

> **版本：** v1（基于 ScoredDemand 初次生成）
> **时间：** 2026-05-12
> **评分：** 28/40 — BUILD

---

## 1. Problem & User

**目标用户：** 连锁酒店前台人员、财务人员及酒店老板（3-30 家门店的小连锁）。

**核心痛点：** 前台每天要把 PMS 系统的入住/消费数据手工整理成交班汇总、日结对账单，再复制粘贴到 Excel 或金蝶/用友财务系统。现金+刷卡+OTA 回款是否对上，全靠人工核算，每天 1-2 小时在纯机械劳动上，出错还要重做。

**用户痛言（老板）：** "你能帮我把财务省掉吗？"

**为什么现有方案不够：** 重型 PMS（OPERA/石基）已覆盖大型连锁；金蝶/用友不是为酒店前台交班设计的；中小连锁处于两者之间的空白地带，现有工具无法做到"当天上线、当天可用"。

---

## 2. Target Outcome & KPIs

- **主要 KPI：** 每日对账时间从 1-2 小时压缩到 10 分钟以内
- **次要 KPI：** 财务差错率降至 <0.5%（现金+刷卡+OTA 回款总额自动校验）
- **PLG 转化 KPI：** 完成首次对账的门店，14 天内付费率 ≥30%

---

## 3. MVP Scope (In)

- 上传酒店 PMS 导出 CSV（每日入住/消费数据）
- 自动解析：入住单、收款方式（现金/刷卡/OTA）、订单号、金额、房间号
- 自动生成 3 类结果：
  1. 前台交班汇总（含收款方式分类汇总）
  2. 财务日结对账单（含校验规则：现金+刷卡+OTA=PMS 日结总额）
  3. 金蝶/用友导入模板 CSV
- 差额自动标红（不平账预警）
- 人工审核通过/驳回按钮
- 审核通过后导出最终文件
- 按门店计费，¥299/月/门店

---

## 4. Out of Scope

- 真实 PMS API 深度集成（第一版只做 CSV 导入）
- OCR 手写单据 / 身份证识别
- 多角色复杂审批流
- 移动端 App
- 全国所有财务软件格式（MVP 只支持金蝶 + 用友标准导入格式）

---

## 5. User Flow（Aha Moment 路径）

**注册后 5 分钟内触达价值：**

1. **注册** → 引导页："配置你的 PMS 导出格式"（选择 PMS 类型或手动映射列名）
2. **上传演示 CSV**（系统提供样本文件）→ 系统自动映射字段
3. **点击"生成今日对账"** → 等待 ~20 秒
4. **Aha Moment：** 前台看到三栏结果：交班汇总表 + 日结对账单 + "现金+刷卡+OTA = ¥12,450，PMS 日结 = ¥12,380，差额 ¥70 标红"
5. **确认/修正差额** → 点击"审核通过"→ 下载金蝶导入 CSV
6. **第 8 天免费试用结束** → 付费墙弹出

---

## 6. Functional Requirements (P0)

**CSV 处理：**
- `POST /api/daily/upload` — CSV 上传 + 列名映射（支持 10 种常见 PMS 导出格式预设 + 手动映射）
- 字段提取：入住单号、客人姓名、房型、入住日期、退房日期、消费金额、收款方式（现金/银联/微信/支付宝/OTA渠道名）
- 存入 `daily_records` 表

**对账引擎：**
- 规则 1：按收款方式分组汇总，与 PMS 日结总额对比
- 规则 2：各渠道 OTA 回款核对（如美团/携程/飞猪）
- 差额 ≠ 0 → `has_discrepancy: true`，标红显示

**报告生成：**
- 交班汇总：房间数、入住率、各收款方式金额、值班员签名栏（PDF/打印友好）
- 日结对账单：分项明细 + 差额校验结果
- 金蝶导入 CSV：按金蝶标准凭证格式（借贷科目、金额、摘要）
- 用友导入 CSV：按用友 T3/T6 标准格式

**人工审核：**
- 审核页面：显示对账结果 + 差额详情
- 审核通过 → 状态更新为 `approved` → 解锁导出
- 驳回 → 前台可重新上传或手动修改金额

**Onboarding（零人工介入）：**
- 注册后提供演示 CSV 样本 + 预设字段映射（常见 PMS 格式）
- 无需配置即可完成一次完整对账流程演示

**付费墙（PLG 设计）：**
- 免费试用：7 天（不限门店数，功能完整）
- 7 天后 → 上传界面提示"试用到期，升级继续使用"
- 首次一次性配置费：¥999（字段映射 + 模板设置服务）→ 仅展示，用户自助完成无需购买

**自动化邮件序列：**
- Day 0：欢迎 + 演示 CSV 下载链接
- Day 3："您已完成 X 次对账，节省约 Y 小时"
- Day 5：试用即将到期提醒（含付费链接）
- Day 7：试用到期 → 升级引导邮件

---

## 7. Data Model（Minimal）

```
users(id, email, plan, trial_ends_at, stripe_customer_id)
properties(id, user_id, name, pms_type, field_mapping_json)
daily_uploads(id, property_id, upload_date, csv_path, parsed_records_count, status)
daily_records(id, upload_id, record_type, amount, payment_method, channel_name, raw_json)
reconciliations(id, upload_id, total_by_method_json, pms_total, discrepancy, has_discrepancy, status, approved_at)
exports(id, reconciliation_id, export_type, file_path, created_at)
```

---

## 8. API/Integration Notes

- **CSV 解析：** `papaparse`（Node.js），列名模糊匹配 + 预设映射表（10 种 PMS 格式）
- **PDF 导出：** `@react-pdf/renderer` 生成交班汇总 PDF
- **Excel/CSV 导出：** `xlsx` 库生成金蝶/用友标准格式
- **支付：** Stripe Billing（¥299/月/门店）
- **邮件：** Resend API

---

## 9. Acceptance Criteria

- [ ] 上传含 20 行的标准 CSV → 系统正确分类为现金/刷卡/OTA 三类收款方式
- [ ] 人工制造 ¥100 差额 → 对账结果中该差额标红显示
- [ ] 点击"审核通过"→ 可下载金蝶格式 CSV，文件包含借贷科目和金额
- [ ] 7 天试用结束 → 上传界面触发 Stripe Checkout
- [ ] 新用户注册 → 5 分钟内用演示 CSV 完成完整对账流程

---

## 10. Delivery Plan

### Milestone 1（Day 1-2）：CSV 处理 + 对账引擎
**文件：**
- `supabase/migrations/001_schema.sql`
- `app/api/daily/upload/route.ts` — CSV 上传 + 字段映射
- `lib/csv-parser.ts` — PMS 格式识别 + 字段提取
- `lib/reconciliation-engine.ts` — 对账规则（汇总 + 差额计算）

**Exit Criteria：** `POST /api/daily/upload`（含现金/银联/美团订单的 CSV）→ DB 中出现分类汇总，差额计算正确

### Milestone 2（Day 3-5）：报告 UI + 导出
**文件：**
- `app/daily/[id]/page.tsx` — 对账结果页（三栏 + 差额标红 + 审核按钮）
- `lib/report-generator.ts` — 交班汇总 PDF + 金蝶/用友 CSV 生成
- `app/api/daily/[id]/export/route.ts` — 导出接口
- `app/properties/[id]/page.tsx` — 门店字段映射配置页

**Exit Criteria：** 访问对账结果页 → 看到差额标红 → 点击审核通过 → 下载金蝶 CSV → 文件格式符合金蝶 T3 导入规范

### Milestone 3（Day 6-7）：PLG + 支付 + 引导
**文件：**
- `app/api/stripe/checkout/route.ts`
- `app/api/stripe/webhook/route.ts`
- `lib/trial.ts` — 7 天试用期检查
- `lib/email.ts` — Resend 邮件序列
- `app/onboarding/page.tsx` — 演示 CSV 引导页

**Exit Criteria：** 试用到期 → 上传接口返回 `trial_expired` → 前端弹出 Stripe Checkout → 支付成功 → 上传功能解锁

---

## 11. Risks & Mitigations

| 风险 | 缓解措施 |
|------|----------|
| PMS 导出格式多样 | 预设 10 种常见格式映射表 + 手动字段映射 UI（拖拽列名对应）|
| 用户不愿意手动映射列名 | 提供 5 种主流 PMS（石基/住哲/中软/Cloudbeds/Excel 手工导出）的一键映射预设 |
| 财务准确性要求高 | 所有差额标红 + 审核通过前无法导出；审核日志留存 |
| 竞品 PMS 已内置对账 | 聚焦"轻量插件"定位，不替换 PMS；强调"一天上线，无需 IT"的差异化 |

---

## 12. Chargeability Rationale

**免费版（7 天试用）：** 完整功能体验，酒店财务可真实测量"节省了多少对账时间 + 发现了多少差额"。

**付费版（¥299/月/门店）：** 试用期后持续使用 + 历史对账记录归档 + 多门店管理；对月均前台/财务人工成本 ¥3000-8000 的门店，只要每月节省 5 小时人工（¥30-50/小时）= ¥150-250 直接成本节约，ROI 合理；更不算减少差错引发的纠纷处理成本。

**付费墙触发时机：** 第 7 天——用户已完成首次对账且下载了财务文件，工作流依赖已建立，替换成本高。