# 货代单证多系统自动录入 - Lean MVP PRD

> Generated: 20260512-1505
> Source: `SmokeTests/traditional-biz-ai-scenarios__smoke-test__20260512-1505.md`

## 1. Problem & User
- Target User: 货代公司单证操作员与报关/船务录入人员
- Core Pain: 一个能从贸易单据中结构化提取字段、做跨单据一致性校验、并直接写入多个业务系统和外部门户的端到端工作流自动化产品，而不是只做OCR识别的单点工具。

## 2. Outcome & KPI
- Primary Outcome: User achieves tangible value within one complete workflow
- KPI-1: Core workflow completion rate
- KPI-2: Trial-to-paid conversion rate
- KPI-3: 7-day retention (minimum tracking)

## 3. MVP Scope (In)
- 一个让单证员上传合同/发票/装箱单后自动抽取核心字段、校验跨单据一致性，并导出CSV或生成网页表单填充数据的轻量工作台。

## 4. Out of Scope
- Native mobile apps
- Enterprise compliance suite (SSO, full SOC2, complex approvals)
- Non-critical automations and high-complexity integrations

## 5. User Flow (Happy Path)
- Sign up / log in → create core object → execute key action → get result → trigger payment / subscription

## 6. Functional Requirements (P0)
- P0-1: Create and list core entities
- P0-2: Execute core task
- P0-3: Status visibility and minimal notifications
- P0-4: Stripe billing entry point (subscription or one-time)

## 7. Minimal Data Model
- users
- accounts_or_workspaces
- core_entities
- core_events
- billing_subscriptions

## 8. API / Integration Notes
- Keep only essential external services: auth, database, billing
- Complete the local end-to-end loop first, then add external integrations

## 9. Acceptance Criteria
- A new user can complete one end-to-end core workflow within 15 minutes
- Payment flow succeeds in the test environment and records order status
- Core pages and APIs have basic error handling
- Minimal event tracking is in place to validate KPIs

## 10. Delivery Plan

### M1 — Data Layer (Day 1 morning)
- [ ] Create / migrate core data model files (e.g. `models/`, `migrations/`, `prisma/schema.prisma`)
- [ ] Core entity CRUD API (e.g. `app/api/<entity>/route.ts`)
- Exit criteria: unit tests pass; core entity is readable and writable

### M2 — Core Business Logic (Day 1 afternoon – Day 2 morning)
- [ ] Core workflow service layer (e.g. `lib/<feature>.ts`)
- [ ] Key UI pages and routes (e.g. `app/<feature>/page.tsx`)
- [ ] Stripe billing entry (e.g. `app/api/billing/`, `lib/stripe.ts`)
- Exit criteria: integration tests pass; core happy path runs end-to-end

### M3 — Polish & Launch (Day 2 afternoon)
- [ ] Error handling and edge cases
- [ ] Minimal event instrumentation (KPI: core flow completed, payment triggered)
- [ ] Build + deployment verification
- Exit criteria: new user completes full end-to-end flow within 15 min; test payment succeeds

## 11. Risks & Mitigations
- Risk: scope creep — Mitigation: any new requirement must replace, not stack on top of, a P0 item
- Risk: unstable key dependency — Mitigation: build a degradable fallback first; keep core flow working

## 12. Chargeability Rationale
- Pricing Hypothesis: 建议¥299-¥699/月/小团队，外加低量级按票数限制；理由是显著低于CargoWise、RPA和企业IDP方案的实施门槛，同时对3-10人的单证组来说，只要每月减少几次返工或每天节省1小时录入时间就有明确ROI。
- Why users will pay: directly reduces time and money lost to a high-frequency pain point.