atorbit

atorbit 是一个围绕 DSA、DSC、DSM 的工程仓库。

当前仓库已完成 DSA Phase 2 的核心伪代码沉淀；后续文档与伪代码将继续补齐 DSC、DSM 以及双侧 SDK，目标是把 DSA / DSC / DSM 的完整功能链路打通。

工程定位

• atorbit 被视为 atframework 体系内的组件工程，而不是独立风格的孤立项目。
• 正式实现将直接复用仓库内 atframework/ 下的 submodule，包括 atframe_utils、libatbus、libatapp 和 cmake-toolset。
• 工程组织、编码风格、日志、测试和构建流程严格对齐 x-server 仓库当前采用的 atframework 组件风格。

组件概览

• DSA: Pod 内的 Dedicated Server Agent，负责 DS 子进程拉起、监控、回收。
• DSC: Dedicated Server Controller，负责调度、会话路由和消息转发。
• DSM: Dedicated Server Manager，全局管理与运维控制平面，负责 Region / Controller inventory、drain / stop / reconcile、审计与策略下发。

文档入口

• doc/guide.md: 设计文档，只描述架构、协议、状态机和方案对比。
• doc/dsm-guide.md: DSM 独立设计文档，描述全局管理平面职责与控制链路。
• doc/implementation-plan.md: 实现阶段拆分与推进顺序。
• doc/pseudocode-roadmap.md: 伪代码目录约定、写法约束和开发流程。

开发方式

• 后续实现默认先落到 pseudocode/，再进入正式代码开发。
• 仓库内已提供 skill：.github/skills/dsa-dsc-dsm-pseudocode/，用于统一后续伪代码工作流。

依赖与风格基线

• 构建系统: 使用 CMake，并优先复用 atframework/cmake-toolset。
• 基础设施: 连接、服务生命周期、配置加载与服务发现优先复用 libatapp。
• 总线与转发: 总线通信、路由、协议收发优先复用 libatbus。
• 通用工具: 基础容器、结果类型、日志与工具函数优先复用 atframe_utils。
• 风格约束: 采用 #pragma once、C++17、snake_case 命名、FWLOG 日志宏、clang-format（Google base, column limit 120）以及 atframework 私有单元测试框架约定。