REITs TechDeveloper
开发文档 7
DOCUMENTATION开发者工作区
从身份、契约到质量发布
更多入口 10
DEVELOPER DIRECTORY业务入口与运行事实
非业务审批和旧刀次已归档，不占当前开发页面
开始接入SSO · Mini App SDK

ARCHITECTURE / 01

全局架构总图

把逻辑边界、生产部署、身份、资源、数据、实时服务、日志、发布和恢复放在同一个架构入口。目标态与运行真值并列展示，避免把规划误认为上线能力。

ARCHITECTURE DOSSIERS

八份可执行的专项架构档案

总图负责全局方向；专项档案负责真正开发。每份都下钻到组件 owner、运行状态、关键时序、接口 guard、数据恢复、故障收敛与 QA 发布门禁。

01mixed
AUTH

身份与访问控制

OTP、JWT、应用会话、设备身份与权限边界

6 components4 contracts打开档案 →
02mixed
MEDIA

资源、包与媒体交付

上传隔离、校验、晋级、下载票据与端侧验证

7 components5 contracts打开档案 →
03running
CONTENT

可信内容与公共知识

来源注册、采集、证据、社区共审与公共发布

6 components3 contracts打开档案 →
04mixed
REALTIME

实时通信与端侧状态

HTTP 会话、WebSocket、消息持久化、Push 与媒体发送

6 components3 contracts打开档案 →
05mixed
ORDER

预约与本地服务交易

发现、发布店铺、容量、预约状态与商家运营

6 components3 contracts打开档案 →
06mixed
QUANT

行情、策略与量化研究

版本化行情、冻结策略、确定性运行、信号与端上展示

10 components7 contracts打开档案 →
07risk
OPS

日志、可观测与恢复

Nginx、systemd、Docker、Loki、Grafana、备份与故障演练

8 components6 contracts打开档案 →
08mixed
DELIVERY

多团队交付与 QA 架构

任务包、契约、UI CI、发布证据、灰度与回滚

7 components3 contracts打开档案 →
REITs TECH · LOGICAL ARCHITECTUREv1.0
01
EXPERIENCE用户与开发者体验层
developer.reits.techwww / bbs / orderMatrix X Chat iOSMatrix Quant iOSMeridian Electron / AndroidOpenAPI Portal
02
DOMAIN领域与控制面
Portal / BBS APIsBooking & Merchantim-core / reits-authMiniapp GatewayQuant Platform
03
TRUST & DATA可信内容与数据面
data-sources RAW 来源池trading-data-source 行情Meridian Polymarket public read / BFFProof / MCP 引用reits-knowledgebacktest 内核
04
PLATFORM共享平台与基础设施
PostgreSQL / MySQL / Redisreits-media / S3 / CDNWebSocket / PushOpenSDKCI / Observability
公共体验 内部控制 状态与数据所有跨层调用必须有 owner + contract + telemetry

DEPLOYED REALITY

生产请求实际经过四层运行栈

所有公共域名、业务服务、数据库、日志和仓库目前汇聚到同一台 EC2。下面是 SSH、Nginx、systemd、Docker 与健康接口共同核实出的部署路径。

HOSTc8i-flex.xlarge

4 vCPU · 7.6 GiB · 单根卷

RUNTIME17 containers

11 个宿主机业务服务，共用一台 EC2

STATE173 GiB · 68%

数据库、Gitea、日志、备份与采集数据同盘

GAPmetrics + recovery

日志链与告警定时器已运行；host/business metrics、根卷治理、单 EC2、异地恢复与消费者证据仍需收口

01

EDGE

DNS · TLS · Nginx

公共域名汇聚到同一公网 IP，由 Nginx 按 host/path 分流；media.reits.tech 已有独立 TLS vhost。
reits / wwwbbsapiauthorderopenapiworkergitealogmedia
02

HOST SERVICES

systemd 业务服务

Go/Node 服务直接运行在宿主机；内部端口由 Nginx 反向代理，11 个相关 systemd 单元当前 active。
access-gatewayreits-auth :8095developer-api :8090miniapp-gateway :8081order :3210data-sources :8080reits-media :8096portal
03

