# Frontend Quality Gates

## 适用范围

- 任何包含页面、组件、样式、交互、导航、表单、图表或前端资源发布的变更，都必须经过本门禁。

## `/team-intake` 与 `/team-plan`

- 已锁定目标端、核心页面/组件、产品类型和设计约束。
- 已明确设计 token 是否沿用、扩展还是重构。
- 已定义响应式基线、可访问性红线和前端性能关注点。
- 已指定需要产出的前端模板：`design-system-brief`、`ui-implementation-plan`、`ui-review-checklist` 中的哪些项。

## `/team-execute`

- 实现与接口/方案一致，关键 loading、empty、error、success 状态完整。
- 视觉值遵循 token 体系，没有新增无来源的散装样式常量。
- 响应式、键盘访问、标签说明、焦点状态和交互反馈自测完成。
- 已通过 [ui-review-checklist.md](../templates/ui-review-checklist.md) 留下证据。

## `/team-review`

- QA 已验证视觉一致性、交互完整性、边界态、异常态、可访问性和前端性能。
- 阻塞问题与非阻塞风险分级清晰，且指向具体页面、组件或用户路径。
- 放行建议包含前端特有风险，例如小屏适配、资源加载、导航回退、图表可读性。

## `/team-release`

- 已定义上线后的关键页面 smoke 范围和回滚触发条件。
- 已明确静态资源、缓存、监控指标和用户反馈观察项。
- 若性能预算或体验门禁未达标，必须由 `tech-lead` 显式接受风险，不能默认放行。

## 一票否决项

- 只实现成功态，没有边界态或异常态。
- 可点击目标过小、焦点不可见、标签缺失或颜色成为唯一状态标识。
- 关键页面出现明显布局抖动、横向滚动或不可恢复的交互死路。
- 没有交付可追溯的前端自测/评审证据。