Scert/README.md

45 lines
2.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Scert 项目
Scert 是一个统一管理 SSL 证书、自动续期并通过密码 SSH 部署到多台服务器的跨平台项目。
## 正式交付范围
正式产品仅包含 Web 管理界面和 Windows/Linux 服务端。CLI 作为服务端运维入口,用于初始化、服务启动、运维诊断、数据库迁移、备份恢复、服务安装和卸载,不作为另一套业务管理界面。
旧业务 CLI 已停用并返回中文迁移提示,范围和迁移方法见 `doc/命令行运维范围说明.md`。自动续期仍由服务端调度,手动业务操作通过 Web 执行,不再提供绕过 Web 流程的第二套 CLI 入口。
`desktop/` 保留 Wails 历史源码,供参考和独立开发;桌面窗口、托盘、自动更新、桌面配置管理及桌面 UI 测试均不属于正式交付或验收范围。正式发布脚本不调用 Wails,也不需要 WebView2 或 GTK 开发依赖。
## 项目目录
- `backend`:Go 核心服务、CLI、数据库和 HTTP API。
- `frontend`:Vue Web 管理界面。
- `doc`:需求确认、技术架构和开发任务清单。
## 开发基线
- 第一阶段使用 Let’s Encrypt + `go-acme/lego`。
- 第一阶段包含单域名、泛域名和多域名 SAN。
- 数据库支持目标包含 SQLite、MySQL 和 PostgreSQL;版本边界及实机验证状态见 `doc/构建版本与数据库支持矩阵.md`,代码适配不等于真实实例验收通过。
- HTTPS 采用默认核心服务终止、高级反向代理终止的双模式设计。
- Web 和运维 CLI 复用服务端核心、配置和数据。
## 开发状态
当前已完成配置、日志、数据库迁移、域名与服务器管理、管理员认证、DNS API 在线测试、lego DNS-01、证书申请与导入、自动续期、密码 SSH 部署、通知、设置接口和 Web 管理页面;SSH 私钥、公钥和密钥登录能力不属于当前产品,真实 DNS、ACME、远程服务器及平台安装验收仍需在授权环境完成。
详细内容请先阅读:
- `doc/Scert整改合并优化清单.md`:当前整改需求基线。
- `doc/Scert整改任务执行清单.md`:当前执行状态和验证证据。
- `build/README.md`:正式构建和交付范围。
- `doc/SSL服务程序需求确认文档.md`
- `doc/SSL服务程序技术架构设计文档.md`
- `doc/Scert开发任务清单.md`
早期需求、架构和开发清单保留历史记录;与当前整改基线冲突的桌面目标不再执行。
## 首轮复审状态
2026 年 8 月 26 日已完成首轮代码复审。基础骨架、SQLite、CLI、HTTP、前端生产构建和 Windows/Linux amd64 构建已通过;MySQL 5.7/8.0 真实实例测试因缺少明确连接参数保持阻塞。详细记录以 `doc/Scert开发任务清单.md` 的“二十七、首轮开发复审记录”为准。