I-01A: 完成 Python 3.11 工程骨架与实现前置修正

[SayQuan1]

变更说明

• 任务编号：I-01A；运行时决策：ADR-PY-01。
• 目的：完成工程骨架审查的六项修正，统一 Python 3.11，不直接推送 main。
• Python 版本统一，但业务和 AI 保留不同依赖环境、独立进程与既有 HTTP 边界。
• 四个应用入口、共用协议与分层包骨架、开发环境配置、开发指南和验收记录一起提交。

影响范围

• 开发工程、CI 与启动配置
• AI 契约实现（沿用现有 schema，无另建 fixture 协议）
• 开发服务 token、租户白名单、生产模式拒绝
• 运行时设计与实施文档
• 数据库迁移或生产数据
• 真实模型权重、OCR/GPU 性能或训练评测
• 生产部署或上线批准

关键修正

1. 移除缺少 FastAPI/Celery 时使用的假框架；真实依赖缺失即失败。
2. AI 实现原契约的 health/ready/version/quality/runs，使用生成的同源 schema 验证。
3. 开发 fixture 使用真实合成文件摘要，严格校验版本、请求哈希、对象引用和图片关联；提供质量、错误、超时分支和单在途保护。
4. API、Worker、AI 和 Web 均拒绝 production；AI 使用服务令牌及显式租户白名单。
5. 统一 Python 3.11，分离业务/AI CI；增加设计契约漂移检查和 npm ci。
6. 补齐虚拟环境、缓存、secret 的 Git 忽略规则，保留已有模型文档表格排版。

实际验证

• 本机 Python 3.11：25 项应用/协议测试通过，含 API/AI 独立 HTTP 子进程。
• 新建 AI-only 虚拟环境：15 项 AI + 4 项共用协议测试通过；未安装 Celery、Redis、SQLAlchemy、Torch、Paddle、ORT。
• Ruff check / format --check：通过（34 个 Python 文件）。
• Python wheel 构建与隔离安装：契约、fixture 资源可从已安装包加载。
• npm ci、开发构建通过，生产构建按预期失败；本机 Node 24，Linux/Node 20 由本 PR CI 验证。
• 16 个生成物一致性检查通过；148 IRR + 41 发布 + 39 D-FINE 合成设计检查通过。
• git diff --cached --check 通过；70 个暂存文件未发现凭据模式、缓存、权重或 secret 文件。
• 远程 Linux/Python 3.11、Node 20 的四项 CI 全部通过；push run 36415277664 与 PR run 36415413997 均为 success，提交 e112680。
• 至少一名独立协作者审查；运行时/权限相关变更按 CONTRIBUTING 共同确认。

详见 DEVELOPMENT.md、docs/02-architecture/07-python-runtime.md、docs/08-delivery/07-i01a-acceptance.md。

风险与后续边界

仅达到 I-01A 开发骨架范围：尚未实现 MySQL/Alembic、会话/RBAC、Outbox/inbox/fencing、Worker→AI→DB、真实 spawn 计算子进程与硬取消、真实 D-FINE/OCR/GPU 或生产部署。fixture 不下载/验证图片字节，其质量、空事实、耗时都是合成值；direct fixture lock 不冒充生产完整运行时锁。API ready 和 worker --check 不代表系统或 broker 已验收。

回滚

revert 本 PR 的实现提交即可；没有数据库迁移或生产数据变化。不改写 main 历史，不自动合并，不代替人工批准。

[SayQuan1]

@1605009600 审 PR

[1605009600]

pass