Cross-border Litigation Procedure Review Workbench
LitFlow 是面向跨国公司总部法务的诉讼程序核查工具：选择一个法域，查看该地的诉讼流程图；点击任一节点，即可看到该步骤的法律文件、期限、风险点、完成标准、异常信号、回问清单、法条出处与总部决策事项，用于对照外国律师的报告，快速识别遗漏与拖延。
LitFlow is a litigation procedure review workbench for in-house legal teams at multinational companies: pick a jurisdiction, review its litigation flow, and click any node to see the required documents, deadlines, risks, completion criteria, red flags, follow-up questions, legal sources and HQ decision items — so you can check foreign counsel reports and spot omissions or delays at a glance.
-
流程可视化 Flow Canvas：按阶段分组的节点图，支持子流程下钻（送达 / 证据 / 保全）
-
节点核查面板 Node Inspector：八大类核查信息（文件清单、期限计算、典型耗时、完成标准、异常信号、回问清单、法条出处、总部决策）
-
算期引擎 Deadline Engine：纯函数实现，周末 / 假日顺延、短期间规则，前后端共享并有完整单测
-
到期清单 Deadline List：按紧迫度排序，自动计算到期日与剩余天数，逾期自动标红
-
全案进度沙盘 Case Sandbox：以实务惯例区间对照当前进度，识别律师报告中的滞后
-
双视角 Role View：原告 / 被告分别查看对应的核查内容
-
可靠度提示 Reliability Warnings：泰国 / 越南内容标注 ⚠ caution，明示须当地律师核实
-
内容工作流 Content Workflow：草稿 → 审核 → 发布，版本历史与 diff，前台只读已发布内容
-
权限与审计 Permissions & Audit：按角色（hq_admin / hq_legal / firm_editor / viewer）强制权限边界，所有写操作落审计日志
-
Flow Canvas: phase-grouped node graph with sub-flow drill-down (service / discovery / interim)
-
Node Inspector: eight categories of review information (documents, deadline computation, typical duration, completion criteria, red flags, follow-up questions, legal sources, HQ decisions)
-
Deadline Engine: pure functions shared between frontend and backend, weekend/holiday rollover and short-period rules, fully unit-tested
-
Deadline List: urgency-sorted, auto-computed due dates and days remaining, overdue items flagged in red
-
Case Sandbox: compares actual progress against practical timelines to detect delays in counsel reports
-
Role View: plaintiff / defendant perspectives with separate review content
-
Reliability Warnings: Thailand & Vietnam content is marked ⚠ caution and clearly flagged as pending local counsel verification
-
Content Workflow: draft → review → publish with version history and diffs; the frontend only reads published content
-
Permissions & Audit: role-based enforcement (hq_admin / hq_legal / firm_editor / viewer) with an audit log for every write operation
| 法域 Jurisdiction | 代码 Code | 可靠度 Reliability |
|---|---|---|
| 澳大利亚 · 新南威尔士州 | nsw | full |
| 美国 · 加利福尼亚州 | ca | full |
| 美国 · 纽约州 | ny | full |
| 新加坡 | sg | full |
| 泰国 | th | ⚠ caution |
| 越南 | vn | ⚠ caution |
6 法域 · 4 类流程（诉讼 / 送达 / 证据 / 保全）· 84 节点 · 111 期限
6 jurisdictions · 4 flow types (litigation / service / discovery / interim) · 84 nodes · 111 deadlines
-
Monorepo：pnpm workspaces
-
apps/web：React 18 + TypeScript + Vite + Tailwind CSS -
apps/api：NestJS 10 + Prisma 5 + PostgreSQL -
packages/shared：算期引擎 + 共享类型（前后端共用） -
认证：Auth0 / Cognito 托管 JWT（jose 校验，fail-closed）
-
部署：Docker / Docker Compose（nginx + NestJS + PostgreSQL）
-
Monorepo: pnpm workspaces
-
apps/web: React 18 + TypeScript + Vite + Tailwind CSS -
apps/api: NestJS 10 + Prisma 5 + PostgreSQL -
packages/shared: deadline engine + shared types used by both ends -
Auth: hosted Auth0/Cognito JWT (verified with jose, fail-closed)
-
Deployment: Docker / Docker Compose (nginx + NestJS + PostgreSQL)
- Node.js 22+，pnpm 9+
- PostgreSQL 16（或 Docker）
# 安装依赖
pnpm install
# 配置环境变量（数据库连接 + 认证三项，认证缺失时 API 会拒绝所有请求）
cp .env.example .env
# 启动数据库（如用本地 PostgreSQL 可跳过）
docker compose up -d db
# 数据库迁移 + 导入原型数据（6 法域 / 84 节点 / 111 期限）
pnpm exec prisma migrate dev
pnpm exec prisma db seed
# 启动 API（默认 http://localhost:3000/api/v1）
pnpm dev:api
# 启动前端（默认 http://localhost:5173）
pnpm dev:web提示：
prisma db seed是幂等的，内容更新后可重复执行。
Note:
prisma db seedis idempotent and safe to re-run after content updates.
apps/
web/ # React 核查前台（Vite）
api/ # NestJS 只读 API + 内容工作流 + 权限 + 审计
packages/
shared/ # 算期引擎（reckoning.ts）+ 共享类型 + 单测
prisma/
schema.prisma
seed.ts # 从 docs/data.js 提取原型数据并断言校验
migrations/
docs/
LitFlow-技术架构与开发规格.md # 完整规格（含分阶段任务路线图）
litflow-prototype.html # 已验证的单文件原型（数据权威来源）
DEPLOY.md # 部署指引
pnpm test # 共享包 74 个用例（含算期引擎 §6.3 全部断言）
pnpm --filter @litflow/api test # API 17 个用例数据迁移断言：法域 = 6、节点 = 84、期限 = 111、caution = 2。
Migration assertions: jurisdictions = 6, nodes = 84, deadlines = 111, caution = 2.
本工具用于对照外国律师报告、识别遗漏与异常，不构成法律意见。泰国 / 越南内容为 ⚠ caution 级（AI 草稿 + 有限英文资料），投入正式核查前必须经当地执业律师复核固化；所有期限以法院实际认定为准。
This tool is for cross-checking foreign counsel reports and identifying omissions or anomalies, and does not constitute legal advice. Thailand and Vietnam content is ⚠ caution-grade (AI draft + limited English sources) and must be reviewed and finalized by local counsel before formal use; all deadlines are subject to the courts' actual determination.