pomaster 0.4.0 → 0.5.0

package/seeds/specs/hard/frontend/30-data-grid-protocol.md

@@ -1,83 +0,0 @@
----
-seed_source: pomaster/components/frontend-hard-spec/assets/universal/30-data-grid-protocol.md
-seed_source_sha256: c702a9956fd5e7aac40e1eefebcdd7a3518b95bd1a750bfcb31cbaddb80f41ff
-seed_version: B6B-2
-lane: frontend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [frontend]
-related_evidence_specs: []
-related_tools: []
----
-
-# 30 数据表格协议
-
-## Scope
-
-P1。定义表格壳、列 schema、列宽、固定列、分页、排序筛选、虚拟滚动、列配置和导出。
-
-## Non-Scope
-
-不定义业务字段口径，不允许表格库决定页面权限和数据契约。
-
-## Terms
-
-- Grid Type：可编辑宽表、只读表、报表、主数据表等类型。
-- Column Schema：列 key、类型、宽度、权限和行为契约。
-- Saved View：用户保存的列、筛选和排序配置。
-
-## MUST
-
-- 表格通过统一壳和 typed Column Schema 渲染。
-- 每列有稳定 key、标题、值类型、宽度策略、权限和导出规则。
-- 大数据使用服务端分页/筛选/排序及虚拟化。
-- 列配置按页面、表格、用户和 schema 版本隔离。
-- 列宽修复先判断单页、同类型、领域 preset、表格壳或全局 token。
-- 公共壳变更验证全部 Grid Type。
-- 表格的交互状态（行 click / double-click / select / drag-select / 列头排序 click / 单元格 focus 等）MUST 在 `interaction-contract-registry` 中逐项声明，每项绑定触发的 `action_id` 与调用的 `api_requirement_ids`；表格不得存在未声明的交互。并非每个表格都要支持所有交互，但所支持的交互子集 MUST 显式界定并说明触发后果。排斥键盘的交互（drag / drag-select / hover-only）MUST 声明键盘等价路径（协议 23）。
-
-## MUST NOT
-
-- MUST NOT template 手写列或跨页面复制列数组。
-- MUST NOT 为单页列宽修改全局 CSS。
-- MUST NOT 不同类型表格共享污染配置 key。
-- MUST NOT 前端加载全量数据假分页。
-
-## SHOULD
-
-- SHOULD 固定关键标识/操作列并限制冻结总宽。
-- SHOULD 支持键盘、复制粘贴、冲突和保存视图的明确契约。
-
-## Contract
-
-```text
-GridType, RowKey, ColumnSchema[], ServerOperations,
-Virtualization, SavedViewKey, ExportScope, Permissions,
-InteractionContracts[]
-```
-
-## Checklist
-
-- [ ] 表格由 schema 驱动。
-- [ ] 列宽影响层级正确。
-- [ ] 大数据和配置隔离安全。
-- [ ] 导出与当前视图一致。
-- [ ] 每个支持的交互（行点击/双击/拖选/排序/聚焦）在 interaction-contract-registry 声明并绑定 action + API。
-
-## Examples
-
-### 内容示例，可删除
-
-同类型报表共享 column preset；单页例外写在 page contract，不改可编辑宽表。
-
-## Anti-patterns
-
-为某报表加全局 `.table td { width }`，导致所有列表和宽表一起变化。
-
-## Ownership
-
-表格平台 Owner 维护壳，领域 Owner 维护列 schema，页面 Owner 维护例外。
-
-## Change Policy
-
-列 schema 和保存视图结构必须版本化；公共行为变化遵循影响评估和视觉回归。

package/seeds/specs/hard/frontend/32-file-import-export-protocol.md

