pomaster 0.3.0 → 0.4.0

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

@@ -0,0 +1,97 @@
+---
+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

@@ -0,0 +1,79 @@
+---
+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

@@ -0,0 +1,83 @@
+---
+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
+
+增加或停止支持环境必须公告、更新构建与测试，并提供升级路径。

package/seeds/specs/hard/frontend/38-internationalization-protocol.md

@@ -0,0 +1,243 @@
+---
+seed_source: pomaster/components/frontend-hard-spec/assets/universal/38-internationalization-protocol.md
+seed_source_sha256: 68ed4e126042eee191f071786d58983b3b2df94a826a13b50fc52aaa6536c7fa
+seed_version: B6B-2
+lane: frontend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [frontend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# 38 国际化协议
+
+## Scope
+
+P2。定义前端多语言机制：locale 标识与切换、文案外置与 key 命名、ICU MessageFormat、日期/时间/时区/相对时间、数字/货币/百分比/单位、列表/排序/搜索、RTL 与双向文本、文本膨胀与排版、图片/图标/颜色文化适配、翻译工作流与字典管理、SSR hydration 一致性、第三方 SDK / 浏览器原生文案 / 后端错误文案的本地化。
+
+## Non-Scope
+
+- 不翻译用户数据、不定义业务文案内容质量（语气/术语/voice）—— 见 `39-copywriting-protocol.md`。
+- 不定义金额精度、业务时区、合规区域本身。
+- 不替代 CLDR/Intl API 的实现细节，只规定必须使用的决策、契约和证据。
+
+## Terms
+
+- Locale：IETF BCP 47 语言标签（如 `zh-CN`、`en-US`、`ja-JP`、`ar-SA`），决定语言、格式、排序、方向和数字系统。
+- Translation Key：稳定文案标识，不随目标语言变化。
+- Formatter Registry：日期、时间、数字、金额、百分比、币种、单位、枚举和空值显示的唯一策略源。
+- RTL：Right-to-Left 文本方向；LTR：Left-to-Right。
+- ICU MessageFormat：Unicode ICU MessageFormat 2.0，用于复数、select、ordinal、offset 和命名占位符。
+
+## MUST
+
+- 明确支持 locale 列表、默认 locale 和完整回退链（如 `zh-CN` → `zh` → `en-US`）。
+- 使用 IETF BCP 47 语言标签标识 locale；禁止手写 `zh`、`cn`、`en` 等不精确别名。
+- locale 切换后所有已渲染的格式化值同步刷新，不允许旧 locale 残留。
+- URL 路径或子域携带 locale（如 `/zh-CN/dashboard`），或提供可书签化的 Cookie/LocalStorage 回退并由服务端首屏读取。
+- 切换 locale 时不丢失页面状态（query string、hash、表单草稿）。
+- 禁止在模板/组件/脚本中硬编码任何自然语言文本（用户数据除外）。
+- key 使用稳定标识，禁止用中文/英文文案本身作为 key。
+- key 采用命名空间隔离，如 `module:page.section.element` 或扁平点分 `login.form.submit`。
+- 插值占位符使用命名占位符 `{userName}`；禁止用位置占位符 `{0}`。
+- 占位符内容在运行时做 HTML 转义；如需输出 HTML，必须显式标记并经安全审查（XSS 边界，见 `04-security-protocol.md`）。
+- key 删除/改名必须走废弃别名机制，不能直接删除。
+- 复数、性别、状态选择使用 ICU MessageFormat `plural` / `select` / `selectordinal`；禁止用字符串拼接实现。
+- `plural` / `select` / `selectordinal` 必须包含 `other` 分支。
+- 日期、时间、相对时间通过 Formatter Registry 统一输出；禁止页面本地拼接 `YYYY-MM-DD` 或写死 "2 天前"。
+- 存储时间使用 ISO 8601 / UTC；显示时间按用户 locale + 显式时区转换。
+- 使用 `Intl.DateTimeFormat` 时显式传入 `timeZone`；禁止依赖系统时区。
+- 数字、货币、百分比、单位统一通过 Formatter Registry 输出。
+- 货币代码使用 ISO 4217（`CNY`、`USD`、`EUR`）；禁止用 `$`、`￥` 符号硬编码。
+- 货币格式化显式指定 `currencyDisplay`（`symbol`/`narrowSymbol`/`code`/`name`）。
+- 小数/千分位分隔符由 CLDR 决定；禁止硬编码 `.` 或 `,`。
+- 百分比与原始数值分离存储，排序/计算用原始值。
+- 列表连接使用 `Intl.ListFormat`；禁止用 `, ` 或 `/` 硬编码。
+- locale-aware 排序使用 `Intl.Collator`；禁止用 `Array.prototype.sort()` 默认字节序。
+- 大小写折叠、搜索归一化使用 locale 感知方法；禁止 `toLowerCase()` 处理非英语搜索。
+- 正则表达式考虑 Unicode 属性（`\p{Letter}`）；禁止只用 `[a-zA-Z]`。
+- HTML 根元素 `dir` 与当前 locale 方向一致；RTL locale（ar/he/fa/ur 等）使用 `dir="rtl"`。
+- 使用 CSS logical properties（`margin-inline-start`、`border-inline-end` 等）替代物理方向属性。
+- 镜像布局要素：导航顺序、按钮组、表单标签位置、图标方向（前进/后退、播放/进度条）。
+- 对动态插入的数字/用户生成内容使用 `<bdi>` 或 CSS `unicode-bidi: isolate`。
+- 德语、芬兰语等长文本膨胀系数按 1.3–1.5 预留空间；按钮、表头、标签必须支持换行或截断策略。
+- 所有文案容器定义 `overflow-wrap` / `word-break` 策略；禁止固定宽度导致文字被截断不可读。
+- 图片不得依赖文字传递关键信息；图标必须可本地化或带文本标签。
+- 避免文化敏感符号、颜色、手势、宗教/政治隐喻。
+- 日期/节假日按 locale 显示；禁止硬编码单一文化节日。
+- 度量衡单位按 locale 适配（英里/公里、磅/千克、华氏/摄氏）。
+- 明确 source-of-truth 语言；字典文件版本化并与代码同步发布。
+- 缺失 key 必须回退到 source 语言并标记告警。
+- 翻译平台 API 与 CI 集成；禁止手动复制 JSON 到代码库。
+- 字典文件支持命名空间/代码分割；禁止单个巨型 JSON。
+- SSR 首屏 locale 由服务端根据 URL/Cookie/Header 确定，并在 HTML 中序列化供 hydration。
+- 构建时抽取翻译 key，避免运行时扫描文件系统。
+- hydration 前后 locale 和初始字典一致；禁止服务端用默认 locale、客户端切换导致 mismatch。
+- 后端错误 message 必须映射为前端翻译 key，禁止直接展示后端原始 message。
+- 第三方 SDK/组件的 locale 配置必须显式传入当前 locale，禁止静默使用默认英文。
+- 验证第三方组件的 RTL 支持能力；不支持 RTL 的第三方组件必须评估替代方案或包装隔离。
+
+### 分层责任（按目录层级）
+
+国际化是跨层机制，按目录层级分担责任；层级划分与 `09-module-boundary-protocol` 一致。
+
+- **app 层 — locale 入口与切换**：初始化 i18n Provider、默认 locale、回退链、locale 协商策略、URL/Cookie 持久化。MUST NOT 在应用入口硬编码 locale 或把 `navigator.language` 作为唯一业务来源。
+- **platform 层 — 全局 formatter 与字典**：维护 Formatter Registry、全局字典加载/分割、伪本地化、翻译平台同步。MUST NOT 让各页面自行格式化数据或复制组件实现多语言。
+- **api 层 — 后端契约本地化**：错误码映射为翻译 key、货币/单位/时区字段语义对齐、API 响应不携带未本地化的自然语言。MUST NOT 直接展示后端原始 message。
+- **domain 层 — 领域值本地化策略**：金额精度、单位换算、枚举显示、空值/缺省值显示由 domain 决定策略，由 Formatter Registry 执行显示。MUST NOT 在 domain 逻辑中用翻译文本做业务判断。
+- **feature 层 — 页面级 i18n 契约**：页面声明支持的 locale、RTL 需求、key namespace、第三方 SDK locale 矩阵。MUST NOT 页面本地拼接日期/货币/列表格式。
+- **shared 层 — 组件级 i18n 内置**：公共组件内置文案外置、RTL 兼容、logical properties、图标方向翻转、可本地化空态。MUST NOT 组件内部硬编码自然语言或假设 LTR。
+
+## MUST NOT
+
+- MUST NOT 各页面自行格式化数据。
+- MUST NOT 用中文/英文标题作为程序 key。
+- MUST NOT 复制组件实现多语言。
+- MUST NOT 将格式化字符串用于计算或排序。
+- MUST NOT 用浏览器 `navigator.language` 作为唯一来源决定业务权限、价格或合规区域。
+- MUST NOT 用中文/英文文案本身作为 key。
+- MUST NOT 用位置占位符 `{0}` / `{1}`。
+- MUST NOT 在源码中直接写 locale-specific 复数分支。
+- MUST NOT 用 `Date.prototype.toLocaleString()` 无参调用。
+- MUST NOT 手动拼接币种和单位符号。
+- MUST NOT 硬编码小数点/千分位分隔符。
+- MUST NOT 用字符串拼接实现复数/选择/序数。
+- MUST NOT 用 `Array.prototype.sort()` 默认字节序做业务排序。
+- MUST NOT 用 `toLowerCase()` / `toUpperCase()` 处理非英语搜索。
+- MUST NOT 用物理方向 CSS（`margin-left/right`）替代 logical properties。
+- MUST NOT 硬编码 `dir="ltr"` 包裹整个应用。
+- MUST NOT 假设源语言（中文）紧凑即所有语言都紧凑。
+- MUST NOT 图片包含不可翻译文字作为关键信息。
+- MUST NOT 硬编码单一文化节日、单位换算或数字系统。
+- MUST NOT 把 UI 文案 key 用作业务逻辑判断（如 `if (t('status') === '已启用')`）。
+- MUST NOT 在源码提交后才发现缺失 key。
+- MUST NOT 在服务端 render 中读取 `window.navigator.language`。
+- MUST NOT 将未本地化的第三方错误文案直接呈现给用户。
+
+## SHOULD
+
+- SHOULD 支持缺失 key 检测和伪本地化。
+- SHOULD 明确存储时区与显示时区。
+- SHOULD 提供 locale 协商：URL > 用户显式选择 > Cookie > `Accept-Language` > 默认。
+- SHOULD 维护 key 命名约定文档 + 禁用词表。
+- SHOULD 提供复数/选择消息的视觉回归测试（阿拉伯语/俄语/波兰语等复杂复数）。
+- SHOULD 在关键业务场景（预约/截止时间）显示时区全名。
+- SHOULD 支持 accounting 格式（负数括号表示）。
+- SHOULD 对关键 UI 文案做 "longest translation" 回归测试。
+- SHOULD 建立可本地化素材清单（illustration/color/icon/photo）。
+- SHOULD 支持 pseudo-localization（伪本地化：lengthening、accents、fake-RTL）做布局回归。
+- SHOULD 在关键错误/空态使用自定义组件替代浏览器原生 `alert()` / `confirm()`。
+- SHOULD 维护第三方 SDK locale/RTL 兼容性矩阵。
+
+## Contract
+
+```text
+Locale, Fallback, KeyNamespace, DateTimePolicy,
+NumberPolicy, CurrencyPolicy, UnitPolicy, EnumPolicy, EmptyPolicy,
+RTLPolicy, PluralPolicy, ListFormatPolicy, CollatorPolicy,
+TranslationWorkflowPolicy, ThirdPartyLocaleMatrix
+```
+
+- `Locale` / `Fallback`：支持的 locale 列表和回退链。
+- `KeyNamespace`：文案 key 的命名空间约定。
+- `DateTimePolicy` / `NumberPolicy` / `CurrencyPolicy` / `UnitPolicy` / `EnumPolicy` / `EmptyPolicy`：Formatter Registry 策略 ID。
+- `RTLPolicy`：RTL locale 列表和布局镜像策略。
+- `PluralPolicy`：ICU MessageFormat 版本和复数分支要求。
+- `ListFormatPolicy` / `CollatorPolicy`：列表连接与排序策略。
+- `TranslationWorkflowPolicy`：source 语言、翻译平台、命名空间拆分、review 策略。
+- `ThirdPartyLocaleMatrix`：第三方 SDK/组件的 locale 与 RTL 兼容性矩阵。
+
+### Formatter Registry
+
+`outputs/frontend/10_planned/formatter-registry.yaml` 记录项目级 formatter 策略：
+
+```text
+Category, PolicyId, DefaultValue, UnknownValue, DeprecatedValue,
+Examples, Owner, Version
+```
+
+- Category 至少覆盖 date、time、datetime、number、money、percent、currency、unit、enum、empty。
+- 每个页面或组件必须通过 registry 中声明的 formatter 输出值，禁止本地拼接格式。
+
+## Checklist
+
+- [ ] locale 列表、默认 locale、回退链和 locale 协商策略已明确。
+- [ ] 文案外置，无硬编码自然语言；key 使用稳定命名空间标识。
+- [ ] 插值使用命名占位符，HTML 输出经显式标记和安全审查。
+- [ ] ICU MessageFormat 用于复数/性别/状态/序数，且包含 `other` 分支。
+- [ ] 日期/时间/相对时间/数字/货币/百分比/单位通过 Formatter Registry 输出。
+- [ ] 显式时区，不依赖系统时区；UTC 存储，locale 显示。
+- [ ] 列表连接、排序、搜索使用 `Intl.ListFormat` / `Intl.Collator` / locale 感知归一化。
+- [ ] RTL locale 已识别，`dir`、`logical properties`、图标翻转和 `<bdi>` 已处理。
+- [ ] 文本膨胀系数、换行/截断策略、长文案回归已安排。
+- [ ] 图片/图标/颜色/节日/单位/数字系统已做文化适配审查。
+- [ ] source-of-truth 语言、翻译平台、命名空间拆分、review 策略已建立。
+- [ ] SSR 首屏 locale 由服务端确定并序列化；hydration 前后一致。
+- [ ] 后端错误 message 映射为翻译 key；第三方 SDK locale/RTL 矩阵已维护。
+- [ ] 分层国际化责任已按 app/platform/api/domain/feature/shared 分担。
+
+## Examples
+
+### locale 切换保留 URL state
+
+```text
+切换前: /zh-CN/dashboard?tab=1#section-a
+切换后: /en-US/dashboard?tab=1#section-a
+```
+
+### 命名占位符与 ICU plural
+
+```text
+key: "cart.item_count"
+en-US: "You have {itemCount, number} {itemCount, plural, one {item} other {items}}."
+ar-SA: "لديك {itemCount, number} {itemCount, plural, zero {} one {عنصر} two {عنصرين} few {عناصر} many {عنصرًا} other {عنصر}}."
+```
+
+### Formatter Registry 统一货币显示
+
+```text
+原始值: 1234.5
+zh-CN 显示: ¥1,234.50
+en-US 显示: $1,234.50
+de-DE 显示: 1.234,50 EUR
+排序/计算仍使用原始数值 1234.5
+```
+
+### RTL 使用 logical properties
+
+```css
+/* 推荐 */
+margin-inline-start: 1rem;
+/* 不推荐 */
+margin-left: 1rem;
+```
+
+### 后端错误映射为翻译 key
+
+```text
+后端返回: { "code": "ORDER.OUT_OF_STOCK", "message": "Insufficient inventory" }
+前端显示: t('error.ORDER.OUT_OF_STOCK') -> "库存不足，无法完成订单。"
+```
+
+## Anti-patterns
+
+- 模板拼接币种和单位，切换语言后顺序、间距和小数规则错误。
+- 用 `if (count === 1)` 拼接单复数，阿拉伯语/俄语/波兰语分支错误。
+- 用 `{0}` 位置占位符，翻译调整语序后插值错位。
+- `Date.prototype.toLocaleString()` 无参调用，依赖用户系统时区导致显示不一致。
+- 硬编码 `$` / `￥` 符号，德语、法语显示格式错误。
+- 对格式化后的金额字符串做排序，导致 1000 < 99。
+- 用 `margin-left/right` 物理方向，RTL 布局破裂。
+- 图片包含 "New!" "Sale" 等英文文字，未做本地化即上线。
+- 硬编码春节/圣诞作为默认节日，其他 locale 用户困惑。
+- 后端错误 message 直接展示给用户，暴露内部术语或英文。
+- SSR 服务端用默认 locale 渲染，客户端 hydration 后闪烁切换。
+
+## Ownership
+
+产品/内容 Owner 维护语言范围和文化适配清单，i18n Owner 维护工具、key、Formatter Registry 和翻译工作流，领域 Owner 维护枚举语义和后端错误码映射，前端架构 Owner 维护 locale 切换、SSR hydration 和第三方 SDK 矩阵。
+
+## Change Policy
+
+Key 改名先提供别名或迁移；新增 locale 必须补资源、格式、布局回归和 RTL 测试。Formatter Registry 策略变化须评估所有页面/组件影响；第三方 SDK locale/RTL 兼容性矩阵随 SDK 版本更新而更新。

package/seeds/specs/hard/frontend/39-copywriting-protocol.md

@@ -0,0 +1,79 @@
+---
+seed_source: pomaster/components/frontend-hard-spec/assets/universal/39-copywriting-protocol.md
+seed_source_sha256: 5df3a2ddcd1140b2e62dd80f547cf6c0197c44a91ebbdda02ded44bcaefed351
+seed_version: B6B-2
+lane: frontend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [frontend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# 39 文案协议
+
+## Scope
+
+P2。定义按钮、确认、成功、错误、空态、删除、导入导出和高风险操作文案。
+
+## Non-Scope
+
+不定义业务规则和错误码，不允许文案隐藏系统行为。
+
+## Terms
+
+- Actionable Copy：说明发生什么、影响什么和下一步的文案。
+- Risk Copy：明确不可逆性、对象和后果的文案。
+
+## MUST
+
+- 按钮使用明确动作和对象。
+- 错误说明发生内容、可恢复性和下一步。
+- 空态区分无数据与筛选无结果。
+- 高风险确认明确对象、后果和是否可恢复。
+- 导入导出说明范围、进度、部分成功和结果有效期。
+- 同类操作使用同一名称和语气。
+
+## MUST NOT
+
+- MUST NOT 直接展示后端原始 message 或技术堆栈。
+- MUST NOT 高风险操作只写“确定吗”。
+- MUST NOT 用颜色或感叹号代替清晰说明。
+- MUST NOT 用模糊“操作”“处理”隐藏动作。
+
+## SHOULD
+
+- SHOULD 简洁、专业、可行动。
+- SHOULD 复用文案模板和错误码映射。
+
+## Contract
+
+```text
+Scenario, Title, Message, PrimaryAction,
+SecondaryAction, Consequence, Recoverability, TraceDisplay
+```
+
+## Checklist
+
+- [ ] 动作和对象明确。
+- [ ] 风险与恢复清晰。
+- [ ] 同类文案一致。
+- [ ] 无原始技术信息。
+
+## Examples
+
+### 内容示例，可删除
+
+“该数据已被其他人更新。请比较最新版本后重新提交。”
+
+## Anti-patterns
+
+系统异常只显示“失败！”，用户不知道对象、原因或下一步。
+
+## Ownership
+
+内容/产品 Owner 维护语气，领域 Owner 确认语义，前端负责正确映射。
+
+## Change Policy
+
+公共文案模板变化需评估全部场景；业务术语变化同步 i18n 和帮助内容。

package/seeds/specs/hard/frontend/40-analytics-protocol.md

@@ -0,0 +1,98 @@
+---
+seed_source: pomaster/components/frontend-hard-spec/assets/universal/40-analytics-protocol.md
+seed_source_sha256: f638c8054ba32d44a15f1dd4fa42b637e1f6ad39cd73c6e1d45cd5bfd71b2c56
+seed_version: B6B-2
+lane: frontend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [frontend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# 40 埋点协议
+
+## Scope
+
+P2。作为业务行为分析的唯一权威，定义用户行为事件、关键业务动作、漏斗、事件 schema、上报时机、去重、同意/授权和分析用途。
+
+## Non-Scope
+
+不替代错误监控、技术 telemetry、Trace/Span、RUM 运行诊断和后端审计；这些运行可观测性规则归 `34-monitoring-logging-protocol`。LCP/INP/CLS 等性能预算与分位数归 `31-performance-protocol`。不允许收集未批准敏感数据。
+
+## Terms
+
+- Event Schema：事件名和字段契约。
+- Funnel：按稳定业务阶段关联的一组行为事件，用于分析到达、转化、放弃和结果。
+- OperationId：关联 attempt/result 的操作标识。
+- Deduplication Key：防止重复上报的键。
+- Consent State：当前用户对非必要分析采集的同意、拒绝或撤回状态。
+
+## MUST
+
+- 事件使用稳定 key，不使用显示文案。
+- 定义公共字段、业务白名单、触发时机和去重。
+- 每个分析事件必须声明 event_id、schema_version、业务目的、触发条件、字段白名单、隐私分类、Owner、目的地和保留策略；页面或组件不得临时扩展 schema。
+- attempt 与 result 通过 OperationId 关联。
+- 核心用户旅程必须以稳定业务阶段定义漏斗，并明确进入、成功、失败、放弃和不适用口径；漏斗不得依赖显示文案、DOM 或 URL 猜测。
+- 页面重渲染、自动刷新和重试不得误记为用户操作。
+- 敏感字段、搜索原文和业务原值默认不上传。
+- 新事件有 Owner、用途和保留策略。
+- 采集必须遵循适用的同意/授权状态；用户撤回后停止非必要采集，并清理或隔离尚未发送的数据。
+- 事件目的地与 payload 字段必须使用白名单；第三方分析脚本、转发规则和数据出境必须经过安全与隐私评审。
+- page-view、action、attempt/result 等事件必须使用稳定 page_id/action_id/operation_id 关联；技术 trace-id 仅可作为经批准的关联字段，不得把分析事件变成运行日志副本。
+
+## MUST NOT
+
+- MUST NOT 同一行为多次上报或多名称。
+- MUST NOT 页面自行扩展不受控公共字段。
+- MUST NOT 用埋点代替审计。
+- MUST NOT 上报权限外数据。
+- MUST NOT 通过抓取 DOM、可见文本、URL 查询参数或用户输入来临时拼装分析数据。
+- MUST NOT 在同意状态未知或撤回后继续发送非必要分析事件。
+- MUST NOT 用业务分析事件替代错误、白屏、API RED、Trace/Span 或 RUM 技术遥测。
+- MUST NOT 把同一业务漏斗阶段在多个页面或组件中定义为不同语义。
+
+## SHOULD
+
+- SHOULD 通过 typed analytics client 和 schema 校验。
+- SHOULD 监控事件质量、丢失和重复率。
+- SHOULD 对漏斗的迟到、乱序、重复、跨设备和 consent 变化定义明确处理策略。
+
+## Contract
+
+```text
+EventId, SchemaVersion, Purpose, FunnelId, FunnelStage, PageId, ActionId,
+Trigger, CommonFields, BusinessFields, OperationId, DedupKey, ConsentState,
+PrivacyClass, Destination, Owner, Retention
+```
+
+## Checklist
+
+- [ ] 名称和字段稳定。
+- [ ] 时机与去重正确。
+- [ ] 漏斗阶段、成功/失败/放弃口径和 OperationId 关联明确。
+- [ ] 隐私边界通过。
+- [ ] Owner 和用途明确。
+- [ ] 同意、撤回、目的地白名单和待发送队列清理已验证。
+- [ ] 业务事件未复制 34 的运行诊断或 31 的性能预算规则。
+
+## Examples
+
+### 内容示例，可删除
+
+用户点击导出记录业务 `attempt`，后台任务完成记录 `result`，两者共享 operation id 并进入同一导出漏斗；API 耗时、错误码和 trace 诊断仍由 34 记录。
+
+## Anti-patterns
+
+按钮组件和页面都上报点击，导致同一行为计数两次且字段不同。
+
+把 JS 错误、API RED 指标和 LCP 阈值塞进分析事件 schema，导致运行诊断、性能预算与业务转化口径互相污染。
+
+## Ownership
+
+数据/产品 Owner 定义用途，埋点平台 Owner 维护 schema，安全/隐私 Owner 审核字段。
+
+## Change Policy
+
+事件改名、字段语义和保留变化必须版本化并通知下游消费者。