CONTAINERS

Docker 产品与平台

IM、官网、BBS、Gitea、日志栈与 Runner 共用一个 Docker daemon 与根卷；本次回读 17 个容器处于 running/healthy。
im-core :18080portal :3003NodeBB :4567Gitea :3002Grafana :3300Loki :3100Alloy
04

STATE

本机数据库与数据卷

数据库、仓库、日志和采集文件仍以本机 EBS/Docker volumes 为主；业务资产已由 reits-media 交给 S3/CloudFront。
MariaDBPostgreSQLRedisMongoDBIM Postgres/Redis/NATS/MinIOS3/CloudFront assetsXFS / Docker volumes
打开 EC2 逐项盘点

CONTROL PLANES

六个产品与平台控制面

每个框都同时给出稳定责任链和当前生产真值。状态不是宣传口径，而是代码与运行环境对照后的结论。

AUTHdurable / bounded keys

身份与授权

Client / Web / iOSreits-auth 157b859HS256 active/previous ringMySQL sessions + eventsOpen fb1a1b4/fa9283d · Booking 83d31a0

K21 Phase A 已在生产发布 active kid、previous 验证槽与 24h no-kid deadline；developer 门户通过 no-store 安全代理读取实时阶段。K20 的 17/17 allow→revoke→deny 证据继续有效。Phase B secret 轮换、生产 OTP、设备/MFA 与其余消费者仍缺。

MEDIArunning

资源与包交付

Open Platformreits-media :8096S3 quarantinechecksum promotionCloudFront signed ticket

2026-08-11 回读：reits-media.service active，/healthz、/readyz、/meta=200；/meta 声明 S3、CloudFront、business-asset-safe-v1 与 ec2_persistent_asset_bytes=false。消费者旅程和恢复演练仍未收口。

CONTENTrunning

可信内容

Source registrydata-sourcesRAW + documentsreits-bbsreits-info-portal

采集数据、内容快照和 BBS/官网链路已运行，但控制面与公共面边界偏重。

REALTIMErunning

实时通信

Matrix clientsapi.reits.techim-corePostgres / Redis / NATSPush / Media kit

IM Core 容器运行；共享单 EC2，媒体控制面已独立为 reits-media，但仍共用宿主故障域。

MOBILEmixed

Matrix X 生态运行

Main App 257e604PluginRegistryEnterprise 1.0.47Wallet 1.0.22MiniApp 1.0.33OpenAPI Gateway

主 App 的实际 SPM 锁定版本已核实；更高 SDK tag 未消费，钱包宿主路由与小程序可信包链仍需 P0 Gate。

COMMERCErunning

预约与开放能力

Order Webpublic-booking 83d31a0Auth consumerOpenSDKHost products

预约与网关已生产运行；K20 见证了 order-web 会话 allow→revoke→deny，并保持项目/租户 owner 边界；billing 仍为 mock。

QUANTmixed

行情与量化

trading-data-sourcefrozen strategybacktestsim miniappquant-platform targetQuant iOS

行情、回测和端上模拟已有代码；quant-platform 仍是规划仓。

TRUST BOUNDARIES

六个信任区，不把公网、应用和状态画成同一层

每次跨区都必须回答：谁认证、什么 scope、哪份数据、怎样审计、失败后如何收敛。下方同时给出现行控制和缺口。

Z0

Public Internet

Web / iOS / Miniapp clientsSearch & crawlerThird-party source sites

CONTROLTLS、公开限流、无隐式信任

GAP公开 API 的一致限流证据仍不足

Z1

Edge

Nginx :443Host + path routingSecurity group

CONTROL单一入口、端口过滤、基础 header

GAPNginx 与单 EC2 同一故障域

Z2

Application

systemd web servicesDocker business servicesNodeBB / Gateway / Auth

CONTROL应用会话、scope、服务健康

GAPOpen Platform / Booking 已闭环首批授权传播；其余资源服务器、组织角色与统一 decision receipt 未闭环

Z3

Stateful Services

PostgreSQLMongoDB / Redis / NATSLocal package & content files

