Flynor Documentation Portal

对外产品门户与对内架构治理入口，从统一清单生成组件、部署、术语、兼容和风险文档。

展示名称官方文档站

类型documentation-and-governance-portal

成熟度建设中

Owner文档平台组

职责与边界

负责

产品与架构介绍
组件与部署导航
治理问题公开标记
标准术语和决策记录发布

不负责

不保存生产运行主状态
不暴露内部密钥、地址或客户拓扑
不替代管理系统

数据与接口

拥有的数据

公共文档呈现与构建产物

输入

architecture 下的机器可读清单；经审计的公共文档

输出

可导航文档站；架构治理视图；公开部署规范

协议

HTTPS；HTML

依赖

protocol

运行与部署

Owner / 支持

文档平台组 · public-preview · active；升级路径：文档平台组 → 平台治理组

交付策略

standalone · supported；使用不可变版本发布到官方托管站点，并与生产业务路由隔离。

配置

.openai/hosting.json 与公共域名路由清单

部署

Cloudflare Worker-compatible Sites 部署，并接入现有域名体系

健康检查

构建、核心路由、导航和链接校验

可观测性

托管部署状态与访问日志；不采集项目敏感数据

升级与回滚

不可变站点版本发布，可快速回退到上一版本

recommended默认

文档站托管部署

公开产品与技术文档；内部运维内容必须独立受控

docs-site-hosted · docs-site · cloudflare-worker-compatible-site · static-assets / server-rendered-routes / existing-domain-route

查看完整部署契约

前置条件

validated build
approved public origin/path
no secret or internal topology content

配置与交付物

apps/docs-site/.openai/hosting.json
architecture/public-origins.manifest.json

健康与验收

build success
root route
representative component route
governance route
broken-link validation

备份范围

Git history and versioned architecture manifests

升级

publish immutable version then switch deployment

回滚

redeploy previous immutable site version