@@ -1,80 +0,0 @@
----
-seed_source: pomaster/components/frontend-hard-spec/assets/universal/32-file-import-export-protocol.md
-seed_source_sha256: 2262d7ce2e910e4d64b0c6f3ef1af0b72c3cafc31d6cb1a796a8fb8b1801cbbc
-seed_version: B6B-2
-lane: frontend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [frontend]
-related_evidence_specs: []
-related_tools: []
----
-
-# 32 文件、导入与导出协议
-
-## Scope
-
-P1。定义文件上传、下载、模板、导入校验、错误明细、导出范围和后台任务。
-
-## Non-Scope
-
-不定义底层存储实现，不替代安全、权限和异步任务接口契约。
-
-## Terms
-
-- Import Template：与 schema 版本匹配的输入模板。
-- Partial Success：部分行成功、失败、跳过或警告。
-- Export Scope：当前页、选中行、筛选全量、保存视图或汇总。
-
-## MUST
-
-- 上传声明类型、大小、数量、文件名和安全校验。
-- 导入流程包含模板、上传、校验、任务、进度、结果和错误明细。
-- 错误明细至少包含行、列、字段、原值、错误码和修复建议。
-- 导出明确范围、字段、权限和有效期。
-- 大文件使用后台任务，完成后刷新依赖数据。
-- 下载时重新鉴权和校验数据范围。
-
-## MUST NOT
-
-- MUST NOT 静默导入失败。
-- MUST NOT 大文件同步阻塞页面。
-- MUST NOT 页面自行拼导出字段或绕过权限。
-- MUST NOT 成功后遗漏缓存刷新。
-
-## SHOULD
-
-- SHOULD 支持取消、重试、结果通知和来源页面跳转。
-- SHOULD 让模板和错误文件可追踪 schema 版本。
-
-## Contract
-
-```text
-FilePolicy, TemplateVersion, ImportJob,
-ErrorRowSchema, ExportScope, ResultExpiry, Permissions
-```
-
-## Checklist
-
-- [ ] 文件策略明确。
-- [ ] 导入全流程和部分成功完整。
-- [ ] 导出范围与权限一致。
-- [ ] 大文件任务化。
-
-## Examples
-
-### 内容示例，可删除
-
-导入完成显示成功、失败、跳过和警告数量，并提供字段级错误文件。
-
-## Anti-patterns
-
-上传后只显示“导入失败”，没有行号、原因、TraceId 或重试路径。
-
-## Ownership
-
-业务 Owner 定义字段，文件/任务 Owner 维护流程，安全 Owner 维护文件策略。
-
-## Change Policy
-
-模板、字段和错误 schema 变化必须版本化并提供兼容/迁移说明。

package/seeds/specs/hard/frontend/33-release-versioning-protocol.md

@@ -1,79 +0,0 @@
----
-seed_source: pomaster/components/frontend-hard-spec/assets/universal/33-release-versioning-protocol.md
-seed_source_sha256: aae0557f4935bac24d04e37ebde5638471b709ff568fea0d13de35bd5dd404af
-seed_version: B6B-2
-lane: frontend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [frontend]
-related_evidence_specs: []
-related_tools: []
----
-
-# 33 版本与发布协议
-
-## Scope
-
-P2。定义版本标识、分支/提交、灰度、回滚、公共 API 兼容和发布证据。
-
-## Non-Scope
-
-不替代验收门禁、组织发布平台和基础设施部署流程。
-
-## Terms
-
-- App Version：可关联提交、构建、环境和 source map 的版本。
-- Gray Release：受控用户/环境范围内逐步发布。
-- Rollback：恢复到已验证版本和兼容状态。
-
-## MUST
-
-- 每个构建有可观测版本和来源。
-- 发布前契约、测试、安全、配置、监控和回滚满足门禁。
-- 高风险变更定义灰度和停止条件。
-- 回滚同时考虑前端资源、接口、缓存、任务和数据兼容。
-- 公共 breaking change 先 deprecated 并提供迁移期。
-
-## MUST NOT
-
-- MUST NOT 无版本标识发布。
-- MUST NOT 无回滚上线破坏性变化。
-- MUST NOT 直接删除公共 API。
-- MUST NOT 发布后才补监控和 source map。
-
-## SHOULD
-
-- SHOULD 自动生成变更摘要和发布证据。
-- SHOULD 使用 Feature Flag 降低高风险上线范围。
-
-## Contract
-
-```text
-Version, Commit, BuildTime, Environment, Changes,
-Flags, Migration, Monitoring, Rollback, Owner
-```
-
-## Checklist
-
-- [ ] 版本可追踪。
-- [ ] 门禁和契约通过。
-- [ ] 灰度与回滚可执行。
-- [ ] deprecated/迁移完整。
-
-## Examples
-
-### 内容示例，可删除
-
-公共组件新 API 与旧 API 并存一个迁移周期，再在版本公告后删除旧 API。
-
-## Anti-patterns
-
-静态资源已回滚，但新缓存 schema 和后台任务仍不兼容旧页面。
-
-## Ownership
-
-发布 Owner 负责流程，模块 Owner 负责兼容，平台 Owner 负责回滚和监控。
-
-## Change Policy
-
-版本和发布策略变化必须同步 CI/CD、门禁、文档和责任人。

