Yuqei AI Contract Platform V2

This repository contains only the active V2 product line. Product, architecture, database, AI platform, frontend, backend, deployment, and QA work use the final four-project layout below.

Project Layout

yuqei-contract-platform/
  apps/contract-web/
  services/contract-api/
  packages/design-system/
  packages/contract-openapi/

yuqei-ai-platform/
  services/ai-platform-api/
  services/worker/
  packages/ai-openapi/

yuqei-ai-sdk-python/

yuqei-infra/
  docker/
  compose/
  nginx/
  observability/
  backup/
  deploy/

docs/
  adr/
  product/
  architecture/
  qa/

project-docs/

Repository Policy

• main is the active V2 development line.
• Do not reintroduce a retired product tree or parallel product implementation.
• Keep the final product boundaries: Contract Platform, AI Platform, Python SDK, and infrastructure.
• Protocol identifiers such as /api/v1, persisted schema versions, migration history, and source-provenance labels are compatibility contracts inside V2; they are not a second product implementation.

Starting Points

• V2-README.md
• project-docs/AI合同平台V2重构版开发方案-2026-06-22.md
• project-docs/钰麒合同品牌方案设计 V3.0.md

Mandatory Delivery Policy / 强制交付规则

所有产品开发、测试、候选构建、UAT 和上线工作，必须先阅读并遵守：

• project-docs/AI合同平台-后期上线任务规划与执行总表-2026-09-21.md（当前冻结后的唯一执行控制计划）
• docs/qa/multiscene-closeout-20260910/release-closeout-execution-register-20260921.json（当前机器可读滚动台账；唯一下一任务以 mainline_next_task_id 为准）
• project-docs/AI合同平台-生产上线加速与开发效率整改方案-2026-09-21.md
• project-docs/AI合同平台-多场景完整交付与开发收口方案-2026-09-10.md

当前唯一冻结候选为 5f4f0d7f64e3a6ff7d62fdbd252da3ffe6fb0035 / v2-multiscene-rc04-20260921.3；.1 与 .2 仅作为 SUPERSEDED 历史证据保留。上述后期计划和滚动台账属于冻结后本地执行管理材料，不得被纳入、改写或冒充该候选的源码组成；构建必须来自冻结 tag、干净 checkout 或已核验源码包。旧 remaining-closure-register-20260919.json 仅为历史快照，不再作为当前状态源。

本轮 RC-05～RC-08 发布收口期间，交付基线保持 60 个资产、14 个 Prompt 模块、144 个正式评测场景，不得擅自缩减为采购单场景，也不得继续增加非阻断功能。本轮正式完成并由发布负责人更新基线后，后续迭代不再受这一临时范围冻结限制。

以下规则是仓库级强制约束：

1. 先完成变更，后冻结候选。 源码仍会变化时，不生成正式 tag、source manifest、镜像、SBOM、完整模型矩阵或正式 UAT 证据。
2. 一次冻结、一次认证。 冻结后 P0 可直接打断候选，P1 必须由发布负责人裁定；先集中修复，以最多重新冻结一次为效率目标。若之后再次发现已证实 P0 或获批 P1，必须保持 NO_GO、作废候选并升级决定，不能为遵守次数目标而放行。P2/P3 进入上线后 backlog。
3. 分层测试。 普通迭代默认只跑直接反例和受影响测试；安全、迁移、共享契约和其他高风险变更必须按风险扩大验证。候选集成冻结后才跑一次完整确定性门禁；真实模型和 UAT 只对同一不可变候选执行。
4. 并行不共享可变工作树。 并行修改使用独立 worktree/分支和明确文件归属，由单一集成人合并；禁止一边修改发布工作树，一边生成不可变证据。
5. 源码与运行产物分离。 原始 JSON、JUnit、案例输出、压缩包和失败诊断进入仓库外的持久产物目录；Git 只保留必要摘要、manifest、索引和 hash。未经归属审阅不得批量删除现有文件。
6. 外部阻塞与研发并行。 政策、域名、证书、Provider、生产主机和人工审批单独列出责任人及期限；材料缺失不得被包装为新的产品开发阶段。
7. 任务必须有终点。 每个任务开始时写明唯一交付物、退出条件和时间盒；完成后只报告候选 SHA、通过/失败、剩余 blocker、责任人和下一项必要动作，不自动创造“下一阶段”。
8. 提速不能绕过底线。 身份与租户隔离、合同事实完整性、版本保护、备份恢复、迁移兼容、TLS/密钥、失败接管、正式政策及最终公众切流授权不得为赶工而取消。

本轮收口唯一执行顺序是 FREEZE → BUILD → RC05-RUN → RC06-UAT → RC07-RECOVERY → RC08-PRODUCTION。在真实证据形成前，内部受控试点和公众开放均保持 NO_GO；不得把本地测试、AI 自动审核或模拟证据描述为法律批准、第三方存证或公众生产放行。效率规则不构成生产操作的长期授权；生产部署、迁移、回退、切流、真实凭据或数据使用、风险接受及法律签署仍须具名授权人明确批准。