REITs TechDeveloper
开发文档 7
DOCUMENTATION开发者工作区
从身份、契约到质量发布
更多入口 10
DEVELOPER DIRECTORY业务入口与运行事实
非业务审批和旧刀次已归档，不占当前开发页面
开始接入SSO · Mini App SDK
UI 蓝图/开放平台/应用索引与控制面健康
TARGETF4B2 PARTIALQA 0/5 VERIFIEDR06 · 7/21 PASS COMPLETEAdmin · 在个人或组织上下文管理应用的开发者

应用索引与控制面健康

先确认组织、环境、应用身份和依赖健康，再进入版本、配置或权限工作

/appsminiapp-open-platform对照 CURRENT · openapi-apps →
R06 · KNIFE 7 / 21

应用索引与控制面健康 · 页面级细化任务包

只展示当前主体拥有的应用，并把当前 Portal、Developer API、Gateway 与生产目录污染事实放在一个可行动的索引中。

CURRENT / TARGET ROUTE

/apps → /apps

ENTRY

邮箱 OTP 后进入 `/apps`，或从创建/发布返回；当前只有单 owner 列表，不存在组织切换与多角色视图。

SUCCESS OUTPUT

打开当前 app 的发布页，或进入目标 settings/config/versions/capabilities/requests；跨页保持 app id 与环境上下文。

COMMAND MODEL

reits-auth introspection → developer account → ListAppsByOwner；Developer API 组合 readiness 与只读 Gateway catalog hygiene，不在浏览器聚合秘密。

RESPONSIVE + A11Y

桌面应用表 + control-plane rail；平板卡表切换；390px 先显示目录污染与应用状态，不显示邮箱、token 或签名下载 URL。

TELEMETRY

open_apps_view · app_open · create_start · health_open；只记录 screen/app ref/status，不记录邮箱、bearer 或下载票据。

CURRENT SOURCE + PRODUCTIONfa9283d / fb1a1b
  • miniapp-open-platform formal main fa9283d；生产 developer-api / gateway 为 fb1a1b4、落后 1 提交；UX bc62595 +1 与 runtime 5e51842 +18 均为未合并 candidate
  • 当前 Portal 只有 `/login`、`/apps`、`/apps/new`、`/apps/:id/publish` 四个 React 路由；E06 以 68 个 formal-main 文件为源码边界
  • 当前 Portal 把 access token 写入 localStorage key `reits.portal.token`；邮箱写入 `reits.portal.email`
  • 生产 Developer API 运行于 :8090，Miniapp Gateway 运行于 :8081，health/ready 200；未授权 `/api/apps` 为 401，OTP/创建/上传/发布写调用为 0
  • 最新代码已在 Developer API 强制 client_id=developer-portal 与 developer:read/developer:write scope
  • 生产 active Gateway catalog 为 45 项，其中 43 项名称是 e2e-smoke-*，非 smoke 只有东京美甲预约与 Demo Miniapp
IMPLEMENTATION GAPNOT PRODUCT UI
  • 当前 `/apps` 只显示名称、appKey 与发布链接，没有状态/版本/Gateway/健康
  • 没有 organization、member、role 或 resource grant 数据模型
  • 生产 smoke 应用清理、隔离命名空间和 catalog hygiene gate 尚未形成产品合同
四个 current Portal 路由与八张目标工作页分开记录；目标页面不能作为产品完成证据。
72-STATE PROGRAM / THIS SCREEN

八页分别改变身份、发布、配置、版本、能力与审核边界

QA 0 / 5 VERIFIED
READY应用索引可以使用

owned app index + platform facts

OPEN-APPS-READY→ 打开一个应用
LOADING正在读取应用与控制面状态

apps + readiness + catalog hygiene

OPEN-APPS-LOAD→ 取消并返回
EMPTY当前账号尚无应用

owned app index

OPEN-APPS-EMPTY→ 创建第一个应用
PARTIAL ERROR应用列表可用，部分控制面证据不可用

gateway/readiness rail

OPEN-APPS-HEALTH-PARTIAL→ 重试控制面证据
ERROR无法读取应用列表

owned app index

OPEN-APPS-503→ 重新读取应用
OFFLINE离线查看最近应用快照

last safe app snapshot

OPEN-APPS-OFFLINE→ 重新连接
FORBIDDENToken 无权读取开发者应用

developer:read policy

OPEN-APPS-SCOPE-DENY→ 重新授权
CONFIRM进入选中应用的生产工作区？

app context

OPEN-APPS-CONTEXT-CONFIRM→ 确认进入应用
SUCCESS应用上下文已建立

context receipt

OPEN-APPS-CONTEXT-READY→ 打开应用概览
OPEN PLATFORM BOUNDARYR06/E06 只细化 developer.reits.tech 的开放平台目标 UI 与可复核执行合同；不使用真实开发者凭证，不发送 OTP，不创建应用，不上传 ZIP，不发布或回滚版本，不轮换 secret，不提交能力申请，也不把 candidate 或目标路由冒充为当前生产事实。
UI STUDIOtarget-open-apps
Admin1440 × 900100%
100%
/apps
TARGET UI1440 × 900FIT 100%
R06 DESIGN CANDIDATE · target-open-apps · NOT PRODUCT UI
CURRENT PORTAL / TARGET CONTROL PLANE应用控制台
AU
APPLICATION INDEX · SOURCE fa9283d / PROD fb1a1b

