REITs TechDeveloper
开发文档 7
DOCUMENTATION开发者工作区
从身份、契约到质量发布
更多入口 10
DEVELOPER DIRECTORY业务入口与运行事实
非业务审批和旧刀次已归档，不占当前开发页面
开始接入SSO · Mini App SDK
UI 蓝图/开放平台 · 商业与数据/组织财务、结算与对账
TARGETF4B2 PARTIALQA 0/5 VERIFIEDR09 · 10/21 PASS COMPLETEAdmin · 查看按币种余额、结算、费用、账本、发票和对账例外的组织财务与安全人员

组织财务、结算与对账

按币种呈现双分录账本、Provider settlement 证据和对账例外，不用仪表盘汇总或跨币种伪总额替代财务真值

/console/financeminiapp-open-platform
R09 · KNIFE 10 / 21

财务、总账与结算 · 页面级细化任务包

分开 Provider event、Payment state、双分录 Ledger、Settlement、Payout 与 Reconciliation exception；不同币种永不直接相加。

CURRENT / TARGET ROUTE

SPA fallback 200 / React route 0 / ledger & settlement model 0 → /console/finance

DOMAIN / SLICE

commerce · K09C

ENTRY

从 Payment evidence、异常或财务期间进入；当前只可查看目标 schema 与 Booking dry-run posture。

SUCCESS OUTPUT

打开 immutable ledger/settlement evidence 或创建 exception investigation receipt；不能手工改余额。

COMMAND MODEL

Verified payment event → ledger posting transaction → settlement import → reconciliation → exception workflow → period close。

RESPONSIVE + A11Y

桌面按币种的 balance/evidence tabs；手机先显示期间、币种和完整性，禁止用总 KPI 合并币种。

TELEMETRY

finance_contract_view · period_schema_open · exception_plan_submit；不记录账户、银行、原始 Provider payload。

CURRENT SOURCE + PRODUCTIONfb1a1b / 6f3e62a / 157b859
  • miniapp-open-platform source fa9283d / production fb1a1b；Developer Portal 只有 `/login`、`/apps`、`/apps/new`、`/apps/:id/publish` 四个 React route
  • openapi.reits.tech 对未知前端路径返回 SPA index HTTP 200，但 React Router 没有 K09C/K09D/K09E route component；200 fallback 不是页面已实现
  • Developer API 只有 4 张业务表；没有 PaymentOrder、Consent、DSR、Ledger、Settlement、Announcement、Subscription 或 PersonalSecurity 聚合模型
  • public-booking-platform source/production 6f3e62a；2026-07-18 生产 `/api/billing/paid-cta` 仍为 status=needs-provider-setup、score=20、cards=3、enabled=0、livePreview=0
  • 推广包当前 billingMode=mock、checkoutMode=none、checkoutConfigured=false、webhookAutoConfirm=false；3 个 JPY package 是 Booking 发现推广，不是开放平台通用支付
  • Booking 源码有 owner-only billing setup/QA/dry-run reconciliation/webhook intake；生产 `/api/ops/billing` 未登录返回 401，仍没有双分录 ledger 或通用 Open Platform PaymentOrder
IMPLEMENTATION GAPTARGET ONLY
  • 没有 LedgerAccount/LedgerEntry/Journal/Balance API
  • 没有 SettlementBatch/Payout/ReconciliationException/period close
  • Booking dry-run reconciliation rows不是财务真值或开放平台账本
SPA fallback 200、静态 MVP docs、相邻 Booking billing 与 Auth/IM 合同都不是这些 Open Platform 页面已经实现的证据。
99-STATE PROGRAM / THIS SCREEN

十一页分别改变支付、数据、声明、内容、申请与身份责任域

QA 0 / 5 VERIFIED
READYLedger & Settlement 合同可以评审

Ledger & Settlement current/target split

R09-FINANCE-READY→ 查看 ledger schema
LOADING正在核对 Ledger & Settlement 证据

Ledger & Settlement independent sources

R09-FINANCE-LOAD→ 保留当前上下文
EMPTY开放平台尚无财务总账与结算模型

Ledger & Settlement index

R09-FINANCE-EMPTY→ 查看实现缺口
PARTIAL ERRORLedger & Settlement 部分证据未知

Ledger & Settlement evidence rail

R09-FINANCE-PARTIAL→ 只重试失败来源
ERRORLedger & Settlement 请求未完成

Ledger & Settlement request

R09-FINANCE-ERROR→ 安全重试
OFFLINE离线只读 · Ledger & Settlement

Ledger & Settlement redacted snapshot

