AsterDrive 开发者文档
这里是面向 AsterDrive 贡献者、集成开发者和维护者的源码级文档库，覆盖仓库架构、领域设计、API、协议契约、测试基础设施和诊断入口。普通用户、部署者和管理员应优先阅读用户文档。
| 你的目标 | 建议入口 |
|---|---|
| 第一次接触仓库，想建立整体心智模型 | 架构概览 → 关键模块设计 |
| 判断一段后端逻辑应该放在哪一层 | 后端服务所有权边界 |
| 查找 REST、WebDAV、WOPI 或内部协议 | API 概览 |
| 修改存储、上传或远端节点链路 | 领域设计与契约 |
| 运行数据库、WebDAV 或诊断测试 | 测试与诊断 |
| 查阅尚未落地的讨论或历史决策背景 | 草稿与历史记录 |
- 架构概览：节点模式、分层、启动链路、配置和数据流。
- 关键模块设计：文件、上传、任务、存储和协议模块的内部形状。
- 后端服务所有权边界：route、service、domain、repository、storage 和 protocol 的职责边界。
领域设计与契约
Section titled “领域设计与契约”API 与协议
Section titled “API 与协议”API 概览按身份认证、文件工作流、团队与分享、后台任务、管理接口、WebDAV、WOPI、健康检查和 follower 内部协议组织全部接口页。机器可读规范仍以 OpenAPI 导出为准。
草稿与历史记录
Section titled “草稿与历史记录”- 草稿与历史记录索引
- 静态配置密钥处理备忘 — 草稿
- 服务层模块化重构历史方案 — 历史快照
| 状态 | 含义 |
|---|---|
| 当前实现 | 默认状态；应与当前代码、路由和测试保持一致 |
| 草稿 | 记录待讨论方向，不代表已经接受或落地 |
| 历史快照 | 保留决策背景；正文中的旧名称和路径不作为当前实现依据 |
| 待翻译 | 中文内容可用，英文站暂时通过 Starlight fallback 展示中文原文 |
修改实现时，先以当前代码和测试确认事实，再同步对应文档。不要因为旧文档写过某个结构，就把已经迁移掉的路径重新引回来。