CONTROL服务内网、业务 owner、备份 timer

GAP状态、日志与备份共用单根卷

Z4

Secrets & Recovery

Environment secretsGitea backupDB dump / package backup

CONTROL宿主机权限、备份清单

GAP没有统一 KMS、异地副本与恢复演练证据

Z5

Operations

SSH operatorsGitea deploy hooksGrafana / CI evidence

CONTROL人工权限、审计页面、发布记录

GAP发布主体、审批和回滚证据尚未统一

ServicePublic entryRuntimeIdentity boundaryOwned stateCalls
reits-info-portalreits.techsystemd / Next.jspublic + operations gatecontent snapshotsBBS · data-sources · MCP
reits-bbsbbs.reits.techDocker / NodeBBNodeBB sessionMongoDB + Redisdata-sources · portal bridge
reits-authauth route :8095systemd / Go · exact 157b859email OTP → persisted session → kid JWTHS256 active/previous ring + memory challenge + MySQL sessions/eventsim-core verification · MySQL · consumers
im-coreapi.reits.techDocker / Godevice + token + MFAPostgreSQL + Redis + NATSpush · media adapter · mobile clients
public-bookingorder.reits.techsystemd / web + API · 83d31a0Auth active order-web + read/write + subject；then project/tenant ownerbooking PostgreSQLAuth · notifications · OpenSDK
miniapp gatewayopenapi.reits.techsystemd / Go + React · fb1a1b4（witness fa9283d）Auth active developer-portal + read/write；then app ownerMySQL + local packageshost clients · package storage
reits-mediamedia.reits.tech :8096systemd / productionsigned upload/download ticketS3 quarantine + CloudFront signed deliveryOpen Platform · iOS
observabilityinternal GrafanaDocker / Alloy + Loki + Grafanaoperatorlocal Loki chunksNginx · Docker · systemd journals

CRITICAL SEQUENCES

六条关键时序把 UI、服务、状态和门禁串起来

架构图只画组件还不够；真正容易出错的是跨边界的步骤、事务点和降级路径。

AUTH

邮箱 OTP、密钥轮换、撤销与消费端判定

  1. 1

    Client + allowlisted route 请求验证码

  2. 2

    reits-auth 限流并由 im-core 校验

  3. 3

    先持久化 session 再由 active kid 签发 JWT

  4. 4

    active/previous/no-kid 有界验证

  5. 5

    业务服务逐请求校验 active/client/scope/subject/object

  6. 6

    revoke 后下一请求 typed deny

RELEASE GATE

K21 Phase A 与 K20 消费端旅程 CURRENT；下一门是 operator-approved Phase B、生产 OTP synthetic 与其余消费者

CONTENT

可信内容发布

  1. 1

    Source registry 授权

  2. 2

    Fetch / Parse / Store

  3. 3

    文档与素材固化

  4. 4

    BBS 候选人工/策略门

  5. 5

    Portal snapshot + citation

RELEASE GATE

来源、data_asof、hash 与纠错状态必须贯穿

MEDIA

资源包发布

  1. 1

    Portal 选择 ZIP

  2. 2

    上传 quarantine

  3. 3

    checksum + scan

  4. 4

    版本签名/promote

  5. 5

    Gateway ticket → Host 校验

RELEASE GATE

当前第 2—4 步仍由 local storage 代替，不能标为完成

ORDER

预约提交

  1. 1

    打开 publish hash

  2. 2

    选择服务与可用时段

  3. 3

    提交客户信息

  4. 4

    容量冲突事务校验

  5. 5

    状态 token / 商家队列 / 通知

RELEASE GATE

提交前后都要处理时段失效、幂等与隐私最小化

IM

实时消息

  1. 1

    HTTP 建立会话

  2. 2

    WebSocket 订阅

  3. 3

    本地 optimistic message

  4. 4

    服务端持久化 + event

  5. 5

    receipt / push / durable replay

RELEASE GATE

媒体发送先走 send-kit；失败状态必须可恢复和可定位

WALLET

