全局架构/DELIVERY/多团队交付与 QA 架构

ARCHITECTURE DOSSIER · 08

多团队交付与 QA 架构

任务包、契约、UI CI、发布证据、灰度与回滚

MIXEDDELIVERYCODE + RUNTIME + QA

DELIVERY · COMPONENT TOPOLOGYowner / runtime / truth state

01Client

Developer portalrunning

架构、UI、契约、QA 与运行真值入口

Architecture OfficeNext.js

02Edge

Gitea org / branch rulesmixed

仓库、review、保护分支与 webhook

Developer Platformself-hosted Gitea

03Service

Task packettarget

scope、owner、screen、contract、acceptance

Product + Architecturemachine-readable manifest

UI CImixed

lint、types、unit、a11y、visual、E2E

UI + QAper-repo pipeline

Release controllermixed

artifact、approval、deploy、smoke、rollback

Platform Opscurrent scripts / target unified

04State

Evidence registrytarget

commit、contract、screenshots、test、deploy result

QA Architectureportal manifest target

CRITICAL SEQUENCE

真实主链与事务边界

每一步都必须能回到调用方、契约、状态 owner 与失败证据；UI 只显示服务端已经确认的真值。

01
Architect 分配稳定项目/Screen ID 与边界
02
任务包冻结输入、输出、契约和验收
03
AI/开发者在独立 worktree 实现
04
CI 运行静态、单测、契约、a11y、视觉和 E2E
05
owner review 合并 immutable artifact
06
部署 smoke 后登记 release evidence，可一键回滚

INTERFACE REGISTER

跨项目接口与安全条件

producer、consumer、契约和 guard 同时登记；其中任何一列缺失都不能进入多团队并行开发。

ProducerVersioned contractConsumerSecurity / consistency guard

ArchitectureTaskPacket {scope,owners,screens,contracts,acceptance}AI / developers

no overlapping ownership

Repository CIEvidence {commit,tests,visuals,artifact}Release controller

all required gates pass

ReleaseDeployment {artifact,env,smoke,rollback}Developer portal

exact commit + approval

STATE OWNERSHIP

数据真值与恢复

Source / reviewGitea

STORErepositories + DB

RETENTION长期

RECOVERYoff-host Gitea backup

Artifacts / screenshotsCI Platform

STOREartifact registry target

RETENTION按 release

RECOVERY可从 commit 重建

Architecture decisionsArchitecture Office

STOREreits-knowledge

RETENTION永久版本化

RECOVERYGit history

FAILURE MODEL

故障必须怎样收敛

TRIGGER多人修改同一边界

SYMPTOM冲突、重复实现、契约漂移

CONTAIN任务包 owner + file/screen scope

assignment registry

TRIGGER视觉回归只有人工肉眼

SYMPTOM页面随合并悄悄漂移

CONTAIN稳定 viewport + baseline + threshold

visual diff artifact

TRIGGER部署版本不可追踪

SYMPTOM线上无法定位代码或回滚

CONTAINartifact 绑定 exact commit

release record + smoke

QA RELEASE GATES

不是画完架构图就算完成

这些门禁连接 UI 状态、接口负向路径、运行证据与可恢复性；发布证据必须绑定 exact commit。

CI-01

lint + typecheck + unit

每次 PR

CI-02

contract + auth negative tests

跨仓变更

CI-03

a11y + desktop/mobile visual

每个 Screen ID

CI-04

production smoke + rollback proof

每次 release

← 日志、可观测与恢复进入 QA 架构 →