Feat/sso role team mapping docs

.agents/skills/translate-zh-to-en/glossary.md

@@ -200,4 +200,3 @@ Translatable companions (do NOT belong in DNT — translate to Chinese):
 
 | English | Chinese |
 |---------|---------|
-| Customize | 自定义 |

.claude/skills/translate-zh-to-en/glossary.md

@@ -121,6 +121,7 @@ Chinese-English terminology mapping. Maintain consistency during translation.
 | 解决办法 | resolution |
 | 推送地址 | push URL |
 | 跳转链接 | jump link |
+| 产物 | Artifact / Artifacts |
 
 ## Actions
 
@@ -188,7 +189,6 @@ a single half-width space on either side (e.g., `管理你的 Routines`, not
 | Knowledge Pack | A curated knowledge bundle attached to an Agent |
 | Tool call | A single tool invocation inside an Agent turn |
 | Slash command | UI slash-prefixed command (e.g., `/help`) |
-| Artifact | Output produced by an Agent (file, doc, image) |
 | Reasoning | The reasoning / chain-of-thought block of a model response |
 | Connector | Integration with an external system (Slack, GitHub, etc.) |
 | Environment | Execution environment for runners (env vars, credentials) |
@@ -200,4 +200,45 @@ Translatable companions (do NOT belong in DNT — translate to Chinese):
 
 | English | Chinese |
 |---------|---------|
-| Customize | 自定义 |
+| Artifact / Artifacts | 产物 |
+
+## Intentional Variants (per-context wording)
+
+These Chinese terms intentionally map to more than one English wording depending
+on UI context. Every listed variant is correct — do not "unify" them.
+Translators: pick the variant whose context matches.
+
+| Chinese | Variants (context) |
+|---------|--------------------|
+| 全屏 | Enter fullscreen (verb tooltip; pairs with "Exit fullscreen") / Fullscreen (compact label) |
+| 来源 | Referrer (RUM view-referrer tag) / Source (generic origin) |
+| 异常 | Error (metric label) / Issue (RUM Error Tracking entity, Datadog convention) |
+| 状态 | Status (issue/alert status) / State (technical thread-dump state) |
+| 成功 | Succeeded (run-status filter) / OK (compact badge) |
+| 对话 | Chat (singular) / Chats (section header, plural) |
+| 环境 | Environment (field label) / Environments (nav or page title, plural) |
+| 知识库 | Knowledge Pack (singular) / Knowledge Packs (page title, plural) |
+| 产物 | Artifact (singular) / Artifacts (plural) |
+| 文档 | Document (artifact kind) / Documentation (docs link) |
+| 邮件 | Email (channel label, pairs with "SMS") / Email us (CTA, pairs with "Call us") |
+| 我的 | Personal (user menu) / My teams (team selector) |
+| 团队 | Team (singular tag after a team name) / Teams (multi-select or group labels) |
+| 关闭 | Close (button or rule action) / Closed (timeline event) / Dismiss (banner) |
+| 天 | Day (picker label) / days (count unit) / d (compact) |
+| 小时 | Hour (picker label) / hour(s) (form or count) / h (compact) |
+| 条 | items (generic count) / alerts (alert count) |
+| 行动项 | action (field label) / Actions (title) |
+| 计划维护 | schedule maintenance (verb) / scheduled (adjective) |
+| 订阅规则 | singular / plural by count context |
+| 协作空间 | Channel (standalone label) / channels (plural base) |
+
+Plural-pair convention (zh-as-key frontends): a count-bearing Chinese key may
+have English `_one` / `_other` splits (e.g. "Ran {{count}} search" / "Ran
+{{count}} searches"). These pairs are intentional — never merge them into one
+English value. The zh locale needs only the base key (Chinese has no plural
+inflection); do not add `_one` / `_other` entries to zh locale files.
+
+Scope note: the "Incident Status" table above (待处理 → triggered, etc.) applies
+to the incident console only. RUM dashboards follow Datadog-style triage wording
+(For Review / Reviewed / Occurred At) — do not rewrite RUM strings to match that
+table.

.github/workflows/openapi-lint.yml

@@ -0,0 +1,28 @@
+name: Lint OpenAPI specs
+
+# Quality gate for the public API reference. Fails on undocumented schema
+# properties, epoch time fields without Unix/timestamp wording, string enums
+# whose values are not explained in the description, and operations without
+# request/response examples. See scripts/lint_openapi.py for the rules.
+
+on:
+  pull_request:
+    paths:
+      - 'api-reference/*.json'
+      - 'scripts/lint_openapi.py'
+      - '.github/workflows/openapi-lint.yml'
+  push:
+    branches: [main]
+    paths:
+      - 'api-reference/*.json'
+      - 'scripts/lint_openapi.py'
+      - '.github/workflows/openapi-lint.yml'
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v5
+      - name: Lint specs
+        run: python3 scripts/lint_openapi.py

README.md

@@ -3,7 +3,7 @@
 English | [中文](https://github.com/flashcatcloud/flashduty-docs/blob/main/README_zh.md)
 
 [![Mintlify](https://img.shields.io/badge/Built_with-Mintlify-8B5CF6?style=flat-square)](https://mintlify.com/)
-[![Docs](https://img.shields.io/badge/Live-docs.flashcat.cloud-blue?style=flat-square)](https://docs.flashcat.cloud)
+[![Docs](https://img.shields.io/badge/Live-docs.flashduty.com-blue?style=flat-square)](https://docs.flashduty.com)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green?style=flat-square)](LICENSE)
 
 Official documentation for [Flashduty](https://flashcat.cloud/), bilingual (Chinese & English), built with [Mintlify](https://mintlify.com/). Covers On-call incident management, RUM real user monitoring, and Monitors alert rules — **390+** pages in total.
@@ -131,7 +131,7 @@ Full glossary: [`glossary.md`](glossary.md)
 
 | Resource | Link |
 |----------|------|
-| Flashduty Docs | [docs.flashcat.cloud](https://docs.flashcat.cloud) |
+| Flashduty Docs | [docs.flashduty.com](https://docs.flashduty.com) |
 | Flashduty Console | [console.flashcat.cloud](https://console.flashcat.cloud/) |
 | Flashduty Website | [flashcat.cloud](https://flashcat.cloud/) |
 | MCP Server | [flashduty-mcp-server](https://github.com/flashcatcloud/flashduty-mcp-server) |

README_zh.md

@@ -3,7 +3,7 @@
 [English](https://github.com/flashcatcloud/flashduty-docs/blob/main/README.md) | 中文
 
 [![Mintlify](https://img.shields.io/badge/Built_with-Mintlify-8B5CF6?style=flat-square)](https://mintlify.com/)
-[![Docs](https://img.shields.io/badge/Live-docs.flashcat.cloud-blue?style=flat-square)](https://docs.flashcat.cloud)
+[![Docs](https://img.shields.io/badge/Live-docs.flashduty.com-blue?style=flat-square)](https://docs.flashduty.com)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green?style=flat-square)](LICENSE)
 
 [Flashduty](https://flashcat.cloud/) 官方文档站，中英双语，基于 [Mintlify](https://mintlify.com/) 构建。覆盖 On-call 故障管理、RUM 真实用户监控、Monitors 告警规则三大产品模块，共 **390+** 页文档。
@@ -131,7 +131,7 @@ flashduty-docs/
 
 | 资源 | 链接 |
 |------|------|
-| Flashduty 文档站 | [docs.flashcat.cloud](https://docs.flashcat.cloud) |
+| Flashduty 文档站 | [docs.flashduty.com](https://docs.flashduty.com) |
 | Flashduty 控制台 | [console.flashcat.cloud](https://console.flashcat.cloud/) |
 | Flashduty 官网 | [flashcat.cloud](https://flashcat.cloud/) |
 | MCP Server | [flashduty-mcp-server](https://github.com/flashcatcloud/flashduty-mcp-server) |