package/seeds/specs/hard/frontend/34-monitoring-logging-protocol.md

@@ -1,128 +0,0 @@
----
-seed_source: pomaster/components/frontend-hard-spec/assets/universal/34-monitoring-logging-protocol.md
-seed_source_sha256: 3c37c1c3aa3ade8d43532a1fcc7561e95aef42a19e46b6eb53d864054a2da013
-seed_version: B6B-2
-lane: frontend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [frontend]
-related_evidence_specs: []
-related_tools: []
----
-
-# 34 监控与日志协议
-
-## Scope
-
-P1。作为前端运行可观测性的主权威，定义结构化日志、技术遥测、错误与白屏、Trace/Span/Breadcrumb、RED 指标、RUM 采集、告警和遥测传输韧性。
-
-## Non-Scope
-
-不替代后端审计、基础设施容量监控和具体 APM 厂商选型；业务行为事件、漏斗和分析用途归 `40-analytics-protocol`，LCP/INP/CLS 等性能预算、RUM 统计口径和分位数归 `31-performance-protocol`。不允许监控收集权限外数据。
-
-## Terms
-
-- Error Event：可定位的运行失败记录。
-- Trace：一次端到端请求的因果链，由 trace-id 贯穿。
-- Span：Trace 内的单个操作单元，记录开始/结束时间、父关系和受控元数据。
-- Breadcrumb：错误前的受控操作路径。
-- RED 指标：Rate（请求率）、Errors（错误率）、Duration（耗时）。
-- RUM：Real User Monitoring，采集真实用户设备、网络、性能和交互指标的运行监测方式。
-- Source Map：映射压缩代码到源代码的受控文件。
-
-## MUST
-
-- 每个应用、页面和关键 API 面必须声明运行可观测性 Owner，负责日志字段、技术指标、追踪、告警和恢复证据。
-- 采集并分类运行错误、Promise rejection、资源失败、接口错误、白屏和根组件渲染失败；每类必须关联 `16-error-handling-protocol` 定义的 UI 状态与恢复策略。
-- 结构化日志包含时间、级别、稳定 message_id、版本、环境、页面、组件/操作、trace-id、浏览器和安全上下文摘要。
-- 关键 API 调用必须生成或传播 trace-id；请求、响应、错误日志与 breadcrumb 必须保持同一关联标识，Span 必须记录父子关系、耗时、结果和受控元数据。
-- HTTP client 与关键异步任务必须聚合 RED 指标；指标名称、单位、维度和版本必须稳定，完整 URL、DOM 文本、用户输入或其他高基数字段不得作为维度。
-- 启用 RUM 时必须采集真实用户运行信号，并携带页面类别、设备类别、网络类别、应用版本和指标版本；性能预算、统计窗口与分位数引用 `31-performance-protocol`，不得在本协议重复定义阈值。
-- source map 与版本对应且受权限保护。
-- 日志字段脱敏并限制请求/响应摘要。
-- 关键错误率、API 失败率、白屏率和运行退化信号必须有告警阈值、升级策略、负责人、静默窗口和运行手册。
-- 监控事件 schema、版本、采样率、批大小、缓存上限、刷新时机、重试退避、用途、保留期限和删除策略必须明确；页面隐藏、卸载或网络恢复时必须按受控策略尽力刷新待发送遥测。
-- 监控 SDK 初始化失败、遥测序列化失败或发送失败必须 fail-open，不得阻断应用主流程；失败本身必须产生可恢复的安全诊断信号，且缓存必须有容量与过期边界。
-
-### 分层运行可观测性责任（按目录层级）
-
-运行可观测性是架构期横切能力，层级划分与 `09-module-boundary-protocol` 一致。
-
-- **app 层 — 启动与全局运行观测**：初始化日志、指标、追踪和 RUM SDK，注册全局错误处理器与白屏检测，声明全局 trace 传播策略；不得用入口 console 输出替代生产遥测或吞错不上报。
-- **platform 层 — 状态与网络观测**：统一记录全局状态操作的受控 span，在 HTTP client 注入请求/响应拦截、RED 指标与 trace-id；不得记录完整状态对象或让业务请求自定义 trace 头格式。
-- **api 层 — 请求链路观测**：记录请求分类、耗时、错误码、重试次数和 trace 传播；不得记录 token，也不得以完整 URL 或 DOM 文本制造高基数维度。
-- **domain 层 — 计算与转换观测**：记录复杂计算/转换耗时、输入量级、异常分支和异步任务状态；不得把 UI Toast/Alert 当作唯一诊断手段。
-- **feature 层 — 页面运行观测**：声明页面运行状态转换、错误边界、关键 API 技术信号和性能预算对比；业务 page-view/action 漏斗与事件去重归 `40-analytics-protocol`。
-- **shared 层 — 组件与工具观测**：公共组件暴露受控 telemetry hook，工具函数记录异常边界；不得把内部调试日志当正式遥测或硬编码业务分析 schema。
-
-## MUST NOT
-
-- MUST NOT 记录 token、密码、敏感原值或完整文件。
-- MUST NOT 仅用 console 作为生产监控。
-- MUST NOT 捕获后静默吞错。
-- MUST NOT 公开部署 source map。
-- MUST NOT 把用户标识、PII、认证信息或业务原值放入 Trace Context、breadcrumb 或高基数字段。
-- MUST NOT 在没有 trace-id 的情况下发起关键 API 请求。
-- MUST NOT 让页面、组件或请求层各自发明不兼容的日志、指标或追踪字段。
-- MUST NOT 让 SDK 初始化、遥测缓存或发送重试阻塞首屏、用户操作或错误恢复。
-- MUST NOT 把业务行为漏斗、转化口径或分析用途定义在运行诊断 schema 中。
-
-## SHOULD
-
-- SHOULD 关联用户操作、请求和异步任务 TraceId。
-- SHOULD 控制采样并防止告警风暴。
-- SHOULD 在启用分布式追踪时遵循 W3C Trace Context，并验证跨来源边界的头部传播和信任策略。
-- SHOULD 对告警关联运行手册、最近变更和可回滚版本。
-- SHOULD 对遥测批处理、缓存、退避和丢弃量建立自监控，但不得形成无限递归上报。
-
-## Contract
-
-```text
-SignalType, SchemaVersion, AppVersion, Environment, Page, ComponentOrOperation,
-TraceId, SpanId, ParentSpanId, MessageId, ErrorCode, Duration, SafeDimensions,
-SamplingPolicy, Retention, Timestamp, Owner
-```
-
-分层运行可观测性责任契约（与 `09-module-boundary-protocol` 层级一致）：
-
-```text
-Layer, Responsibility, CheckPoint, Forbidden
-app, SDK/全局错误/白屏/trace 策略, 初始化降级 + 全局处理器 + 版本绑定, console 替代遥测 / 吞错
-platform, 状态与网络技术遥测, store span + HTTP RED + trace 注入, 完整状态对象 / 自定义 trace 格式
-api, 请求链路, 分类 + 耗时 + 错误码 + 重试 + trace, token / 高基数 URL 或 DOM
-domain, 计算与异步任务, 耗时 + 数据量级 + 异常分支 + 任务状态, UI 提示作为唯一诊断
-feature, 页面运行状态, 错误边界 + 技术信号 + 性能预算引用, 重复定义业务分析漏斗
-shared, 公共 telemetry hook, 组件/工具异常边界, 调试日志当正式遥测 / 业务 schema 硬编码
-```
-
-## Checklist
-
-- [ ] 错误和白屏可定位。
-- [ ] 版本与 source map 对应。
-- [ ] 日志无敏感信息。
-- [ ] 告警和 Owner 明确。
-- [ ] Trace/Span/Breadcrumb 与关键 API、错误和异步任务可关联。
-- [ ] RED 与 RUM 技术信号有稳定名称、单位、维度和指标版本；预算与分位数口径引用 31。
-- [ ] schema、版本、采样、批处理、缓存、重试、保留和删除策略明确。
-- [ ] 遥测故障不影响主流程，Trace Context 不携带敏感数据。
-- [ ] 分层责任已按 app/platform/api/domain/feature/shared 分担并引用 09。
-
-## Examples
-
-### 内容示例，可删除
-
-系统错误展示 TraceId；HTTP client、错误日志和 breadcrumb 记录同一 TraceId 与版本。遥测按受控批次发送，SDK 故障时主流程继续并记录安全降级信号，不记录输入原值。
-
-## Anti-patterns
-
-生产只打印 console.error，用户截图是唯一定位依据。
-
-每个页面自行初始化 SDK、定义 trace 头和日志字段，导致链路无法关联；发送失败时无限重试并阻塞页面卸载。
-
-## Ownership
-
-Observability/平台 Owner 维护运行遥测 schema、SDK、trace 传播和告警；模块 Owner 维护安全上下文与恢复映射；性能 Owner 维护 31 的预算与统计口径；数据/产品 Owner 维护 40 的业务分析事件；安全/隐私 Owner 审核字段、采样、保留和删除策略。
-
-## Change Policy
-
-运行遥测 schema、日志字段、技术指标、trace 传播、采样、批处理、缓存、重试、保留、告警和 source map 策略变化必须评审隐私、性能、成本、兼容性和可诊断性；不得把 31/40 的权威规则复制回本协议。

