千星矩阵 · 小河基地 采集网关

数据底座写入管道 · append-only + 三级哈希链 + 企业微信实名 · 节点 YZT-XH · v0.1.0
控制台
交互式 API 文档 (Swagger)
在浏览器里直接测试全部接口
API 参考 (ReDoc)
结构化接口说明文档
健康检查
服务与数据库连通性
OpenAPI 描述
机器可读接口契约
写入接口 · 第一批 13 张表单
POST /api/v1/batches
批次建档
POST /api/v1/water/auto · manual
水质自动采集 / 人工检测
POST /api/v1/environment
棚内光照 / 气温
POST /api/v1/equipment
设备运行与能耗
POST /api/v1/operations
投菌/海盐/纳米气泡等(实名)
POST /api/v1/fish-metrics
鱼体 T0/T30 指标
POST /api/v1/lab-reports
第三方检测报告归档
POST /api/v1/abnormal-events
异常事件与批次冻结
POST /api/v1/staff
企业微信实名身份绑定(admin)
封板与审计
POST /api/v1/seal/daily
日结封板(行→日, admin)
POST /api/v1/seal/batch
批次封板/冻结(批级, admin)
GET /api/v1/verify/{table_id}
不可篡改链校验(staff)
读路径 · 客户证据包(脱敏只读)
客户证据包样例页
单批次脱敏证据 + 逐链验真(可视成果)
GET /api/v1/evidence/{batch_id}
证据包 JSON 接口
读路径 · 政府监管大屏(脱敏聚合)
政府监管大屏
暗色大屏: 批次/水质时效/合格率/封板覆盖/出境留痕
GET /api/v1/dashboard/gov
监管聚合 JSON 接口
读路径 · 科研控制台(内部受控, 需令牌)
科研控制台
批次对比 · T0→T30 转化 · 水质趋势 · 根因(需 ?token=)
GET /api/v1/research/*
批次清单/深钻/对比 JSON 接口(staff)
读路径 · 现场任务板(任务驱动闭环, 需令牌)
现场任务板
未闭环异常/待审/采样缺口/溶氧告警按优先级派工(需 ?token=)
POST /api/v1/taskboard/ack
任务实名签收回执(append-only 闭环)
CELSS/OA² 特征闭环(可复算可验真, 需令牌)
POST /api/v1/features/compute/{batch_id}
确定性特征计算+血缘哈希+版本化(admin)
GET /api/v1/features/{batch_id}/verify
以当前源复算验真, 检出篡改/漂移(staff)
跨境出境闸门 · 数据主权红线(admin)
POST /api/v1/traceability/publish
发布脱敏溯源快照(出境前置审批)
GET /api/v1/export/batch/{batch_id}
默认拒绝 + 白名单组包 + 黑名单扫描
GET /api/v1/export/audit
出境同步审计(放行/拦截均留痕)
GET /api/v1/export/selftest
闸门自检: 黑名单字段拦截演示
鉴权: 写入/封板接口需请求头 X-API-Token(device 自动采集 / staff 人员 / admin 管理)。令牌由 scripts/mint_token.py 离线签发。
四条红线: 原始数据永不可覆盖 · 边缘即真理源 · 一个底座四种只读视图 · 数据主权境内焊死