Molo
技术与接口交付说明
比赛版以本地 HTML、确定性 Mock 与浏览器存储完成可演示闭环；本页把当前实现、生产化接口边界、数据对象和安全约束明确分开，不把 Mock 包装成真实后端。
运行架构
技术物料视觉证据
以下图片是随包交付的架构表达，用于把服务器运行拓扑与数据库血缘从抽象字段变成可核验物料；比赛版仍不宣称已经连接真实后端。
Server Architecture网关、服务集群、健康检查与运行环境的视觉化交付。
1672 × 941 · TECH
Database LineageSchema、迁移、回滚和数据血缘的视觉化交付。
1672 × 941 · TECH本地状态契约
| 存储键 | 范围 | 保存内容 | 重置方式 |
|---|---|---|---|
molo-demo-auth | sessionStorage | admin/admin 演示登录状态 | 点击右上角退出 |
molo-q1-workflow-v3 | localStorage | 八节点进度、需求状态、CHG-028 更新结果、自定义需求 | 使用 ?demo=1 回到确定性演示态 |
molo-lingo-retro-meeting | localStorage | 复盘主题、目的、参会人、分享链接、接受与参会回执 | 在 LinGo / Molo 演示中重新发起会议 |
生产化 API 适配契约
以下为从当前本地状态机迁移到真实服务时的建议接口，不代表比赛版已经部署这些服务。
| 方法与路径 | 用途 | 核心输入 | 核心输出 |
|---|---|---|---|
POST /requirements | 创建需求 | title, goal, priority, owner, dueAt | requirementId, version, stage |
POST /requirements/{id}/transitions | 推进或打回阶段 | from, to, actor, reason, evidenceIds | stageRecord, downstreamTasks |
POST /requirements/{id}/changes | 发起需求变更 | description, urgency, author | changeId, impactedArtifacts |
GET /requirements/{id}/lineage | 查询物料谱系 | requirementId, version | PRD / Frame / UI / Build / API / QA 节点 |
POST /deliverables | 上传交付物 | role, requirementId, file, url, notify | artifactId, sha256, version, status |
POST /bugs/{id}/transitions | 缺陷流转 | status, owner, build, evidence | bugRecord, releaseGate |
GET /projects/{id}/risks | 风险预警 | progress, workload, throughput, blockers | score, causes, impact, mitigations |
POST /retrospectives | 创建复盘 | signals, attendees, purpose, evidence | meetingThread, actions, owners |
核心数据对象
Requirementid · title · stage · owner · progress · dueAt · version
StageRecordenteredAt · exitedAt · actor · decision · reason · evidence
ArtifactLinktype · anchor · beforeVersion · afterVersion · owner · confirmation
ChangechangeId · description · impactedArtifacts · syncStatus · trace
HandoffsubmittedAt · notifiedAt · acceptedAt · slaHours · impactDays
Retrospectivesignals · burndown · memberTime · actions · meetingStatus
权限、安全与生产边界
交付结论：当前版本完整证明产品交互、状态模型和端到端协作闭环；真实数据库、文件服务、消息总线、设计平台、代码仓库与 CI/CD 属于生产适配层。