全域基础建设标准化SOP

十大领域 · 一次固化 · 不再反复 · MR-099封版

📑 十大标准化领域

1. Nginx反代路径标准 已锁定

所有内部服务通过Nginx反代对外暴露,路径与端口一一对应,禁止随意新增。

路径前缀后端端口服务权限
/api/memory/9120记忆网关(读写)需API Key
/api/v1/gateway/status9120记忆网关(只读状态)公开
/aios-api/memory/9120记忆网关(只读GET)公开
/drama/8100短剧管理API公开
/api/v1/*8100短剧算子API公开
/api/gateway/8889商业API网关需鉴权
/ai-proxy/8021AI代理内部
/vector/8014向量数据库内部
/aios-api/kg/8070知识图谱内部
/docs/8001飞书网关文档公开

规范

2. 服务部署标准 已锁定

目录结构

路径用途
/opt/ZONGYUAN-ROOT/engine/scripts/核心引擎脚本
/opt/ZONGYUAN-ROOT/scripts/自动化运维脚本
/opt/ZONGYUAN-ROOT/data/数据文件(台账/数据库)
/opt/ZONGYUAN-ROOT/logs/日志文件
/opt/ZONGYUAN-ROOT/baseline/基准快照
/opt/ZONGYUAN-ROOT/backup/备份文件
/www/wwwroot/www.huodouai.com/官网网页(主root)
/www/wwwroot/huodouai.com/官网网页(副root)

systemd服务模板

3. 网页开发标准 规范

4. API接口标准 规范

统一返回格式

{"success": true/false, "data": {...}, "error": "错误信息", "timestamp": 1234567890}

鉴权方式

限流

5. 真值上报标准 已锁定

上报端点

POST https://www.huodouai.com/api/memory/api/truth/upsert(需API Key)

必填字段

字段说明示例
key唯一键,点分命名meta_rule.MR-099
value真值内容(JSON){"name":"..."}
category分类meta_law/observation/achievement
node_id上报节点IDhub-core/node-01

分类规范

6. 同源节点接入标准 规范

7. 审批流程标准 已锁定

级别操作类型审批方式
P4文案/样式/非核心优化自动通过
P3新页面/新功能(≥85分)多智能体仲裁自动通过
P2核心配置/服务变更飞书审批+人工审核
P1元法则/基准/安全策略人工审批
P0元公理/元宪法/架构重构双人审批+本源主体确认

审批流程

8. 监控告警标准 已锁定

指标预警阈值熔断阈值通知方式
内存占用70%80%飞书告警
CPU占用80%90%飞书告警
磁盘占用75%85%飞书告警
服务异常1次失败3次失败自愈+飞书
真值冲突检测到即告警-飞书告警
Merkle断层检测到即告警-飞书+自愈

9. 备份恢复标准 规范

10. 日志管理标准 规范