应用与目录质量

owner 应用列表不能从公共 Gateway 反推。当前可验证的生产事实是 45 个 active 目录项，其中 43 个是 smoke 数据。

CURRENT PORTAL ROUTES4login · apps · new · publish
ACTIVE CATALOG45public gateway
E2E SMOKE4395.6% catalog pollution
NON-SMOKE2Tokyo + Demo
READINESS2 / 2API + Gateway ready
目录项App keyVersion证据分类状态
東
东京美甲预约public Gateway record
app_9db8…1e581783607762PUBLICnon-smokecurrent
DM
Demo Miniapppublic Gateway record
demo_app_key1PUBLICnon-smokecurrent
QA
e2e-smoke-* × 43aggregate evidence
production catalog1HYGIENEmust cleanwarn
REFERENCE VIEWPORT1440 × 900Desktop first · responsive
PRIMARY TASK创建应用主操作、权限与完成反馈必须同屏可验证
DATA CONTRACTOrganizationContextready / loading / empty / error 使用同一 fixture
ACCESSIBILITYKeyboard + WCAG AA焦点顺序、可读名称、对比度进入 UI CI
VISUAL BASELINETARGET · 2026-07-17桌面/移动、浅色/错误态按稳定 Screen ID 留档

IMPLEMENTATION MAP

目标定义与下一轮逐页细化入口

当前处于 B1/B2：可以拆出架构、设计、交互和 QA 任务，但完成 D01–D12、通过 B3/B4 之前，不得宣称页面已经可以照稿实现。

01

页面区域

  • 组织级侧栏
  • 全局搜索和帮助
  • 页面任务与创建入口
  • 跨应用指标
  • 应用筛选和目录
  • 依赖健康侧栏
  • 分页与配额
  • 危险动作确认
02

用户动作

  • 创建应用
  • 切换组织与环境
  • 搜索/筛选应用
  • 进入应用管理
  • 停用或归档应用
  • 查看控制面故障
03

必须状态

  • 应用目录就绪
  • 目录与健康加载
  • 尚无应用
  • Gateway 健康部分失败
  • 应用目录失败
  • 离线只读目录
  • 组织/应用无权限
  • 停用/删除确认
  • 应用操作回执
04

数据契约

  • OrganizationContext
  • DeveloperAppIndex
  • AppIdentity
  • ReleaseSummary
  • GatewaySyncStatus
  • ControlPlaneHealth
  • AppQuota
  • AuditReceipt

TARGET MODULES

目标页面必须交付的模块

  1. 01组织与环境选择
  2. 02应用/版本/待办 KPI
  3. 03搜索与状态筛选
  4. 04应用目录表
  5. 05宿主同步状态
  6. 06控制面依赖健康
  7. 07空态与配额
  8. 08删除/停用入口

PRODUCT ROUTE INDEX

开放平台 的 38 个稳定 Screen ID

同一产品内的页面共享 token、导航和状态语言，但每个 Screen ID 保留自己的字段、数据契约和 QA 基线。

01
开发者登录/login
Web02
我的小程序/apps
Web03
创建小程序/apps/new
Web04
应用发布/apps/:id/publish
Web05
应用索引与控制面健康/apps
Admin06
三步创建应用/apps/new
Admin07
上传、审核与原子发布/apps/:appId/releases/new
Admin08
应用基本信息与生命周期/apps/:appId/settings
Admin09
环境、回调与凭证/apps/:appId/config
Admin10
版本历史、对比与回滚/apps/:appId/versions
Admin11
接口、Scope 与使用量/apps/:appId/capabilities
Admin12
能力申请与审核/apps/:appId/capability-requests
Admin13
组织目录与企业边界/mini-company/list
Admin14
创建与验证企业/mini-company/create
Admin15
开发治理概览/console/development
Admin16
开发者身份与资源关系/console/developer
Admin17
成员、邀请与离职治理/console/member
Admin18
角色、策略与有效权限/console/role
Admin19
服务账号与工作负载身份/console/service-accounts
Admin20
操作、授权与安全审计/console/log
Admin21
机器人目录与运行健康/robot/list
Admin22
创建机器人与最小授权/robot/create
Admin23
机器人基本信息与生命周期/robot/baseInfo/:id
Admin24
事件订阅与开发配置/robot/devConfig/:id
Admin25
命令定义、权限与测试/robot/command/:id
Admin26
Bot Token 与运行凭证/robot/token/:id
Admin27
事件交付、重试与 Redelivery/robot/:id/deliveries
Admin28
支付订单与资金生命周期/mini/:type/paymentOrders/:id
Admin29
用户数据、授权与主体请求/mini/:type/userData/:id
Admin30
支付能力申请与独立复核/mini/:type/payApply/:id
Admin31
组织财务、结算与对账/console/finance
Admin32
公共开发者首页与能力总览/
Web33
Mini App 产品、Quickstart 与宿主边界/mini
Web34
企业开发与组织治理介绍/mini-company
Web35
机器人、命令与事件自动化介绍/robot
Web36
商业合作、场景准入与能力边界/business
Web37
平台公告、变更影响与订阅中心/notice
Web38
个人账号、安全、授权与偏好中心/console/my
Admin
← 店铺设置与渠道治理三步创建应用 →