钱包资金动作

  1. 1

    Host capability preflight

  2. 2

    冻结金额/币种/收款方

  3. 3

    StrongAuth / payment passcode

  4. 4

    幂等提交支付命令

  5. 5

    receipt + ledger event 对账

RELEASE GATE

示例余额不冒充线上；缺宿主 route、强认证或渠道授权时 fail closed

MINIAPP

小程序可信启动

  1. 1

    Gateway 获取目录版本

  2. 2

    缓存与版本判定

  3. 3

    下载/安全解包

  4. 4

    127.0.0.1 + WKWebView

  5. 5

    Bridge grant / native payment

RELEASE GATE

checksum/签名、origin/bridge allowlist、敏感日志和支付确认进入自动 Gate

QUANT

确定性回测

  1. 1

    选择冻结策略版本

  2. 2

    绑定 data_asof 行情

  3. 3

    提交参数与 seed

  4. 4

    backtest 生成不可变 run

  5. 5

    iOS 展示指标/信号/风险

RELEASE GATE

fixture、live、unavailable 不能混用；不连接交易执行

EDGE + STATE

域名路由和状态存储必须成对看

路由说明请求落到哪里；状态表说明失败后真正要恢复什么。reits-media 已从 target 进入 running，但 S3 对象恢复与消费者票据链仍需证据。

