COLLABORATION / 05

协作与 CI

允许 9 条责任泳道并行，不允许隐式耦合。D04 已把协议落进 18 个真实仓：每个变更都必须在同一 diff 提交 Task Packet 与 consumer evidence。

CORE REPOS18machine profiles

WORKFLOW GAPS10 → 0closed

PROTECTED MAIN18 / 18live Gitea rules

REQUIRED CHECK18 / 18consumer evidence

MAC RUNNEROFFLINEnative jobs stay queued

OWNERSHIP

9 条可并行开发线

跨线依赖通过版本化契约和 consumer test，而不是临时口头约定。

ID工作流 / Owner范围发布门

门户与信息架构Developer Experience

本网站、清单 schema、搜索、模块详情catalog schema + build

UI FoundationsDesign Systems

tokens、组件状态、Figma/Swift/Web 映射token drift + visual

内容与社区Content Platform

data-sources → BBS → Portal 契约contract + provenance

IM 与移动端Realtime / iOS

im-core、iOS、媒体 SDK、Push/WScross-repo smoke

开放平台与资源Developer Platform

miniapp-open-platform、reits-media、opensdkpackage integrity + sandbox

预约与商业化Booking Platform

发现、预约、商户、支付、增长order contract + E2E

量化与行情Quant Platform

行情、策略、运行、模拟、Quant iOSdata contract + determinism

身份与平台发布Platform Engineering

reits-auth、CI、安全、观测、部署、回滚auth + release evidence

Meridian 预测市场Meridian Product Engineering

只读市场、模拟交易、订单边界、资金与结算、Electron / Android、项目证据门户contract + cross-client + funds isolation + release evidence

TASK PACKET

人和 AI 使用同一种任务包

下面是字段结构示意；正式约束以 JSON Schema 和仓内 .reits/task-packets 为准。任务包是一次改动的最小协作边界。

{
  "schemaVersion": "developer.reits.tech/task-packet/v1",
  "taskId": "W3-CONTENT-014",
  "idempotencyKey": "w3-content-014-v1",
  "owner": { "team": "content-platform", "agent": "ai-02" },
  "repositories": ["data-sources", "reits-bbs"],
  "source": { "baseRevision": "cb37d2ce9633e7395d614f3b3239c5efea2902f7",
    "headRevision": "SELF", "defaultBranch": "main" },
  "scope": {
    "in": ["schema", "producer", "consumer test"],
    "out": ["UI redesign", "database migration"]
  },
  "changeSet": { "include": ["contracts/**", "feed/**"], "exclude": [] },
  "contracts": [{ "id": "bbs-feed", "version": "v2",
    "change": "compatible", "producer": "data-sources",
    "consumers": ["reits-bbs"] }],
  "acceptance": ["producer and consumer contract tests pass"],
  "rollback": { "trigger": ["consumer fails"],
    "steps": ["retain v1 alias for one release"], "dataImpact": "none" },
  "evidence": { "requiredConsumers": ["reits-bbs"],
    "files": [".reits/consumer-evidence/w3-content-014.json"] }
}

一个结果

goal 只描述一个可验证结果。

一个 owner

多仓任务仍只有一位集成负责人。

显式边界

in_scope / out_of_scope 阻止 AI 自行扩大任务。

契约先行

producer 与 consumer 使用同一版本和 fixture。

证据交付

完成不是“代码写完”，而是证据包可复核。

回滚可用

发布前就写清回退开关、旧版本兼容期和数据恢复。

打开 18 仓真实工作台读取 Task Packet Schema 读取 Evidence Schema

CI ARCHITECTURE

从提交到运行证据的六级流水线

Intake

manifest schema、任务范围、owner、依赖锁定

scope-check

Fast

format、lint、typecheck、unit、secret scan

≤ 10 min

Contract

API、路由、事件、token 与数据库迁移 diff

consumer gate

Experience

a11y、visual、关键旅程、iOS snapshot

surface gate

Release

制品 hash、SBOM、迁移、回滚、部署清单

evidence pack

Observe

健康、错误预算、告警、值班、回滚验证

post-deploy

BLOCKING

合并必过

构建、单测、契约、安全、迁移、关键 UI 可访问性。失败不得以重跑掩盖。

REVIEW

需要 owner 判断

视觉基线、性能预算、依赖更新、公开文案与合规语义。

SCHEDULED

周期运行

完整 E2E、真实设备、长时 chaos、依赖与安全扫描、容量和备份恢复演练。

CHANGE PROTOCOL

跨仓变更四步协议

01
Propose
在生产方提交 contract diff、兼容策略、消费者清单和弃用日期。
02
Prove
新增 consumer fixture；旧消费者继续通过，新消费者在 feature flag 后验证。
03
Promote
先发布生产方兼容版本，再逐个升级消费者，观测错误预算和数据一致性。
04
Prune
兼容期结束且所有消费者迁移后，删除旧契约并归档决策与证据。