D3 · Architecture · v1.0 Kickoff

D3 · 架构级文档

Xisound System / Backend / Frontend / DSP / Data-Model / Protocol / Deployment Topology

7

子目录

33

old-arch-doc 待整合

1

部署拓扑（本期新建）

D3 · 架构级文档总览

摘要

D3 · 架构级是 Xisound 文档体系七层分治中的第四层，定位跨产品 / 跨栈的系统级架构文档。主要来源：整合 old-arch-doc/ 的 33 份早期设计稿（System / Backend / Frontend / DSP / Data-Model / Protocol 6 大主题）+ 新建 deployment-topology 部署拓扑。与 D2（产品级）的区别：D2 讲产品，D3 讲架构；产品可以跨架构，架构可以被多产品复用。

整理批 2 完成（2026-05-06）

已从 old-arch-doc/ 迁入 26 份定稿（D3 13 份 + D4/dsp-algo 13 份）· _legacy_arch_drafts/ 归档 8 份 v5/v6/重复草稿 · mkdocs build 零 WARNING。 7 大子目录的主文档状态由 🟡 骨架升级为 ✅ 已建（主文档到位 · 次要辅助文档仍 🔴 新建）。

1. 七大子目录

#	子目录	主题	主要来源	状态
1	`system/`	全局系统架构 · 模块交互 · 总揽图	old-arch-doc/deployment/System_Architecture.md v7（1280 行）	✅ 已建
2	`backend/`	C# 后端架构 · Controllers · WebSocket · AIAgent	old-arch-doc/deployment/Backend_Architecture.md	✅ 已建
3	`frontend/`	Vue 3 前端架构 · Pinia · Components	old-arch-doc/deployment/Frontend_Architecture.md	✅ 已建
4	`dspalgo/`	DSP 算法库架构 · 数据流 · 模块注册	old-arch-doc/deployment/DSPAlgo_Architecture_v6.md（实为 v7 · 2440 行）	✅ 已建
5	`data-model/`	全局数据结构 · 参数协议 · 持久化 schema	old-arch-doc/doc_ref/DataStructure_Reference.md · data_model_and_arch_v2.md	✅ 已建
6	`protocol/`	WebSocket 协议 · 参数协议 · gRPC schema	old-arch-doc/doc_ref/Protocol_Design.md · api/*	✅ 已建
7	`deployment-topology/`	部署拓扑 · 进程模型 · 端口约定 · M6.1 部署方案	本期新建（07_web M6.1 挂此处）	✅ 已建

2. D3 与其他层的关系

flowchart TB
    D1[🏢 D1 · 中心章程<br/>B研发中心规范] --> D3
    D2[📦 D2 · 产品矩阵<br/>10 产品 × 12 模板] --> D3
    D3[🏛️ D3 · 架构级<br/>本层] --> D4[🔧 D4 · 实现级<br/>代码 1:1 mirror]
    D3 --> D6[🧪 D6 · 测试与运维]

    classDef xyL0 fill:#6B3FA0,stroke:#6B3FA0,color:#fff
    classDef xyL2 fill:#A83F88,stroke:#A83F88,color:#fff
    classDef xyL3 fill:#DFA66D,stroke:#DFA66D,color:#fff
    class D3 xyL0
    class D1,D2 xyL2
    class D4,D6 xyL3

3. 与 old-arch-doc/ 的对应（33 份 → D3 + D4）

详见《技术开发文档体系方案 v1.0》§4.1 映射表。

迁入 D3：约 10-12 份（系统 / 架构 / 数据模型 / 协议类）
迁入 D4：约 15 份（9 大 DSP 模块 + 实现细节）
归档：约 6-10 份（v5/v6 草稿 → _legacy_arch_drafts/）

4. 版本演进

版本	日期	变更
v1.0-draft	2026-05-06	D3 顶级骨架建立 · 7 子目录 index 占位 · 等待整理批 2 迁移内容
v1.1	2026-05-06	整理批 2 完成 · 26 份定稿从 old-arch-doc/ 迁入 · 7 子目录状态 🟡 → ✅ · status: draft → published