HostPathTargetRuntimeStatus
reits.tech · www/ · /snapshots · /api/operationsreits-info-portal:3003Dockerhealthy
bbs.reits.tech/NodeBB:4567Dockerhealthy
api.reits.tech/healthz · /readyz · /websock/open · defaultim-core:18080Dockerhealthy
api.reits.tech/api/*public-booking-platform:3210systemdhealthy
api.reits.tech/openapi/*miniapp-gateway:8081systemdhealthy
auth.reits.tech/v1/* · /api/*reits-auth:8095systemdhealthy
order.reits.tech/public-booking-platform:3210systemdhealthy
openapi.reits.tech/readyz · /api/* · /openapi/* · /packages/*developer-api runtime fb1a1b4 · gateway · local disk:8090 / 8081systemdrisk
worker.reits.tech/data-sources:8080systemdhealthy
gitea.reits.tech/Gitea:3002Dockerhealthy
log.reits.tech/Grafana:3300Dockerprotected
media.reits.tech/healthz · /readyz · /meta · /v1/*reits-media:8096systemdhealthy

Host MariaDB

Auth Session Registry / OpenAPI
824 MiB + K18 tables

jx_reits_auth.auth_sessions + auth_session_events · jx_im_developer · jx_im_openapi · wukong

Backup · daily dump → local + S3; Auth registry restore drill not proven

Host PostgreSQL

Gitea
4.3 GiB / DB 3.9 GiB

Gitea metadata

Backup · missing from current backup script

Host Redis

Auth / OpenAPI
1 key observed

session/challenge support

Backup · not declared

data-sources data

Content Data
19 GiB + 1.2 GiB backups

crawler state, files and local data

Backup · local backup directory

Gitea Docker volume

Developer Platform
22 GiB

repositories, LFS and Gitea /data

Backup · daily tar → local + S3

BBS volumes

Community
Mongo 524 MiB · uploads 14 MiB

topics/users/uploads + Redis

Backup · not proven in EC2 backup flow

IM volumes

Realtime
Postgres 73 MiB · MinIO 44 KiB

IM state, Redis, NATS, object data

Backup · not proven in EC2 backup flow

Media business assets

reits-media
S3-backed · EC2 persistent bytes=false

business_asset + miniapp_package；CloudFront signed URL delivery；business-asset-safe-v1 policy

Backup · S3/CloudFront boundary；本次未执行对象恢复演练

DATA OWNERSHIP

每类状态只有一个真值 owner，并绑定恢复目标

RPO/RTO 标注为目标，不冒充已实现 SLA；Evidence 栏说明目前能拿出的恢复证据。

Data domainOwnerStoreRPORTOCurrent evidence
Identity challenge / JWT sessionsreits-authin-memory ChallengeStore + HS256 kid key ring + MySQL auth_sessions/eventsdaily MariaDB dump；key escrow/registry restore RPO 未演练restart clears challenges；sessions remain durable；key ring and binary roll back atomically

K21 Auth 157b859 Phase A + live safe metadata + K20 consumers fa9283d/83d31a0 + 17/17 witness

IM messages / membership / receiptsim-corePostgreSQL + Redis/NATS≤15m target≤2h target

durable replay 有代码；跨机恢复未演练

Workspace / Moments / Wallet ledgerim-core domain ownersPostgreSQL + service caches按资金/社交域独立定义按域 target

客户端路由与 API 已核实；资金账本恢复和 owner 清单仍需生产证据

Bookings / merchant / capacitypublic-bookingPostgreSQL≤1h target≤2h target

本机备份；恢复包未统一

Source documents / media / run logsdata-sourcesPostgreSQL + local files≤24h target≤8h target

后台有备份恢复面；需自动演练

Community topics / profiles / moderationreits-bbsMongoDB + Redis≤24h target≤4h target

NodeBB 状态与自定义审计需成组恢复

Miniapp manifests / versions / packagesminiapp-open-platformPostgreSQL + local files≤1h target≤4h target

reits-media 未部署，checksum 不是异地备份

Git repositories / release definitionsGiteaPostgreSQL + repositoriestimer snapshotmanual

有本机备份；缺离机恢复验证

Logs / deployment evidencePlatform OpsLoki + journalsbest effortN/A

4 天本机链路；缺异地保留与统一告警

FAILURE DOMAINS

从单点故障看爆炸半径、检测和收敛

当前生产最需要解决的不是再画更多理想服务，而是把单 EC2、单卷、Auth 和本地包存储的爆炸半径降下来。

P0

EC2 instance

IMPACT
全部公共域名与内部服务同时不可用
DETECTION
external health + SSH
CONTAINMENT
无跨机隔离
NEXT CONTROL
拆 Edge/State，建立替换实例与恢复 runbook
P0

Root EBS volume

IMPACT
数据库、Gitea、包、日志和备份同损
DETECTION
disk / fs / backup checks
CONTAINMENT
同盘备份不能覆盖卷故障
NEXT CONTROL
独立数据卷 + 异地对象存储 + restore drill
P1

Nginx / certificate

IMPACT
所有公共 host 入口中断
DETECTION
TLS / route smoke
CONTAINMENT
应用可能健康但不可达
NEXT CONTROL
配置测试、证书预警、可回滚 edge bundle
P0

Auth / session / signing key

IMPACT
Registry 故障使保护操作 fail-closed；key-ring 配置错误可能阻断新签发或现有 token；未纳入矩阵的 consumer 仍可能遗漏撤销
DETECTION
K21 safe key meta + readiness + unknown-kid negative；K20 17/17 witness
CONTAINMENT
Phase A 有界 no-kid；binary/env 原子回滚；公共只读面继续；已覆盖服务无正向撤销缓存
NEXT CONTROL
K22 operator-approved Phase B、扩消费者与生产 OTP synthetic
P1

Mongo / Redis / NATS

IMPACT
社区或 IM 的实时/缓存/队列能力降级
DETECTION
dependency health + replay lag
CONTAINMENT
按领域分级降级
NEXT CONTROL
为无缓存、无队列、重连分别定义 SLO
P0

Local package storage

IMPACT
新包发布与客户端包下载受阻
DETECTION
checksum / ticket smoke
CONTAINMENT
已缓存包可继续运行
NEXT CONTROL
部署 reits-media，隔离 quarantine 与 immutable assets

OBSERVABILITY + RECOVERY

从日志进入发布证据和恢复能力

可观测不是 Grafana 一个框；恢复也不是备份定时器一个框。这里把采集、存储、查看、部署证据和备份范围放进同一条责任链。

Nginx JSON access→file tail→Grafana Alloy→Loki→Grafana
Docker stdout/stderr→Docker socket→Grafana Alloy→Loki→Grafana
systemd journal→journal source→Grafana Alloy→Loki→Grafana

BBS / Data / Portal

~1 minute
  1. SourceGitea main
  2. Executorsystemd timers
  3. TargetDocker / systemd
  4. Evidencecurrent-sha files

Order

~5 minutes
  1. SourceGitea main@83d31a0
  2. Executorreits-order-auto-deploy
  3. Targetsystemd :3210
  4. Evidenceexact release + Auth readiness + K20 witness

OpenAPI

~1 hour
  1. SourceGitea main/witness@fa9283d · runtime@fb1a1b4
  2. Executorreits-openapi-autodeploy
  3. Targettwo systemd services
  4. Evidenceexact runtime build + separate K20 witness source + MySQL/Auth readiness

Auth

manual
  1. SourceGitea main@157b859
  2. Executoroperator config/store preflight + immutable release
  3. Targetsystemd · 127.0.0.1:8095
  4. Evidencesource = production · K21 Phase A safe smoke/meta · MySQL 2/2 ready · env/current rollback set

EC2 backup

daily 03:00 UTC
  1. SourceMariaDB + Gitea /data
  2. Executorec2-backup.timer
  3. Targetlocal + S3
  4. Evidencegzip integrity only
01P1

Auth 当前 productionSafe + OIDC ready，但 knife 仍为 6/7

2026-08-11 Auth /v1/meta=200，productionSafe=true、OIDC ready=true、13 个 client、11 个 machine client；密钥轮换、生产 OTP synthetic、设备/MFA 与其余消费者仍不能直接标为完成。

02P1

首批消费端受控旅程已闭环，全生态与生产 OTP 仍未完成

K20 已用 Open Platform fa9283d 与 Booking 83d31a0 的真实 consumer 代码完成 17/17 allow→revoke→deny 断言，且无正向撤销缓存；OpenSDK 与其他资源服务器仍需逐项进入同一 consumer matrix，经授权的生产 OTP journey 尚未执行。

03P0

资源控制面已运行，但消费者与恢复证据仍未收口

reits-media.service active，healthz/readyz/meta 均为 200；/meta 明确 storage=amazon-s3、delivery=cloudfront-signed-url、business-asset-safe-v1、ec2_persistent_asset_bytes=false。仍需逐一完成 OpenAPI/Gateway/iOS 消费端票据旅程和对象恢复演练。

04P0

当前备份无法完整恢复 Gitea

备份包含 MariaDB 和 Gitea /data tar，但 Gitea 实际使用的宿主机 PostgreSQL 约 3.9 GiB 未被 dump；BBS 与 IM 数据卷也未进入这条备份链，脚本还包含应迁移到受管密钥存储的硬编码凭据。

05P0

单 EC2 是全生态共同故障域

Edge、Auth、IM、官网、BBS、Order、OpenAPI、数据库、日志和 Gitea 共用一个实例、一块根卷与一个 Docker daemon。

06P1

日志可查询，但没有异地副本

Alloy → Loki → Grafana 容器仍在运行且 Grafana 入口受保护；当前架构仍未证明异地日志副本，实例或根卷故障会同时丢失服务和诊断证据。

07P1

当前是日志链 + 操作守卫，不是完整指标平台

2026-08-12T02:30:16Z 的 EC2 只读盘点确认没有 Prometheus、node_exporter、cAdvisor、Alertmanager 或业务指标进程；data-sources /metrics=401，developer-api/Auth/Media /metrics=404，Loki /metrics 与 Grafana /api/health 仅服务级证据。C03 因此继续保持 ACTIVE。

08P1

发布证据格式仍未统一

Auth 已用 immutable release 绑定 source/production exact SHA；Order/OpenAPI 的 build SHA 仍来自健康接口，其他服务的 current-sha、制品摘要、回滚与审批记录格式不一致。

09P1

根卷容量已越过 WARNING，必须持续治理

2026-08-12T02:30:16Z 只读采集为 173/256 GiB、68%、83 GiB 可用，超过 65% WARNING 线但未到 75% HOLD 线；受控发布器仅清理暂存制品，未触碰业务数据。仍需按 release、日志、备份、Docker 镜像分别设置保留策略；禁止把业务资产回迁到 EC2。

10P1

Runner 已有 workflow 成功证据，但 Gitea 管理端点不暴露计数

gitea-runner.service active，Runner 相关容器在运行；data-sources PR #9 的 run 77303 completed/success，main run 77453 completed/success。Gitea 1.27.0 的 admin runners 端点返回 HTTP 404，因此组织级 Runner 数量仍不能从该端点宣称。

DEPENDENCY CONTRACTS

项目依赖不是一根线，而是一份契约

依赖表只表达稳定输入输出；部署拓扑和实现细节由各仓维护。每份契约还要进入 QA 追踪链。

生产方稳定契约消费方
data-sourcesRAW 来源、文档、素材、发布候选reits-bbs
reits-bbs互动、机构回答、可信候选reits-info-portal
im-core身份、HTTP/WS、Push、状态matrix-x-chat-ios
im-media-send-kit媒体准备、hash、分片、QAmatrix-x-chat-ios
IMEnterprise / IMWallet / IMMiniAppSPM 锁定版本、插件 UI 与宿主协议Matrix X PluginRegistry
matrixantai-backtest冻结策略与确定性运行记录matrixantai-sim
matrixantai-sim离线 miniapp bundlematrix-x-chat-ios
reits-auth应用会话、subject 与 scopesBooking / Open Platform
reits-media不可变资产、checksum、下载票据Miniapp Gateway / iOS
trading-data-source版本化行情目录与 K 线切片Backtest / Quant Platform
public-booking-platform预约、商户、订单与宿主契约OpenSDK / Quant iOS
miniapp-open-platform签名版本、包 hash 与能力声明Matrix X / Quant iOS
quant-platform策略、运行、信号与权益（目标）Matrix Quant iOS
reits-knowledgeADR、规则、QA、运行手册全部项目
全部项目manifest、route、token、CI evidencedeveloper-portal
Q1Requirement / risk→
Q2Screen ID + UI state→
Q3API / event contract→
Q4Fixture + automated test→
Q5Build + deployment digest→
Q6Production smoke + telemetry
打开 QA 架构与项目覆盖矩阵

END-TO-END

端到端链路

每条链路都从可审计输入开始，以明确用户价值和发布证据结束。

01

可信内容主链

  1. 官方披露/API
  2. data-sources 采集与合规
  3. BBS 机器人动态与共审
  4. 官网编辑/质量门禁
  5. 全球/国家/资产聚合
02

即时通讯主链

  1. Matrix X / Quant iOS
  2. im-core HTTP/WS
  3. PostgreSQL/Redis
  4. Push/Realtime replay
  5. 设备端状态收敛
03

预约交易主链

  1. 发现/店铺
  2. 预约与自助管理
  3. 商户审核/排班
  4. 订单/支付/通知
  5. 归因与发布证据
04

小程序发布主链

  1. 开发者应用
  2. reits-media 直传
  3. ZIP 完整性验证
  4. 版本发布/Gateway
  5. iOS 验 hash 后运行
05

端上模拟主链

  1. trading-data-source
  2. 冻结策略
  3. deterministic backtest
  4. quant-platform 目标服务
  5. Quant iOS / miniapp
06

Meridian 公开只读纵切

  1. Polymarket Gamma / CLOB GET
  2. GET-only adapter
  3. loopback read BFF
  4. 共享只读合同与 fixture
  5. Electron / Android
  6. Build Observatory 证据
07

协作治理主链

  1. 知识库决策
  2. 机器清单
  3. 任务包/Owner
  4. 代码与契约
  5. CI 证据
  6. 门户自动更新

ARCHITECTURE RULES

六条不可绕过的架构规则

R1

边界

项目通过版本化契约协作，不跨仓引用业务源码。

R2

真值

运行状态归业务数据库；架构状态归 machine manifest；决策归 ADR。

R3

安全

认证、发布、上传、支付和人工写入门默认 fail-closed。

R4

数据

所有公开内容保留来源、时间、授权/合规状态和不可变 hash。

R5

发布

公共体验、内部运营和后台任务使用独立 owner 与爆炸半径。

R6

演进

先保持外部契约，再拆巨型文件与内部领域边界。