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
mainis 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.mdproject-docs/AI合同平台V2重构版开发方案-2026-06-22.mdproject-docs/钰麒合同品牌方案设计 V3.0.md
Mandatory Delivery Policy / 强制交付规则
所有产品开发、测试、候选构建、UAT 和上线工作，必须先阅读并遵守：
本轮 RC-05～RC-08 发布收口期间，交付基线保持 60 个资产、14 个 Prompt 模块、144 个正式评测场景，不得擅自缩减为采购单场景，也不得继续增加非阻断功能。本轮正式完成并由发布负责人更新基线后，后续迭代不再受这一临时范围冻结限制。
以下规则是仓库级强制约束：
- 先完成变更，后冻结候选。 源码仍会变化时，不生成正式 tag、source manifest、镜像、SBOM、完整模型矩阵或正式 UAT 证据。
- 一次冻结、一次认证。 冻结后 P0 可直接打断候选，P1 必须由发布负责人裁定；先集中修复，以最多重新冻结一次为效率目标。若之后再次发现已证实 P0 或获批 P1，必须保持
NO_GO、作废候选并升级决定，不能为遵守次数目标而放行。P2/P3 进入上线后 backlog。 - 分层测试。 普通迭代默认只跑直接反例和受影响测试；安全、迁移、共享契约和其他高风险变更必须按风险扩大验证。候选集成冻结后才跑一次完整确定性门禁；真实模型和 UAT 只对同一不可变候选执行。
- 并行不共享可变工作树。 并行修改使用独立 worktree/分支和明确文件归属，由单一集成人合并；禁止一边修改发布工作树，一边生成不可变证据。
- 源码与运行产物分离。 原始 JSON、JUnit、案例输出、压缩包和失败诊断进入仓库外的持久产物目录；Git 只保留必要摘要、manifest、索引和 hash。未经归属审阅不得批量删除现有文件。
- 外部阻塞与研发并行。 政策、域名、证书、Provider、生产主机和人工审批单独列出责任人及期限；材料缺失不得被包装为新的产品开发阶段。
- 任务必须有终点。 每个任务开始时写明唯一交付物、退出条件和时间盒；完成后只报告候选 SHA、通过/失败、剩余 blocker、责任人和下一项必要动作，不自动创造“下一阶段”。
- 提速不能绕过底线。 身份与租户隔离、合同事实完整性、版本保护、备份恢复、迁移兼容、TLS/密钥、失败接管、正式政策及最终公众切流授权不得为赶工而取消。
本轮收口唯一执行顺序是 FREEZE → BUILD → RC05-RUN → RC06-UAT → RC07-RECOVERY → RC08-PRODUCTION。在真实证据形成前，内部受控试点和公众开放均保持 NO_GO；不得把本地测试、AI 自动审核或模拟证据描述为法律批准、第三方存证或公众生产放行。效率规则不构成生产操作的长期授权；生产部署、迁移、回退、切流、真实凭据或数据使用、风险接受及法律签署仍须具名授权人明确批准。