package/seeds/specs/hard/frontend/35-mock-protocol.md

@@ -1,97 +0,0 @@
----
-seed_source: pomaster/components/frontend-hard-spec/assets/universal/35-mock-protocol.md
-seed_source_sha256: c9288fe227cb26633d23c5d0e2e710b9cde716371f66cf3157c63b3ec8a58342
-seed_version: B6B-2
-lane: frontend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [frontend]
-related_evidence_specs: []
-related_tools: []
----
-
-# 35 Mock 协议
-
-## Scope
-
-P2。定义后端未就绪或测试时的 Mock 来源、场景、契约校验和启停。
-
-## Non-Scope
-
-Mock 不定义正式业务规则，不替代接口契约和真实集成测试。
-
-## Terms
-
-- Fixture：稳定可复用的测试数据。
-- Scenario：success、empty、error、timeout 等受控响应模式。
-- Contract Mock：由正式 schema 生成或校验的 Mock。
-
-## MUST
-
-- Mock 字段符合正式接口契约。
-- Mock schema 必须与正式 OpenAPI 或等价契约保持一致；漂移必须被 CI 检测并阻断。
-- 覆盖 success、empty、large、slow、timeout、permission、conflict、error 和 partial success。
-- Fixture 使用稳定 id、时间和有种子的生成器。
-- Mock 通过统一环境开关启停，生产默认关闭。
-- 临时 Mock 必须记录 contract_version、到期日（expires_at）和替换状态（active/deprecated/removed）。
-- 真实接口接入后保留测试 Mock 并删除临时错误结构。
-
-## MUST NOT
-
-- MUST NOT 只 Mock 成功小数据。
-- MUST NOT 用 Mock 推导正式字段和规则。
-- MUST NOT 在业务组件写 Mock 分支。
-- MUST NOT 生产默认启用 Mock。
-
-## SHOULD
-
-- SHOULD 由契约生成类型和基础场景。
-- SHOULD 模拟幂等、409、429、断线和任务状态。
-- SHOULD 在 `outputs/frontend/10_planned/mock-contract.yaml` 中维护场景清单与契约版本绑定。
-
-## Contract
-
-```text
-Endpoint, ScenarioId, RequestMatch, ResponseSchema,
-Delay, Error, FixtureSeed, ContractVersion
-```
-
-### Mock 生命周期
-
-`outputs/frontend/10_planned/mock-contract.yaml` 记录每个 Mock 场景：
-
-```text
-Endpoint, ScenarioId, ContractVersion, Status,
-ExpiresAt, ReplacementEndpoint, OpenapiDiffChecked
-```
-
-- 临时 Mock 必须有到期日；到期前必须完成真实接口替换或显式延期。
-- 每个场景必须通过 OpenAPI diff 检查；漂移项必须阻塞合并。
-
-## Checklist
-
-- [ ] 契约一致。
-- [ ] OpenAPI/契约漂移检查通过。
-- [ ] 非理想态完整。
-- [ ] 数据稳定可重复。
-- [ ] 生产安全关闭。
-- [ ] 临时 Mock 有到期日和替换状态。
-- [ ] mock-contract.yaml 已维护。
-
-## Examples
-
-### 内容示例，可删除
-
-同一接口提供 normal、empty、409 和 slow 场景，组件测试通过 scenario id 切换。
-
-## Anti-patterns
-
-页面内写死假数组，字段与后端完全不同，联调时才重写页面。
-
-## Ownership
-
-契约 Owner 负责 schema，前端/QA 维护场景，平台 Owner 维护启停基础设施。
-
-## Change Policy
-
-契约变化必须同步 Mock；删除场景前确认无测试依赖。

