Skip to content

docs(architecture): Lingow 架构总览 - #165

Open
Gwen317 wants to merge 6 commits into
1024XEngineer:devfrom
Gwen317:codex/architecture-overview
Open

docs(architecture): Lingow 架构总览#165
Gwen317 wants to merge 6 commits into
1024XEngineer:devfrom
Gwen317:codex/architecture-overview

Conversation

@Gwen317

@Gwen317 Gwen317 commented Jul 31, 2026

Copy link
Copy Markdown

变更说明

  • docs/ARCHITECTURE.md 重构为面向评审和汇报的架构总览
  • 全文优先使用中文白话,将控制面、媒体面、幂等、补偿等术语改写为“业务管理服务、实时语音服务、重复请求只执行一次、失败后继续收尾”
  • 将英文核心对象图改为账户、会话、说话人、对话记录、用量和消息的中文关系图
  • 明确两个后端服务的系统边界和五个业务模块
  • 说明首期单 API 实例为什么可以支撑较多会话,以及单实例的可用性边界
  • 说明实时语音服务为什么按同时在线会话数部署多台,并明确一场会话固定在同一节点
  • 增加共享会话路由目录、节点健康与容量信息、分配编号和故障重连方案
  • 以“谁记哪本账”的方式说明会话状态、实时状态、节点归属、最终文字和用量如何保持一致
  • 区分已实现的数据库锁、操作编号和防重复机制,与尚未实现的节点注册、心跳、节点路由、通行证绑定和旧节点写入拦截
  • 以用户故事说明核心链路和分方向的手机显示/语音播放策略
  • 使用“声音切成小包上传、凑成一句、译文语音边生成边下发”解释实时音频链路
  • 保留研发代码对照表,技术方法名和编码格式不要求在汇报时讲解
  • 记录技术选择、系统质量要求、当前实现状态和未决风险

验证

  • git diff --check -- docs/ARCHITECTURE.md
  • 核对 Markdown 文档代码围栏和引用文件
  • 核对固定 REALTIME_BASE_URL、节点内存状态、实时通行证字段和现有防重复代码
  • 核对分支基于最新 upstream/dev,且 PR 仅包含 docs/ARCHITECTURE.md

本次仅修改文档,未运行本地代码测试;仓库 CI 负责执行相关测试矩阵。

@github-actions

github-actions Bot commented Jul 31, 2026

Copy link
Copy Markdown

Go coverage

Scope Current Baseline Delta
packages/contracts 86.4% 86.4% +0.0%
services/api 55.2% 55.1% +0.0%
services/realtime-audio 77.3% 77.3% +0.1%
Total 63.7% 63.7% +0.0%

Base branch: dev · Commit: 0b9c99d · Test workflow run

@jinyu918 jinyu918 changed the title docs(architecture): 重写 Lingow 架构总览 docs(architecture): Lingow 架构总览 Jul 31, 2026
fennoai[bot]

This comment was marked as resolved.

Comment thread docs/ARCHITECTURE.md Outdated
@Leon-Dicaprio

This comment was marked as resolved.

Comment thread docs/ARCHITECTURE.md Outdated
Comment thread docs/ARCHITECTURE.md Outdated
Comment thread docs/ARCHITECTURE.md Outdated
@Gwen317
Gwen317 force-pushed the codex/architecture-overview branch from f4e29d3 to 799c528 Compare August 1, 2026 03:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants