ARY 文档索引

P4 前端入口

P4 当前采用 React + TypeScript + Vite + React Router，应用入口在 apps/web。

常用命令：

npm install
npm run dev
npm run typecheck
npm run build

P4 架构说明见 docs/p4/frontend-architecture.md，接口协作草案见 docs/p4/api-contracts.md。

本文用于帮助 Agent 和开发者快速找到当前权威文档。根目录 PLAN.md 负责近期任务窗口，根目录 STATUS.md 负责任务瞬时看板。

文档路由

文档	作用
ary-mvp.prd.md	产品目标、MVP 范围、角色路径、产品验收口径。
ary-domain-analysis.v0.3.md	领域概念、核心对象、关系和不变量。
ary-mvp.ia.md	信息架构、页面层级、导航、页面状态和 URL 建议。
ary-permission-matrix.md	资源动作级权限、角色范围和接口鉴权输入。
ary.plan.md	研发任务定义、工作域编号、任务产出、任务验收和 Demo 节奏。
ary-qa-plan.md	测试覆盖、回归要求和质量门。
ary-release-ops-plan.md	发布、监控、备份、值守和回滚要求。
ary-ca-integration-spec.md	CA 接入契约草案，定义参赛过程中 CAConnection 登记与握手、多 CAConnection、push / fetch 边界、骑行状态消息、Projection 输入和评审前风险提示。
ux-hifi.taskbook.md	UX-1 高保真原型任务书，定义视觉为主、体验为先的原型工作方式。
registration-ca-rules-alignment.taskbook.md	PRD-TEMP-1 临时任务书，承接报名、RaceProject 自动生成、CAConnection 动态接入和评审前风险提示的一致性整改。

项目状态

Vitest   20 files / 120 tests  ✅
E2E      34 specs / 32 passed  ⚠️ (2 fail = P4+P3 seed sync)
lint     0 errors              ✅
build    ✅
deploy   ✅

公网地址：https://ary-grs-temp-demo.vercel.app

P5 最终报告：docs/p5/p5-final-report.md

快速启动

npm install

# 全栈启动（开发）
npm run dev:api    # P1 Race/Registration (3001)
npm run dev:p2     # P2 CA/Metrics/Evidence (4001)
npm run dev:p3     # P3 Work/Award/Report (4003)
npm run dev        # 前端 (5173)

测试命令

npm run lint                              # TypeScript 编译检查
npm run test -w @ary/web                  # Vitest 单元测试 (120 tests)
npm run test:e2e -w @ary/web              # Playwright E2E (34 tests)
npm run build -w @ary/web                 # 生产构建

部署

# 首次
npm i -g vercel
cd apps/web && vercel

# 之后
npm run build -w @ary/web && cd apps/web && npx vercel --prod --yes

演示路径（30 分钟）

1. 公网首页 → Race Gallery
2. /races/bay-area-happy-trip → Race Page
3. /races/bay-area-happy-trip/live → Live Hall
4. /console/screen → Open Display → Jumbotron 投屏
5. Display 6 模式切换
6. 关 P2 → degraded → 重启 P2 → recovery
7. Works → Results → Review → Rider Profile → Cooperation

文档路由