package/seeds/specs/hard/frontend/36-feature-flag-protocol.md

@@ -1,79 +0,0 @@
----
-seed_source: pomaster/components/frontend-hard-spec/assets/universal/36-feature-flag-protocol.md
-seed_source_sha256: ba6cf2d5607ba54d9864cd6c07899d2e13a8d33ea248fbd7469b92c23474f474
-seed_version: B6B-2
-lane: frontend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [frontend]
-related_evidence_specs: []
-related_tools: []
----
-
-# 36 Feature Flag 协议
-
-## Scope
-
-P2。定义功能开关来源、命名、灰度范围、关闭表现、默认值和生命周期。
-
-## Non-Scope
-
-不替代权限、业务状态和环境配置。
-
-## Terms
-
-- Flag Key：稳定唯一的开关键。
-- Targeting：按环境、用户、角色或组织控制命中。
-- Kill Switch：紧急关闭新能力的开关。
-
-## MUST
-
-- 每个 flag 有 owner、目的、默认值、目标范围、期限和清理日期。
-- 入口、路由和后台请求在关闭时一致停用。
-- 获取失败使用保守默认值。
-- Flag 与权限同时通过才允许操作。
-- 全量稳定后删除临时判断和旧路径。
-
-## MUST NOT
-
-- MUST NOT 在多个页面手写同一判断。
-- MUST NOT 将 flag 当权限或业务状态。
-- MUST NOT 使用无 owner、无期限的永久临时 flag。
-- MUST NOT 关闭 UI 却继续触发后台请求。
-
-## SHOULD
-
-- SHOULD 支持灰度、回滚、监控和实验审计。
-- SHOULD 对关键写操作提供 kill switch。
-
-## Contract
-
-```text
-FlagKey, Owner, Default, Targeting, Fallback,
-StartAt, EndAt, CleanupAt, Metrics
-```
-
-## Checklist
-
-- [ ] 默认和失败行为安全。
-- [ ] UI/路由/请求一致。
-- [ ] 不绕过权限。
-- [ ] 有清理日期。
-
-## Examples
-
-### 内容示例，可删除
-
-新编辑器 flag 关闭后回到旧编辑器，相关新 API 不再调用。
-
-## Anti-patterns
-
-组件中散落环境判断，开关关闭后深链接仍能访问新功能。
-
-## Ownership
-
-功能 Owner 维护业务生命周期，平台 Owner 维护系统，安全/权限 Owner 审查边界。
-
-## Change Policy
-
-Flag 语义和目标规则变化必须记录；转长期配置时迁移到正式配置系统。