R09-FINANCE-OFFLINE→ 重新连接
FORBIDDEN没有查看或管理 Ledger & Settlement 的权限

Ledger & Settlement authorization

R09-FINANCE-DENY→ 返回公开或安全页面
CONFIRM确认创建财务例外调查或关账计划？

Ledger & Settlement command impact

R09-FINANCE-CONFIRM→ 确认并提交
SUCCESS财务调查计划已登记

Ledger & Settlement receipt

R09-FINANCE-SUCCESS→ 查看回执
R09 BOUNDARY本刀只细化 developer.reits.tech 的 Commerce、Data Governance、Public DX 与 Personal Security 目标 UI；不创建支付/退款/账本/结算，不提交 KYB 或合作申请，不导出/删除用户数据，不注册公告订阅，不撤销真实会话，也不把 Booking mock promotion、dry-run billing、SPA fallback 200、静态 MVP docs、Auth session schema 或 IM device API 冒充为 Open Platform 产品能力。
UI STUDIOtarget-open-finance
Admin1440 × 900100%
100%
/console/finance
TARGET UI1440 × 900FIT 100%
R09 DESIGN CANDIDATEtarget-open-financeTARGET ONLY · API PROBE 404
OPEN PLATFORM / R09Commerce & Data Governance
R9
FINANCE CONTROL · TARGET ONLY

财务、结算与对账

Open Platform 当前没有内部账本、余额、结算或 payout。目标页先明确双分录、Provider 外部证据、币种隔离和例外处理，不展示任何假金额。

!
CURRENT / ADJACENT / TARGET 必须分轨Open Platform production fb1a1b：4 个控制台路由、1 页静态文档、10 个列出 endpoint；finance 目标 API 探测 404。Booking production 6f3e62a 只作为相邻 billing readiness 证据。
i
没有真实账本，就没有可展示余额Booking dry-run reconciliation 是准备度工具，不是 JournalEntry、Settlement 或可支付余额；跨币种总额也不得由 UI 临时换算。
SSGD balanceLedger account · not implemented
— SGD
Available unknownPending unknown
JJPY balanceLedger account · not implemented
— JPY
Available unknownPending unknown
UUSD balanceLedger account · not implemented
— USD
Available unknownPending unknown
Target ledgerSettlementsProvider evidenceExportsExceptions 0
Target objectOwnerSourceAuthorizationEvidenceStatus
LedgerAccountfinance servicenot implementedserver-enforced0 fixtures TARGET
JournalEntryfinance servicenot implementedserver-enforced0 fixtures TARGET
Settlementfinance servicenot implementedserver-enforced0 fixtures TARGET
SettlementLinefinance servicenot implementedserver-enforced0 fixtures TARGET
ReconciliationRunfinance servicenot implementedserver-enforced0 fixtures TARGET
FinanceExportfinance servicenot implementedserver-enforced0 fixtures TARGET
0 settlements · 0 journals · 0 balances
未来高风险动作MFA + independent approver + limits + destination fingerprintrequest → approve → execute → reconcile → receiptNOT IMPLEMENTED
REFERENCE VIEWPORT1440 × 900Desktop first · responsive
PRIMARY TASK选择币种主操作、权限与完成反馈必须同屏可验证
DATA CONTRACTLedgerAccountready / 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

页面区域

  • 组织与 as-of 上下文
  • 财务任务头
  • FX 报告边界
  • 按币种余额卡
  • 财务分区导航
  • 结算表格
  • 对账/Journal 详情
  • 高风险动作门禁
02

用户动作

  • 选择币种
  • 打开 Settlement
  • 调查对账例外
  • 查看 Journal
  • 导入 Provider 证据
  • 创建财务导出
  • 配置报告币种
  • 请求 payout 审批
03

必须状态

  • 财务读模型就绪
  • 余额与结算加载
  • 尚无财务活动
  • Provider/账本部分失败
  • 财务查询失败
  • 离线只读快照
  • 缺少 finance:read
  • Payout/导出确认
  • 财务命令已受理
04

数据契约

  • LedgerAccount
  • JournalEntry
  • LedgerEntry
  • OrganizationBalance
  • Settlement
  • Payout
  • ReconciliationException
  • AuditReceipt

TARGET MODULES

目标页面必须交付的模块

  1. 01账本模型 0 证据
  2. 02空币种余额槽
  3. 03目标对象目录
  4. 04Provider evidence 边界
  5. 05双分录合同
  6. 06dry-run 非账本声明
  7. 07Reconciliation 状态机
  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
← 支付能力申请与独立复核公共开发者首页与能力总览 →