package/seeds/specs/hard/frontend/37-browser-device-compatibility-protocol.md

@@ -1,83 +0,0 @@
----
-seed_source: pomaster/components/frontend-hard-spec/assets/universal/37-browser-device-compatibility-protocol.md
-seed_source_sha256: 81c0d4bf8996f6cf6b38d1c8514385065785728011222b524d73d8135703a3b3
-seed_version: B6B-2
-lane: frontend
-status: CURRENT
-authority_scope: mixed_required_and_advisory
-applies_to: [frontend]
-related_evidence_specs: []
-related_tools: []
----
-
-# 37 浏览器与设备兼容协议
-
-## Scope
-
-P2。定义支持浏览器、设备、分辨率、缩放、输入方式和不支持环境提示。
-
-## Non-Scope
-
-不要求所有项目支持移动端或旧浏览器，不替代响应式布局协议。
-
-## Terms
-
-- Support Matrix：正式支持并测试的环境组合。
-- Graceful Degradation：能力不足时的安全降级。
-- Unsupported Environment：明确不提供质量承诺的环境。
-
-## MUST
-
-- 明确浏览器及最低版本、操作系统、设备和输入方式。
-- 明确关键分辨率和 100%/125%/150% 等缩放矩阵。
-- 关键流程在所有支持组合验证。
-- 不支持环境提供可操作说明或安全降级。
-- 使用能力检测而非脆弱 user-agent 业务判断。
-- 支持矩阵必须覆盖关键 Web API 能力与约束，包括存储、权限、Worker、文件/媒体能力和长连接；能力缺失或被策略禁用时提供可测试降级。
-- 页面必须兼容 `pagehide` / `pageshow`、可见性变化和 bfcache 恢复；恢复后重新校验连接、缓存、权限与数据新鲜度。
-
-## MUST NOT
-
-- MUST NOT 只在开发者默认环境验收。
-- MUST NOT 未测试就宣称支持。
-- MUST NOT 用缩小字体解决小屏。
-- MUST NOT 为旧环境引入无人维护的大型 polyfill。
-- MUST NOT 使用 `unload` 作为保存或清理的可靠信号；`beforeunload` 仅在存在未保存用户输入时按需注册并及时移除。
-
-## SHOULD
-
-- SHOULD 优先支持组织真实使用环境。
-- SHOULD 自动运行代表性兼容测试。
-
-## Contract
-
-```text
-Browser, MinVersion, OS, Device, Viewport,
-Zoom, Input, SupportLevel, TestEvidence
-```
-
-## Checklist
-
-- [ ] 支持矩阵明确。
-- [ ] 关键视口与缩放通过。
-- [ ] 不支持提示可用。
-- [ ] polyfill 风险已评估。
-- [ ] 生命周期/bfcache 恢复通过，关键能力降级可验证。
-
-## Examples
-
-### 内容示例，可删除
-
-企业桌面项目明确支持受管 Chrome/Edge 版本和关键办公分辨率，不含手机 Safari。
-
-## Anti-patterns
-
-只在 1920×1080@100% 测试，1366 笔记本上按钮和表格互相遮挡。
-
-## Ownership
-
-产品 Owner 定义范围，前端/QA 维护矩阵，平台 Owner 维护构建目标。
-
-## Change Policy
-
-增加或停止支持环境必须公告、更新构建与测试，并提供升级路径。