commit fd8d8608f5187c067fda36a8d0032e86971cfb2f Author: xuans Date: Wed Aug 26 10:34:04 2026 +0800 完成Scert首轮基础骨架开发与复审 diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..2129bb6 --- /dev/null +++ b/.gitignore @@ -0,0 +1,4 @@ +backend/dist/ +frontend/node_modules/ +frontend/dist/ +*.log diff --git a/README.md b/README.md new file mode 100644 index 0000000..1c6cee7 --- /dev/null +++ b/README.md @@ -0,0 +1,31 @@ +# Scert 项目 + +Scert 是一个统一管理 SSL 证书、自动续期并部署到多台服务器的跨平台项目。 + +## 项目目录 + +- `backend`:Go 核心服务、CLI、数据库和 HTTP API。 +- `frontend`:Vue Web 管理界面占位结构。 +- `doc`:需求确认、技术架构和开发任务清单。 + +## 开发基线 + +- 第一阶段使用 Let’s Encrypt + `go-acme/lego`。 +- 第一阶段包含单域名、泛域名和多域名 SAN。 +- 支持 MySQL 5.7、MySQL 8.0 和 SQLite。 +- HTTPS 采用默认核心服务终止、高级反向代理终止的双模式设计。 +- CLI、Web 和桌面版共享核心服务、配置和数据。 + +## 开发状态 + +首轮基础骨架已经完成并等待复审。当前已完成配置、日志、数据库迁移、域名 Repository、基础 HTTP API、CLI 和前端占位页面;完整证书生命周期功能按 `doc/Scert开发任务清单.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` 的“二十七、首轮开发复审记录”为准。 \ No newline at end of file diff --git a/backend/README.md b/backend/README.md new file mode 100644 index 0000000..caaf4c5 --- /dev/null +++ b/backend/README.md @@ -0,0 +1,71 @@ +# Scert + +Scert 是面向 Windows 和 Linux 的 SSL 证书管理服务。当前代码处于首轮基础骨架阶段,已建立配置、数据库、日志、CLI、HTTP API 和前端占位结构。 + +## 当前已实现 + +- Go 后端模块和 `scert` CLI 入口。 +- JSON 配置生成、读取、校验和原子保存。 +- Windows 与 Linux 默认目录模型。 +- SQLite 和 MySQL 数据库连接抽象。 +- SQLite/MySQL 首版迁移脚本。 +- 域名基础模型与 Repository。 +- 健康检查、状态和域名基础 API。 +- 中文 CLI:`version`、`help`、`init`、`status`、`serve`、`domain list`、`domain add`。 +- Vue 前端状态占位页面。 + +## 首轮运行 + +在 `backend` 目录执行: + +```powershell +go run ./cmd/scert init --base-dir C:\ScertData +go run ./cmd/scert status --base-dir C:\ScertData +go run ./cmd/scert domain add --base-dir C:\ScertData --name example.com --type single +go run ./cmd/scert domain list --base-dir C:\ScertData +go run ./cmd/scert serve --base-dir C:\ScertData +``` + +服务启动后可访问: + +- `GET /healthz` +- `GET /api/v1/status` +- `GET /api/v1/domains` +- `POST /api/v1/domains` +- `DELETE /api/v1/domains/:id` + +当前 `serve` 是 HTTP 基础骨架。HTTPS 双模式、ACME 证书申请、DNS-01、远程部署等功能按开发任务清单在后续阶段实现。 + +## 测试和构建 + +```powershell +go fmt ./... +go test ./... +go build -o dist/scert.exe ./cmd/scert +``` + +Linux amd64 交叉编译: + +```powershell +$env:GOOS = 'linux' +$env:GOARCH = 'amd64' +go build -o dist/scert-linux-amd64 ./cmd/scert +Remove-Item Env:GOOS +Remove-Item Env:GOARCH +``` + +## 数据库说明 + +- SQLite 用于单机、桌面和开发测试模式。 +- MySQL 5.7 是基础开发和最低兼容版本。 +- MySQL 8.0 用于兼容性测试。 +- 数据库密码不得写入 Git、脚本参数或日志。 +- MySQL 客户端和服务实例必须使用明确路径、端口和 DSN,不能通过 PATH 中的单个 `mysql` 命令判断版本。 + +## 当前未实现 + +ACME/lego 实际申请、DNS 服务商 API、自动续期、SSH/SFTP 部署、Nginx/Caddy/Apache reload、完整 Web 管理界面、Wails 桌面版、Windows Service 和 Linux systemd 均未在首轮基础骨架中宣称完成。 + +## 首轮复审状态 + +2026 年 8 月 26 日已完成首轮代码复审。`gofmt`、`go vet`、`go test`、竞态检测、Windows amd64 构建、Linux amd64 交叉构建、CLI 和 HTTP 实际流程均通过。MySQL 5.7/8.0 仅完成代码层实现和客户端版本确认,真实实例连接与迁移仍需明确 DSN、端口和凭据后验证。 \ No newline at end of file diff --git a/backend/cmd/scert/main.go b/backend/cmd/scert/main.go new file mode 100644 index 0000000..63eda33 --- /dev/null +++ b/backend/cmd/scert/main.go @@ -0,0 +1,7 @@ +package main + +import "git.pcux.cn/xuans/Scert/backend/internal/cli" + +func main() { + cli.Execute() +} diff --git a/backend/go.mod b/backend/go.mod new file mode 100644 index 0000000..5b6d07f --- /dev/null +++ b/backend/go.mod @@ -0,0 +1,50 @@ +module git.pcux.cn/xuans/Scert/backend + +go 1.26.0 + +require ( + github.com/gin-gonic/gin v1.10.1 + github.com/go-sql-driver/mysql v1.9.3 + github.com/spf13/cobra v1.10.1 + modernc.org/sqlite v1.37.0 +) + +require ( + filippo.io/edwards25519 v1.1.0 // indirect + github.com/bytedance/sonic v1.11.6 // indirect + github.com/bytedance/sonic/loader v0.1.1 // indirect + github.com/cloudwego/base64x v0.1.4 // indirect + github.com/cloudwego/iasm v0.2.0 // indirect + github.com/dustin/go-humanize v1.0.1 // indirect + github.com/gabriel-vasile/mimetype v1.4.3 // indirect + github.com/gin-contrib/sse v0.1.0 // indirect + github.com/go-playground/locales v0.14.1 // indirect + github.com/go-playground/universal-translator v0.18.1 // indirect + github.com/go-playground/validator/v10 v10.20.0 // indirect + github.com/goccy/go-json v0.10.2 // indirect + github.com/google/uuid v1.6.0 // indirect + github.com/inconshreveable/mousetrap v1.1.0 // indirect + github.com/json-iterator/go v1.1.12 // indirect + github.com/klauspost/cpuid/v2 v2.2.7 // indirect + github.com/leodido/go-urn v1.4.0 // indirect + github.com/mattn/go-isatty v0.0.20 // indirect + github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect + github.com/modern-go/reflect2 v1.0.2 // indirect + github.com/ncruces/go-strftime v0.1.9 // indirect + github.com/pelletier/go-toml/v2 v2.2.2 // indirect + github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec // indirect + github.com/spf13/pflag v1.0.9 // indirect + github.com/twitchyliquid64/golang-asm v0.15.1 // indirect + github.com/ugorji/go/codec v1.2.12 // indirect + golang.org/x/arch v0.8.0 // indirect + golang.org/x/crypto v0.23.0 // indirect + golang.org/x/exp v0.0.0-20250305212735-054e65f0b394 // indirect + golang.org/x/net v0.25.0 // indirect + golang.org/x/sys v0.31.0 // indirect + golang.org/x/text v0.15.0 // indirect + google.golang.org/protobuf v1.34.1 // indirect + gopkg.in/yaml.v3 v3.0.1 // indirect + modernc.org/libc v1.62.1 // indirect + modernc.org/mathutil v1.7.1 // indirect + modernc.org/memory v1.9.1 // indirect +) diff --git a/backend/go.sum b/backend/go.sum new file mode 100644 index 0000000..983face --- /dev/null +++ b/backend/go.sum @@ -0,0 +1,141 @@ +filippo.io/edwards25519 v1.1.0 h1:FNf4tywRC1HmFuKW5xopWpigGjJKiJSV0Cqo0cJWDaA= +filippo.io/edwards25519 v1.1.0/go.mod h1:BxyFTGdWcka3PhytdK4V28tE5sGfRvvvRV7EaN4VDT4= +github.com/bytedance/sonic v1.11.6 h1:oUp34TzMlL+OY1OUWxHqsdkgC/Zfc85zGqw9siXjrc0= +github.com/bytedance/sonic v1.11.6/go.mod h1:LysEHSvpvDySVdC2f87zGWf6CIKJcAvqab1ZaiQtds4= +github.com/bytedance/sonic/loader v0.1.1 h1:c+e5Pt1k/cy5wMveRDyk2X4B9hF4g7an8N3zCYjJFNM= +github.com/bytedance/sonic/loader v0.1.1/go.mod h1:ncP89zfokxS5LZrJxl5z0UJcsk4M4yY2JpfqGeCtNLU= +github.com/cloudwego/base64x v0.1.4 h1:jwCgWpFanWmN8xoIUHa2rtzmkd5J2plF/dnLS6Xd/0Y= +github.com/cloudwego/base64x v0.1.4/go.mod h1:0zlkT4Wn5C6NdauXdJRhSKRlJvmclQ1hhJgA0rcu/8w= +github.com/cloudwego/iasm v0.2.0 h1:1KNIy1I1H9hNNFEEH3DVnI4UujN+1zjpuk6gwHLTssg= +github.com/cloudwego/iasm v0.2.0/go.mod h1:8rXZaNYT2n95jn+zTI1sDr+IgcD2GVs0nlbbQPiEFhY= +github.com/cpuguy83/go-md2man/v2 v2.0.6/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g= +github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c= +github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkpeCY= +github.com/dustin/go-humanize v1.0.1/go.mod h1:Mu1zIs6XwVuF/gI1OepvI0qD18qycQx+mFykh5fBlto= +github.com/gabriel-vasile/mimetype v1.4.3 h1:in2uUcidCuFcDKtdcBxlR0rJ1+fsokWf+uqxgUFjbI0= +github.com/gabriel-vasile/mimetype v1.4.3/go.mod h1:d8uq/6HKRL6CGdk+aubisF/M5GcPfT7nKyLpA0lbSSk= +github.com/gin-contrib/sse v0.1.0 h1:Y/yl/+YNO8GZSjAhjMsSuLt29uWRFHdHYUb5lYOV9qE= +github.com/gin-contrib/sse v0.1.0/go.mod h1:RHrZQHXnP2xjPF+u1gW/2HnVO7nvIa9PG3Gm+fLHvGI= +github.com/gin-gonic/gin v1.10.1 h1:T0ujvqyCSqRopADpgPgiTT63DUQVSfojyME59Ei63pQ= +github.com/gin-gonic/gin v1.10.1/go.mod h1:4PMNQiOhvDRa013RKVbsiNwoyezlm2rm0uX/T7kzp5Y= +github.com/go-playground/assert/v2 v2.2.0 h1:JvknZsQTYeFEAhQwI4qEt9cyV5ONwRHC+lYKSsYSR8s= +github.com/go-playground/assert/v2 v2.2.0/go.mod h1:VDjEfimB/XKnb+ZQfWdccd7VUvScMdVu0Titje2rxJ4= +github.com/go-playground/locales v0.14.1 h1:EWaQ/wswjilfKLTECiXz7Rh+3BjFhfDFKv/oXslEjJA= +github.com/go-playground/locales v0.14.1/go.mod h1:hxrqLVvrK65+Rwrd5Fc6F2O76J/NuW9t0sjnWqG1slY= +github.com/go-playground/universal-translator v0.18.1 h1:Bcnm0ZwsGyWbCzImXv+pAJnYK9S473LQFuzCbDbfSFY= +github.com/go-playground/universal-translator v0.18.1/go.mod h1:xekY+UJKNuX9WP91TpwSH2VMlDf28Uj24BCp08ZFTUY= +github.com/go-playground/validator/v10 v10.20.0 h1:K9ISHbSaI0lyB2eWMPJo+kOS/FBExVwjEviJTixqxL8= +github.com/go-playground/validator/v10 v10.20.0/go.mod h1:dbuPbCMFw/DrkbEynArYaCwl3amGuJotoKCe95atGMM= +github.com/go-sql-driver/mysql v1.9.3 h1:U/N249h2WzJ3Ukj8SowVFjdtZKfu9vlLZxjPXV1aweo= +github.com/go-sql-driver/mysql v1.9.3/go.mod h1:qn46aNg1333BRMNU69Lq93t8du/dwxI64Gl8i5p1WMU= +github.com/goccy/go-json v0.10.2 h1:CrxCmQqYDkv1z7lO7Wbh2HN93uovUHgrECaO5ZrCXAU= +github.com/goccy/go-json v0.10.2/go.mod h1:6MelG93GURQebXPDq3khkgXZkazVtN9CRI+MGFi0w8I= +github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI= +github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY= +github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg= +github.com/google/pprof v0.0.0-20250317173921-a4b03ec1a45e h1:ijClszYn+mADRFY17kjQEVQ1XRhq2/JR1M3sGqeJoxs= +github.com/google/pprof v0.0.0-20250317173921-a4b03ec1a45e/go.mod h1:boTsfXsheKC2y+lKOCMpSfarhxDeIzfZG1jqGcPl3cA= +github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0= +github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= +github.com/inconshreveable/mousetrap v1.1.0 h1:wN+x4NVGpMsO7ErUn/mUI3vEoE6Jt13X2s0bqwp9tc8= +github.com/inconshreveable/mousetrap v1.1.0/go.mod h1:vpF70FUmC8bwa3OWnCshd2FqLfsEA9PFc4w1p2J65bw= +github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM= +github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo= +github.com/klauspost/cpuid/v2 v2.0.9/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg= +github.com/klauspost/cpuid/v2 v2.2.7 h1:ZWSB3igEs+d0qvnxR/ZBzXVmxkgt8DdzP6m9pfuVLDM= +github.com/klauspost/cpuid/v2 v2.2.7/go.mod h1:Lcz8mBdAVJIBVzewtcLocK12l3Y+JytZYpaMropDUws= +github.com/knz/go-libedit v1.10.1/go.mod h1:MZTVkCWyz0oBc7JOWP3wNAzd002ZbM/5hgShxwh4x8M= +github.com/leodido/go-urn v1.4.0 h1:WT9HwE9SGECu3lg4d/dIA+jxlljEa1/ffXKmRjqdmIQ= +github.com/leodido/go-urn v1.4.0/go.mod h1:bvxc+MVxLKB4z00jd1z+Dvzr47oO32F/QSNjSBOlFxI= +github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY= +github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= +github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q= +github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w8PVh93nsPXa1VrQ6jlwL5oN8l14QlcNfg= +github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q= +github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M= +github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk= +github.com/ncruces/go-strftime v0.1.9 h1:bY0MQC28UADQmHmaF5dgpLmImcShSi2kHU9XLdhx/f4= +github.com/ncruces/go-strftime v0.1.9/go.mod h1:Fwc5htZGVVkseilnfgOVb9mKy6w1naJmn9CehxcKcls= +github.com/pelletier/go-toml/v2 v2.2.2 h1:aYUidT7k73Pcl9nb2gScu7NSrKCSHIDE89b3+6Wq+LM= +github.com/pelletier/go-toml/v2 v2.2.2/go.mod h1:1t835xjRzz80PqgE6HHgN2JOsmgYu/h4qDAS4n929Rs= +github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= +github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= +github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec h1:W09IVJc94icq4NjY3clb7Lk8O1qJ8BdBEF8z0ibU0rE= +github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec/go.mod h1:qqbHyh8v60DhA7CoWK5oRCqLrMHRGoxYCSS9EjAz6Eo= +github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM= +github.com/spf13/cobra v1.10.1 h1:lJeBwCfmrnXthfAupyUTzJ/J4Nc1RsHC/mSRU2dll/s= +github.com/spf13/cobra v1.10.1/go.mod h1:7SmJGaTHFVBY0jW4NXGluQoLvhqFQM+6XSKD+P4XaB0= +github.com/spf13/pflag v1.0.9 h1:9exaQaMOCwffKiiiYk6/BndUBv+iRViNW+4lEMi0PvY= +github.com/spf13/pflag v1.0.9/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg= +github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= +github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw= +github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo= +github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA= +github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI= +github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= +github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= +github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU= +github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4= +github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo= +github.com/stretchr/testify v1.9.0 h1:HtqpIVDClZ4nwg75+f6Lvsy/wHu+3BoSGCbBAcpTsTg= +github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY= +github.com/twitchyliquid64/golang-asm v0.15.1 h1:SU5vSMR7hnwNxj24w34ZyCi/FmDZTkS4MhqMhdFk5YI= +github.com/twitchyliquid64/golang-asm v0.15.1/go.mod h1:a1lVb/DtPvCB8fslRZhAngC2+aY1QWCk3Cedj/Gdt08= +github.com/ugorji/go/codec v1.2.12 h1:9LC83zGrHhuUA9l16C9AHXAqEV/2wBQ4nkvumAE65EE= +github.com/ugorji/go/codec v1.2.12/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg= +golang.org/x/arch v0.0.0-20210923205945-b76863e36670/go.mod h1:5om86z9Hs0C8fWVUuoMHwpExlXzs5Tkyp9hOrfG7pp8= +golang.org/x/arch v0.8.0 h1:3wRIsP3pM4yUptoR96otTUOXI367OS0+c9eeRi9doIc= +golang.org/x/arch v0.8.0/go.mod h1:FEVrYAQjsQXMVJ1nsMoVVXPZg6p2JE2mx8psSWTDQys= +golang.org/x/crypto v0.23.0 h1:dIJU/v2J8Mdglj/8rJ6UUOM3Zc9zLZxVZwwxMooUSAI= +golang.org/x/crypto v0.23.0/go.mod h1:CKFgDieR+mRhux2Lsu27y0fO304Db0wZe70UKqHu0v8= +golang.org/x/exp v0.0.0-20250305212735-054e65f0b394 h1:nDVHiLt8aIbd/VzvPWN6kSOPE7+F/fNFDSXLVYkE/Iw= +golang.org/x/exp v0.0.0-20250305212735-054e65f0b394/go.mod h1:sIifuuw/Yco/y6yb6+bDNfyeQ/MdPUy/hKEMYQV17cM= +golang.org/x/mod v0.24.0 h1:ZfthKaKaT4NrhGVZHO1/WDTwGES4De8KtWO0SIbNJMU= +golang.org/x/mod v0.24.0/go.mod h1:IXM97Txy2VM4PJ3gI61r1YEk/gAj6zAHN3AdZt6S9Ww= +golang.org/x/net v0.25.0 h1:d/OCCoBEUq33pjydKrGQhw7IlUPI2Oylr+8qLx49kac= +golang.org/x/net v0.25.0/go.mod h1:JkAGAh7GEvH74S6FOH42FLoXpXbE/aqXSrIQjXgsiwM= +golang.org/x/sync v0.12.0 h1:MHc5BpPuC30uJk597Ri8TV3CNZcTLu6B6z4lJy+g6Jw= +golang.org/x/sync v0.12.0/go.mod h1:1dzgHSNfp02xaA81J2MS99Qcpr2w7fw1gpm99rleRqA= +golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.31.0 h1:ioabZlmFYtWhL+TRYpcnNlLwhyxaM9kWTDEmfnprqik= +golang.org/x/sys v0.31.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k= +golang.org/x/text v0.15.0 h1:h1V/4gjBv8v9cjcR6+AR5+/cIYK5N/WAgiv4xlsEtAk= +golang.org/x/text v0.15.0/go.mod h1:18ZOQIKpY8NJVqYksKHtTdi31H5itFRjB5/qKTNYzSU= +golang.org/x/tools v0.31.0 h1:0EedkvKDbh+qistFTd0Bcwe/YLh4vHwWEkiI0toFIBU= +golang.org/x/tools v0.31.0/go.mod h1:naFTU+Cev749tSJRXJlna0T3WxKvb1kWEx15xA4SdmQ= +google.golang.org/protobuf v1.34.1 h1:9ddQBjfCyZPOHPUiPxpYESBLc+T8P3E+Vo4IbKZgFWg= +google.golang.org/protobuf v1.34.1/go.mod h1:c6P6GXX6sHbq/GpV6MGZEdwhWPcYBgnhAHhKbcUYpos= +gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM= +gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= +gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= +gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA= +gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= +modernc.org/cc/v4 v4.25.2 h1:T2oH7sZdGvTaie0BRNFbIYsabzCxUQg8nLqCdQ2i0ic= +modernc.org/cc/v4 v4.25.2/go.mod h1:uVtb5OGqUKpoLWhqwNQo/8LwvoiEBLvZXIQ/SmO6mL0= +modernc.org/ccgo/v4 v4.25.1 h1:TFSzPrAGmDsdnhT9X2UrcPMI3N/mJ9/X9ykKXwLhDsU= +modernc.org/ccgo/v4 v4.25.1/go.mod h1:njjuAYiPflywOOrm3B7kCB444ONP5pAVr8PIEoE0uDw= +modernc.org/fileutil v1.3.0 h1:gQ5SIzK3H9kdfai/5x41oQiKValumqNTDXMvKo62HvE= +modernc.org/fileutil v1.3.0/go.mod h1:XatxS8fZi3pS8/hKG2GH/ArUogfxjpEKs3Ku3aK4JyQ= +modernc.org/gc/v2 v2.6.5 h1:nyqdV8q46KvTpZlsw66kWqwXRHdjIlJOhG6kxiV/9xI= +modernc.org/gc/v2 v2.6.5/go.mod h1:YgIahr1ypgfe7chRuJi2gD7DBQiKSLMPgBQe9oIiito= +modernc.org/libc v1.62.1 h1:s0+fv5E3FymN8eJVmnk0llBe6rOxCu/DEU+XygRbS8s= +modernc.org/libc v1.62.1/go.mod h1:iXhATfJQLjG3NWy56a6WVU73lWOcdYVxsvwCgoPljuo= +modernc.org/mathutil v1.7.1 h1:GCZVGXdaN8gTqB1Mf/usp1Y/hSqgI2vAGGP4jZMCxOU= +modernc.org/mathutil v1.7.1/go.mod h1:4p5IwJITfppl0G4sUEDtCr4DthTaT47/N3aT6MhfgJg= +modernc.org/memory v1.9.1 h1:V/Z1solwAVmMW1yttq3nDdZPJqV1rM05Ccq6KMSZ34g= +modernc.org/memory v1.9.1/go.mod h1:/JP4VbVC+K5sU2wZi9bHoq2MAkCnrt2r98UGeSK7Mjw= +modernc.org/opt v0.1.4 h1:2kNGMRiUjrp4LcaPuLY2PzUfqM/w9N23quVwhKt5Qm8= +modernc.org/opt v0.1.4/go.mod h1:03fq9lsNfvkYSfxrfUhZCWPk1lm4cq4N+Bh//bEtgns= +modernc.org/sortutil v1.2.1 h1:+xyoGf15mM3NMlPDnFqrteY07klSFxLElE2PVuWIJ7w= +modernc.org/sortutil v1.2.1/go.mod h1:7ZI3a3REbai7gzCLcotuw9AC4VZVpYMjDzETGsSMqJE= +modernc.org/sqlite v1.37.0 h1:s1TMe7T3Q3ovQiK2Ouz4Jwh7dw4ZDqbebSDTlSJdfjI= +modernc.org/sqlite v1.37.0/go.mod h1:5YiWv+YviqGMuGw4V+PNplcyaJ5v+vQd7TQOgkACoJM= +modernc.org/strutil v1.2.1 h1:UneZBkQA+DX2Rp35KcM69cSsNES9ly8mQWD71HKlOA0= +modernc.org/strutil v1.2.1/go.mod h1:EHkiggD70koQxjVdSBM3JKM7k6L0FbGE5eymy9i3B9A= +modernc.org/token v1.1.0 h1:Xl7Ap9dKaEs5kLoOQeQmPWevfnk/DM5qcLcYlA8ys6Y= +modernc.org/token v1.1.0/go.mod h1:UGzOrNV1mAFSEB63lOFHIpNRUVMvYTc6yu1SMY/XTDM= +nullprogram.com/x/optparse v1.0.0/go.mod h1:KdyPE+Igbe0jQUrVfMqDMeJQIJZEuyV7pjYmp6pbG50= +rsc.io/pdf v0.1.1/go.mod h1:n8OzWcQ6Sp37PL01nO98y4iUCRdTGarVfzxY20ICaU4= diff --git a/backend/internal/app/app.go b/backend/internal/app/app.go new file mode 100644 index 0000000..b045cdf --- /dev/null +++ b/backend/internal/app/app.go @@ -0,0 +1,79 @@ +package app + +import ( + "context" + "fmt" + "log/slog" + "time" + + "git.pcux.cn/xuans/Scert/backend/internal/config" + "git.pcux.cn/xuans/Scert/backend/internal/database" + "git.pcux.cn/xuans/Scert/backend/internal/httpapi" + "git.pcux.cn/xuans/Scert/backend/internal/logging" + "git.pcux.cn/xuans/Scert/backend/internal/repository" +) + +type App struct { + Config config.Config + Logger *logging.Logger + Database *database.Database + Repository *repository.SQLDomainRepository + HTTP *httpapi.Server +} + +func New(ctx context.Context, cfg config.Config) (*App, error) { + if err := cfg.Validate(); err != nil { + return nil, err + } + for _, path := range []string{cfg.Paths.Install, cfg.Paths.Certificate, cfg.Paths.Config, cfg.Paths.Data, cfg.Paths.Log, cfg.Paths.Backup} { + if err := makeDirectory(path); err != nil { + return nil, fmt.Errorf("创建运行目录失败:%w", err) + } + } + logger, err := logging.New(cfg.Paths.Log, slog.LevelInfo) + if err != nil { + return nil, fmt.Errorf("初始化日志失败:%w", err) + } + db, err := database.Open(ctx, cfg.Database) + if err != nil { + _ = logger.Close() + return nil, err + } + if err := database.Migrate(ctx, db.DB, cfg.Database.Driver); err != nil { + _ = db.Close() + _ = logger.Close() + return nil, err + } + repo := repository.NewSQLDomainRepository(db.DB) + server := httpapi.New(httpapi.Dependencies{Config: cfg, Logger: logger, Repository: repo}) + return &App{Config: cfg, Logger: logger, Database: db, Repository: repo, HTTP: server}, nil +} + +func (a *App) Close() error { + if a == nil { + return nil + } + var first error + if a.HTTP != nil { + ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second) + if err := a.HTTP.Shutdown(ctx); err != nil && first == nil { + first = err + } + cancel() + } + if a.Database != nil { + if err := a.Database.Close(); err != nil && first == nil { + first = err + } + } + if a.Logger != nil { + if err := a.Logger.Close(); err != nil && first == nil { + first = err + } + } + return first +} + +func makeDirectory(path string) error { + return osMkdirAll(path) +} diff --git a/backend/internal/app/files.go b/backend/internal/app/files.go new file mode 100644 index 0000000..797a03f --- /dev/null +++ b/backend/internal/app/files.go @@ -0,0 +1,7 @@ +package app + +import "os" + +var osMkdirAll = func(path string) error { + return os.MkdirAll(path, 0o750) +} diff --git a/backend/internal/buildinfo/version.go b/backend/internal/buildinfo/version.go new file mode 100644 index 0000000..c2cfd63 --- /dev/null +++ b/backend/internal/buildinfo/version.go @@ -0,0 +1,3 @@ +package buildinfo + +const Version = "0.1.0" diff --git a/backend/internal/cli/root.go b/backend/internal/cli/root.go new file mode 100644 index 0000000..35671e8 --- /dev/null +++ b/backend/internal/cli/root.go @@ -0,0 +1,234 @@ +package cli + +import ( + "encoding/json" + "errors" + "fmt" + "net/http" + "os" + "os/signal" + "path/filepath" + "strings" + "syscall" + + "github.com/spf13/cobra" + + "git.pcux.cn/xuans/Scert/backend/internal/app" + "git.pcux.cn/xuans/Scert/backend/internal/buildinfo" + "git.pcux.cn/xuans/Scert/backend/internal/config" + "git.pcux.cn/xuans/Scert/backend/internal/domain" +) + +const version = buildinfo.Version + +var ( + configPath string + baseDir string +) + +const helpTemplate = `{{with (or .Long .Short)}}{{. | trimTrailingWhitespaces}}{{end}} + +用法: + {{.UseLine}}{{if .HasAvailableSubCommands}} + +可用命令: +{{range .Commands}}{{if (or .IsAvailableCommand (eq .Name "help"))}} {{rpad .Name .NamePadding }} {{.Short}}{{"\n"}}{{end}}{{end}}{{end}}{{if .HasAvailableLocalFlags}} + +参数: +{{.LocalFlags.FlagUsages | trimTrailingWhitespaces}}{{end}}{{if .HasAvailableInheritedFlags}} + +全局参数: +{{.InheritedFlags.FlagUsages | trimTrailingWhitespaces}}{{end}}{{if .HasHelpSubCommands}} + +其他帮助: + {{.CommandPath}} help [命令]{{end}} +` + +func Execute() { + if err := newRootCommand().Execute(); err != nil { + fmt.Fprintln(os.Stderr, "错误:", err) + os.Exit(1) + } +} + +func newRootCommand() *cobra.Command { + root := &cobra.Command{Use: "scert", Short: "SSL 证书管理服务", SilenceUsage: true} + root.CompletionOptions.DisableDefaultCmd = true + root.SetHelpCommand(newHelpCommand()) + root.SetHelpTemplate(helpTemplate) + root.PersistentFlags().StringVar(&configPath, "config", "", "配置文件路径") + root.PersistentFlags().StringVar(&baseDir, "base-dir", "", "Windows 默认安装根目录") + root.AddCommand( + &cobra.Command{Use: "version", Short: "显示版本信息", Run: func(cmd *cobra.Command, args []string) { cmd.Printf("Scert %s\n", version) }}, + newInitCommand(), newStatusCommand(), newServeCommand(), newDomainCommand(), + ) + localizeHelpFlags(root) + return root +} + +func newHelpCommand() *cobra.Command { + return &cobra.Command{ + Use: "help [命令]", + Short: "显示帮助信息", + RunE: func(cmd *cobra.Command, args []string) error { + if len(args) == 0 { + return cmd.Root().Help() + } + target, remaining, err := cmd.Root().Find(args) + if err != nil { + return err + } + if len(remaining) > 0 { + return fmt.Errorf("未知命令:%s", strings.Join(remaining, " ")) + } + return target.Help() + }, + } +} + +func localizeHelpFlags(command *cobra.Command) { + command.DisableFlagsInUseLine = true + command.InitDefaultHelpFlag() + if flag := command.Flags().Lookup("help"); flag != nil { + flag.Usage = "显示帮助信息" + } + for _, child := range command.Commands() { + localizeHelpFlags(child) + } +} + +func newInitCommand() *cobra.Command { + return &cobra.Command{Use: "init", Short: "生成初始配置", RunE: func(cmd *cobra.Command, args []string) error { + path := resolveConfigPath() + if _, err := os.Stat(path); err == nil { + return fmt.Errorf("配置文件已存在:%s", path) + } else if !errors.Is(err, os.ErrNotExist) { + return err + } + cfg := config.Default(baseDir) + if err := cfg.Save(path); err != nil { + return err + } + fmt.Printf("初始配置已生成:%s\n", path) + fmt.Println("当前默认使用 ACME Staging 环境,完成 DNS 配置后再切换 Production。") + return nil + }} +} + +func newStatusCommand() *cobra.Command { + return &cobra.Command{Use: "status", Short: "查看服务状态", RunE: func(cmd *cobra.Command, args []string) error { + cfg, err := loadConfig() + if err != nil { + return err + } + return printJSON(cmd, commandStatus(cfg)) + }} +} + +func commandStatus(cfg config.Config) map[string]any { + return map[string]any{"service": "scert", "version": buildinfo.Version, "config_version": cfg.Version, "setup_ready": cfg.SetupReady, "https_mode": cfg.Server.HTTPSMode, "database_driver": cfg.Database.Driver} +} + +func newServeCommand() *cobra.Command { + return &cobra.Command{Use: "serve", Short: "启动 Web 服务", RunE: func(cmd *cobra.Command, args []string) error { + cfg, err := loadConfig() + if err != nil { + return err + } + service, err := app.New(cmd.Context(), cfg) + if err != nil { + return err + } + defer service.Close() + ctx, stop := signal.NotifyContext(cmd.Context(), os.Interrupt, syscall.SIGTERM) + defer stop() + errCh := make(chan error, 1) + go func() { errCh <- service.HTTP.ListenAndServe() }() + select { + case <-ctx.Done(): + return nil + case err := <-errCh: + if errors.Is(err, http.ErrServerClosed) { + return nil + } + return err + } + }} +} + +func newDomainCommand() *cobra.Command { + command := &cobra.Command{Use: "domain", Short: "管理托管域名"} + command.AddCommand(newDomainListCommand(), newDomainAddCommand()) + return command +} + +func newDomainListCommand() *cobra.Command { + return &cobra.Command{Use: "list", Short: "查看域名列表", RunE: func(cmd *cobra.Command, args []string) error { + cfg, err := loadConfig() + if err != nil { + return err + } + service, err := app.New(cmd.Context(), cfg) + if err != nil { + return err + } + defer service.Close() + items, err := service.Repository.List(cmd.Context()) + if err != nil { + return err + } + return printJSON(cmd, items) + }} +} + +func newDomainAddCommand() *cobra.Command { + var name, certificateType string + var sans []string + command := &cobra.Command{Use: "add", Short: "添加托管域名", RunE: func(cmd *cobra.Command, args []string) error { + cfg, err := loadConfig() + if err != nil { + return err + } + service, err := app.New(cmd.Context(), cfg) + if err != nil { + return err + } + defer service.Close() + item, err := domain.NewDomain(name, domain.CertificateType(certificateType), sans) + if err != nil { + return err + } + if err := service.Repository.Create(cmd.Context(), item); err != nil { + return err + } + fmt.Printf("域名已添加:%s\n", item.Name) + return nil + }} + command.Flags().StringVar(&name, "name", "", "域名") + command.Flags().StringVar(&certificateType, "type", string(domain.CertificateSingle), "证书类型:single、wildcard、san") + command.Flags().StringSliceVar(&sans, "sans", nil, "SAN 域名列表") + _ = command.MarkFlagRequired("name") + return command +} + +func printJSON(cmd *cobra.Command, value any) error { + data, err := json.MarshalIndent(value, "", " ") + if err != nil { + return fmt.Errorf("编码 JSON 失败:%w", err) + } + _, err = fmt.Fprintln(cmd.OutOrStdout(), string(data)) + return err +} + +func loadConfig() (config.Config, error) { + path := resolveConfigPath() + return config.Load(path) +} + +func resolveConfigPath() string { + if configPath != "" { + return configPath + } + paths := config.DefaultPaths(baseDir) + return filepath.Join(paths.Config, "scert.json") +} diff --git a/backend/internal/cli/root_test.go b/backend/internal/cli/root_test.go new file mode 100644 index 0000000..7b18ac9 --- /dev/null +++ b/backend/internal/cli/root_test.go @@ -0,0 +1,60 @@ +package cli + +import ( + "bytes" + "strings" + "testing" + + "git.pcux.cn/xuans/Scert/backend/internal/buildinfo" + "git.pcux.cn/xuans/Scert/backend/internal/config" +) + +func TestHelpIsLocalizedAndHasNoDuplicateCommands(t *testing.T) { + configPath = "" + baseDir = "" + root := newRootCommand() + var output bytes.Buffer + root.SetOut(&output) + root.SetErr(&output) + root.SetArgs([]string{"help"}) + if err := root.Execute(); err != nil { + t.Fatalf("执行帮助命令失败:%v", err) + } + text := output.String() + for _, expected := range []string{"用法:", "可用命令:", "参数:"} { + if !strings.Contains(text, expected) { + t.Fatalf("帮助缺少中文标题 %q:%s", expected, text) + } + } + for _, unexpected := range []string{"Available Commands:", "Usage:", "Flags:", "completion"} { + if strings.Contains(text, unexpected) { + t.Fatalf("帮助仍包含未本地化或禁用内容 %q:%s", unexpected, text) + } + } + if strings.Count(text, "\n help ") != 1 { + t.Fatalf("help 命令数量不正确:%s", text) + } +} + +func TestHelpSupportsSubcommand(t *testing.T) { + root := newRootCommand() + var output bytes.Buffer + root.SetOut(&output) + root.SetErr(&output) + root.SetArgs([]string{"help", "domain"}) + if err := root.Execute(); err != nil { + t.Fatalf("查看子命令帮助失败:%v", err) + } + text := output.String() + if !strings.Contains(text, "管理托管域名") || !strings.Contains(text, "添加托管域名") { + t.Fatalf("子命令帮助内容不正确:%s", text) + } +} + +func TestCommandStatusUsesApplicationVersion(t *testing.T) { + cfg := config.Default(t.TempDir()) + status := commandStatus(cfg) + if status["version"] != buildinfo.Version || status["config_version"] != config.CurrentVersion { + t.Fatalf("状态版本字段不正确:%+v", status) + } +} diff --git a/backend/internal/config/config.go b/backend/internal/config/config.go new file mode 100644 index 0000000..816b48c --- /dev/null +++ b/backend/internal/config/config.go @@ -0,0 +1,183 @@ +package config + +import ( + "encoding/json" + "fmt" + "os" + "path/filepath" + "runtime" + "strings" +) + +const CurrentVersion = 1 +const ConfigFormat = "json" + +type Config struct { + Version int `json:"version"` + SetupReady bool `json:"setup_ready"` + Server ServerConfig `json:"server"` + Database DatabaseConfig `json:"database"` + Paths PathsConfig `json:"paths"` + ACME ACMEConfig `json:"acme"` + Notification NotificationConfig `json:"notification"` +} + +type ServerConfig struct { + Host string `json:"host"` + Port int `json:"port"` + HTTPSMode string `json:"https_mode"` +} + +type DatabaseConfig struct { + Driver string `json:"driver"` + DSN string `json:"dsn"` + MaxOpenConns int `json:"max_open_conns"` + MaxIdleConns int `json:"max_idle_conns"` + ConnMaxLifetimeMins int `json:"conn_max_lifetime_mins"` +} + +type PathsConfig struct { + Install string `json:"install"` + Certificate string `json:"certificate"` + Config string `json:"config"` + Data string `json:"data"` + Log string `json:"log"` + Backup string `json:"backup"` +} + +type ACMEConfig struct { + CA string `json:"ca"` + Environment string `json:"environment"` + AccountEmail string `json:"account_email"` + RenewalThresholdDays int `json:"renewal_threshold_days"` +} + +type NotificationConfig struct { + HTTPEnabled bool `json:"http_enabled"` + SMTPEnabled bool `json:"smtp_enabled"` + TimeoutSecs int `json:"timeout_secs"` + RetryCount int `json:"retry_count"` +} + +func Default(baseDir string) Config { + paths := DefaultPaths(baseDir) + return Config{ + Version: CurrentVersion, + SetupReady: false, + Server: ServerConfig{Host: "127.0.0.1", Port: 8080, HTTPSMode: "direct"}, + Database: DatabaseConfig{ + Driver: "sqlite", DSN: filepath.Join(paths.Data, "scert.db"), + MaxOpenConns: 4, MaxIdleConns: 2, ConnMaxLifetimeMins: 30, + }, + Paths: paths, + ACME: ACMEConfig{CA: "letsencrypt", Environment: "staging", RenewalThresholdDays: 6}, + Notification: NotificationConfig{TimeoutSecs: 10, RetryCount: 3}, + } +} + +func DefaultPaths(baseDir string) PathsConfig { + if runtime.GOOS == "linux" { + return PathsConfig{ + Install: "/scert", Certificate: "/ssl", Config: "/scert/conf", + Data: "/scert/data", Log: "/scert/log", Backup: "/scert/backups", + } + } + if strings.TrimSpace(baseDir) == "" { + baseDir = "." + } + install := filepath.Join(baseDir, "Scert") + return PathsConfig{ + Install: install, Certificate: filepath.Join(install, "ssl"), + Config: filepath.Join(install, "config"), Data: filepath.Join(install, "data"), + Log: filepath.Join(install, "logs"), Backup: filepath.Join(install, "backups"), + } +} + +func Load(path string) (Config, error) { + data, err := os.ReadFile(path) + if err != nil { + return Config{}, fmt.Errorf("读取配置文件失败:%w", err) + } + var cfg Config + if err := json.Unmarshal(data, &cfg); err != nil { + return Config{}, fmt.Errorf("解析配置文件失败:%w", err) + } + if err := cfg.Validate(); err != nil { + return Config{}, err + } + return cfg, nil +} + +func (c Config) Save(path string) error { + if err := c.Validate(); err != nil { + return err + } + if err := os.MkdirAll(filepath.Dir(path), 0o700); err != nil { + return fmt.Errorf("创建配置目录失败:%w", err) + } + data, err := json.MarshalIndent(c, "", " ") + if err != nil { + return fmt.Errorf("编码配置失败:%w", err) + } + data = append(data, '\n') + tmpPath := path + ".tmp" + if err := os.WriteFile(tmpPath, data, 0o600); err != nil { + return fmt.Errorf("写入临时配置文件失败:%w", err) + } + if err := os.Rename(tmpPath, path); err != nil { + _ = os.Remove(tmpPath) + return fmt.Errorf("替换配置文件失败:%w", err) + } + if err := os.Chmod(path, 0o600); err != nil { + return fmt.Errorf("设置配置文件权限失败:%w", err) + } + return nil +} + +func (c Config) Validate() error { + if c.Version != CurrentVersion { + return fmt.Errorf("配置版本不兼容:%d", c.Version) + } + if strings.TrimSpace(c.Server.Host) == "" { + return fmt.Errorf("服务监听地址不能为空") + } + if c.Server.Port < 1 || c.Server.Port > 65535 { + return fmt.Errorf("服务监听端口无效:%d", c.Server.Port) + } + if c.Server.HTTPSMode != "direct" && c.Server.HTTPSMode != "proxy" { + return fmt.Errorf("HTTPS 模式无效:%s", c.Server.HTTPSMode) + } + if c.Database.Driver != "sqlite" && c.Database.Driver != "mysql" { + return fmt.Errorf("数据库驱动无效:%s", c.Database.Driver) + } + if strings.TrimSpace(c.Database.DSN) == "" { + return fmt.Errorf("数据库连接信息不能为空") + } + if c.Database.MaxOpenConns < 1 || c.Database.MaxIdleConns < 0 || c.Database.MaxIdleConns > c.Database.MaxOpenConns { + return fmt.Errorf("数据库连接池配置无效") + } + if c.Database.ConnMaxLifetimeMins < 0 { + return fmt.Errorf("数据库连接生命周期不能为负数") + } + for name, value := range map[string]string{ + "安装目录": c.Paths.Install, "证书目录": c.Paths.Certificate, "配置目录": c.Paths.Config, + "数据目录": c.Paths.Data, "日志目录": c.Paths.Log, "备份目录": c.Paths.Backup, + } { + if strings.TrimSpace(value) == "" { + return fmt.Errorf("%s不能为空", name) + } + } + if c.ACME.CA != "letsencrypt" { + return fmt.Errorf("当前仅支持 Let's Encrypt") + } + if c.ACME.Environment != "staging" && c.ACME.Environment != "production" { + return fmt.Errorf("ACME 环境无效:%s", c.ACME.Environment) + } + if c.ACME.RenewalThresholdDays < 1 { + return fmt.Errorf("续期阈值必须大于 0") + } + if c.Notification.TimeoutSecs < 1 || c.Notification.RetryCount < 0 { + return fmt.Errorf("通知配置无效") + } + return nil +} diff --git a/backend/internal/config/config_test.go b/backend/internal/config/config_test.go new file mode 100644 index 0000000..380dedf --- /dev/null +++ b/backend/internal/config/config_test.go @@ -0,0 +1,44 @@ +package config + +import ( + "path/filepath" + "runtime" + "testing" +) + +func TestDefaultPaths(t *testing.T) { + paths := DefaultPaths(t.TempDir()) + if runtime.GOOS == "linux" { + if paths.Install != "/scert" || paths.Certificate != "/ssl" { + t.Fatalf("Linux 默认路径不正确:%+v", paths) + } + return + } + if filepath.Base(paths.Install) != "Scert" || filepath.Base(paths.Certificate) != "ssl" { + t.Fatalf("Windows 默认路径不正确:%+v", paths) + } +} + +func TestSaveAndLoad(t *testing.T) { + dir := t.TempDir() + cfg := Default(dir) + path := filepath.Join(dir, "config", "scert.json") + if err := cfg.Save(path); err != nil { + t.Fatalf("保存配置失败:%v", err) + } + loaded, err := Load(path) + if err != nil { + t.Fatalf("读取配置失败:%v", err) + } + if loaded.Version != cfg.Version || loaded.Database.Driver != "sqlite" { + t.Fatalf("读取配置内容不一致:%+v", loaded) + } +} + +func TestValidateRejectsInvalidPort(t *testing.T) { + cfg := Default(t.TempDir()) + cfg.Server.Port = 70000 + if err := cfg.Validate(); err == nil { + t.Fatal("无效端口未被拒绝") + } +} diff --git a/backend/internal/config/review_test.go b/backend/internal/config/review_test.go new file mode 100644 index 0000000..217517d --- /dev/null +++ b/backend/internal/config/review_test.go @@ -0,0 +1,45 @@ +package config + +import ( + "os" + "path/filepath" + "runtime" + "testing" +) + +func TestValidateRejectsIncompatibleVersion(t *testing.T) { + cfg := Default(t.TempDir()) + cfg.Version = CurrentVersion + 1 + if err := cfg.Validate(); err == nil { + t.Fatal("不兼容配置版本未被拒绝") + } +} + +func TestSaveCanReplaceExistingConfig(t *testing.T) { + dir := t.TempDir() + path := filepath.Join(dir, "config", "scert.json") + cfg := Default(dir) + if err := cfg.Save(path); err != nil { + t.Fatalf("首次保存配置失败:%v", err) + } + cfg.Server.Port = 9443 + if err := cfg.Save(path); err != nil { + t.Fatalf("覆盖保存配置失败:%v", err) + } + loaded, err := Load(path) + if err != nil { + t.Fatalf("读取覆盖后的配置失败:%v", err) + } + if loaded.Server.Port != 9443 { + t.Fatalf("覆盖后的配置内容不正确:%d", loaded.Server.Port) + } + if runtime.GOOS != "windows" { + info, err := os.Stat(path) + if err != nil { + t.Fatalf("读取配置文件权限失败:%v", err) + } + if info.Mode().Perm() != 0o600 { + t.Fatalf("配置文件权限不正确:%o", info.Mode().Perm()) + } + } +} diff --git a/backend/internal/database/database.go b/backend/internal/database/database.go new file mode 100644 index 0000000..d320175 --- /dev/null +++ b/backend/internal/database/database.go @@ -0,0 +1,90 @@ +package database + +import ( + "context" + "database/sql" + "fmt" + "path/filepath" + "strings" + "time" + + "github.com/go-sql-driver/mysql" + _ "modernc.org/sqlite" + + "git.pcux.cn/xuans/Scert/backend/internal/config" +) + +type Database struct { + DB *sql.DB +} + +func Open(ctx context.Context, cfg config.DatabaseConfig) (*Database, error) { + if cfg.Driver != "sqlite" && cfg.Driver != "mysql" { + return nil, fmt.Errorf("数据库驱动无效:%s", cfg.Driver) + } + dsn := cfg.DSN + if cfg.Driver == "mysql" { + var err error + dsn, err = normalizeMySQLDSN(dsn) + if err != nil { + return nil, err + } + } + if cfg.Driver == "sqlite" { + if cfg.DSN != ":memory:" && len(cfg.DSN) > 0 && cfg.DSN != "file::memory:?cache=shared" { + if err := ensureSQLiteDir(cfg.DSN); err != nil { + return nil, err + } + } + } + db, err := sql.Open(cfg.Driver, dsn) + if err != nil { + return nil, fmt.Errorf("打开数据库失败:%w", err) + } + db.SetMaxOpenConns(cfg.MaxOpenConns) + db.SetMaxIdleConns(cfg.MaxIdleConns) + db.SetConnMaxLifetime(time.Duration(cfg.ConnMaxLifetimeMins) * time.Minute) + pingCtx, cancel := context.WithTimeout(ctx, 10*time.Second) + defer cancel() + if err := db.PingContext(pingCtx); err != nil { + _ = db.Close() + return nil, fmt.Errorf("连接数据库失败:%w", err) + } + return &Database{DB: db}, nil +} + +func normalizeMySQLDSN(dsn string) (string, error) { + cfg, err := mysql.ParseDSN(dsn) + if err != nil { + return "", fmt.Errorf("解析 MySQL 连接信息失败:%w", err) + } + cfg.ParseTime = true + cfg.Loc = time.UTC + return cfg.FormatDSN(), nil +} + +func ensureSQLiteDir(dsn string) error { + path := dsn + if strings.HasPrefix(path, "file:") { + path = strings.TrimPrefix(strings.SplitN(path, "?", 2)[0], "file:") + } + return osMkdirAll(filepath.Dir(path)) +} + +var osMkdirAll = func(path string) error { + if path == "." || path == "" { + return nil + } + return mkdirAll(path) +} + +var mkdirAll = func(path string) error { + return makeDirectory(path) +} + +func (d *Database) Close() error { + if d == nil || d.DB == nil { + return nil + } + return d.DB.Close() +} diff --git a/backend/internal/database/database_test.go b/backend/internal/database/database_test.go new file mode 100644 index 0000000..168eb0e --- /dev/null +++ b/backend/internal/database/database_test.go @@ -0,0 +1,30 @@ +package database + +import ( + "context" + "path/filepath" + "testing" + + "git.pcux.cn/xuans/Scert/backend/internal/config" +) + +func TestOpenAndMigrateSQLite(t *testing.T) { + dir := t.TempDir() + cfg := config.Default(dir) + cfg.Database.DSN = filepath.Join(dir, "data", "test.db") + db, err := Open(context.Background(), cfg.Database) + if err != nil { + t.Fatalf("打开 SQLite 失败:%v", err) + } + defer db.Close() + if err := Migrate(context.Background(), db.DB, "sqlite"); err != nil { + t.Fatalf("SQLite 迁移失败:%v", err) + } + var count int + if err := db.DB.QueryRow("SELECT COUNT(*) FROM schema_migrations").Scan(&count); err != nil { + t.Fatalf("读取迁移版本失败:%v", err) + } + if count != 1 { + t.Fatalf("迁移版本数量错误:%d", count) + } +} diff --git a/backend/internal/database/drivers.go b/backend/internal/database/drivers.go new file mode 100644 index 0000000..7b79a98 --- /dev/null +++ b/backend/internal/database/drivers.go @@ -0,0 +1,7 @@ +package database + +import "os" + +func makeDirectory(path string) error { + return os.MkdirAll(path, 0o750) +} diff --git a/backend/internal/database/migrate.go b/backend/internal/database/migrate.go new file mode 100644 index 0000000..32e1d48 --- /dev/null +++ b/backend/internal/database/migrate.go @@ -0,0 +1,97 @@ +package database + +import ( + "context" + "database/sql" + "embed" + "fmt" + "strings" +) + +//go:embed migrations/sqlite/0001_initial.sql migrations/mysql/0001_initial.sql +var migrationFiles embed.FS + +func Migrate(ctx context.Context, db *sql.DB, driver string) error { + if db == nil { + return fmt.Errorf("数据库连接不能为空") + } + if driver != "sqlite" && driver != "mysql" { + return fmt.Errorf("数据库驱动无效:%s", driver) + } + if _, err := db.ExecContext(ctx, migrationTableSQL(driver)); err != nil { + return fmt.Errorf("创建迁移表失败:%w", err) + } + var version int + err := db.QueryRowContext(ctx, "SELECT version FROM schema_migrations ORDER BY version DESC LIMIT 1").Scan(&version) + if err != nil && err != sql.ErrNoRows { + return fmt.Errorf("读取迁移版本失败:%w", err) + } + if err == sql.ErrNoRows { + version = 0 + } + if version >= 1 { + return nil + } + path := "migrations/sqlite/0001_initial.sql" + if driver == "mysql" { + path = "migrations/mysql/0001_initial.sql" + } + content, err := migrationFiles.ReadFile(path) + if err != nil { + return fmt.Errorf("读取迁移文件失败:%w", err) + } + statements := migrationStatements(content) + if driver == "mysql" { + for _, statement := range statements { + if _, err := db.ExecContext(ctx, statement); err != nil { + return fmt.Errorf("执行数据库迁移失败:%w", err) + } + } + if _, err := db.ExecContext(ctx, "INSERT INTO schema_migrations (version) VALUES (1)"); err != nil { + return fmt.Errorf("记录迁移版本失败:%w", err) + } + return nil + } + tx, err := db.BeginTx(ctx, nil) + if err != nil { + return fmt.Errorf("开始迁移事务失败:%w", err) + } + for _, statement := range statements { + if _, err := tx.ExecContext(ctx, statement); err != nil { + _ = tx.Rollback() + return fmt.Errorf("执行数据库迁移失败:%w", err) + } + } + if _, err := tx.ExecContext(ctx, "INSERT INTO schema_migrations (version) VALUES (1)"); err != nil { + _ = tx.Rollback() + return fmt.Errorf("记录迁移版本失败:%w", err) + } + if err := tx.Commit(); err != nil { + return fmt.Errorf("提交数据库迁移失败:%w", err) + } + return nil +} + +func migrationStatements(content []byte) []string { + statements := make([]string, 0) + for _, statement := range strings.Split(string(content), ";") { + statement = strings.TrimSpace(statement) + if statement != "" { + statements = append(statements, statement) + } + } + return statements +} + +func migrationTableSQL(driver string) string { + if driver == "mysql" { + return `CREATE TABLE IF NOT EXISTS schema_migrations ( + version INT NOT NULL PRIMARY KEY, + applied_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP + )` + } + return `CREATE TABLE IF NOT EXISTS schema_migrations ( + version INTEGER NOT NULL PRIMARY KEY, + applied_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP + )` +} diff --git a/backend/internal/database/migrations/mysql/0001_initial.sql b/backend/internal/database/migrations/mysql/0001_initial.sql new file mode 100644 index 0000000..92ddf35 --- /dev/null +++ b/backend/internal/database/migrations/mysql/0001_initial.sql @@ -0,0 +1,39 @@ +CREATE TABLE IF NOT EXISTS settings ( + `key` VARCHAR(128) NOT NULL PRIMARY KEY, + `value` TEXT NOT NULL, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP +); + +CREATE TABLE IF NOT EXISTS domains ( + id VARCHAR(36) NOT NULL PRIMARY KEY, + name VARCHAR(253) NOT NULL UNIQUE, + certificate_type VARCHAR(32) NOT NULL, + sans_json TEXT NOT NULL, + status VARCHAR(32) NOT NULL, + expires_at DATETIME NULL, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP +); + +CREATE TABLE IF NOT EXISTS tasks ( + id VARCHAR(36) NOT NULL PRIMARY KEY, + domain_id VARCHAR(36) NOT NULL, + task_type VARCHAR(32) NOT NULL, + status VARCHAR(32) NOT NULL, + message TEXT NOT NULL, + started_at DATETIME NULL, + finished_at DATETIME NULL, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + INDEX idx_tasks_domain_id (domain_id) +); + +CREATE TABLE IF NOT EXISTS audit_logs ( + id BIGINT NOT NULL AUTO_INCREMENT PRIMARY KEY, + action VARCHAR(64) NOT NULL, + resource_type VARCHAR(64) NOT NULL, + resource_id VARCHAR(36) NOT NULL, + status VARCHAR(32) NOT NULL, + message TEXT NOT NULL, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + INDEX idx_audit_logs_created_at (created_at) +); diff --git a/backend/internal/database/migrations/sqlite/0001_initial.sql b/backend/internal/database/migrations/sqlite/0001_initial.sql new file mode 100644 index 0000000..4c9bc16 --- /dev/null +++ b/backend/internal/database/migrations/sqlite/0001_initial.sql @@ -0,0 +1,37 @@ +CREATE TABLE IF NOT EXISTS settings ( + key TEXT NOT NULL PRIMARY KEY, + value TEXT NOT NULL, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP +); + +CREATE TABLE IF NOT EXISTS domains ( + id TEXT NOT NULL PRIMARY KEY, + name TEXT NOT NULL UNIQUE, + certificate_type TEXT NOT NULL, + sans_json TEXT NOT NULL, + status TEXT NOT NULL, + expires_at DATETIME NULL, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP +); + +CREATE TABLE IF NOT EXISTS tasks ( + id TEXT NOT NULL PRIMARY KEY, + domain_id TEXT NOT NULL, + task_type TEXT NOT NULL, + status TEXT NOT NULL, + message TEXT NOT NULL, + started_at DATETIME NULL, + finished_at DATETIME NULL, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP +); + +CREATE TABLE IF NOT EXISTS audit_logs ( + id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT, + action TEXT NOT NULL, + resource_type TEXT NOT NULL, + resource_id TEXT NOT NULL, + status TEXT NOT NULL, + message TEXT NOT NULL, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP +); diff --git a/backend/internal/database/review_test.go b/backend/internal/database/review_test.go new file mode 100644 index 0000000..939ef3f --- /dev/null +++ b/backend/internal/database/review_test.go @@ -0,0 +1,68 @@ +package database + +import ( + "context" + "path/filepath" + "testing" + "time" + + "github.com/go-sql-driver/mysql" + + "git.pcux.cn/xuans/Scert/backend/internal/config" +) + +func TestOpenRejectsUnknownDriver(t *testing.T) { + cfg := config.Default(t.TempDir()).Database + cfg.Driver = "postgres" + cfg.DSN = "unused" + if _, err := Open(context.Background(), cfg); err == nil { + t.Fatal("未知数据库驱动未被拒绝") + } +} + +func TestNormalizeMySQLDSNEnablesTimeParsing(t *testing.T) { + dsn, err := normalizeMySQLDSN("user:password@tcp(127.0.0.1:3306)/scert?charset=utf8mb4") + if err != nil { + t.Fatalf("规范化 MySQL DSN 失败:%v", err) + } + parsed, err := mysql.ParseDSN(dsn) + if err != nil { + t.Fatalf("解析规范化后的 MySQL DSN 失败:%v", err) + } + if !parsed.ParseTime || parsed.Loc != time.UTC { + t.Fatal("MySQL DSN 未启用时间解析或未使用 UTC") + } +} + +func TestSQLiteMigrationIsIdempotentAndCreatesBaseTables(t *testing.T) { + dir := t.TempDir() + cfg := config.Default(dir).Database + cfg.DSN = filepath.Join(dir, "data", "review.db") + db, err := Open(context.Background(), cfg) + if err != nil { + t.Fatalf("打开 SQLite 失败:%v", err) + } + defer db.Close() + for i := 0; i < 2; i++ { + if err := Migrate(context.Background(), db.DB, "sqlite"); err != nil { + t.Fatalf("第 %d 次迁移失败:%v", i+1, err) + } + } + var versions int + if err := db.DB.QueryRow("SELECT COUNT(*) FROM schema_migrations").Scan(&versions); err != nil { + t.Fatalf("读取迁移版本失败:%v", err) + } + if versions != 1 { + t.Fatalf("重复迁移写入了多条版本记录:%d", versions) + } + var tables int + if err := db.DB.QueryRow(`SELECT COUNT(*) FROM sqlite_master WHERE type = 'table' AND name IN ('settings', 'domains', 'tasks', 'audit_logs')`).Scan(&tables); err != nil { + t.Fatalf("检查基础数据表失败:%v", err) + } + if tables != 4 { + t.Fatalf("基础数据表数量不正确:%d", tables) + } + if err := Migrate(context.Background(), db.DB, "postgres"); err == nil { + t.Fatal("未知迁移驱动未被拒绝") + } +} diff --git a/backend/internal/domain/domain.go b/backend/internal/domain/domain.go new file mode 100644 index 0000000..4311e91 --- /dev/null +++ b/backend/internal/domain/domain.go @@ -0,0 +1,99 @@ +package domain + +import ( + "crypto/rand" + "fmt" + "regexp" + "strings" + "time" +) + +var domainPattern = regexp.MustCompile(`^(?i)([a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,63}$`) + +type CertificateType string + +const ( + CertificateSingle CertificateType = "single" + CertificateWildcard CertificateType = "wildcard" + CertificateSAN CertificateType = "san" +) + +type Domain struct { + ID string `json:"id"` + Name string `json:"name"` + CertificateType CertificateType `json:"certificate_type"` + SANs []string `json:"sans"` + Status string `json:"status"` + ExpiresAt *time.Time `json:"expires_at,omitempty"` + CreatedAt time.Time `json:"created_at"` + UpdatedAt time.Time `json:"updated_at"` +} + +func NewDomain(name string, certificateType CertificateType, sans []string) (Domain, error) { + name = strings.ToLower(strings.TrimSpace(name)) + if !IsValidName(name) { + return Domain{}, fmt.Errorf("域名格式无效:%s", name) + } + if certificateType != CertificateSingle && certificateType != CertificateWildcard && certificateType != CertificateSAN { + return Domain{}, fmt.Errorf("证书类型无效:%s", certificateType) + } + cleanSANs := normalizeSANs(sans) + if certificateType == CertificateSAN { + cleanSANs = normalizeSANs(append([]string{name}, cleanSANs...)) + } + if certificateType == CertificateSAN && len(cleanSANs) < 2 { + return Domain{}, fmt.Errorf("SAN 证书至少需要两个域名") + } + for _, san := range cleanSANs { + if !IsValidName(san) { + _, err := NewDomain(san, CertificateSingle, nil) + return Domain{}, err + } + } + if certificateType != CertificateSAN { + cleanSANs = []string{name} + } + if certificateType == CertificateWildcard && !strings.HasPrefix(name, "*.") { + return Domain{}, fmt.Errorf("泛域名必须以 *. 开头") + } + if certificateType != CertificateWildcard && strings.HasPrefix(name, "*.") { + return Domain{}, fmt.Errorf("只有泛域名证书类型允许使用 *. 域名") + } + now := time.Now().UTC() + return Domain{ID: NewID(), Name: name, CertificateType: certificateType, SANs: cleanSANs, Status: "pending", CreatedAt: now, UpdatedAt: now}, nil +} + +func IsValidName(name string) bool { + name = strings.TrimSpace(strings.ToLower(name)) + if strings.HasPrefix(name, "*.") { + name = strings.TrimPrefix(name, "*.") + } + return domainPattern.MatchString(name) +} + +func normalizeSANs(sans []string) []string { + seen := make(map[string]struct{}, len(sans)) + result := make([]string, 0, len(sans)) + for _, item := range sans { + item = strings.ToLower(strings.TrimSpace(item)) + if item == "" { + continue + } + if _, ok := seen[item]; ok { + continue + } + seen[item] = struct{}{} + result = append(result, item) + } + return result +} + +func NewID() string { + var b [16]byte + if _, err := rand.Read(b[:]); err != nil { + return fmt.Sprintf("%d", time.Now().UnixNano()) + } + b[6] = (b[6] & 0x0f) | 0x40 + b[8] = (b[8] & 0x3f) | 0x80 + return fmt.Sprintf("%08x-%04x-%04x-%04x-%012x", b[0:4], b[4:6], b[6:8], b[8:10], b[10:16]) +} diff --git a/backend/internal/domain/domain_test.go b/backend/internal/domain/domain_test.go new file mode 100644 index 0000000..1473301 --- /dev/null +++ b/backend/internal/domain/domain_test.go @@ -0,0 +1,57 @@ +package domain + +import "testing" + +func TestNewDomainTypes(t *testing.T) { + tests := []struct { + name string + domainName string + certificateType CertificateType + wantError bool + }{ + {name: "单域名", domainName: "Example.COM", certificateType: CertificateSingle}, + {name: "泛域名", domainName: "*.example.com", certificateType: CertificateWildcard}, + {name: "泛域名缺少前缀", domainName: "example.com", certificateType: CertificateWildcard, wantError: true}, + {name: "单域名使用泛域名", domainName: "*.example.com", certificateType: CertificateSingle, wantError: true}, + {name: "非法证书类型", domainName: "example.com", certificateType: CertificateType("invalid"), wantError: true}, + } + for _, item := range tests { + t.Run(item.name, func(t *testing.T) { + result, err := NewDomain(item.domainName, item.certificateType, nil) + if item.wantError { + if err == nil { + t.Fatal("预期返回错误,实际未返回") + } + return + } + if err != nil { + t.Fatalf("创建域名失败:%v", err) + } + if result.Name == "" || len(result.SANs) != 1 || result.SANs[0] != result.Name { + t.Fatalf("域名规范化结果不正确:%+v", result) + } + }) + } +} + +func TestNewDomainSANIncludesPrimaryAndDeduplicates(t *testing.T) { + result, err := NewDomain("Example.com", CertificateSAN, []string{"www.example.com", "EXAMPLE.COM", "www.example.com"}) + if err != nil { + t.Fatalf("创建 SAN 域名失败:%v", err) + } + if len(result.SANs) != 2 { + t.Fatalf("SAN 去重结果不正确:%v", result.SANs) + } + if result.SANs[0] != "example.com" || result.SANs[1] != "www.example.com" { + t.Fatalf("SAN 未自动包含主域名或顺序异常:%v", result.SANs) + } +} + +func TestNewDomainSANValidation(t *testing.T) { + if _, err := NewDomain("example.com", CertificateSAN, []string{"example.com"}); err == nil { + t.Fatal("仅包含主域名的 SAN 配置未被拒绝") + } + if _, err := NewDomain("example.com", CertificateSAN, []string{"bad_domain"}); err == nil { + t.Fatal("非法 SAN 域名未被拒绝") + } +} diff --git a/backend/internal/httpapi/review_test.go b/backend/internal/httpapi/review_test.go new file mode 100644 index 0000000..21ff32b --- /dev/null +++ b/backend/internal/httpapi/review_test.go @@ -0,0 +1,104 @@ +package httpapi + +import ( + "context" + "database/sql" + "encoding/json" + "errors" + "net/http" + "net/http/httptest" + "strings" + "testing" + + "git.pcux.cn/xuans/Scert/backend/internal/buildinfo" + "git.pcux.cn/xuans/Scert/backend/internal/config" + "git.pcux.cn/xuans/Scert/backend/internal/domain" +) + +type stubDomainRepository struct { + items []domain.Domain + created domain.Domain + listErr error + createErr error + deleteErr error +} + +func (r *stubDomainRepository) Create(_ context.Context, item domain.Domain) error { + r.created = item + return r.createErr +} + +func (r *stubDomainRepository) GetByID(_ context.Context, _ string) (domain.Domain, error) { + return domain.Domain{}, sql.ErrNoRows +} + +func (r *stubDomainRepository) List(_ context.Context) ([]domain.Domain, error) { + return r.items, r.listErr +} + +func (r *stubDomainRepository) Delete(_ context.Context, _ string) error { + return r.deleteErr +} + +func TestStatusReturnsApplicationAndConfigVersions(t *testing.T) { + cfg := config.Default(t.TempDir()) + server := New(Dependencies{Config: cfg, Repository: &stubDomainRepository{}}) + response := httptest.NewRecorder() + server.Handler().ServeHTTP(response, httptest.NewRequest(http.MethodGet, "/api/v1/status", nil)) + if response.Code != http.StatusOK { + t.Fatalf("状态接口响应错误:%d", response.Code) + } + var payload struct { + Version string `json:"version"` + ConfigVersion int `json:"config_version"` + } + if err := json.Unmarshal(response.Body.Bytes(), &payload); err != nil { + t.Fatalf("解析状态响应失败:%v", err) + } + if payload.Version != buildinfo.Version || payload.ConfigVersion != config.CurrentVersion { + t.Fatalf("状态版本字段不正确:%+v", payload) + } +} + +func TestDomainAPIValidatesSANAndHidesInternalErrors(t *testing.T) { + cfg := config.Default(t.TempDir()) + repo := &stubDomainRepository{} + server := New(Dependencies{Config: cfg, Repository: repo}) + + invalid := httptest.NewRequest(http.MethodPost, "/api/v1/domains", strings.NewReader(`{"name":"example.com","certificate_type":"san","sans":["bad_domain"]}`)) + invalid.Header.Set("Content-Type", "application/json") + invalidResponse := httptest.NewRecorder() + server.Handler().ServeHTTP(invalidResponse, invalid) + if invalidResponse.Code != http.StatusBadRequest || strings.Contains(invalidResponse.Body.String(), "detail") { + t.Fatalf("非法 SAN 响应不正确:%d %s", invalidResponse.Code, invalidResponse.Body.String()) + } + + valid := httptest.NewRequest(http.MethodPost, "/api/v1/domains", strings.NewReader(`{"name":"example.com","certificate_type":"san","sans":["www.example.com"]}`)) + valid.Header.Set("Content-Type", "application/json") + validResponse := httptest.NewRecorder() + server.Handler().ServeHTTP(validResponse, valid) + if validResponse.Code != http.StatusCreated || len(repo.created.SANs) != 2 || repo.created.SANs[0] != "example.com" { + t.Fatalf("合法 SAN 响应不正确:%d %s", validResponse.Code, validResponse.Body.String()) + } + + repo.listErr = errors.New("internal-dsn-secret") + listResponse := httptest.NewRecorder() + server.Handler().ServeHTTP(listResponse, httptest.NewRequest(http.MethodGet, "/api/v1/domains", nil)) + if listResponse.Code != http.StatusInternalServerError { + t.Fatalf("列表错误状态码不正确:%d", listResponse.Code) + } + if strings.Contains(listResponse.Body.String(), "internal-dsn-secret") || strings.Contains(listResponse.Body.String(), "detail") { + t.Fatalf("接口泄露了底层错误:%s", listResponse.Body.String()) + } +} + +func TestDeleteMissingDomainReturnsNotFound(t *testing.T) { + cfg := config.Default(t.TempDir()) + repo := &stubDomainRepository{deleteErr: sql.ErrNoRows} + server := New(Dependencies{Config: cfg, Repository: repo}) + response := httptest.NewRecorder() + server.Handler().ServeHTTP(response, httptest.NewRequest(http.MethodDelete, "/api/v1/domains/missing", nil)) + if response.Code != http.StatusNotFound || strings.Contains(response.Body.String(), "detail") { + t.Fatalf("删除不存在域名响应不正确:%d %s", response.Code, response.Body.String()) + } +} diff --git a/backend/internal/httpapi/server.go b/backend/internal/httpapi/server.go new file mode 100644 index 0000000..19b79ba --- /dev/null +++ b/backend/internal/httpapi/server.go @@ -0,0 +1,146 @@ +package httpapi + +import ( + "context" + "errors" + "net" + "net/http" + "strconv" + "time" + + "github.com/gin-gonic/gin" + + "git.pcux.cn/xuans/Scert/backend/internal/buildinfo" + "git.pcux.cn/xuans/Scert/backend/internal/config" + "git.pcux.cn/xuans/Scert/backend/internal/domain" + "git.pcux.cn/xuans/Scert/backend/internal/logging" + "git.pcux.cn/xuans/Scert/backend/internal/repository" +) + +type Dependencies struct { + Config config.Config + Logger *logging.Logger + Repository repository.DomainRepository +} + +type Server struct { + config config.Config + logger *logging.Logger + repository repository.DomainRepository + httpServer *http.Server + router *gin.Engine +} + +func New(deps Dependencies) *Server { + gin.SetMode(gin.ReleaseMode) + router := gin.New() + router.Use(gin.Recovery()) + server := &Server{config: deps.Config, logger: deps.Logger, repository: deps.Repository, router: router} + server.registerRoutes() + return server +} + +func (s *Server) registerRoutes() { + s.router.GET("/healthz", s.health) + s.router.GET("/api/v1/status", s.status) + s.router.GET("/api/v1/domains", s.listDomains) + s.router.POST("/api/v1/domains", s.createDomain) + s.router.DELETE("/api/v1/domains/:id", s.deleteDomain) +} + +func (s *Server) Handler() http.Handler { + return s.router +} + +func (s *Server) ListenAndServe() error { + s.httpServer = &http.Server{ + Addr: net.JoinHostPort(s.config.Server.Host, strconv.Itoa(s.config.Server.Port)), + Handler: s.router, + ReadHeaderTimeout: 10 * time.Second, + ReadTimeout: 30 * time.Second, + WriteTimeout: 30 * time.Second, + IdleTimeout: 60 * time.Second, + } + if s.logger != nil { + s.logger.Info("HTTP 服务启动", "address", s.httpServer.Addr, "https_mode", s.config.Server.HTTPSMode) + } + return s.httpServer.ListenAndServe() +} + +func (s *Server) Shutdown(ctx context.Context) error { + if s.httpServer == nil { + return nil + } + err := s.httpServer.Shutdown(ctx) + if errors.Is(err, http.ErrServerClosed) { + return nil + } + return err +} + +type createDomainRequest struct { + Name string `json:"name" binding:"required"` + CertificateType string `json:"certificate_type" binding:"required"` + SANs []string `json:"sans"` +} + +func (s *Server) health(c *gin.Context) { + c.JSON(http.StatusOK, gin.H{"status": "ok", "service": "scert"}) +} + +func (s *Server) status(c *gin.Context) { + c.JSON(http.StatusOK, gin.H{ + "service": "scert", + "version": buildinfo.Version, + "config_version": s.config.Version, + "setup_ready": s.config.SetupReady, + "https_mode": s.config.Server.HTTPSMode, + "database_driver": s.config.Database.Driver, + }) +} + +func (s *Server) listDomains(c *gin.Context) { + items, err := s.repository.List(c.Request.Context()) + if err != nil { + s.writeError(c, http.StatusInternalServerError, "查询域名失败", err) + return + } + c.JSON(http.StatusOK, gin.H{"items": items}) +} + +func (s *Server) createDomain(c *gin.Context) { + var request createDomainRequest + if err := c.ShouldBindJSON(&request); err != nil { + s.writeError(c, http.StatusBadRequest, "请求参数无效", err) + return + } + item, err := domain.NewDomain(request.Name, domain.CertificateType(request.CertificateType), request.SANs) + if err != nil { + s.writeError(c, http.StatusBadRequest, "域名配置无效", err) + return + } + if err := s.repository.Create(c.Request.Context(), item); err != nil { + s.writeError(c, http.StatusInternalServerError, "保存域名失败", err) + return + } + c.JSON(http.StatusCreated, item) +} + +func (s *Server) deleteDomain(c *gin.Context) { + if err := s.repository.Delete(c.Request.Context(), c.Param("id")); err != nil { + if repository.IsNotFound(err) { + s.writeError(c, http.StatusNotFound, "域名不存在", err) + return + } + s.writeError(c, http.StatusInternalServerError, "删除域名失败", err) + return + } + c.Status(http.StatusNoContent) +} + +func (s *Server) writeError(c *gin.Context, status int, message string, err error) { + if s.logger != nil { + s.logger.Error(message, "error", err) + } + c.JSON(status, gin.H{"error": message}) +} diff --git a/backend/internal/httpapi/server_test.go b/backend/internal/httpapi/server_test.go new file mode 100644 index 0000000..67fedfd --- /dev/null +++ b/backend/internal/httpapi/server_test.go @@ -0,0 +1,55 @@ +package httpapi + +import ( + "context" + "net/http" + "net/http/httptest" + "path/filepath" + "strings" + "testing" + + "git.pcux.cn/xuans/Scert/backend/internal/config" + "git.pcux.cn/xuans/Scert/backend/internal/database" + "git.pcux.cn/xuans/Scert/backend/internal/logging" + "git.pcux.cn/xuans/Scert/backend/internal/repository" +) + +func TestHealthAndDomainAPI(t *testing.T) { + dir := t.TempDir() + cfg := config.Default(dir) + cfg.Database.DSN = filepath.Join(dir, "data", "test.db") + db, err := database.Open(context.Background(), cfg.Database) + if err != nil { + t.Fatalf("打开数据库失败:%v", err) + } + defer db.Close() + if err := database.Migrate(context.Background(), db.DB, "sqlite"); err != nil { + t.Fatalf("数据库迁移失败:%v", err) + } + logger, err := logging.New(filepath.Join(dir, "logs"), 0) + if err != nil { + t.Fatalf("初始化日志失败:%v", err) + } + defer logger.Close() + server := New(Dependencies{Config: cfg, Logger: logger, Repository: repository.NewSQLDomainRepository(db.DB)}) + + health := httptest.NewRecorder() + server.Handler().ServeHTTP(health, httptest.NewRequest(http.MethodGet, "/healthz", nil)) + if health.Code != http.StatusOK || !strings.Contains(health.Body.String(), `"status":"ok"`) { + t.Fatalf("健康检查响应错误:%d %s", health.Code, health.Body.String()) + } + + request := httptest.NewRequest(http.MethodPost, "/api/v1/domains", strings.NewReader(`{"name":"example.com","certificate_type":"single"}`)) + request.Header.Set("Content-Type", "application/json") + created := httptest.NewRecorder() + server.Handler().ServeHTTP(created, request) + if created.Code != http.StatusCreated { + t.Fatalf("创建域名响应错误:%d %s", created.Code, created.Body.String()) + } + + list := httptest.NewRecorder() + server.Handler().ServeHTTP(list, httptest.NewRequest(http.MethodGet, "/api/v1/domains", nil)) + if list.Code != http.StatusOK || !strings.Contains(list.Body.String(), "example.com") { + t.Fatalf("域名列表响应错误:%d %s", list.Code, list.Body.String()) + } +} diff --git a/backend/internal/logging/logging.go b/backend/internal/logging/logging.go new file mode 100644 index 0000000..c0741e9 --- /dev/null +++ b/backend/internal/logging/logging.go @@ -0,0 +1,38 @@ +package logging + +import ( + "io" + "log/slog" + "os" + "path/filepath" +) + +type Logger struct { + *slog.Logger + file *os.File +} + +func New(logDir string, level slog.Level) (*Logger, error) { + if err := os.MkdirAll(logDir, 0o750); err != nil { + return nil, err + } + path := filepath.Join(logDir, "scert.log") + file, err := os.OpenFile(path, os.O_CREATE|os.O_APPEND|os.O_WRONLY, 0o600) + if err != nil { + return nil, err + } + if err := file.Chmod(0o600); err != nil { + _ = file.Close() + return nil, err + } + writer := io.MultiWriter(os.Stdout, file) + handler := slog.NewJSONHandler(writer, &slog.HandlerOptions{Level: level}) + return &Logger{Logger: slog.New(handler), file: file}, nil +} + +func (l *Logger) Close() error { + if l == nil || l.file == nil { + return nil + } + return l.file.Close() +} diff --git a/backend/internal/logging/logging_test.go b/backend/internal/logging/logging_test.go new file mode 100644 index 0000000..624cb46 --- /dev/null +++ b/backend/internal/logging/logging_test.go @@ -0,0 +1,40 @@ +package logging + +import ( + "log/slog" + "os" + "path/filepath" + "runtime" + "strings" + "testing" +) + +func TestLoggerWritesJSONAndUsesRestrictedPermissions(t *testing.T) { + dir := t.TempDir() + logger, err := New(dir, slog.LevelInfo) + if err != nil { + t.Fatalf("初始化日志失败:%v", err) + } + logger.Info("复审日志", "component", "test") + if err := logger.Close(); err != nil { + t.Fatalf("关闭日志失败:%v", err) + } + path := filepath.Join(dir, "scert.log") + data, err := os.ReadFile(path) + if err != nil { + t.Fatalf("读取日志失败:%v", err) + } + text := string(data) + if !strings.Contains(text, `"msg":"复审日志"`) || !strings.Contains(text, `"component":"test"`) { + t.Fatalf("日志内容不正确:%s", text) + } + if runtime.GOOS != "windows" { + info, err := os.Stat(path) + if err != nil { + t.Fatalf("读取日志权限失败:%v", err) + } + if info.Mode().Perm() != 0o600 { + t.Fatalf("日志文件权限不正确:%o", info.Mode().Perm()) + } + } +} diff --git a/backend/internal/repository/domain_repository.go b/backend/internal/repository/domain_repository.go new file mode 100644 index 0000000..7de59a6 --- /dev/null +++ b/backend/internal/repository/domain_repository.go @@ -0,0 +1,14 @@ +package repository + +import ( + "context" + + "git.pcux.cn/xuans/Scert/backend/internal/domain" +) + +type DomainRepository interface { + Create(ctx context.Context, item domain.Domain) error + GetByID(ctx context.Context, id string) (domain.Domain, error) + List(ctx context.Context) ([]domain.Domain, error) + Delete(ctx context.Context, id string) error +} diff --git a/backend/internal/repository/sql_domain_repository.go b/backend/internal/repository/sql_domain_repository.go new file mode 100644 index 0000000..d6e427e --- /dev/null +++ b/backend/internal/repository/sql_domain_repository.go @@ -0,0 +1,126 @@ +package repository + +import ( + "context" + "database/sql" + "encoding/json" + "errors" + "fmt" + "time" + + "git.pcux.cn/xuans/Scert/backend/internal/domain" +) + +type SQLDomainRepository struct { + db *sql.DB +} + +func NewSQLDomainRepository(db *sql.DB) *SQLDomainRepository { + return &SQLDomainRepository{db: db} +} + +func (r *SQLDomainRepository) Create(ctx context.Context, item domain.Domain) error { + if r == nil || r.db == nil { + return errors.New("数据库连接不能为空") + } + payload, err := json.Marshal(item.SANs) + if err != nil { + return fmt.Errorf("编码 SAN 域名失败:%w", err) + } + _, err = r.db.ExecContext(ctx, `INSERT INTO domains + (id, name, certificate_type, sans_json, status, expires_at, created_at, updated_at) + VALUES (?, ?, ?, ?, ?, ?, ?, ?)`, item.ID, item.Name, item.CertificateType, string(payload), item.Status, + nullableTime(item.ExpiresAt), item.CreatedAt, item.UpdatedAt) + if err != nil { + return fmt.Errorf("保存域名失败:%w", err) + } + return nil +} + +func (r *SQLDomainRepository) GetByID(ctx context.Context, id string) (domain.Domain, error) { + if r == nil || r.db == nil { + return domain.Domain{}, errors.New("数据库连接不能为空") + } + row := r.db.QueryRowContext(ctx, `SELECT id, name, certificate_type, sans_json, status, expires_at, created_at, updated_at + FROM domains WHERE id = ?`, id) + return scanDomain(row) +} + +func (r *SQLDomainRepository) List(ctx context.Context) ([]domain.Domain, error) { + if r == nil || r.db == nil { + return nil, errors.New("数据库连接不能为空") + } + rows, err := r.db.QueryContext(ctx, `SELECT id, name, certificate_type, sans_json, status, expires_at, created_at, updated_at + FROM domains ORDER BY name`) + if err != nil { + return nil, fmt.Errorf("查询域名失败:%w", err) + } + defer rows.Close() + items := make([]domain.Domain, 0) + for rows.Next() { + item, err := scanDomain(rows) + if err != nil { + return nil, err + } + items = append(items, item) + } + if err := rows.Err(); err != nil { + return nil, fmt.Errorf("读取域名结果失败:%w", err) + } + return items, nil +} + +func (r *SQLDomainRepository) Delete(ctx context.Context, id string) error { + if r == nil || r.db == nil { + return errors.New("数据库连接不能为空") + } + result, err := r.db.ExecContext(ctx, "DELETE FROM domains WHERE id = ?", id) + if err != nil { + return fmt.Errorf("删除域名失败:%w", err) + } + count, err := result.RowsAffected() + if err != nil { + return fmt.Errorf("读取删除结果失败:%w", err) + } + if count == 0 { + return sql.ErrNoRows + } + return nil +} + +type scanner interface { + Scan(dest ...any) error +} + +func scanDomain(row scanner) (domain.Domain, error) { + var item domain.Domain + var certificateType string + var sansJSON string + var expiresAt sql.NullTime + if err := row.Scan(&item.ID, &item.Name, &certificateType, &sansJSON, &item.Status, &expiresAt, &item.CreatedAt, &item.UpdatedAt); err != nil { + if errors.Is(err, sql.ErrNoRows) { + return domain.Domain{}, sql.ErrNoRows + } + return domain.Domain{}, fmt.Errorf("读取域名失败:%w", err) + } + if err := json.Unmarshal([]byte(sansJSON), &item.SANs); err != nil { + return domain.Domain{}, fmt.Errorf("解析 SAN 域名失败:%w", err) + } + item.CertificateType = domain.CertificateType(certificateType) + if expiresAt.Valid { + value := expiresAt.Time + item.ExpiresAt = &value + } + return item, nil +} + +func nullableTime(value *time.Time) any { + if value == nil { + return nil + } + return value.UTC() +} + +func IsNotFound(err error) bool { + return err != nil && errors.Is(err, sql.ErrNoRows) +} diff --git a/backend/internal/repository/sql_domain_repository_test.go b/backend/internal/repository/sql_domain_repository_test.go new file mode 100644 index 0000000..a770540 --- /dev/null +++ b/backend/internal/repository/sql_domain_repository_test.go @@ -0,0 +1,78 @@ +package repository + +import ( + "context" + "database/sql" + "path/filepath" + "testing" + + "git.pcux.cn/xuans/Scert/backend/internal/config" + "git.pcux.cn/xuans/Scert/backend/internal/database" + "git.pcux.cn/xuans/Scert/backend/internal/domain" +) + +func TestRepositoryRejectsNilDatabase(t *testing.T) { + var repo *SQLDomainRepository + ctx := context.Background() + item, err := domain.NewDomain("example.com", domain.CertificateSingle, nil) + if err != nil { + t.Fatalf("准备域名失败:%v", err) + } + if err := repo.Create(ctx, item); err == nil { + t.Fatal("Create 未拒绝空数据库") + } + if _, err := repo.GetByID(ctx, item.ID); err == nil { + t.Fatal("GetByID 未拒绝空数据库") + } + if _, err := repo.List(ctx); err == nil { + t.Fatal("List 未拒绝空数据库") + } + if err := repo.Delete(ctx, item.ID); err == nil { + t.Fatal("Delete 未拒绝空数据库") + } + if IsNotFound(nil) { + t.Fatal("nil 错误不应被识别为未找到") + } + if !IsNotFound(sql.ErrNoRows) { + t.Fatal("sql.ErrNoRows 未被识别为未找到") + } +} + +func TestRepositoryCRUD(t *testing.T) { + dir := t.TempDir() + cfg := config.Default(dir).Database + cfg.DSN = filepath.Join(dir, "data", "repository.db") + db, err := database.Open(context.Background(), cfg) + if err != nil { + t.Fatalf("打开数据库失败:%v", err) + } + defer db.Close() + if err := database.Migrate(context.Background(), db.DB, "sqlite"); err != nil { + t.Fatalf("迁移数据库失败:%v", err) + } + repo := NewSQLDomainRepository(db.DB) + item, err := domain.NewDomain("example.com", domain.CertificateSAN, []string{"www.example.com"}) + if err != nil { + t.Fatalf("创建域名模型失败:%v", err) + } + if err := repo.Create(context.Background(), item); err != nil { + t.Fatalf("保存域名失败:%v", err) + } + loaded, err := repo.GetByID(context.Background(), item.ID) + if err != nil { + t.Fatalf("读取域名失败:%v", err) + } + if loaded.Name != item.Name || len(loaded.SANs) != 2 { + t.Fatalf("读取域名内容不正确:%+v", loaded) + } + items, err := repo.List(context.Background()) + if err != nil || len(items) != 1 { + t.Fatalf("域名列表不正确:%v,%+v", err, items) + } + if err := repo.Delete(context.Background(), item.ID); err != nil { + t.Fatalf("删除域名失败:%v", err) + } + if err := repo.Delete(context.Background(), item.ID); !IsNotFound(err) { + t.Fatalf("重复删除未返回未找到:%v", err) + } +} diff --git a/doc/SSL服务程序技术架构设计文档.md b/doc/SSL服务程序技术架构设计文档.md new file mode 100644 index 0000000..9e4b2d7 --- /dev/null +++ b/doc/SSL服务程序技术架构设计文档.md @@ -0,0 +1,1168 @@ +# SSL 服务程序技术架构设计文档 + +- 项目名:Scert +- 关联需求文档:`SSL服务程序需求确认文档.md` +- 文档状态:技术架构草案,已按用户最新决策切换为 `lego`、MySQL/SQLite 双数据库和双 HTTPS 模式,等待代码实现复审 +- 创建日期:2026-08-25 +- 适用版本:第一阶段 + +> 本文档根据用户提供的技术选型草案和已经确认的需求整理形成。保留 Go、Gin、Cobra、MySQL、SQLite、Vue、Wails 等总体方向,并对与已确认需求冲突的部分进行调整。 +> +> 本文档暂不替代需求确认文档。代码目录、依赖锁定和实际平台测试完成后,才能冻结为发布基线。 +> +> **架构决策变更:**第一阶段使用 `go-acme/lego`;多域名 SAN 纳入第一阶段;管理后台采用双 HTTPS 模式;通知通过外部 HTTP API 和 SMTP 适配器发送;数据库支持 MySQL 和 SQLite。 + +--- + +## 一、架构目标和边界 + +### 1.1 架构目标 + +1. 使用同一套核心业务服务支撑 CLI、Web 管理界面和桌面图形界面。 +2. 使用 Let’s Encrypt 和 `go-acme/lego` 完成证书申请、DNS-01 验证和自动续期。 +3. 在 Windows 和 Linux 上使用同一套业务模型、任务模型和配置模型。 +4. 证书申请、续期、部署、校验和通知全部通过可恢复的持久化任务执行。 +5. 证书私钥、DNS 凭据、SSH 私钥和 SMTP 凭据采用统一的敏感信息保护机制。 +6. 第一阶段保持单实例、单数据库、单申请任务串行执行,暂不引入高可用集群复杂度。 + +### 1.2 第一阶段边界 + +第一阶段包含: + +- Go 核心服务 +- Gin Web API +- Vue Web 管理界面 +- Cobra CLI +- Wails 桌面封装 +- MySQL 和 SQLite 双数据库模式 +- Let’s Encrypt + `go-acme/lego` +- DNS-01 和 DNS 服务商适配器 +- CNAME 委派自动创建及失败手动提示 +- SSH/SFTP 多服务器部署 +- Nginx 及主流 Web 服务器、反向代理适配接口 +- HTTP 和 SMTP 通知 +- 外部邮件/消息服务 HTTP API 通知 +- 用户自有证书上传和手动部署 +- Windows Service、Linux systemd +- 审计日志、任务重试、部署回滚和数据库备份 + +暂不作为第一阶段默认实现: + +- 高可用、多实例和集群部署 +- ARM64 +- 自定义 ACME CA +- SMTP、IMAP、POP3 邮件服务器端实现不属于 Scert 范围;Scert 仅通过外部邮件服务 API 或 SMTP 出站客户端发送通知 + +> **边界说明:**SMTP、IMAP、POP3 协议表仅作为外部邮件服务兼容性参考。Scert 不实现邮件服务器端,通知通过外部 HTTP API 和 SMTP 客户端适配器完成。 + +--- + +## 二、总体架构 + +### 2.1 逻辑架构 + +```text ++----------------------+ +--------------------------+ +| Web 管理界面 | | 桌面客户端(Wails) | +| Vue + Vite | | 启动/监控本地核心服务 | ++----------+-----------+ +-------------+------------+ + | HTTP API | + +----------------+----------------+ + v + +--------------------------+ + | Scert 核心服务 | + | Go + Gin | + +------------+-------------+ + | + +----------------------+----------------------+ + | | | + v v v ++-------------+ +---------------+ +---------------+ +| 业务服务层 | | 任务调度/队列 | | 认证与权限层 | +| 域名/证书 | | 持久化任务 | | 用户/角色/会话 | +| 续期/部署 | | 单申请任务锁 | | 审计记录 | ++------+------+ +-------+-------+ +---------------+ + | | + +----------+----------+ + v + +--------------------+ + | 基础设施适配层 | + | MySQL/SQLite / lego | + | DNS / SSH / 通知 | + | 文件系统 / HTTPS | + +--------------------+ +``` + +### 2.2 进程组成 + +#### 核心服务进程 + +建议使用一个 Go 二进制提供以下子命令: + +```text +scert init 初始化基础配置 +scert serve 启动核心服务和 Web API +scert status 通过 API 查询服务状态 +scert task 通过 API 查询和等待任务 +``` + +核心服务启动后负责: + +- 提供 Web API 和前端静态资源 +- 执行认证、权限检查和审计 +- 调度续期、部署、校验和通知任务 +- 访问数据库和加密配置 +- 调用 `lego`、DNS API、SSH/SFTP 和通知适配器 + +CLI 在初始化完成后不直接操作数据库。`init` 负责交互式填写基础配置;`status` 和 `task wait` 只提供非交互式状态查询和任务等待能力,不承担域名、证书、DNS、服务器或通知配置的日常管理。初始化后的日常管理统一通过 Web 管理界面完成。 + +#### 桌面客户端进程 + +桌面版不是第二套业务服务,而是: + +1. 启动或连接本机 Scert 核心服务。 +2. 检查核心服务健康状态。 +3. 使用 Wails 加载同一套 Vue 页面。 +4. 提供系统托盘、后台任务状态和退出/重启服务操作。 +5. 根据用户选择配置开机自启动。 + +--- + +## 三、技术选型及优化结果 + +### 3.1 后端 + +| 模块 | 推荐选型 | 调整说明 | +|---|---|---| +| 编程语言 | Go | 保留,适合单二进制、跨平台服务和并发任务 | +| Web 框架 | Gin | 保留,用于 REST API、中间件和路由 | +| CLI | Cobra | 保留,CLI 作为核心服务 API 客户端 | +| 数据库 | MySQL 5.7 / MySQL 8.0 / SQLite | MySQL 5.7 作为基础开发和最低兼容版本,MySQL 8.0 作为兼容性测试版本;SQLite 用于单机、桌面和开发模式 | +| 数据库驱动 | `go-sql-driver/mysql`、`modernc.org/sqlite` | 使用 `database/sql` 统一访问;MySQL 和 SQLite 分别维护迁移脚本与方言适配 | +| 数据访问 | `database/sql` + Repository | 不强制使用 GORM,避免隐式查询和迁移行为;复杂查询使用明确 SQL,并通过数据库方言适配层处理差异 | +| 配置管理 | 类型化配置服务 + MySQL/SQLite | 不把 Viper 热加载作为运行时配置源;Viper 如保留,仅用于初始化文件、环境变量或命令行参数解析;敏感配置统一由加密配置服务管理 | +| 任务调度 | 持久化任务队列 + 内部调度器 | 不使用单纯 cron 承担任务状态、重试和恢复 | +| ACME | `go-acme/lego` 原生 Go 适配器 | 按用户最新确认,第一阶段使用 `lego` 完成申请、DNS-01 验证、续期和撤销 | +| SSH | `golang.org/x/crypto/ssh` | 密钥认证、主机指纹校验和远程命令执行 | +| SFTP | SSH 子系统适配器 | 用于安全上传证书文件,具体库在依赖验证阶段锁定 | +| 邮件 | HTTP API + SMTP 客户端适配器 | HTTP 调用外部邮件/消息服务 API,SMTP 支持明文连接限制、STARTTLS 和隐式 TLS;Scert 不实现 SMTP/IMAP/POP3 服务端 | +| 日志 | `log/slog` | 结构化日志,统一脱敏和审计字段 | +| 静态资源 | `embed` | 将 Vue 构建产物嵌入核心服务二进制 | +| 数据库迁移 | 版本化 SQL Migration | 启动时执行可追踪、可回滚的数据库迁移 | +| 图形界面 | Wails | 作为 Web 管理界面封装,不重复实现业务逻辑 | + +### 3.2 运行时依赖原则 + +- 核心服务本身尽量保持单个 Go 可执行文件交付,证书申请和 DNS API 调用不依赖外部 Shell 或脚本运行时。 +- `lego`、DNS provider、证书解析、任务调度和部署逻辑均作为 Go 模块或内部适配器实现,减少 Linux 与 Windows 的行为差异。 +- 初始化阶段仍需要预检公网连通性、DNS API 权限、证书存储目录、系统时间和文件权限;这些预检必须使用 Go 实现,不依赖平台特定 Shell 命令。 +- DNS 凭据只以受控配置对象传递到 provider,禁止出现在命令行参数、日志、任务错误详情和 API 响应中。 +- 证书链和私钥校验优先使用 Go 标准库 `crypto/x509`;只有确实需要调用外部 Web 服务器检查命令时,才通过平台命令执行适配器运行白名单命令。 +- Windows 和 Linux 的服务注册、文件权限、路径规范化和系统托盘仍由平台适配层分别实现。 +- 安装、升级和卸载不得删除用户证书、数据库或备份;所有删除操作必须经过 Web/CLI 明确确认并写入审计日志。 + +### 3.3 前端 + +| 模块 | 推荐选型 | 说明 | +|---|---|---| +| 框架 | Vue | Web 和桌面版共享 | +| 构建 | Vite | 前端构建和开发服务器 | +| 组件库 | Naive UI | 管理后台表单、表格和状态展示 | +| 状态管理 | Pinia | 用户、域名、任务和系统配置状态 | +| 路由 | Vue Router | 页面路由和权限控制 | +| HTTP 客户端 | Axios 或封装后的 `fetch` | 统一处理认证、错误、任务轮询和超时 | + +### 3.4 关键调整 + +#### 调整一:采用 `lego` 原生集成 ACME + +根据用户最新确认,第一阶段改用 `go-acme/lego`。相比外部进程方案,`lego` 可以直接嵌入 Go 服务,减少 Shell 运行时依赖,并便于统一处理超时、取消、错误分类、日志脱敏和跨平台行为。 + +建议抽象为: + +```go +type CertificateIssuer interface { + Issue(ctx context.Context, request IssueRequest) (IssueResult, error) + Renew(ctx context.Context, request RenewRequest) (RenewResult, error) + Revoke(ctx context.Context, request RevokeRequest) error +} +``` + +第一阶段实现: + +```text +LegoIssuer -> lego ACME client -> DNS provider adapter +``` + +`CertificateIssuer` 仍需屏蔽 CA、账户、DNS provider 和证书文件布局差异,避免后续接入其他 ACME CA 时改动业务层。 + +#### 调整二:使用持久化任务调度替代单纯每日 cron + +需求不是简单的“每天运行一次”,而是: + +- 常规每 3 天检查 +- 剩余有效期低于 10 天时每天检查 +- 剩余有效期低于 6 天触发续期 +- 剩余有效期低于 3 天进入紧急重试 +- 默认重试 3 次,每次间隔 30 分钟 +- 服务重启后恢复任务状态 +- 同一时间只运行一个证书申请任务 + +因此采用: + +```text +调度器 + -> 创建 RenewalTask + -> 数据库持久化 + -> Worker 获取任务租约 + -> 执行申请/部署/校验 + -> 保存状态、重试时间和错误 +``` + +`robfig/cron` 可以作为周期触发器,但不能作为任务状态存储、重试管理和崩溃恢复机制。 + +#### 调整三:服务器和域名使用多对多关系 + +原方案在 `servers` 表中直接使用 `domain_id`,只能表达“一台服务器属于一个域名”。实际需求允许: + +- 一个域名部署到多台服务器 +- 一台服务器部署多个域名 +- 每个域名在每台服务器上使用不同证书路径和 reload 命令 + +因此需要使用: + +```text +domains +servers + domain_servers +``` + +部署参数放在 `domain_servers` 关联表中,而不是只放在服务器基础信息表中。 + +#### 调整四:不把敏感配置放入普通 settings 键值表 + +普通配置和敏感配置分离: + +- 普通配置:数据库中的类型化配置表 +- 敏感配置:加密密文、密钥版本和轮换信息 +- 密钥材料:由主密码派生的加密密钥解密 +- 日志:只记录配置编号、版本和操作结果,不记录明文 + +--- + +## 四、核心模块设计 + +### 4.1 配置和密钥模块 + +职责: + +- 管理初始化状态 +- 管理管理后台域名、存储路径和通知配置 +- 保存 DNS API、SSH 私钥、SMTP 密码等敏感信息 +- 使用主密码解锁加密配置 +- 支持敏感信息轮换 +- 支持加密密钥备份和恢复校验 + +禁止: + +- 在日志中输出明文密钥 +- 在 API 响应中返回完整密钥 +- 使用普通 settings 表保存明文凭据 + +### 4.2 证书生命周期模块 + +职责: + +- 域名和证书类型校验 +- 生产/开发环境分类 +- 单域名和泛域名证书处理 +- 证书和私钥匹配校验 +- 证书链完整性校验 +- 到期时间和域名匹配校验 +- 证书版本保存、当前版本切换和历史版本保留 +- 失败时保留原证书 + +第一阶段正式实现 SAN,证书以主域名作为管理归属,并保存完整的证书标识集合快照。 + +### 4.3 `lego` 适配模块 + +```text +CertificateService + | + v +LegoIssuer + | + +-- ACME directory adapter + +-- DNS provider adapter + +-- Account and certificate store +``` + +要求: + +- 默认支持 Let’s Encrypt Production 和 Staging 两套 ACME Directory +- ACME 账户密钥、订单状态和证书版本分离保存,任务失败不能污染当前版本 +- 每次执行使用独立任务上下文和证书版本目录 +- 保存 CA 响应摘要、步骤状态和执行耗时 +- 禁止把 DNS 密钥、账户私钥和挑战值写入普通日志 +- 申请任务全局串行 +- 支持超时、取消、重试和失败清理 +- 申请成功后由 Go 代码完成证书解析、私钥匹配、版本保存和目录切换 +- 不直接把 `lego` 的内部状态当作 Scert 对外证书目录 +- DNS provider 通过显式接口注入,默认一个 provider 配置可以服务多个域名,支持域名级覆盖 +- 将 ACME 错误分类为 DNS、限流、账户、网络、验证、证书解析和未知错误,供任务重试策略使用 +- Windows 与 Linux 共用同一套 ACME 业务流程,仅在路径、权限和服务生命周期适配层区分 + +### 4.4 DNS 服务商模块 + +使用适配器: + +```go +type DnsProvider interface { + Validate(ctx context.Context, config ProviderConfig) error + DetectZone(ctx context.Context, fqdn string) (ZoneInfo, error) + CheckPermission(ctx context.Context, zone ZoneInfo) error + UpsertTxt(ctx context.Context, record TxtRecord) error + DeleteTxt(ctx context.Context, record TxtRecord) error + CreateDelegation(ctx context.Context, delegation DelegationRecord) error +} +``` + +流程: + +1. 检测 DNS Zone。 +2. 检测 API 权限。 +3. 检测是否支持 CNAME 委派自动创建。 +4. 自动创建委派;失败时显示完整记录并提示手动创建。 +5. 写入 TXT 记录。 +6. 检测 DNS 传播。 +7. 由 `lego` 完成 DNS-01 验证。 +8. 任务结束后清理临时记录。 + +### 4.5 续期调度和任务模块 + +建议使用数据库任务表实现: + +```text +Scheduler + -> RenewalTask + -> CertificateIssueStep + -> DeploymentStep + -> ValidationStep + -> NotificationStep +``` + +任务必须包含: + +- 任务编号 +- 任务类型 +- 当前状态 +- 域名和证书版本 +- 尝试次数 +- 最大重试次数 +- 下次重试时间 +- 租约时间 +- 当前步骤 +- 错误分类 +- 可展示错误信息 +- 创建时间和完成时间 + +申请任务采用全局互斥锁;同一时间只能有一个证书申请任务运行。一个申请任务完成后,才能开始下一个申请任务。 + +### 4.6 部署执行器 + +部署采用“临时版本目录 + 校验 + 原子切换 + reload + 远程校验”的流程: + +```text +1. 本地校验证书和私钥 +2. 创建目标服务器临时目录 +3. SFTP 上传证书、证书链和私钥 +4. 设置目标文件权限 +5. 执行 Web 服务器配置检查 +6. 原子切换当前证书版本 +7. 执行默认或自定义 reload 命令 +8. 检查所有 A/AAAA 地址的 HTTPS 证书 +9. 失败时回滚到旧版本 +10. 保存部署节点结果 +``` + +部署策略: + +- 证书申请任务串行。 +- 同一证书关联的多台服务器可以并行部署,但必须有并发上限。 +- 每台服务器独立记录状态、错误、重试和回滚结果。 +- 默认支持 Nginx,其他 Web 服务器通过适配器实现。 +- 每台服务器独立配置 SSH 用户、端口、主机指纹、密钥、证书路径和 reload 命令。 +- 远程 HTTPS 校验默认超时 2 分钟;按域名解析出的全部 A 和 AAAA 地址执行校验,并分别保存地址级结果。 +- 远程部署路径必须在目标服务器上经过规范化和白名单校验,禁止使用未经校验的用户输入拼接 Shell 命令。 + +### 4.7 通知模块 + +通知模块只负责出站通知,不实现邮件接收服务: + +```go +type Notifier interface { + Send(ctx context.Context, message NotificationMessage) error +} +``` + +第一阶段保留: + +- HTTP 通知适配器 +- SMTP 出站客户端适配器 + +HTTP 通知适配器必须支持: + +- 用户自定义请求地址 +- Bearer Token、HMAC-SHA256 和无认证模式 +- 详细事件和统一事件两种事件模式,默认使用详细事件 +- 完整服务器部署明细、证书序列号、管理后台链接的可选发送 +- 用户自定义请求头 +- HTTP 2xx 成功判定 +- 默认 10 秒超时和可配置重试 +- `request_id` 幂等键 + +无认证模式仅用于开发、测试或受控内网场景;Token、签名密钥和密码禁止写入日志。 + +SMTP 连接策略按需求确认单执行: + +- SMTP 接收连接信息可包含 25、465 端口及对应连接模式。 +- SMTP Submission 使用 587 端口和 STARTTLS,不允许明文认证。 +- Scert 不实现 SMTP、IMAP、POP3 服务端。 +- IMAP/POP3 仅在确认需要作为外部服务检测功能时,再单独设计客户端适配器。 +- 通知发送必须独立于证书部署任务,可以在证书任务完成后创建通知子任务;通知失败只重试通知,不回滚已成功的证书部署。 +- 通知规则需要支持全局开关、按域名开关、事件类型开关、收件人覆盖和默认账户邮箱回退。 + +### 4.8 Web API 和认证模块 + +API 统一使用版本前缀: + +```text +/api/v1/auth +/api/v1/domains +/api/v1/certificates +/api/v1/servers +/api/v1/tasks +/api/v1/settings +/api/v1/logs +/api/v1/backups +``` + +任务型接口使用异步返回: + +```text +POST /api/v1/domains/{id}/renew +-> 202 Accepted +-> { "task_id": "..." } +``` + +前端通过任务查询接口轮询状态,不保持长时间 HTTP 请求。 + +认证建议: + +- Web 使用 HttpOnly、Secure、SameSite 会话 Cookie。 +- CLI 使用短期访问令牌或本地受保护的 API 凭据。 +- 所有会话支持撤销、过期和强制退出。 +- 登录失败锁定和角色权限在服务端统一执行。 + +### 4.9 域名配置页面设计 + +域名配置页面参考用户提供的表格布局设计,采用“域名列表汇总 + 服务器关联明细”的方式。这样既保留表格查看效率,又能正确支持一个域名部署到多台服务器、每台服务器使用不同路径和 SSH 配置的需求。 + +#### 4.9.1 页面主列表 + +页面标题建议为: + +```text +域名配置 +``` + +顶部操作区包含: + +- 添加域名 +- 搜索域名 +- 按证书类型筛选 +- 按部署环境筛选 +- 按证书状态筛选 +- 刷新状态 + +主列表字段参考用户图片: + +| 页面显示字段 | 页面含义 | 展示规则 | +|---|---|---| +| 域名 | 托管域名 | 显示规范化后的域名;支持点击进入详情 | +| 证书类型 | 单域名、泛域名或后续 SAN | 使用标签显示;泛域名显示 `*.example.com`,不包含根域名 | +| 部署环境 | 生产或开发 | 使用颜色标签区分生产和开发,生产环境需要二次确认危险操作 | +| 部署服务器 IP | 关联的目标服务器 | 一行显示服务器数量和 IP 摘要;多台服务器使用标签或“共 N 台”显示,点击展开明细 | +| SSH 密钥 | 服务器 SSH 密钥引用 | 只显示密钥名称、指纹末尾和校验状态,不显示私钥内容 | +| 部署位置 | 远程证书部署路径 | 显示默认路径或“多个路径”;点击后查看每台服务器的证书、私钥和链文件路径 | +| 续签时间 | 下一次计划检查/续期时间 | 显示计划时间;详情中同时显示自动续期阈值,默认剩余有效期低于 6 天 | +| 紧急续签时间 | 紧急续期计划和触发条件 | 显示紧急任务时间或待触发状态;详情中显示紧急阈值,默认剩余有效期低于 3 天 | +| 状态 | 证书、部署和任务综合状态 | 显示有效、即将到期、续期中、部署失败、部分成功等状态 | +| 操作 | 页面操作 | 详情、编辑、手动续期、手动部署、查看日志、删除 | + +> **时间字段说明:**现有需求使用“剩余有效期阈值”定义续期策略,而参考表格使用“续签时间”列。页面建议同时展示“下一次计划时间”和“阈值”,例如:`2026-09-01 02:00(剩余 6 天)`,避免用户误以为续期只在固定日期执行。 + +#### 4.9.2 多服务器展开明细 + +域名列表不把多个服务器强行拼接成一条长文本。点击服务器信息后,使用展开行或右侧抽屉显示: + +| 明细字段 | 说明 | +|---|---| +| 服务器名称 | 用户自定义名称,便于区分不同节点 | +| 服务器 IP/主机名 | SSH 连接地址 | +| SSH 端口 | 默认 22,可单独覆盖 | +| SSH 用户 | 远程登录用户 | +| SSH 密钥 | 密钥引用、指纹和验证状态 | +| 主机指纹 | 已确认、待确认或指纹变化 | +| Web 服务类型 | 默认 Nginx,也可选择其他适配器或自定义 | +| 证书部署目录 | 远程证书目录 | +| 证书文件路径 | 远程证书文件 | +| 证书链文件路径 | 远程链文件 | +| 私钥文件路径 | 远程私钥文件 | +| reload 命令 | 默认命令或用户自定义命令 | +| 部署状态 | 成功、失败、回滚中、未部署 | +| 最近部署时间 | 最近一次部署任务完成时间 | + +每台服务器独立保存部署状态、错误、重试次数和回滚结果,不能因为同一域名的其他服务器部署成功就覆盖失败节点的状态。 + +#### 4.9.3 添加/编辑域名表单 + +表单建议分为四个区域,避免把所有配置堆在一个页面中: + +**一、域名基本信息** + +- 域名:必填,校验 FQDN 格式和重复配置 +- 证书类型:第一阶段支持单域名、泛域名和多域名 SAN 证书;SAN 证书保存完整域名集合,并按证书标识和版本管理 +- 部署环境:生产、开发 +- 是否启用自动续期:默认启用 ACME 证书,用户上传证书默认关闭 +- ACME 环境:Production 或 Staging + +**二、DNS 验证配置** + +- DNS 服务商配置:选择已保存的 DNS 配置 +- 允许域名级覆盖:需要时覆盖全局 DNS 配置 +- CNAME 委派:自动创建、失败手动提示 +- DNS 传播检测超时 +- 测试 DNS 权限和 Zone + +**三、部署服务器配置** + +- 添加一台或多台部署服务器 +- 选择已有服务器或创建服务器配置 +- 选择 SSH 密钥引用 +- 配置远程证书、证书链和私钥路径 +- 选择 Web 服务类型 +- 配置默认或自定义 reload 命令 +- 测试 SSH 连接、主机指纹和远程目录权限 +- 设置部署顺序或并发组 + +**四、续期和通知配置** + +- 常规检查间隔:默认每 3 天 +- 临近到期检查:剩余有效期低于 10 天时每天检查 +- 自动续期阈值:默认剩余有效期低于 6 天 +- 紧急重试阈值:默认剩余有效期低于 3 天 +- 最大重试次数:默认 3 次 +- 重试间隔:默认 30 分钟 +- 通知类型:续期、部署、校验、错误、通知发送失败 +- 收件人:默认账户绑定邮箱,可按域名覆盖 + +保存域名时先执行前端格式校验,再由后端执行域名、证书类型、DNS 配置、部署服务器和路径安全校验;保存成功后不立即执行续期或部署,用户需通过明确操作触发。 + +#### 4.9.4 页面操作规则 + +| 操作 | 行为 | +|---|---| +| 添加域名 | 打开域名配置表单,保存后返回列表 | +| 编辑 | 修改普通配置和服务器关联,敏感信息只允许重新录入或更换引用 | +| 手动续期 | 创建异步续期任务,返回 `task_id`,不阻塞页面 | +| 手动部署 | 选择证书版本和目标服务器,创建异步部署任务 | +| 查看详情 | 显示证书、DNS、服务器、任务、日志和通知配置 | +| 查看日志 | 按域名、服务器和任务过滤审计日志 | +| 删除 | 先停止关联任务,再二次确认删除数据库记录和历史证书文件 | + +生产环境的手动续期、手动部署、删除和覆盖当前证书操作必须显示风险确认;失败时保留原证书并在页面展示回滚结果。 + +#### 4.9.5 页面响应式设计 + +- 桌面端使用表格布局,保持用户参考图中的横向字段组织方式。 +- 低宽度窗口将“部署服务器 IP、SSH 密钥、部署位置”合并为“部署配置”列,通过展开行查看详细信息。 +- 移动端使用卡片布局,每张卡片显示域名、证书类型、环境、到期状态和操作按钮,服务器明细使用抽屉展示。 +- 表格不显示私钥、DNS API Token、SMTP 密码或完整 SSH 密钥内容。 + +#### 4.9.6 页面与 API 映射 + +域名配置页面只通过 Web API 访问业务服务,不直接操作 MySQL 或 SQLite: + +```text +GET /api/v1/domains +POST /api/v1/domains +GET /api/v1/domains/{id} +PATCH /api/v1/domains/{id} +DELETE /api/v1/domains/{id} + +GET /api/v1/domains/{id}/servers +POST /api/v1/domains/{id}/servers +PATCH /api/v1/domains/{id}/servers/{serverId} +DELETE /api/v1/domains/{id}/servers/{serverId} + +POST /api/v1/domains/{id}/renew +POST /api/v1/domains/{id}/deploy +POST /api/v1/domains/{id}/test-dns +POST /api/v1/domains/{id}/test-servers +``` + +`GET /api/v1/domains` 返回列表汇总字段,至少包含域名、证书类型、部署环境、服务器数量、服务器 IP 摘要、证书到期时间、下一次检查时间、自动续期阈值、紧急重试阈值和综合状态。服务器密码、SSH 私钥、DNS 凭据和 SMTP 密码不得出现在响应中。 + +续期、部署、DNS 测试和服务器测试均采用异步任务返回;配置保存接口只保存配置,不隐式触发证书申请或部署。 + +--- + +## 五、数据库设计调整 + +数据库支持 MySQL 和 SQLite 两种运行模式。MySQL 5.7 作为基础开发和最低兼容版本,MySQL 8.0 作为兼容性测试版本;SQLite 用于单机、桌面和开发模式。所有时间统一使用 UTC 存储,界面按用户时区显示。 + +数据库实现要求: + +- 使用 `database/sql` 和 Repository 层统一业务访问。 +- MySQL 与 SQLite 分别维护迁移脚本,禁止把 SQLite 专用语句直接用于 MySQL。 +- 事务、分页、时间、布尔值、JSON 和自增主键等差异通过数据库方言适配层处理。 +- SQLite 模式可以启用 WAL、busy timeout 和外键约束;MySQL 模式使用连接池、事务隔离和外键约束。 +- 本机存在两套 MySQL 安装,开发配置必须通过明确的实例地址、端口和 DSN 区分 MySQL 5.7 与 MySQL 8.0,不根据 PATH 中的单个命令推断数据库版本。 + +本机开发环境的客户端版本已通过完整安装路径分别确认: + +| 安装路径 | 检测结果 | 用途 | +|---|---|---| +| `E:\DB\5.7\bin\mysql.exe` | MySQL 5.7.44 | 基础开发和最低兼容性验证 | +| `E:\DB\8.0\bin\mysql.exe` | MySQL 8.0.45 | 兼容性测试 | + +以上仅记录客户端版本确认结果;实际数据库连接必须继续使用明确的主机、端口、数据库名、账号和 DSN,禁止通过 PATH 中的 `mysql` 命令作为版本判断依据。 + +### 5.1 domains + +| 字段 | 说明 | +|---|---| +| id | 主键 | +| domain_name | 托管域名,唯一 | +| environment | `production` 或 `development` | +| certificate_type | `single` 或 `wildcard` | +| status | 域名管理状态 | +| renewal_enabled | 是否启用自动续期 | +| check_interval_days | 常规检查间隔,默认 3 天 | +| near_expiry_check_days | 临近到期检查阈值,默认 10 天 | +| renewal_threshold_days | 自动续期阈值,默认 6 天 | +| emergency_threshold_days | 紧急重试阈值,默认 3 天 | +| next_check_at | 下一次计划检查时间 | +| next_renewal_at | 下一次计划续期时间,可为空 | +| notification_rule_id | 域名级通知规则引用 | +| created_at | 创建时间 | +| updated_at | 修改时间 | + +### 5.2 certificates + +| 字段 | 说明 | +|---|---| +| id | 证书逻辑主键 | +| domain_id | 关联域名 | +| source | `acme` 或 `uploaded` | +| current_version_id | 当前使用版本 | +| auto_renew | 是否参与自动续期 | +| created_at | 创建时间 | +| updated_at | 修改时间 | + +### 5.3 certificate_versions + +| 字段 | 说明 | +|---|---| +| id | 版本主键 | +| certificate_id | 关联证书 | +| version_name | 版本标识 | +| certificate_path | 证书文件路径 | +| chain_path | 证书链路径 | +| private_key_path | 私钥路径或加密存储引用 | +| fingerprint | 证书指纹 | +| issued_at | 签发时间 | +| expires_at | 到期时间 | +| status | `current`、`history`、`failed`、`rolled_back` | +| created_at | 创建时间 | + +### 5.4 servers + +保存服务器基础信息: + +- 主机地址 +- SSH 端口 +- SSH 用户 +- 主机指纹 +- 密钥引用 +- 启用状态 + +### 5.5 domain_servers + +保存域名和服务器关联配置: + +- domain_id +- server_id +- 远程证书目录 +- 远程证书文件名 +- 远程私钥文件名 +- reload 命令 +- Web 服务器类型 +- 部署顺序或并发组 +- 是否启用部署 +- 最近部署状态、错误信息和最近部署时间 + +### 5.6 dns_credentials + +保存 DNS 服务商和加密认证信息: + +- provider_type +- account_name +- encrypted_secret_ref +- zone_scope +- enabled +- key_version +- created_at +- rotated_at + +### 5.7 tasks、task_attempts + +任务和任务尝试分离,支持: + +- 续期任务 +- 部署任务 +- 校验任务 +- 通知任务 +- 重试次数 +- 错误分类 +- 下次执行时间 +- 任务租约 +- 节点级结果 + +### 5.8 users、sessions、audit_logs + +用于支持: + +- 超级管理员、管理员、普通用户 +- 登录会话和强制退出 +- 登录失败锁定 +- 30 分钟无操作退出 +- 重要操作审计 +- 安全审计报告 + +### 5.9 app_settings、notification_channels、notification_recipients + +用于保存普通运行配置和通知规则: + +- `app_settings`:管理后台域名、HTTPS 模式、存储根路径、时区、检查间隔、重试次数、重试间隔和初始化状态等普通配置。 +- `notification_channels`:HTTP 或 SMTP 通道、启用状态、地址、端口、连接模式、发件人显示名称、发件人地址和加密认证信息引用。 +- `notification_recipients`:全局收件人、域名级收件人、启用状态和排序。 +- `notification_rules`:续期、部署、校验、通知失败等事件的开关和通知级别。 + +SMTP 连接模式必须使用枚举值,不允许仅通过端口号推断: + +```text +plain、starttls、implicit_tls +``` + +同时保存“是否允许明文认证”的显式策略,587 端口默认禁止明文认证。 + +### 5.10 backups、recovery_materials、acme_profiles + +- `backups`:数据库备份、配置导出、加密备份版本、创建时间、校验值和恢复结果。 +- `recovery_materials`:超级管理员专用恢复材料的版本、状态、使用时间和审计引用;不保存可直接登录的明文恢复凭据。 +- `acme_profiles`:ACME CA、目录地址、生产/测试环境、账户引用和启用状态。第一阶段默认启用 Let’s Encrypt Production 和 Staging,其他 CA 只保留扩展字段。 + +### 5.11 SAN 扩展数据边界 + +SAN 第一阶段新增并启用: + +- `certificate_identifiers`:证书关联的 DNS 名称、类型(精确域名或通配符)和排序。 +- 申请任务保存完整标识集合快照,避免域名配置变更后无法追溯历史申请内容。 +- 目录名称使用稳定的证书逻辑标识,不直接使用未经规范化的用户输入。 + +SAN 进入默认 UI、自动续期、证书版本保存、部署关联和验收路径。证书以主域名作为管理归属;域名集合变化时创建新的证书标识和证书版本,不覆盖原有版本。 + +--- + +## 六、文件和证书目录 + +逻辑目录: + +```text +{storage_root}/{domain}/ +├── production/ +│ ├── wildcard/ +│ │ ├── current/ +│ │ └── versions/{version}/ +│ └── single/ +│ ├── current/ +│ └── versions/{version}/ +└── development/ + ├── wildcard/ + │ ├── current/ + │ └── versions/{version}/ + └── single/ + ├── current/ + └── versions/{version}/ +``` + +每个版本目录至少包含: + +```text +cert.pem +chain.pem +fullchain.pem +privkey.pem +metadata.json +``` + +安全要求: + +- Linux 私钥文件使用 600 或更严格权限。 +- Windows 使用仅服务账户和授权管理员可读的 ACL。 +- `current` 可以使用目录切换或受控复制,不直接覆盖正在使用的版本。 +- 删除域名时先停止相关任务,再删除数据库记录和证书文件。 +- 用户上传证书默认保留当前版本和一个最近历史版本。 + +### 6.1 跨平台默认路径 + +需求中的 `/ssl` 作为 Linux 默认证书根路径保留,安装、配置、日志和备份目录分别固定;Windows 使用用户选择的安装根目录进行平台适配: + +- Linux 默认:`/ssl` +- Linux 安装目录:`/scert` +- Linux 配置目录:`/scert/conf` +- Linux 日志目录:`/scert/log` +- Linux 备份目录:`/scert/backups` +- Windows 证书目录:`{安装目录}\Scert\ssl` +- Windows 数据库目录:`{安装目录}\Scert\data` +- Windows 配置目录:`{安装目录}\Scert\config` +- Windows 日志目录:`{安装目录}\Scert\logs` +- Windows 备份目录:`{安装目录}\Scert\backups` +- 用户可以在初始化或 Web 管理界面中修改 +- 界面必须显示实际解析后的绝对路径 + +Linux 服务安装时创建专用 `Scert` 服务运行用户,仅用于运行核心服务;授予该用户专门管理 `/ssl` 或用户自定义证书目录的权限。私钥文件默认使用 600 或更严格权限,`Scert` 与 `root` 共同受控管理。Windows 使用等效 ACL 权限保护私钥。 + +--- + +## 七、HTTPS 和服务部署拓扑 + +### 7.1 当前明确的要求 + +- 管理后台正式访问使用 HTTPS。 +- 初始化期间允许使用 HTTP 访问初始化界面。 +- 前端和后端均需纳入 HTTPS 安全部署。 +- HTTPS 采用双模式,默认模式为核心服务直接终止 HTTPS,高级模式为 Nginx/Caddy 终止公网 HTTPS、核心服务使用内部 HTTPS。 + +### 7.2 支持的部署模式 + +```text +浏览器 / 桌面 WebView + | + HTTPS 443 + v ++------------------------+ +| HTTPS 入口层 | +| 反向代理或服务网关 | ++-----------+------------+ + | + 内部 HTTPS + v ++------------------------+ +| Scert 核心服务 | +| Gin API + Vue 静态资源 | ++------------------------+ +``` + +架构需要同时兼容以下两种模式,默认使用模式 A,高级配置使用模式 B: + +**模式 A:核心服务直接终止 HTTPS** + +- 核心服务监听 443 并加载管理域名证书。 +- 初始化期间监听 80,仅开放受控初始化入口或跳转到 HTTPS。 +- 适合单机、Windows 和不额外部署反向代理的环境。 + +**模式 B:反向代理终止 HTTPS** + +- 入口层监听 443,负责公网 TLS。 +- 核心服务仍使用 HTTPS 监听内部端口,避免前后端之间退化为明文连接。 +- 适合已有 Nginx、Caddy 或其他网关的服务器环境。 + +采用模式 B 时,公网 HTTPS 入口与核心服务分离可以: + +- 管理证书自动更新不影响核心服务进程 +- 核心服务不直接暴露公网监听 +- 前后端统一受入口层保护 +- 后续可扩展访问控制和安全策略 + +桌面版本地服务、CLI 初始化和没有额外反向代理的 Windows 环境默认使用模式 A;用户配置高级模式后使用模式 B。初始化流程必须明确当前模式、监听地址、证书来源和证书切换方式。 + +### 7.3 初始化特殊流程 + +```text +1. 启动核心服务 +2. 检查初始化状态 +3. 未初始化时只开放受控初始化入口 +4. 完成管理员、DNS、存储和通知配置 +5. 使用 Let’s Encrypt + `lego` 申请管理域名证书 +6. 完成本地证书校验和部署 +7. 启用正式 HTTPS 访问 +8. 关闭或保护初始化入口 +``` + +初始化入口必须防止重复初始化和未授权重新配置。 + +--- + +## 八、任务执行和可靠性 + +### 8.1 任务执行原则 + +- 所有耗时操作必须异步任务化。 +- 所有任务必须持久化。 +- 服务重启后根据租约和状态恢复任务。 +- 申请任务全局串行。 +- 部署节点可以有限并行。 +- 每个外部调用必须设置超时。 +- 所有重试必须记录原因和下一次执行时间。 +- 任务操作必须具备幂等性,避免重复部署或重复通知。 + +### 8.2 失败处理 + +| 阶段 | 失败处理 | +|---|---| +| DNS 检测 | 标记 DNS 错误,保留原证书,不进入部署 | +| ACME 申请 | 按任务重试策略重试,超过次数后发送摘要通知 | +| 本地证书校验 | 丢弃新版本,保留当前证书 | +| 单台服务器部署 | 该节点回滚并记录失败,其他节点继续或按策略停止 | +| 远程 HTTPS 校验 | 回滚该节点,任务标记失败或部分成功 | +| 全部部署失败 | 保持原版本,发送失败通知 | +| 通知发送失败 | 通知任务独立重试,不回滚已成功的证书部署 | + +--- + +## 九、安全架构 + +### 9.1 身份和权限 + +- 管理员密码使用安全密码哈希。 +- Web 会话使用 HttpOnly、Secure、SameSite Cookie。 +- 所有写操作执行角色权限检查。 +- 普通用户不能查看其他用户的敏感配置。 +- 续期、部署、导入、恢复和密钥备份操作全部记录审计日志。 + +### 9.2 敏感信息 + +需要加密保护: + +- DNS API 凭据 +- SSH 私钥 +- SMTP 密码 +- HTTP 通知认证信息 +- 加密配置主密钥相关材料 + +敏感信息不允许: + +- 出现在普通日志 +- 出现在任务错误详情 +- 出现在 API 列表响应 +- 出现在 Git、脚本参数或命令回显中 + +### 9.3 远程主机安全 + +- 首次连接记录 SSH 主机指纹。 +- 指纹变化时阻止自动部署并要求管理员确认。 +- 不使用服务器登录密码。 +- 远程命令和目标路径执行白名单或格式校验。 +- 证书文件上传禁止路径穿越。 + +--- + +## 十、API 设计原则 + +### 10.1 API 版本和任务响应 + +- 使用 `/api/v1` 版本前缀。 +- 修改和执行操作返回任务编号。 +- 重复请求支持幂等键。 +- 任务状态通过查询接口获取。 +- 统一返回错误代码、用户可读信息和审计编号。 + +### 10.2 API 分组 + +```text +/api/v1/auth +/api/v1/users +/api/v1/domains +/api/v1/certificates +/api/v1/servers +/api/v1/dns-providers +/api/v1/tasks +/api/v1/notifications +/api/v1/settings +/api/v1/logs +/api/v1/backups +``` + +### 10.3 CLI 与 API + +CLI 不直接访问数据库: + +```text +scert init 本地初始化向导 +scert serve 启动服务 +scert status API 查询状态 +scert task wait API 等待任务 +``` + +如果后续保留域名增删、手动续期和部署 CLI 命令,也必须作为 API 客户端实现,不得复制业务逻辑。 + +--- + +## 十一、运行和打包 + +### 11.1 Linux + +- 核心服务以 systemd 服务运行。 +- 服务账户使用最小权限。 +- 数据目录、证书目录、日志目录分离。 +- 使用 systemd 重启策略和启动前权限检查。 + +### 11.2 Windows + +- 核心服务以 Windows Service 运行。 +- 服务账户使用最小权限。 +- 敏感目录配置 ACL。 +- 桌面版通过 Wails 启动或连接服务。 +- 开机自启动必须由用户选择启用。 + +### 11.3 构建产物 + +建议拆分为: + +```text +scert.exe / scert CLI 和服务主程序 +scert-desktop.exe Wails 桌面程序 +web assets 构建后嵌入核心服务 +service installer Windows/Linux 安装脚本或安装包 +``` + +“单文件部署”只适用于核心服务二进制和前端静态资源;证书存储、数据库、日志、服务注册和系统权限仍属于运行时资源,不能简单视为全部包含在单文件中。 + +--- + +## 十二、开发阶段建议 + +### 阶段一:架构和基础设施 + +- [x] 已确认 Go 版本和构建矩阵:以当前开发电脑工具链为开发基线,目标构建架构为 amd64 +- [x] 已确认数据库访问和迁移方式:使用 `database/sql`、Repository 和 MySQL/SQLite 独立迁移脚本 +- [x] 已确认 HTTPS 终止拓扑:默认由核心服务直接终止 HTTPS,高级模式由 Nginx/Caddy 终止公网 HTTPS,核心服务使用内部 HTTPS +- [ ] 完成 Windows 与 Linux 的 `lego`、DNS API、文件权限和服务生命周期兼容性验证 +- [x] 已确认 DNS 第一批适配器:Cloudflare、阿里云 DNS、DNSPod、CNAME 委派、华为云、腾讯云、AWS Route 53、Google Cloud DNS,并预留其他服务商扩展 +- [x] 已确认 SMTP/IMAP/POP3 功能边界:协议表仅作外部邮件服务兼容性参考,Scert 不实现邮件服务器端 +- [ ] 完成领域模型、任务状态机和 API 契约 + +### 阶段二:证书申请 + +- [ ] 实现 `lego` ACME Issuer 和 DNS provider 适配器 +- [ ] 接入 Let’s Encrypt Staging +- [ ] 接入 Let’s Encrypt Production +- [ ] 建立 ACME CA 配置抽象;第一阶段仅启用 Let’s Encrypt,其他 CA 暂不纳入验收 +- [ ] 实现 DNS 适配器和 CNAME 委派 +- [ ] 实现证书解析、校验和版本保存 +- [ ] 实现 SAN 标识集合快照和目录规则 + +### 阶段三:续期、部署和通知 + +- [ ] 实现持久化调度器 +- [ ] 实现申请任务全局串行锁 +- [ ] 实现 SSH/SFTP 和主机指纹校验 +- [ ] 实现 Web 服务器部署适配器 +- [ ] 实现回滚和远程 HTTPS 校验 +- [ ] 实现 HTTP/SMTP 通知和独立重试 + +### 阶段四:管理端 + +- [ ] 实现认证、角色和会话 +- [ ] 实现 Web API +- [ ] 实现域名配置页面:列表汇总、服务器展开明细、添加/编辑表单和危险操作确认 +- [ ] 实现域名、证书和服务器页面 +- [ ] 实现任务、日志和通知页面 +- [ ] 实现初始化向导 + +### 阶段五:平台和桌面端 + +- [ ] 实现 Linux systemd +- [ ] 实现 Windows Service +- [ ] 实现 Wails 桌面封装 +- [ ] 实现系统托盘和后台任务状态 +- [ ] 完成基础平台测试:Windows 10/11、Ubuntu 22.04 + Nginx +- [ ] 完成扩展平台测试:Ubuntu 24.04 + Nginx、CentOS/Rocky Linux、Debian、Caddy、Apache 和其他主流反向代理 + +--- + +## 十三、已确认和仍需细化的架构决策 + +以下内容已经根据需求确认结果冻结,不再作为开发前置待确认项: + +1. 第一阶段使用 Let’s Encrypt 和 `go-acme/lego`,支持 Production、Staging、DNS-01、单域名、泛域名和多域名 SAN。 +2. HTTPS 采用双模式:默认由核心服务直接终止 HTTPS;高级模式由 Nginx/Caddy 终止公网 HTTPS,核心服务使用内部 HTTPS。 +3. 数据访问使用 `database/sql` + Repository;支持 MySQL 5.7、MySQL 8.0 和 SQLite,分别维护迁移脚本与方言适配。 +4. DNS 第一批适配器包括 Cloudflare、阿里云 DNS、DNSPod、CNAME 委派、华为云、腾讯云、AWS Route 53、Google Cloud DNS,并预留其他服务商扩展。 +5. SMTP、IMAP、POP3 协议表仅作为外部邮件服务兼容性参考;Scert 不实现邮件服务器端,通知通过外部 HTTP API 和 SMTP 出站客户端完成。 +6. HTTP 通知支持自定义地址、Bearer Token、HMAC-SHA256、无认证、详细/统一事件、自定义请求头、完整部署明细、证书序列号、管理后台链接、2xx 成功判定和可配置重试。 +7. SAN 纳入第一阶段,保存完整域名集合,并按证书标识和版本管理,不覆盖历史证书版本。 +8. Windows 和 Linux 默认目录、Linux `Scert` 专用运行用户、证书目录管理和私钥权限要求已经确认。 +9. 基础测试范围为 Windows 10/11、Ubuntu 22.04 + Nginx;扩展测试范围为 Ubuntu 24.04 + Nginx、CentOS/Rocky Linux、Debian、Caddy、Apache 和其他主流反向代理。 + +仍需在编码和联调阶段细化,但不影响开始开发: + +1. HTTP HMAC-SHA256 的签名原文、时间戳有效期、重放防护和幂等键过期策略。 +2. HTTP 通知完整 JSON 请求体、详细事件与统一事件的具体事件名称和字段约束。 +3. MySQL 连接配置、连接池默认值、SQLite 是否允许在 Web 服务器生产模式使用,以及数据库备份恢复流程。 +4. 核心服务、Web 前端和桌面端的最终目录组织、构建脚本和安装包细节。 + +--- + +## 十四、与原技术方案相比的主要优化 + +| 原方案 | 优化后 | +|---|---| +| 使用 `lego` 申请证书 | 按用户最新确认保留并加强为原生 Go 集成,减少外部脚本运行时依赖 | +| 每日 cron 检查 | 持久化调度器,支持每 3 天、临近到期每天检查、重试和恢复 | +| `servers.domain_id` | 使用 `domains`、`servers`、`domain_servers` 多对多模型 | +| 证书直接放域名目录 | 增加环境、证书类型、当前版本和历史版本目录 | +| settings 键值表保存全部配置 | 普通配置与加密敏感配置分离 | +| 直接写死 Nginx 部署 | Web 服务器/反向代理适配器,默认 Nginx | +| API 返回同步执行结果 | 长任务统一返回 task_id 并轮询 | +| JWT 或 Session 二选一 | Web 使用受保护会话,CLI 使用受控 API 凭据,后续统一实现 | +| 单文件包含全部运行环境 | 明确区分核心二进制、证书、数据库、日志和系统服务资源 | +| SMTP/TLS 描述较宽泛 | 按端口、STARTTLS、隐式 TLS 和明文认证限制具体化 | +| 未说明 Windows 与 Linux 的 ACME 差异 | 增加 `lego` 原生适配、DNS provider 注入、平台权限适配和跨平台测试边界 | +| 未区分通知配置和任务结果 | 增加通知通道、收件人、规则和独立通知任务模型 | +| 只预留 SAN,未说明需求冲突 | SAN 已纳入第一阶段,保存完整域名集合并按证书标识和版本管理 | + +--- + +## 十五、文档状态 + +- [x] 已完成:读取并优化用户提供的技术选型草案 +- [x] 已完成:根据用户最新确认将 ACME 主实现调整为 `lego` +- [x] 已完成:补充持久化任务调度和失败恢复设计 +- [x] 已完成:补充多对多服务器部署数据模型 +- [x] 已完成:补充安全、API、跨平台和打包边界 +- [~] 进行中:等待用户确认最终技术架构 +- [ ] 未开始:根据最终架构创建项目代码结构 + +--- + +## 十六、状态标记 + +- `[ ]` 未开始 +- `[~]` 进行中 +- `[x]` 已完成,等待复审 +- `[✓]` 复审通过 +- `[!]` 暂缓或存在阻塞 diff --git a/doc/SSL服务程序需求确认文档.md b/doc/SSL服务程序需求确认文档.md new file mode 100644 index 0000000..2bec58d --- /dev/null +++ b/doc/SSL服务程序需求确认文档.md @@ -0,0 +1,916 @@ +# SSL 服务程序需求确认文档 + +- 文档状态:已根据需求确认单更新,73 项用户补充已填写;部分架构事项仍待评审 +- 创建日期:2026-08-25 +- 适用项目:SSL 证书管理服务程序 +- 文档用途:用于确认功能边界、技术方案和验收标准,确认后作为后续设计与开发依据 +- 项目名:Scert + +> 本文档整理正式需求、待确认事项和开发任务,不代表所有方案已经最终确定。正式需求以已确认结果为准,未确认事项不得擅自假设。 +> 填写规则:需求确认阶段,紧跟待确认项后的 `【用户补充 U-编号】` 为用户填写区;需求确认后,系统根据用户补充区同步更新正式需求、流程和验收标准。 + +--- + +## 一、需求确认清单 + +### 1.1 项目目标 + +- [x] 统一管理多个域名的 SSL/TLS 证书 +- [x] 支持自动申请、自动续期和手动部署 +- [x] 支持将证书部署到多台远程服务器 +- [x] 支持部署完成后的证书校验 +- [x] 支持邮件通知和操作日志 +- [x] 支持命令行、Web 管理界面和桌面图形界面 +- [x] 支持 Windows 和 Linux 运行环境 +- [x] 已确认需求:第一阶段同时提供命令行、Web 管理界面和桌面图形界面;命令行仅负责初始化基础配置,初始化完成后日常管理通过 Web 界面进行。 + - 【用户补充 U-001】(请填写): + - 补充内容:命令行系统需要实现,命令行只进行基础信息填写:web页面的域名、dns的配置、ssl证书部署的位置,Web 管理界面需要实现,桌面图形界面需要实现 + - 确认结果:已填写 +- [x] 已确认需求:第一阶段同时支持 Windows 和 Linux 两条开发线。 + - 【用户补充 U-002】(请填写): + - 补充内容:需要,两条线进行开发 + - 确认结果:已填写 + +### 1.2 域名和证书管理 + +- [x] 支持添加托管域名 +- [x] 支持删除托管域名 +- [x] 支持配置证书类型 +- [x] 支持单域名证书 +- [x] 支持泛域名证书 +- [x] 证书默认存放在配置根目录下的域名目录中 +- [x] 已确认需求:泛域名证书不包含根域名。 + - 【用户补充 U-003】(请填写): + - 补充内容:泛域名不需要包含根域名 + - 确认结果:已填写 +- [x] 已确认需求:证书按生产证书和开发证书分类管理;多域名 SAN 证书纳入第一阶段。 + - 【用户补充 U-004】(请填写): + - 补充内容:确认启用 + - 确认结果:已填写 +- [x] 已确认需求:删除域名时同时删除该域名的历史证书文件。 + - 【用户补充 U-005】(请填写): + - 补充内容:需要 + - 确认结果:已填写 +- [x] 已确认需求:同一域名允许保存多个证书版本;根目录使用 `/ssl/{域名}/`,按生产/开发环境和证书类型分目录,下设泛域名和单域名目录。 + - 【用户补充 U-006】(请填写): + - 补充内容:允许,但同一个域名多个版本的证书的话,需要以文件夹区分,文件夹名是证书类型,目录结构为: + /ssl/{域名}/ + -*(泛域名) + -{域名}(单域名 + 目录格式参考这个进行排布设计 + - 确认结果:已填写 + + +#### 已确认方向的证书目录结构 + +```text +/ssl/{域名}/ +├── production/ 生产证书 +│ ├── wildcard/ 泛域名证书,例如 *.example.com +│ │ ├── current/ 当前使用版本 +│ │ └── versions/{版本}/ 历史版本 +│ └── single/ 单域名证书,例如 example.com +│ ├── current/ +│ └── versions/{版本}/ +└── development/ 开发证书,目录结构与 production 相同 +``` + +多域名 SAN 证书纳入第一阶段,证书以主域名作为管理归属,并保存完整的 SAN 域名集合。SAN 证书目录使用证书标识区分不同域名集合: + +```text +/ssl/{主域名}/ +├── production/ +│ ├── wildcard/ +│ ├── single/ +│ └── san/{证书标识}/ +│ ├── current/ +│ └── versions/{版本}/ +└── development/ + ├── wildcard/ + ├── single/ + └── san/{证书标识}/ + ├── current/ + └── versions/{版本}/ +``` + +其中 `{证书标识}` 必须能够稳定对应主域名和 SAN 域名集合;域名集合发生变化时创建新的证书版本,不覆盖原有证书版本。 + +### 1.3 DNS 验证 + +- [x] 使用 ACME 协议申请证书 +- [x] 支持 DNS-01 验证 +- [x] 支持 Cloudflare API Token +- [x] 支持阿里云 DNS/RAM 凭据 +- [x] 支持 DNSPod API Token +- [x] 预留其他 DNS 服务商适配接口 +- [x] 支持 CNAME 委派方式 +- [x] 第一阶段 DNS 验证方式支持 Cloudflare、阿里云 DNS、DNSPod、CNAME 委派、华为云、腾讯云、AWS Route 53、Google Cloud DNS,并预留其他服务商适配接口。 +- [x] 已确认需求:第一阶段使用 Let's Encrypt 作为 ACME CA,并使用 `go-acme/lego` 负责证书申请、DNS-01 验证和自动续期。 + - 【用户补充 U-007】(请填写): + - 补充内容:Let's Encrypt、ZeroSSL、Buypass Go SSL、SSL.com、Google Trust Services + - 确认结果:已填写 +- [x] 已确认需求:支持国内外主流 DNS 服务商,并通过适配器扩展。 + - 【用户补充 U-008】(请填写): + - 补充内容:需要支持国内外主流dns服务商 + - 确认结果:已填写 +- [x] 已确认需求:CNAME 委派默认自动创建;自动创建失败时提示用户手动创建。 + - 【用户补充 U-009】(请填写): + - 补充内容:无需用户创建,自动创建失败时,提示用户手动创建 + - 确认结果:已填写 +- [x] 已确认需求:自动检测 DNS Zone 和权限。 + - 【用户补充 U-010】(请填写): + - 补充内容:需要 + - 确认结果:已填写 +- [x] 已确认需求:默认使用一个 API 配置多个域名,并支持后续按域名覆盖配置。 + - 【用户补充 U-011】(请填写): + - 补充内容:默认使用一个api配置多个域名 + - 确认结果:已填写 +- [x] 已确认需求:支持 DNS 传播检测和超时设置。 + - 【用户补充 U-012】(请填写): + - 补充内容:需要 + - 确认结果:已填写 + +#### 建议的 DNS 验证抽象 + +```text +DNS 验证方式 +├── DNS API 自动管理 +│ ├── Cloudflare +│ ├── 阿里云 +│ ├── DNSPod +│ └── 其他适配器 +└── CNAME 委派 + ├── 显示需要创建的 CNAME 记录 + ├── 检查 CNAME 是否生效 + └── 管理委派目标下的 TXT 记录 +``` + +### 1.4 自动续期 + +- [x] 系统按续期调度策略检查托管证书状态:常规每 3 天检查一次;证书剩余有效期低于 10 天时每天检查一次 +- [x] 证书接近到期时自动触发续期 +- [x] 续期失败时保留原证书 +- [x] 支持手动触发续期 +- [x] 支持记录续期任务状态 +- [x] 支持失败重试 +- [x] 已确认需求:证书剩余有效期低于 6 天时开启自动续期。 + - 【用户补充 U-013】(请填写): + - 补充内容:低于6天时开启自动续期 + - 确认结果:已填写 +- [x] 已确认需求:剩余有效期低于 6 天时触发续期,剩余有效期低于 3 天时进入紧急重试。 + - 【用户补充 U-014】(请填写): + - 补充内容:默认提前 6 天尝试,剩余 3 天进入紧急重试 + - 确认结果:已填写 +- [x] 已确认需求:每 3 天检查一次;有效期低于 10 天时每天检查一次。 + - 【用户补充 U-015】(请填写): + - 补充内容:每3天检查一次,有效期低于10天时,每天检查一次 + - 确认结果:已填写 +- [x] 已确认需求:允许用户自定义续期时间和重试次数;默认重试 3 次,每次间隔 30 分钟,并发送邮件提醒。 + - 【用户补充 U-016】(请填写): + - 补充内容:允许用户自定义续期时间和重试次数,默认重试3次,每次间隔30分钟,同时发送邮件提醒 + - 确认结果:已填写 +- [x] 已确认需求:提供 ACME Staging 测试环境。 + - 【用户补充 U-017】(请填写): + - 补充内容:需要 + - 确认结果:已填写 +- [x] 已确认需求:申请任务串行执行,同时只运行一个申请任务;多个任务按提交顺序执行。 + - 【用户补充 U-018】(请填写): + - 补充内容:需要,每次限制一个申请任务,用户提交多个任务时,按提交的顺序进行申请,避免申请失败出现 + - 确认结果:已填写 + +#### 已确认的续期配置 + +```text +常规检查间隔:每 3 天 +临近到期检查:剩余有效期低于 10 天时每天检查 +自动续期阈值:剩余有效期低于 6 天 +紧急重试阈值:剩余有效期低于 3 天 +默认最大重试次数:3 次 +默认重试间隔:30 分钟 +自定义配置:用户可以自定义续期时间和重试次数 +``` + +### 1.5 多服务器部署 + +- [x] 一个域名可以关联多台服务器 +- [x] 使用 SSH 密钥认证 +- [x] 不使用服务器登录密码 +- [x] 支持上传证书和私钥 +- [x] 支持替换远程证书文件 +- [x] 支持执行 Web 服务器或反向代理配置检查;默认适配 Nginx +- [x] 支持执行默认或用户自定义的 reload 命令 +- [x] 支持部署完成后的远程 HTTPS 检查 +- [x] 支持保留旧证书 +- [x] 已确认需求:默认使用 Nginx;检测到其他 Web 服务器或反向代理时提示用户修改,并适配主流软件。 + - 【用户补充 U-019】(请填写): + - 补充内容:默认使用Nginx,如果用户使用其他的,提示用户进行修改,同时适配当前主流的web服务器/反向代理软件 + - 确认结果:已填写 +- [x] 已确认需求:支持自定义 reload 命令。 + - 【用户补充 U-020】(请填写): + - 补充内容:支持自定义 + - 确认结果:已填写 +- [x] 已确认需求:每台服务器允许单独配置证书路径,未配置时使用默认路径。 + - 【用户补充 U-021】(请填写): + - 补充内容:允许单独配置,不配置就使用默认的路径 + - 确认结果:已填写 +- [x] 已确认需求:每台服务器允许单独配置 SSH 用户、端口和密钥。 + - 【用户补充 U-022】(请填写): + - 补充内容:允许 + - 确认结果:已填写 +- [x] 已确认需求:记录 SSH 主机指纹。 + - 【用户补充 U-023】(请填写): + - 补充内容:需要 + - 确认结果:已填写 +- [x] 已确认需求:部署任务重试 3 次仍失败后,报告当前状态并通过邮件发送任务摘要。 + - 【用户补充 U-024】(请填写): + - 补充内容:重试3次仍然失败后,将当前状态报告给用户,整理任务状态发送给用户使用邮件 + - 确认结果:已填写 +- [x] 已确认需求:部署失败时自动回滚,避免影响生产环境。 + - 【用户补充 U-025】(请填写): + - 补充内容:需要,避免影响生产环境 + - 确认结果:已填写 + +#### 建议的部署流程 + +```text +1. 本地校验证书和私钥 +2. 生成部署版本目录 +3. 推送到远程目录 +4. 设置远程文件权限 +5. 执行 nginx -t +6. 原子替换证书文件 +7. 执行 nginx -s reload +8. 发起远程 HTTPS 校验 +9. 校验失败时恢复旧版本 +10. 记录每台服务器的结果 +``` + +### 1.6 部署后校验 + +- [x] 校验本地证书文件存在 +- [x] 校验证书格式有效 +- [x] 校验证书和私钥匹配 +- [x] 校验证书未过期 +- [x] 校验证书域名匹配 +- [x] 校验远程服务器实际返回的证书 +- [x] 校验证书链和 TLS 握手 +- [x] 已确认需求:部署后检查域名的所有 A 记录。 + - 【用户补充 U-026】(请填写): + - 补充内容:需要 + - 确认结果:已填写 +- [x] 已确认需求:部署后检查 AAAA 记录。 + - 【用户补充 U-027】(请填写): + - 补充内容:需要 + - 确认结果:已填写 +- [x] 已确认需求:远程 HTTPS 校验超时时间为 2 分钟。 + - 【用户补充 U-028】(请填写): + - 补充内容:2分钟 + - 确认结果:已填写 +- [x] 已确认需求:生产证书不允许使用自签名临时证书,测试证书允许使用。 + - 【用户补充 U-029】(请填写): + - 补充内容:生产证书不允许,测试证书允许 + - 确认结果:已填写 + +### 1.7 用户自有证书 + +- [x] 支持上传已有证书 +- [x] 支持上传私钥 +- [x] 支持手动触发部署 +- [x] 上传证书前进行格式检查 +- [x] 检查证书和私钥是否匹配 +- [x] 检查证书域名和有效期 +- [x] 已确认需求:允许上传加密私钥。 + - 【用户补充 U-030】(请填写): + - 补充内容:允许 + - 确认结果:已填写 +- [x] 已确认需求:用户上传证书保留最新版本和一个最近的历史版本。 + - 【用户补充 U-031】(请填写): + - 补充内容:保留最新的版本与一个最近的历史版本 + - 确认结果:已填写 +- [x] 已确认需求:用户上传证书默认不参与自动续期,用户主动选择后才参与。 + - 【用户补充 U-032】(请填写): + - 补充内容:默认不参与,除非用户选择参与 + - 确认结果:已填写 +- [x] 已确认需求:证书文件最大 5 MB,压缩包最大 10 MB。 + - 【用户补充 U-033】(请填写): + - 补充内容:证书文件限制最大5mb,压缩包10mb + - 确认结果:已填写 + +### 1.8 邮件通知 + +- [x] 每次续期任务完成后发送通知 +- [x] 任务成功时发送通知 +- [x] 任务失败时发送通知 +- [x] 支持多个收件人 +- [x] 通知内容包含域名、任务状态、错误信息和时间 +- [x] 已确认需求:同时保留 HTTP API 和 SMTP 通知方式;HTTP 通知通过调用外部邮件或消息服务 API 完成,Scert 不实现 SMTP、IMAP、POP3 邮件服务器端。 + - 【用户补充 U-034】(请填写): + - 补充内容:http和smtp都保留,后期经过测试后决定保留具体方式 + - 确认结果:已填写 + +#### HTTP 通知接口已确认模板 + +```text +请求方法:POST +请求地址:用户可自定义 +请求格式:application/json +认证方式:Bearer Token、HMAC-SHA256、无认证均支持;无认证仅建议用于开发、测试或受控内网环境 +请求头:支持 Scert 标准请求头和用户自定义请求头 +事件模式:详细事件和统一事件均支持,默认使用详细事件 +成功判定:HTTP 状态码 200-299 +请求唯一标识:必须携带 request_id,接收方需要支持幂等处理 +超时时间:默认 10 秒,可配置 +失败重试:默认 3 次,间隔 30 秒、2 分钟、10 分钟,可配置 +敏感信息:Token、签名密钥和密码不得写入日志 +``` + +请求体至少包含:事件类型、任务状态、任务编号、域名、证书类型、运行环境、开始时间、结束时间、错误信息、重试信息和部署结果。用户可选择是否发送完整服务器部署明细、证书序列号和管理后台链接;上述内容默认支持配置。 + +HTTP 通知接口确认项: + +- [x] 请求路径允许用户自定义。 +- [x] 支持 Bearer Token。 +- [x] 支持 HMAC-SHA256。 +- [x] 保留无认证模式;该模式仅建议用于开发、测试或受控内网环境。 +- [x] 同时支持详细事件和统一事件,默认使用详细事件。 +- [x] 支持发送完整服务器部署明细。 +- [x] 支持发送证书序列号。 +- [x] 支持发送管理后台链接。 +- [x] HTTP 状态码按 200-299 判定为成功。 +- [x] 重试次数和间隔支持使用默认值,也支持用户自定义。 +- [x] 请求字段统一使用英文。 +- [x] 支持用户自定义请求头。 + +建议请求头: + +```text +Content-Type: application/json +Authorization: Bearer {token} +X-Scert-Event: certificate.renewed +X-Scert-Request-Id: {request_id} +X-Scert-Timestamp: {unix_timestamp} +X-Scert-Signature: sha256={hmac_signature} +``` +- [x] 已确认需求:SMTP、IMAP、POP3 和 Web 管理后台的协议连接表仅作为外部邮件服务兼容性参考,不作为 Scert 实现邮件服务器端的要求;Scert 后续通过外部 API 接口调用邮件发送服务。 + - 【用户补充 U-035】(请填写): + - 补充内容:协议表仅作参考,后续通过 API 接口调用外部邮件发送服务。 + + | 协议 | 明文连接 | STARTTLS/STLS | 隐式 TLS | 端口 | + |---|---|---|---|---| + | SMTP 接收 | 支持 | 支持 | 支持 | 25、465 | + | SMTP Submission | 仅允许建立连接,不允许明文认证 | 支持 | 不在 587 上使用 | 587 | + | IMAP | 不支持 | 不支持 | 支持 | 993 | + | POP3 | 仅允许建立连接,不允许明文认证 | 支持,命令为 `STLS` | 支持 | 110、995 | + | Web 管理后台 | HTTP 初始化期间支持 | 不适用 | HTTPS 支持 | 80、443 | + - 确认结果:已填写 +- [x] 已确认需求:发件人显示名称默认为 Scert,发件人地址待测试后确定。 + - 【用户补充 U-036】(请填写): + - 补充内容:发件人:Scert,地址等待我测试后决定 + - 确认结果:已填写 +- [x] 已确认需求:通知发送失败时进行重试。 + - 【用户补充 U-037】(请填写): + - 补充内容:需要重试 + - 确认结果:已填写 +- [x] 已确认需求:支持按域名配置收件人,默认使用账户绑定的邮箱。 + - 【用户补充 U-038】(请填写): + - 补充内容:支持,但是默认使用账户绑定的邮箱 + - 确认结果:已填写 +- [x] 已确认需求:支持通知类型开关。 + - 【用户补充 U-039】(请填写): + - 补充内容:支持 + - 确认结果:已填写 + +#### 建议的通知状态 + +```text +续期结果:成功、失败、错误、未知、根据具体报错进行通知:如dns错误、dns超时等 +部署结果:全部成功、部分成功、全部失败、未执行 +邮件结果:发送成功、发送失败、未配置 +web页面:站内信提示全部的通知状态 +``` + +### 1.9 Web 管理界面 + +- [x] 管理员登录 +- [x] 查看所有托管域名 +- [x] 查看证书类型 +- [x] 查看证书到期时间 +- [x] 查看剩余有效天数 +- [x] 查看关联服务器 +- [x] 查看最近续期状态 +- [x] 添加和删除域名 +- [x] 配置 DNS 验证方式 +- [x] 配置部署服务器 +- [x] 手动续期 +- [x] 手动部署 +- [x] 上传自有证书 +- [x] 修改邮件配置 +- [x] 修改证书存储路径 +- [x] 查看操作日志 +- [x] 已确认需求:管理后台不由核心服务单独终止 HTTPS,前端和后端均需纳入 HTTPS 安全部署;具体终止层待架构评审。 + - 【用户补充 U-040】(请填写): + - 补充内容:由你确定边界 + - 确认结果:已填写 +- [x] 已确认需求:支持多个管理员。 + - 【用户补充 U-041】(请填写): + - 补充内容:支持 + - 确认结果:已填写 +- [x] 已确认需求:支持一个超级管理员、多个管理员和多个普通用户的角色体系。 + - 【用户补充 U-042】(请填写): + - 补充内容:需要:1个超级管理员,n个管理员,n个普通用户 + - 确认结果:已填写 +- [x] 已确认需求:支持用户名加密码、邮箱加密码、邮箱加验证码、用户名加验证码等登录方式。 + - 【用户补充 U-043】(请填写): + - 补充内容:需要:通过用户名+密码、邮箱+密码、邮箱+验证码、用户名+验证码 + - 确认结果:已填写 +- [x] 已确认需求:5 分钟内登录失败 5 次后禁止登录 30 分钟。 + - 【用户补充 U-044】(请填写): + - 补充内容:5分钟内失败5次禁止登录30分钟 + - 确认结果:已填写 +- [x] 已确认需求:连续 30 分钟无操作时自动强制退出。 + - 【用户补充 U-045】(请填写): + - 补充内容:30分钟未操作自动强制退出 + - 确认结果:已填写 + +### 1.10 命令行版本 + +- [x] 初始化配置 +- [x] 添加域名 +- [x] 删除域名 +- [x] 手动续期 +- [x] 手动部署 +- [x] 查看域名状态 +- [x] 查看证书信息 +- [x] 查看日志 +- [x] 修改系统配置 +- [x] 与 Web 管理界面共享配置和数据 +- [x] 已确认需求:CLI 通过 API 调用核心服务,不直接操作本地数据库。 + - 【用户补充 U-046】(请填写): + - 补充内容:通过api调用服务 + - 确认结果:已填写 +- [x] 已确认需求:初始化配置时使用交互式输入;初始化完成后不再使用交互式 CLI,转由 Web 页面操作。 + - 【用户补充 U-047】(请填写): + - 补充内容:初始化配置时需要交互式输入配置信息,初始化完成后不需要交互式,转由web页面操作 + - 确认结果:已填写 +- [x] 已确认需求:不支持 JSON 输出。 + - 【用户补充 U-048】(请填写): + - 补充内容:不支持 + - 确认结果:已填写 +- [x] 已确认需求:不支持脚本退出码。 + - 【用户补充 U-049】(请填写): + - 补充内容:不支持 + - 确认结果:已填写 +- [x] 已确认需求:支持任务等待和轮询。 + - 【用户补充 U-050】(请填写): + - 补充内容:支持 + - 确认结果:已填写 + +### 1.11 桌面图形界面 + +- [x] 支持首次初始化 +- [x] 支持配置管理员账号 +- [x] 支持配置邮件服务器 +- [x] 支持配置 DNS 验证 +- [x] 支持配置证书存储路径 +- [x] 支持打开 Web 管理界面 +- [x] 已确认需求:桌面版作为 Web 管理界面的封装。 + - 【用户补充 U-051】(请填写): + - 补充内容:是 + - 确认结果:已填写 +- [x] 已确认需求:桌面版负责启动本地核心服务。 + - 【用户补充 U-052】(请填写): + - 补充内容:是 + - 确认结果:已填写 +- [x] 已确认需求:需要系统托盘。 + - 【用户补充 U-053】(请填写): + - 补充内容:是 + - 确认结果:已填写 +- [x] 已确认需求:需要显示后台任务状态。 + - 【用户补充 U-054】(请填写): + - 补充内容:需要 + - 确认结果:已填写 +- [x] 已确认需求:支持开机自启动,但由用户选择是否启用。 + - 【用户补充 U-055】(请填写): + - 补充内容:需要,但是根据用户选择执行 + - 确认结果:已填写 +- [x] 已确认需求:桌面版安装包格式为 exe。 + - 【用户补充 U-056】(请填写): + - 补充内容:exe + - 确认结果:已填写 + +### 1.12 平台支持 + +- [x] Windows +- [x] Linux +- [x] Linux systemd 服务 +- [x] Windows Service 服务 +- [x] 已确认需求:支持 Windows 10 和 Windows 11,目标构建架构为 amd64。 + - 【用户补充 U-057】(请填写): + - 补充内容:win10 + - 确认结果:已填写 +- [x] 已确认需求:第一阶段以 Ubuntu 22.04 + Nginx 作为 Linux 基础测试环境,并覆盖 Ubuntu 24.04 + Nginx、CentOS/Rocky Linux、Debian、Caddy、Apache 和其他主流反向代理软件的兼容性测试。 + - 【用户补充 U-058】(请填写): + - 补充内容:Ubuntu20.04、debain11 + - 确认结果:已填写 +- [x] 已确认需求:Linux 服务以 Ubuntu 22.04 的 systemd 版本作为最低 systemd 兼容基线,其他 Linux 发行版通过测试矩阵确认兼容性。 + - 【用户补充 U-059】(请填写): + - 补充内容:需要支持到当前最新版 + - 确认结果:已填写 +- [x] 已确认需求:暂不支持 ARM64。 + - 【用户补充 U-060】(请填写): + - 补充内容:暂不需要,没有对应的环境进行测试 + - 确认结果:已填写 +- [x] 已确认需求:支持主流 Windows、Linux、Web 服务器和反向代理软件。 + - 【用户补充 U-061】(请填写): + - 补充内容:主流的win、Linux、web服务器/反向代理都需要支持 + - 确认结果:已填写 +- [x] 已确认需求:支持在 Windows 上部署 Nginx,并根据用户需求启用。 + - 【用户补充 U-062】(请填写): + - 补充内容:支持这个功能,但是根据用户需求启用 + - 确认结果:已填写 + +### 1.13 安全需求 + +- [x] 管理后台使用 HTTPS +- [x] 管理员密码使用安全哈希保存 +- [x] Linux 私钥文件权限限制为 600 或更严格 +- [x] Windows 使用等效 ACL 权限保护私钥 +- [x] SSH 私钥加密存储 +- [x] DNS API 密钥加密存储 +- [x] SMTP 密码加密存储 +- [x] 日志中禁止记录明文密钥 +- [x] 所有重要操作记录审计日志 +- [x] 已确认需求:使用主密码保护的加密配置。 + - 【用户补充 U-063】(请填写): + - 补充内容:使用主密码保护的加密配置 + - 确认结果:已填写 +- [x] 已确认需求:需要管理员恢复机制:超级管理员只能通过配套重置入口重置;管理员和普通用户可由超级管理员重置;普通用户可由管理员重置,且普通用户只能重置自身。 + - 【用户补充 U-064】(请填写): + - 补充内容:需要:超级管理员只能通过配套的重置入口进行重置,管理员和普通用户可以通过超级管理员重置,普通用户可以通过管理员重置,普通用户只能重置本身 + - 确认结果:已填写 +- [x] 已确认需求:支持敏感信息轮换。 + - 【用户补充 U-065】(请填写): + - 补充内容:需要 + - 确认结果:已填写 +- [x] 已确认需求:支持加密密钥备份。 + - 【用户补充 U-066】(请填写): + - 补充内容:需要 + - 确认结果:已填写 +- [x] 已确认需求:需要安全审计报告,且仅超级管理员和管理员可以查看。 + - 【用户补充 U-067】(请填写): + - 补充内容:需要,但是只能超级管理员和管理员查看 + - 确认结果:已填写 + +### 1.14 可靠性和运维 + +- [x] 失败时保留原证书 +- [x] 续期任务可重试 +- [x] 部署任务可重试 +- [x] 记录操作日志 +- [x] 记录错误原因 +- [x] 服务重启后可以恢复任务状态 +- [x] 已确认需求:支持数据库备份。 + - 【用户补充 U-068】(请填写): + - 补充内容:数据库备份 + - 确认结果:已填写 +- [x] 已确认需求:日志保留 30 天,默认保留最新 30 天后删除旧日志。 + - 【用户补充 U-069】(请填写): + - 补充内容:保留30天,默认保留最新的30天,然后删除旧的 + - 确认结果:已填写 +- [x] 已确认需求:日志每天限制 5 MB。 + - 【用户补充 U-070】(请填写): + - 补充内容:每天限制5mb + - 确认结果:已填写 +- [x] 已确认需求:支持日志轮转。 + - 【用户补充 U-071】(请填写): + - 补充内容:需要 + - 确认结果:已填写 +- [x] 已确认需求:支持配置导出和导入。 + - 【用户补充 U-072】(请填写): + - 补充内容:需要 + - 确认结果:已填写 +- [x] 已确认需求:需要灾难恢复流程。 + - 【用户补充 U-073】(请填写): + - 补充内容:需要 + - 确认结果:已填写 + +--- + +## 二、第一阶段范围 + +以下范围已根据需求确认结果纳入第一阶段。具体实现仍需按照开发任务清单逐项完成并复审。 + +- [x] 已确认纳入:核心证书管理服务和统一配置、数据模型 +- [x] 已确认纳入:数据库存储及任务、日志、证书版本数据管理 +- [x] 已确认纳入:Let’s Encrypt ACME CA,并使用 `go-acme/lego` 负责证书申请、DNS-01 验证和自动续期 +- [x] 已确认纳入:Cloudflare、阿里云 DNS、DNSPod、CNAME 委派、华为云、腾讯云、AWS Route 53、Google Cloud DNS 及其他服务商适配器 +- [x] 已确认纳入:DNS-01 验证、DNS Zone 和权限检测、DNS 传播检测 +- [x] 已确认纳入:CNAME 委派自动创建;自动创建失败时提示用户手动创建 +- [x] 已确认纳入:单域名证书、泛域名证书(不包含根域名)、多域名 SAN 证书以及生产/开发证书分类 +- [x] 已确认纳入:证书多版本保存、按证书类型分目录、失败时保留原证书 +- [x] 已确认纳入:通过 SSH 密钥部署到多台服务器,支持独立配置路径、用户、端口和密钥 +- [x] 已确认纳入:默认 Nginx,适配主流 Web 服务器和反向代理,并支持自定义 reload 命令 +- [x] 已确认纳入:部署失败重试、自动回滚、A/AAAA 记录检查和远程 HTTPS 校验 +- [x] 已确认纳入:HTTP API 和 SMTP 通知方式;SMTP、IMAP、POP3 协议表仅作为外部邮件服务兼容性参考,Scert 不实现邮件服务器端 +- [x] 已确认纳入:MySQL 5.7 基础开发、MySQL 8.0 兼容性测试和 SQLite 单机/桌面/开发模式 +- [x] 已确认纳入:Linux 默认目录 `/ssl`、`/scert`、`/scert/conf`、`/scert/log`、`/scert/backups` +- [x] 已确认纳入:Windows 按自定义安装目录使用 `Scert\ssl`、`Scert\data`、`Scert\config`、`Scert\logs`、`Scert\backups` +- [x] 已确认纳入:Linux 创建专用 `Scert` 服务运行用户;该用户专门管理证书目录,私钥由 `Scert` 和 `root` 共同受控管理 +- [x] 已确认纳入:CLI 初始化、Web 管理界面和桌面图形界面 +- [x] 已确认纳入:多管理员、超级管理员、管理员和普通用户角色权限 +- [x] 已确认纳入:Windows 10/11、Ubuntu 22.04 + Nginx、Ubuntu 24.04 + Nginx、CentOS/Rocky Linux、Debian、Caddy、Apache 和其他主流反向代理测试范围 +- [x] 已确认纳入:Linux systemd 服务、Windows Service 服务和桌面版 exe 安装包;systemd 以 Ubuntu 22.04 默认版本为最低兼容基线 +- [x] 已确认纳入:以当前开发电脑工具链为开发基线,目标构建架构为 amd64;当前记录为 Go 1.26.2、Node.js 24.19.0、npm 11.17.0、Wails 2.11.0 +- [x] 已确认纳入:用户自有证书上传、校验和手动部署;默认不参与自动续期 + +以下内容暂不纳入第一阶段或仍需后续确认: + +- [!] 自定义 ACME CA:第一阶段固定使用 Let’s Encrypt,后续预留扩展 +- [!] 高可用、多实例和集群部署 +- [!] ARM64 平台支持 +- [x] 已确认:HTTPS 采用双模式;默认由核心服务直接终止 HTTPS,高级模式由 Nginx/Caddy 终止公网 HTTPS,核心服务使用内部 HTTPS + +--- + +## 三、建议的系统模块 + +```text +SSL 服务程序 +├── 配置管理模块 +├── 管理员认证模块 +├── 域名管理模块 +├── 证书生命周期模块 +├── ACME 客户端模块 +├── DNS 服务商适配模块 +├── 续期调度模块 +├── SSH 部署模块 +├── Web 服务器和反向代理适配模块 +├── 远程 HTTPS 校验模块 +├── 自有证书导入模块 +├── 邮件通知模块 +├── Web API 模块 +├── CLI 模块 +├── 桌面客户端模块 +├── 审计日志模块 +└── 平台服务模块 +``` + +业务逻辑只放在核心服务中,CLI、Web 和桌面客户端不重复实现证书申请及部署逻辑。 + +--- + +## 四、建议的证书任务状态 + +### 4.1 续期任务状态 + +```text +pending 等待执行 +running 执行中 +succeeded 成功 +failed 失败 +partial 部分成功 +cancelled 已取消 +unknown 未知 +``` + +### 4.2 部署节点状态 + +```text +pending 等待部署 +uploading 上传中 +checking 配置检查中 +reloading 重载中 +validating HTTPS 校验中 +succeeded 成功 +failed 失败 +rolled_back 已回滚 +rollback_failed 回滚失败 +``` + +### 4.3 证书来源 + +```text +acme ACME 自动申请 +uploaded 用户上传 +imported 外部导入 +``` + +--- + +## 五、关键业务流程 + +### 5.1 首次初始化流程 + +```text +1. 启动程序 +2. 检查是否已完成初始化 +3. 未初始化时进入初始化向导 +4. 配置管理后台域名 +5. 配置管理员账号和密码 +6. 配置证书存储根目录 +7. 配置邮件服务器和通知方式(HTTP、SMTP) +8. 配置至少一种 DNS 验证方式 +9. 验证 DNS 凭据、DNS Zone、权限和 DNS 传播能力 +10. 检查管理后台域名解析 +11. 使用 Let’s Encrypt 和 `go-acme/lego` 通过 DNS-01 申请管理后台证书 +12. 校验并安装本地 HTTPS 证书 +13. 启动前后端均纳入 HTTPS 部署的管理后台 +14. 标记初始化完成 +``` + +### 5.2 自动续期流程 + +```text +1. 调度器按每 3 天一次的常规周期检查证书;剩余有效期低于 10 天时改为每天检查 +2. 证书剩余有效期低于 6 天时创建续期任务;低于 3 天时按紧急策略重试 +3. 申请任务进入串行队列,同一时间只运行一个申请任务 +4. 检查 DNS 配置、DNS Zone、权限和 ACME 账户 +5. 调用 `go-acme/lego` 使用 Let’s Encrypt 创建 ACME Order +6. 创建或委派 DNS TXT 记录 +7. 等待并检测 DNS 记录传播 +8. 执行 ACME DNS-01 验证并下载新证书 +9. 校验新证书和私钥 +10. 保存新的本地证书版本 +11. 部署到关联服务器并执行 Web 服务器或反向代理检查、reload +12. 检查所有 A/AAAA 记录并执行远程 HTTPS 校验 +13. 校验失败或部署失败时恢复旧版本 +14. 按默认 3 次、每次间隔 30 分钟的策略重试;用户可自定义续期时间和重试次数 +15. 写入任务和审计日志,并发送 HTTP/SMTP 任务通知 +``` + +### 5.3 用户证书部署流程 + +```text +1. 上传证书和私钥 +2. 校验文件格式 +3. 校验证书和私钥匹配 +4. 校验证书域名和有效期 +5. 保存为新版本 +6. 用户手动确认部署 +7. 部署到关联服务器 +8. 执行目标 Web 服务器或反向代理检查和 reload +9. 执行 HTTPS 校验 +10. 记录结果并发送通知 +``` + +--- + +## 六、验收标准 + +### 6.1 核心功能验收 + +- [ ] 能通过 CLI 完成首次初始化 +- [ ] 能通过 Web 管理界面完成首次初始化 +- [ ] 能通过桌面版完成首次初始化,并在初始化后打开 Web 管理界面 +- [ ] 能添加单域名 +- [ ] 能添加泛域名 +- [ ] 能通过 Let’s Encrypt 和 `go-acme/lego` 使用 DNS-01 成功申请证书 +- [ ] 能检测 DNS Zone、权限和 DNS 传播状态;CNAME 委派自动创建失败时能提示用户手动创建 +- [ ] 能保存证书、证书链和私钥 +- [ ] 能按生产证书、开发证书、单域名、泛域名和 SAN 证书保存多个证书版本;泛域名证书不包含根域名,SAN 域名集合变化时创建新的证书版本 +- [ ] 能通过 SSH 部署到多台目标服务器,并按服务器独立配置路径、用户、端口和密钥 +- [ ] 默认能部署到远程 Nginx,并能适配主流 Web 服务器和反向代理 +- [ ] 能执行目标 Web 服务器或反向代理的配置检查和 reload,且支持自定义 reload 命令 +- [ ] 能在部署后通过 HTTPS 校验 +- [ ] 能按每 3 天检查、低于 10 天每天检查、低于 6 天续期、低于 3 天紧急重试的策略自动续期 +- [ ] 默认失败重试 3 次、每次间隔 30 分钟,并允许用户自定义续期时间和重试次数 +- [ ] 能在失败时保留旧证书 +- [ ] 能在部署失败时回滚 +- [ ] 能通过 HTTP API 和 SMTP 发送成功、失败、错误、未知等任务通知;HTTP API 支持自定义地址、Bearer Token、HMAC-SHA256、无认证测试模式、详细/统一事件、完整部署明细、证书序列号、管理后台链接、自定义请求头和独立重试 +- [ ] 能上传自有证书并手动部署,且默认不参与自动续期 +- [ ] 能查看操作日志 + +### 6.2 安全验收 + +- [ ] 未登录用户不能访问管理接口 +- [ ] 管理员密码不以明文保存 +- [ ] DNS 密钥、SMTP 密码和 SSH 私钥不出现在日志中 +- [ ] 私钥文件权限符合平台要求 +- [ ] 上传路径不能越权 +- [ ] 远程 SSH 主机指纹可验证 +- [ ] Web 管理后台强制 HTTPS +- [ ] 续期和部署任务不能被未授权用户触发 + +### 6.3 平台验收 + +- [ ] Windows 10 及以上环境可以启动核心服务 +- [ ] Linux 环境可以启动核心服务 +- [ ] Ubuntu 22.04 + Nginx 可以运行 +- [ ] Ubuntu 24.04 + Nginx、CentOS/Rocky Linux、Debian、Caddy、Apache 和其他主流反向代理通过测试矩阵验证 +- [ ] Windows 服务可以自动启动 +- [ ] Linux systemd 服务可以自动启动 +- [ ] 桌面版可以通过 exe 安装包安装,并能启动本地核心服务、显示系统托盘和后台任务状态 +- [ ] Windows 和 Linux 使用同一套业务配置模型 + +--- + +## 七、需求确认结果与待确认事项 + +本节已根据前述用户补充区更新。已确认内容作为正式需求依据,未确认内容不得在实现阶段擅自假设。 + +### 7.1 已确认的关键结论 + +1. 第一阶段使用 Let’s Encrypt 作为 ACME CA,并使用 `go-acme/lego` 负责申请、DNS-01 验证和自动续期;其他 ACME CA 仅预留后续扩展能力。 +2. 第一阶段支持 Cloudflare、阿里云 DNS、DNSPod、CNAME 委派、华为云、腾讯云、AWS Route 53、Google Cloud DNS 及其他服务商适配器;CNAME 委派自动创建失败时提示用户手动创建。 +3. 第一阶段同时保留 HTTP API 和 SMTP 通知方式;SMTP、IMAP、POP3 协议表仅作为外部邮件服务兼容性参考,Scert 通过外部 API 调用邮件发送服务,不实现邮件服务器端。 +4. 管理后台采用双 HTTPS 模式:默认由核心服务直接终止 HTTPS;高级模式由 Nginx/Caddy 终止公网 HTTPS,核心服务使用内部 HTTPS。 +5. 续期策略为:每 3 天常规检查一次,剩余有效期低于 10 天时每天检查,低于 6 天触发续期,低于 3 天进入紧急重试;默认重试 3 次、每次间隔 30 分钟,用户可自定义续期时间和重试次数。 +6. 泛域名证书只申请 `*.example.com` 形式的泛域名,不自动包含 `example.com` 根域名。 +7. CNAME 委派默认由程序自动创建;自动创建失败时,必须向用户展示记录并提示手动创建。 +8. 第一阶段不限定远程目标为 Linux Nginx;默认支持 Nginx,并适配主流 Windows/Linux Web 服务器和反向代理软件。 +9. 桌面版采用 Web 管理界面封装,由桌面版启动本地核心服务,并提供系统托盘、后台任务状态和可选开机自启动。 +10. 协议连接表仅作为外部邮件服务兼容性参考;通知接口支持用户自定义地址、Bearer Token、HMAC-SHA256、无认证测试模式、详细/统一事件、自定义请求头、2xx 成功判定和可配置重试。 +11. 多域名 SAN 证书纳入第一阶段,使用主域名作为管理归属并保存完整 SAN 域名集合;域名集合变化时生成新的证书版本。 +12. 数据库支持 MySQL 和 SQLite;MySQL 5.7 作为基础开发和最低兼容版本,MySQL 8.0 作为兼容性测试版本,SQLite 用于单机、桌面和开发模式。 +13. Linux 默认使用 `/ssl`、`/scert`、`/scert/conf`、`/scert/log`、`/scert/backups`;创建专用 `Scert` 服务运行用户管理证书目录,私钥由 `Scert` 和 `root` 共同受控管理。Windows 按自定义安装目录使用 `Scert\\ssl`、`Scert\\data`、`Scert\\config`、`Scert\\logs`、`Scert\\backups`。 + +### 7.2 仍需确认或架构评审的事项 + +- [x] 已确认:U-004 多域名 SAN 证书纳入第一阶段,目录、申请、续期和部署规则已纳入正式需求。 +- [x] 已确认:U-040 HTTPS 采用双模式,默认核心服务直接终止,高级模式由 Nginx/Caddy 终止公网 HTTPS,核心服务使用内部 HTTPS。 +- [x] 已确认:平台测试范围为 Windows 10/11、Ubuntu 22.04 + Nginx、Ubuntu 24.04 + Nginx、CentOS/Rocky Linux、Debian、Caddy、Apache 和其他主流反向代理。 + +--- + +## 八、需求确认后的开发任务清单 + +### 阶段一:基础设计 + +- [ ] 未开始:冻结第一阶段需求范围 +- [ ] 未开始:确定核心服务和数据模型 +- [ ] 未开始:确定配置文件和数据库方案 +- [ ] 未开始:确定敏感信息加密方案 +- [ ] 未开始:确定证书目录和版本结构 +- [ ] 未开始:确定任务状态机 +- [ ] 未开始:确定 Windows、Linux、Windows Service 和 Linux systemd 的运行适配边界 +- [ ] 未开始:建立 Windows 10/11、Ubuntu 22.04 + Nginx、Ubuntu 24.04 + Nginx、CentOS/Rocky Linux、Debian、Caddy、Apache 和其他主流反向代理测试矩阵 + +### 阶段二:证书申请 + +- [ ] 未开始:实现 `go-acme/lego` ACME Issuer 和生命周期管理 +- [ ] 未开始:接入 Let’s Encrypt 生产环境和 ACME Staging 测试环境 +- [ ] 未开始:实现 DNS 服务商适配器接口 +- [ ] 未开始:实现国内外主流 DNS 服务商适配器 +- [ ] 未开始:实现 CNAME 委派自动创建、失败提示和传播检测 +- [ ] 未开始:实现 DNS Zone、权限和 DNS 传播检测 +- [ ] 未开始:实现证书保存和校验 +- [ ] 未开始:实现生产/开发证书分类及单域名、泛域名证书目录 +- [ ] 未开始:实现多域名 SAN 证书标识集合、目录、申请、续期、版本保存和部署关联 + +### 阶段三:续期和部署 + +- [ ] 未开始:实现每 3 天检查、低于 10 天每天检查的调度器 +- [ ] 未开始:实现低于 6 天续期、低于 3 天紧急重试的续期任务 +- [ ] 未开始:实现申请任务串行队列和任务等待、轮询 +- [ ] 未开始:实现默认 3 次、每次间隔 30 分钟且可配置的失败重试 +- [ ] 未开始:实现 SSH 部署 +- [ ] 未开始:实现 Web 服务器和反向代理部署适配器,默认支持 Nginx +- [ ] 未开始:实现远程配置检查、默认或自定义 reload 命令 +- [ ] 未开始:实现远程 HTTPS 校验 +- [ ] 未开始:实现版本化部署和回滚 +- [ ] 未开始:实现所有 A/AAAA 记录检查 +- [ ] 未开始:实现 HTTP API 和 SMTP 任务通知及通知失败重试 + +### 阶段四:管理界面 + +- [ ] 未开始:实现管理员认证 +- [ ] 未开始:实现超级管理员、管理员和普通用户角色权限 +- [ ] 未开始:实现 Web API +- [ ] 未开始:实现域名管理页面 +- [ ] 未开始:实现证书状态页面 +- [ ] 未开始:实现服务器配置页面 +- [ ] 未开始:实现任务和日志页面 +- [ ] 未开始:实现初始化向导 + +### 阶段五:平台和扩展 + +- [ ] 未开始:实现 Linux systemd 适配 +- [ ] 未开始:实现 Windows Service 适配 +- [ ] 未开始:实现桌面版 Web 封装、核心服务启动、系统托盘和后台任务状态 +- [ ] 未开始:实现桌面版 exe 安装包和可选开机自启动 +- [ ] 未开始:实现用户证书上传 +- [ ] 未开始:实现数据库备份、配置导入导出和灾难恢复 +- [ ] 未开始:实现敏感信息轮换、加密密钥备份和安全审计报告 +- [ ] 未开始:实现外部邮件服务 API 通知、SMTP 通知和 HTTP 通知配置页面 +- [ ] 未开始:实现双 HTTPS 模式、Linux systemd 最低基线和 Windows Service 适配 +- [ ] 未开始:预留自定义 ACME CA、高可用、多实例和 ARM64 扩展 + +--- + +## 九、确认记录 + +| 日期 | 确认人 | 变更内容 | 结果 | +|---|---|---|---| +| 2026-08-25 | 用户与系统整理 | 根据用户补充 U-035 更新协议连接策略、端口和认证限制 | 73 项已填写 | + +--- + +## 十、文档状态说明 + +- `[ ]` 未开始 +- `[~]` 进行中 +- `[x]` 已完成,等待复审 +- `[✓]` 复审通过 +- `[!]` 暂缓或存在阻塞 + +需求确认后,已填写并整理的条目标记为 `[x]`,等待复审;复审通过后标记为 `[✓]`;暂缓、阻塞或仍需确认的条目标记为 `[!]`。开发任务清单中的任务在实际开发过程中按状态更新。 diff --git a/doc/Scert开发任务清单.md b/doc/Scert开发任务清单.md new file mode 100644 index 0000000..d214ea1 --- /dev/null +++ b/doc/Scert开发任务清单.md @@ -0,0 +1,1276 @@ +# Scert 开发任务清单 + +> 文档用途:作为 Scert 项目后续开发、进度跟踪、阶段复审和验收的执行清单。 +> +> 项目名称:Scert +> 当前阶段:开发启动前任务规划 +> 文档状态:已生成,等待执行 +> 编制日期:2026-08-25 +> Git 远程名称:Scert +> Git 远程地址:`https://git.pcux.cn/xuans/Scert.git` + +--- + +## 一、任务状态说明 + +| 标记 | 含义 | +|---|---| +| `[ ]` | 未开始 | +| `[~]` | 进行中 | +| `[x]` | 已完成,等待复审 | +| `[✓]` | 复审通过 | +| `[!]` | 暂缓或存在阻塞 | + +开发过程中,每个任务完成后先标记为 `[x]`,经过复审和验证后再标记为 `[✓]`。未经过验证的实现不得直接标记为复审通过。 + +--- + +## 二、已确认的需求基线 + +### 2.1 项目和平台 + +- [x] 项目名称为 `Scert`。 +- [x] 支持 Windows 和 Linux。 +- [x] 目标构建架构为 amd64。 +- [x] 基础测试范围为 Windows 10/11、Ubuntu 22.04 + Nginx。 +- [x] 扩展测试范围为 Ubuntu 24.04 + Nginx、CentOS/Rocky Linux、Debian、Caddy、Apache 和其他主流反向代理。 +- [x] Linux systemd 以 Ubuntu 22.04 默认版本作为最低兼容基线。 +- [x] 提供命令行版本、Web 管理界面和 Wails 桌面版。 +- [x] CLI、Web 和桌面版共享同一套核心服务、配置和数据库。 + +### 2.2 工具链基线 + +- [x] Go:`go1.26.2`。 +- [x] Node.js:`v24.19.0`。 +- [x] npm:`11.17.0`,Windows PowerShell 中优先使用 `npm.cmd`。 +- [x] Wails:`v2.11.0`。 +- [x] 编写代码时使用英文标识符。 +- [x] 注释、说明、文档和界面显示使用中文。 + +### 2.3 ACME 和证书 + +- [x] 第一阶段使用 Let’s Encrypt。 +- [x] 使用 `go-acme/lego`,不使用 `acme.sh`。 +- [x] 支持 Let’s Encrypt Production 和 Staging。 +- [x] 支持 DNS-01 验证。 +- [x] 第一阶段支持单域名、泛域名和多域名 SAN 证书。 +- [x] SAN 证书以主域名作为管理归属。 +- [x] 保存完整 SAN 域名集合。 +- [x] SAN 集合变化时生成新的证书标识和证书版本。 +- [x] 续期失败时保留原证书,避免服务中断。 + +### 2.4 DNS 验证 + +第一阶段 DNS 验证适配范围: + +- [x] Cloudflare。 +- [x] 阿里云 DNS。 +- [x] DNSPod。 +- [x] CNAME 委派。 +- [x] 华为云。 +- [x] 腾讯云。 +- [x] AWS Route 53。 +- [x] Google Cloud DNS。 +- [x] 预留其他 DNS 服务商扩展接口。 + +### 2.5 数据库 + +- [x] 支持 MySQL 5.7。 +- [x] 支持 MySQL 8.0。 +- [x] 支持 SQLite。 +- [x] MySQL 5.7 作为基础开发和最低兼容版本。 +- [x] MySQL 8.0 作为兼容性测试版本。 +- [x] SQLite 用于单机、桌面版和开发测试模式。 +- [x] 使用 `database/sql` 和 Repository 数据访问层。 +- [x] MySQL 与 SQLite 分别维护迁移脚本和方言适配。 +- [x] 不通过 PATH 中的单个 `mysql` 命令判断版本。 + +本机 MySQL 客户端版本记录: + +| 安装路径 | 版本 | 用途 | +|---|---|---| +| `E:\DB\5.7\bin\mysql.exe` | MySQL 5.7.44 | 基础开发和最低兼容性验证 | +| `E:\DB\8.0\bin\mysql.exe` | MySQL 8.0.45 | 兼容性测试 | + +### 2.6 HTTPS 模式 + +- [x] 默认模式:核心服务直接终止 HTTPS。 +- [x] 高级模式:Nginx/Caddy 终止公网 HTTPS,核心服务使用内部 HTTPS。 +- [x] 初始化期间允许 HTTP。 +- [x] 初始化完成后管理后台强制使用 HTTPS。 + +### 2.7 通知边界 + +- [x] 支持 HTTP API 通知。 +- [x] 支持 SMTP 出站客户端通知。 +- [x] Scert 不实现 SMTP、IMAP、POP3 邮件服务器端。 +- [x] SMTP、IMAP、POP3 协议表仅作为外部邮件服务兼容性参考。 +- [x] HTTP 通知支持自定义地址、Bearer Token、HMAC-SHA256、无认证、详细事件、统一事件、自定义请求头、完整部署明细、证书序列号、管理后台链接、2xx 成功判断和可配置重试。 + +### 2.8 默认目录 + +Linux: + +```text +证书:/ssl +安装:/scert +配置:/scert/conf +日志:/scert/log +备份:/scert/backups +``` + +Windows: + +```text +证书:{安装目录}\Scert\ssl +数据库:{安装目录}\Scert\data +配置:{安装目录}\Scert\config +日志:{安装目录}\Scert\logs +备份:{安装目录}\Scert\backups +``` + +--- + +## 三、开发原则和边界 + +- [ ] 不在第一轮基础骨架中虚构证书申请已经完成。 +- [ ] 不在未完成验证前宣称 DNS Provider 已经可用。 +- [ ] 不在未完成远程测试前宣称多服务器部署完成。 +- [ ] 所有长任务使用持久化任务记录。 +- [ ] 所有证书操作保留审计日志。 +- [ ] 所有敏感信息必须加密保存或脱敏处理。 +- [ ] 续期和部署失败时保留旧证书。 +- [ ] 安装、升级和卸载不得删除用户证书、数据库和备份。 +- [ ] 远程命令必须经过白名单或严格格式校验。 +- [ ] 不把用户输入直接拼接为 Shell 命令。 +- [ ] 不把数据库连接信息、Token、密码和私钥写入 Git。 +- [ ] 不未经用户同意删除任何文件。 +- [ ] 不未经用户明确要求提交或推送 Git。 + +--- + +## 四、阶段总览 + +| 阶段 | 名称 | 主要目标 | 状态 | +|---|---|---|---| +| 0 | 需求和架构冻结 | 锁定开发基线和边界 | `[~]` | +| 1 | 项目基础工程 | 建立可编译、可运行的 Go 工程 | `[ ]` | +| 2 | 配置系统 | 完成跨平台配置和默认目录 | `[ ]` | +| 3 | 日志和错误 | 建立日志、错误和审计基础设施 | `[ ]` | +| 4 | 数据库 | 完成 MySQL/SQLite 连接、迁移和模型 | `[ ]` | +| 5 | 安全权限 | 完成管理员认证、角色和敏感信息保护 | `[ ]` | +| 6 | 域名证书模型 | 完成域名、SAN、证书版本模型 | `[ ]` | +| 7 | ACME/DNS | 集成 lego 和 DNS-01 Provider | `[ ]` | +| 8 | 自动续期 | 完成调度器、任务状态机和失败恢复 | `[ ]` | +| 9 | 多服务器部署 | 完成 SSH/SFTP、reload、回滚和验证 | `[ ]` | +| 10 | Web 服务 | 完成 HTTP/HTTPS API 和部署校验 | `[ ]` | +| 11 | 通知系统 | 完成 HTTP API 和 SMTP 出站通知 | `[ ]` | +| 12 | Web 管理后台 | 完成管理页面和初始化向导 | `[ ]` | +| 13 | CLI | 完成初始化、域名、续期、部署和查询命令 | `[ ]` | +| 14 | Wails 桌面版 | 完成桌面封装和托盘能力 | `[ ]` | +| 15 | 平台安装 | 完成 Windows Service、systemd 和安装包 | `[ ]` | +| 16 | 测试 | 完成单元、集成、安全和兼容性测试 | `[ ]` | +| 17 | 发布验收 | 完成构建、发布和概要验收 | `[ ]` | + +--- + +## 五、阶段 0:需求和架构冻结 + +### 5.1 文档基线 + +- [x] 需求确认文档已经生成。 +- [x] 技术架构设计文档已经生成。 +- [x] 已确认使用 `go-acme/lego`。 +- [x] 已确认 SAN 纳入第一阶段。 +- [x] 已确认双 HTTPS 模式。 +- [x] 已确认 MySQL 5.7、MySQL 8.0 和 SQLite。 +- [x] 已确认 HTTP 通知接口的 12 项要求。 +- [x] 已确认 DNS Provider 第一阶段清单。 +- [ ] 将需求编号与代码模块建立对应关系。 +- [ ] 将暂缓事项和阶段外事项建立清单。 + +### 5.2 阶段 0 交付物 + +- [x] `SSL服务程序需求确认文档.md` +- [x] `SSL服务程序技术架构设计文档.md` +- [ ] `Scert开发任务清单.md` +- [ ] 需求编号与模块映射表 +- [ ] 第一阶段范围说明 + +阶段验收标准: + +- 需求文档、技术架构文档和任务清单没有互相矛盾的基础决策。 +- 代码开发不再使用已废弃的 `acme.sh` 方案。 +- MySQL 5.7 和 MySQL 8.0 的用途明确区分。 + +--- + +## 六、阶段 1:项目基础工程 + +### 6.1 目录结构 + +- [ ] 创建 `backend` Go 后端目录。 +- [ ] 创建 CLI 入口目录。 +- [ ] 创建内部业务模块目录。 +- [ ] 创建数据库迁移目录。 +- [ ] 创建测试目录。 +- [ ] 完善 `frontend` 前端目录。 +- [ ] 创建 `desktop` Wails 封装目录。 +- [ ] 创建基础开发说明。 + +建议结构: + +```text +Scert/ +├── backend/ +│ ├── cmd/scert/ +│ ├── internal/ +│ │ ├── app/ +│ │ ├── config/ +│ │ ├── database/ +│ │ ├── domain/ +│ │ ├── repository/ +│ │ ├── service/ +│ │ ├── httpapi/ +│ │ ├── notifier/ +│ │ ├── acme/ +│ │ ├── deploy/ +│ │ ├── scheduler/ +│ │ ├── security/ +│ │ └── platform/ +│ ├── migrations/mysql/ +│ ├── migrations/sqlite/ +│ ├── tests/ +│ └── go.mod +├── frontend/ +├── desktop/ +├── scripts/ +├── doc/ +└── README.md +``` + +### 6.2 Go 模块和依赖 + +- [ ] 创建 `go.mod`。 +- [ ] 确定 Go Module 路径。 +- [ ] 设置 Go 版本。 +- [ ] 引入 `go-sql-driver/mysql`。 +- [ ] 引入 `modernc.org/sqlite`。 +- [ ] 引入 Web 框架。 +- [ ] 引入 CLI 框架。 +- [ ] 引入 `go-acme/lego`。 +- [ ] 引入安全密码哈希依赖。 +- [ ] 执行依赖整理和版本锁定。 +- [ ] 检查依赖许可证和安全公告。 + +### 6.3 首个可运行入口 + +- [ ] 实现 `scert version`。 +- [ ] 实现 `scert help`。 +- [ ] 实现 `scert serve`。 +- [ ] 实现启动参数解析。 +- [ ] 实现配置文件路径参数。 +- [ ] 实现监听地址参数。 +- [ ] 实现数据库驱动参数。 +- [ ] 实现优雅退出。 +- [ ] 实现启动失败的中文错误提示。 + +阶段验收标准: + +```text +scert version 可以执行 +scert help 可以显示中文帮助 +scert serve 可以启动服务 +Windows amd64 可以编译 +Linux amd64 可以交叉编译 +Ctrl+C 可以优雅退出 +``` + +--- + +## 七、阶段 2:配置系统 + +### 7.1 配置模型 + +- [ ] 服务配置。 +- [ ] 数据库配置。 +- [ ] 证书存储配置。 +- [ ] 日志配置。 +- [ ] HTTPS 配置。 +- [ ] ACME 配置。 +- [ ] DNS Provider 配置。 +- [ ] SMTP 配置。 +- [ ] HTTP 通知配置。 +- [ ] 安全配置。 +- [ ] 平台运行配置。 + +### 7.2 默认目录 + +- [ ] 实现 Linux 默认目录。 +- [ ] 实现 Windows 默认目录。 +- [ ] 支持用户自定义证书根路径。 +- [ ] 支持用户自定义安装目录。 +- [ ] 支持配置文件覆盖默认路径。 +- [ ] 支持环境变量覆盖配置。 +- [ ] 支持命令行参数覆盖配置。 +- [ ] 检查目录权限。 +- [ ] 自动创建必要目录。 +- [ ] 禁止初始化流程覆盖已有证书。 + +### 7.3 配置读写和升级 + +- [ ] 实现配置文件读取。 +- [ ] 实现配置文件保存。 +- [ ] 实现配置字段校验。 +- [ ] 实现配置版本字段。 +- [ ] 实现配置升级机制。 +- [ ] 实现配置备份。 +- [ ] 实现配置恢复。 +- [ ] 敏感字段单独加密保存。 +- [ ] 敏感字段不写入普通日志。 + +--- + +## 八、阶段 3:日志、错误和审计 + +### 8.1 日志系统 + +- [ ] 使用结构化日志。 +- [ ] 支持日志级别。 +- [ ] 支持控制台输出。 +- [ ] 支持文件输出。 +- [ ] 支持日志轮转。 +- [ ] 支持任务日志。 +- [ ] 支持错误日志。 +- [ ] 支持审计日志。 +- [ ] 记录请求 ID。 +- [ ] 记录任务 ID。 +- [ ] 记录操作用户。 +- [ ] 对密码、Token、密钥和私钥进行脱敏。 + +### 8.2 错误模型 + +- [ ] 定义配置错误。 +- [ ] 定义数据库错误。 +- [ ] 定义 ACME 错误。 +- [ ] 定义 DNS 错误。 +- [ ] 定义部署错误。 +- [ ] 定义证书校验错误。 +- [ ] 定义通知错误。 +- [ ] 定义权限错误。 +- [ ] 定义未知错误。 +- [ ] 统一 CLI、Web 和任务日志的错误分类。 + +--- + +## 九、阶段 4:数据库和数据模型 + +### 9.1 数据库连接层 + +- [ ] 实现数据库驱动选择。 +- [ ] 实现 SQLite 连接。 +- [ ] 实现 MySQL 5.7 连接。 +- [ ] 实现 MySQL 8.0 连接。 +- [ ] 实现连接池配置。 +- [ ] 实现连接健康检查。 +- [ ] 实现连接关闭。 +- [ ] 实现数据库错误分类。 +- [ ] DSN 日志脱敏。 +- [ ] 使用明确端口和 DSN 区分两套 MySQL。 + +### 9.2 数据库方言适配 + +- [ ] 处理自增主键差异。 +- [ ] 处理布尔字段差异。 +- [ ] 处理时间字段差异。 +- [ ] 处理 JSON 字段差异。 +- [ ] 处理分页语句差异。 +- [ ] 处理事务差异。 +- [ ] 处理索引差异。 +- [ ] 处理唯一约束差异。 +- [ ] SQLite 启用 WAL 和 busy timeout。 +- [ ] MySQL 使用连接池和事务隔离。 + +### 9.3 第一版数据表 + +- [ ] `users` +- [ ] `roles` +- [ ] `user_roles` +- [ ] `domains` +- [ ] `domain_identifiers` +- [ ] `certificates` +- [ ] `certificate_versions` +- [ ] `dns_providers` +- [ ] `dns_credentials` +- [ ] `servers` +- [ ] `domain_servers` +- [ ] `deployment_records` +- [ ] `tasks` +- [ ] `task_attempts` +- [ ] `notification_channels` +- [ ] `notification_deliveries` +- [ ] `audit_logs` +- [ ] `settings` +- [ ] `schema_migrations` + +### 9.4 数据库迁移 + +- [ ] 建立 MySQL 迁移目录。 +- [ ] 建立 SQLite 迁移目录。 +- [ ] 实现迁移版本表。 +- [ ] 实现迁移执行器。 +- [ ] 实现重复执行保护。 +- [ ] 实现迁移失败处理。 +- [ ] 实现启动时迁移。 +- [ ] 实现迁移状态查询。 +- [ ] 测试 MySQL 5.7 迁移。 +- [ ] 测试 MySQL 8.0 迁移。 +- [ ] 测试 SQLite 迁移。 + +--- + +## 十、阶段 5:安全和权限 + +### 10.1 管理员认证 + +- [ ] 管理员账号创建。 +- [ ] 管理员密码设置。 +- [ ] bcrypt 或等效安全哈希。 +- [ ] 登录失败限制。 +- [ ] 会话创建。 +- [ ] 会话过期。 +- [ ] 退出登录。 +- [ ] CSRF 防护。 +- [ ] Secure Cookie。 +- [ ] HttpOnly Cookie。 +- [ ] SameSite Cookie。 + +### 10.2 角色权限 + +- [ ] 超级管理员。 +- [ ] 管理员。 +- [ ] 普通用户。 +- [ ] 域名级权限。 +- [ ] 服务器级权限。 +- [ ] 证书上传权限。 +- [ ] 续期权限。 +- [ ] 部署权限。 +- [ ] 配置查看权限。 +- [ ] 敏感配置隐藏。 + +### 10.3 敏感信息保护 + +- [ ] DNS API 凭据加密存储。 +- [ ] SSH 私钥加密存储。 +- [ ] SMTP 密码加密存储。 +- [ ] HTTP Token 加密存储。 +- [ ] HMAC 密钥加密存储。 +- [ ] 生成配置主密钥。 +- [ ] 配置主密钥备份。 +- [ ] 配置主密钥恢复。 +- [ ] 私钥文件权限设置为 600 或 Windows 等效安全权限。 + +--- + +## 十一、阶段 6:域名、SAN 和证书模型 + +### 11.1 域名管理 + +- [ ] 添加域名。 +- [ ] 编辑域名。 +- [ ] 删除域名。 +- [ ] 启用或禁用自动续期。 +- [ ] 配置生产或开发环境。 +- [ ] 配置单域名证书。 +- [ ] 配置泛域名证书。 +- [ ] 配置 SAN 证书。 +- [ ] 配置关联服务器。 +- [ ] 配置 DNS Provider。 +- [ ] 配置 CNAME 委派。 +- [ ] 校验 FQDN。 +- [ ] 检查域名重复。 +- [ ] 检查泛域名格式。 +- [ ] 检查 SAN 域名集合。 + +### 11.2 SAN 管理 + +- [ ] 定义主域名。 +- [ ] 定义 SAN 域名集合。 +- [ ] 保存 SAN 集合快照。 +- [ ] 生成证书标识。 +- [ ] SAN 集合变化时生成新的证书标识。 +- [ ] 不覆盖旧 SAN 证书。 +- [ ] SAN 域名去重。 +- [ ] SAN 域名合法性校验。 +- [ ] 申请前展示 SAN 集合预览。 +- [ ] 保存 SAN 部署明细。 + +### 11.3 证书文件管理 + +- [ ] 生产证书目录。 +- [ ] 开发证书目录。 +- [ ] 单域名目录。 +- [ ] 泛域名目录。 +- [ ] SAN 证书目录。 +- [ ] `current` 目录。 +- [ ] `versions` 历史目录。 +- [ ] 证书链保存。 +- [ ] 私钥保存。 +- [ ] 证书元数据保存。 +- [ ] 证书序列号保存。 +- [ ] 证书指纹保存。 +- [ ] 证书有效期保存。 +- [ ] 私钥权限设置。 +- [ ] 证书版本清理策略。 + +--- + +## 十二、阶段 7:ACME 和 DNS 验证 + +### 12.1 Lego 基础集成 + +- [ ] 引入 `go-acme/lego`。 +- [ ] 实现 ACME Client 创建。 +- [ ] 配置 Let’s Encrypt Staging。 +- [ ] 配置 Let’s Encrypt Production。 +- [ ] 配置 ACME 账号邮箱。 +- [ ] 保存 ACME 账号信息。 +- [ ] 保存 ACME 注册状态。 +- [ ] 实现 ACME Order。 +- [ ] 实现证书申请。 +- [ ] 实现证书续期。 +- [ ] 实现证书撤销。 +- [ ] 实现 ACME 错误分类。 +- [ ] 实现速率限制提示。 + +### 12.2 DNS Provider 接口 + +- [ ] 定义 DNS Provider 接口。 +- [ ] 定义凭据验证接口。 +- [ ] 定义 Zone 查询接口。 +- [ ] 定义 TXT 记录创建接口。 +- [ ] 定义 TXT 记录删除接口。 +- [ ] 定义传播检测接口。 +- [ ] 定义权限检测接口。 +- [ ] 定义 Provider 配置模型。 +- [ ] 定义 Provider 错误模型。 + +### 12.3 第一批 DNS 实现 + +- [ ] Cloudflare。 +- [ ] 阿里云 DNS。 +- [ ] DNSPod。 +- [ ] 华为云。 +- [ ] 腾讯云。 +- [ ] AWS Route 53。 +- [ ] Google Cloud DNS。 +- [ ] CNAME 委派。 +- [ ] 其他服务商扩展占位。 + +### 12.4 CNAME 委派 + +- [ ] 配置专用验证域。 +- [ ] 生成 `_acme-challenge` 目标记录。 +- [ ] 自动创建 CNAME。 +- [ ] 检查 CNAME 是否生效。 +- [ ] 自动创建失败时提示用户。 +- [ ] 支持用户手动确认 CNAME。 +- [ ] 清理临时记录。 +- [ ] 记录委派操作日志。 + +--- + +## 十三、阶段 8:自动续期调度 + +### 13.1 调度器 + +- [ ] 实现持久化调度器。 +- [ ] 每日检查证书状态。 +- [ ] 证书剩余 6 天或更少时触发续期。 +- [ ] 支持自定义检查周期。 +- [ ] 支持手动触发续期。 +- [ ] 支持任务取消。 +- [ ] 支持任务暂停。 +- [ ] 支持任务恢复。 +- [ ] 支持任务优先级。 + +### 13.2 任务状态机 + +任务状态: + +```text +pending +running +succeeded +failed +error +unknown +cancelled +rolled_back +partial_success +``` + +- [ ] 定义任务状态。 +- [ ] 定义任务阶段。 +- [ ] 定义重试次数。 +- [ ] 定义错误信息。 +- [ ] 定义开始和结束时间。 +- [ ] 定义操作者。 +- [ ] 定义关联域名。 +- [ ] 定义关联证书版本。 +- [ ] 定义关联服务器。 +- [ ] 实现任务幂等。 +- [ ] 实现同域名任务互斥。 +- [ ] 实现全局 ACME 任务限制。 +- [ ] 实现失败恢复。 +- [ ] 实现任务历史查询。 + +### 13.3 续期流程 + +- [ ] 查询即将到期证书。 +- [ ] 检查 DNS Provider。 +- [ ] 创建 ACME Order。 +- [ ] 执行 DNS-01。 +- [ ] 获取证书。 +- [ ] 校验证书链。 +- [ ] 校验证书域名。 +- [ ] 保存新证书版本。 +- [ ] 更新 `current` 指向。 +- [ ] 触发部署。 +- [ ] 执行部署后验证。 +- [ ] 发送成功通知。 +- [ ] 失败时保留旧证书。 +- [ ] 失败时发送通知。 + +--- + +## 十四、阶段 9:多服务器部署 + +### 14.1 服务器配置 + +- [ ] 添加服务器。 +- [ ] 编辑服务器。 +- [ ] 删除服务器。 +- [ ] 配置服务器名称。 +- [ ] 配置 IP 或主机名。 +- [ ] 配置 SSH 端口。 +- [ ] 配置 SSH 用户。 +- [ ] 配置 SSH 私钥。 +- [ ] 配置主机指纹。 +- [ ] 配置证书目录。 +- [ ] 配置私钥目录。 +- [ ] 配置证书链目录。 +- [ ] 配置 reload 命令。 +- [ ] 配置 Web 服务类型。 + +### 14.2 SSH/SFTP + +- [ ] 实现 SSH 密钥认证。 +- [ ] 禁止密码登录。 +- [ ] 实现主机指纹校验。 +- [ ] 指纹变化时阻止部署。 +- [ ] 实现 SSH 连接超时。 +- [ ] 实现 SFTP 上传。 +- [ ] 实现远程目录检查。 +- [ ] 实现远程文件备份。 +- [ ] 实现临时文件上传。 +- [ ] 实现原子替换。 +- [ ] 实现远程权限设置。 +- [ ] 实现远程命令白名单。 + +### 14.3 部署回滚 + +- [ ] 部署前备份远程旧证书。 +- [ ] 上传证书文件。 +- [ ] 上传私钥文件。 +- [ ] 上传证书链文件。 +- [ ] 执行 Web 服务 reload。 +- [ ] reload 失败时回滚。 +- [ ] 部署失败时保留旧文件。 +- [ ] 每台服务器独立保存部署结果。 +- [ ] 支持部分成功状态。 +- [ ] 支持全部失败状态。 +- [ ] 支持手动重新部署。 + +--- + +## 十五、阶段 10:Web 服务和验证 + +### 15.1 Web API + +- [ ] 创建 HTTP 服务。 +- [ ] 创建 HTTPS 服务。 +- [ ] 实现 HTTP 初始化模式。 +- [ ] 实现 HTTPS 默认模式。 +- [ ] 实现内部 HTTPS 高级模式。 +- [ ] 实现健康检查接口。 +- [ ] 实现版本接口。 +- [ ] 实现统一 API 响应格式。 +- [ ] 实现统一错误格式。 +- [ ] 实现请求日志。 +- [ ] 实现请求 ID。 +- [ ] 实现基础限流。 + +### 15.2 本地证书校验 + +- [ ] 检查证书文件存在。 +- [ ] 检查私钥文件存在。 +- [ ] 检查证书和私钥匹配。 +- [ ] 检查证书链完整。 +- [ ] 检查证书有效期。 +- [ ] 检查证书域名匹配。 +- [ ] 检查 SAN 集合。 +- [ ] 检查证书序列号。 +- [ ] 检查证书指纹。 + +### 15.3 远程 HTTPS 校验 + +- [ ] 解析 A 记录。 +- [ ] 解析 AAAA 记录。 +- [ ] 对域名发起 HTTPS 请求。 +- [ ] 校验远程证书链。 +- [ ] 校验远程证书域名。 +- [ ] 校验远程证书有效期。 +- [ ] 校验证书序列号。 +- [ ] 保存每个 IP 的校验结果。 +- [ ] 校验失败时标记任务错误。 +- [ ] 校验失败时发送通知。 + +--- + +## 十六、阶段 11:通知系统 + +### 16.1 HTTP API 通知 + +- [ ] 支持用户自定义请求地址。 +- [ ] 支持 Bearer Token。 +- [ ] 支持 HMAC-SHA256。 +- [ ] 保留无认证模式。 +- [ ] 支持详细事件。 +- [ ] 支持统一事件。 +- [ ] 默认使用详细事件。 +- [ ] 请求字段统一使用英文。 +- [ ] 支持自定义请求头。 +- [ ] 支持完整服务器部署明细。 +- [ ] 支持证书序列号。 +- [ ] 支持管理后台链接。 +- [ ] HTTP 200-299 判定成功。 +- [ ] 默认请求超时 10 秒。 +- [ ] 默认重试 3 次。 +- [ ] 支持自定义重试次数和间隔。 +- [ ] 支持 `request_id`。 +- [ ] 实现接收方幂等要求说明。 +- [ ] 敏感信息不写入日志。 + +### 16.2 SMTP 出站通知 + +- [ ] 支持 SMTP 地址和端口。 +- [ ] 支持账号和密码。 +- [ ] 支持多个收件人。 +- [ ] 支持明文连接限制。 +- [ ] 支持 STARTTLS。 +- [ ] 支持隐式 TLS。 +- [ ] 发件人名称默认为 `Scert`。 +- [ ] 发件人地址保留可配置。 +- [ ] 邮件标题格式统一。 +- [ ] 邮件正文包含任务结果。 +- [ ] 支持成功、失败、错误、未知状态。 +- [ ] 支持通知独立重试。 + +--- + +## 十七、阶段 12:Web 管理后台 + +### 17.1 初始化向导 + +- [ ] 检查是否首次运行。 +- [ ] 配置管理后台域名。 +- [ ] 配置管理员账号。 +- [ ] 配置管理员密码。 +- [ ] 配置邮件服务器。 +- [ ] 配置收件人。 +- [ ] 配置证书存储根路径。 +- [ ] 至少配置一种 DNS 验证方式。 +- [ ] 校验 DNS API 权限。 +- [ ] 初始化数据库。 +- [ ] 创建管理员账号。 +- [ ] 申请管理后台证书。 +- [ ] 部署管理后台证书。 +- [ ] 切换 HTTPS。 +- [ ] 记录初始化日志。 + +### 17.2 管理页面 + +- [ ] 登录页面。 +- [ ] 首页仪表盘。 +- [ ] 域名列表页面。 +- [ ] 添加和编辑域名页面。 +- [ ] 证书详情页面。 +- [ ] SAN 域名管理页面。 +- [ ] DNS Provider 配置页面。 +- [ ] CNAME 委派配置页面。 +- [ ] 服务器列表页面。 +- [ ] 服务器部署状态页面。 +- [ ] 手动续期页面。 +- [ ] 手动部署页面。 +- [ ] 任务列表和详情页面。 +- [ ] 操作日志页面。 +- [ ] 邮件通知配置页面。 +- [ ] HTTP 通知配置页面。 +- [ ] 系统配置页面。 +- [ ] 备份恢复页面。 +- [ ] 用户和角色页面。 + +### 17.3 页面验收 + +- [ ] 使用中文界面。 +- [ ] 适配桌面浏览器。 +- [ ] 适配低高度窗口。 +- [ ] 适配移动视口基础布局。 +- [ ] 无严重横向溢出。 +- [ ] 错误提示清晰。 +- [ ] 危险操作二次确认。 +- [ ] 敏感字段默认隐藏。 +- [ ] 任务状态可刷新。 + +--- + +## 十八、阶段 13:CLI 命令 + +### 18.1 初始化命令 + +- [ ] `scert init`。 +- [ ] 交互式填写管理员账号。 +- [ ] 交互式填写管理员密码。 +- [ ] 交互式填写管理后台域名。 +- [ ] 交互式填写邮件配置。 +- [ ] 交互式填写证书根路径。 +- [ ] 交互式选择 DNS Provider。 +- [ ] 交互式填写 DNS 凭据。 +- [ ] 测试 DNS 凭据。 +- [ ] 初始化数据库。 +- [ ] 申请和部署管理后台证书。 + +### 18.2 域名和证书命令 + +- [ ] `scert domain add`。 +- [ ] `scert domain edit`。 +- [ ] `scert domain delete`。 +- [ ] `scert domain list`。 +- [ ] `scert domain show`。 +- [ ] `scert certificate list`。 +- [ ] `scert certificate show`。 +- [ ] `scert certificate upload`。 +- [ ] `scert certificate validate`。 +- [ ] `scert renew`。 +- [ ] `scert deploy`。 + +### 18.3 查询和配置命令 + +- [ ] `scert status`。 +- [ ] `scert logs`。 +- [ ] `scert config show`。 +- [ ] `scert config set`。 +- [ ] `scert config validate`。 +- [ ] `scert backup`。 +- [ ] `scert restore`。 +- [ ] `scert version`。 +- [ ] 支持非交互模式。 +- [ ] 支持脚本退出码。 +- [ ] 支持任务编号输出。 +- [ ] 支持等待任务完成。 + +--- + +## 十九、阶段 14:Wails 桌面版 + +- [ ] 创建 Wails 项目结构。 +- [ ] 接入同一套 Vue 前端。 +- [ ] 桌面端启动核心服务。 +- [ ] 桌面端连接本地核心服务。 +- [ ] 检查核心服务健康状态。 +- [ ] 实现桌面端初始化页面。 +- [ ] 实现系统托盘。 +- [ ] 实现服务启动、停止和重启。 +- [ ] 实现开机自启动配置。 +- [ ] 实现桌面端日志查看。 +- [ ] 实现桌面端错误提示。 +- [ ] Windows 10 安装测试。 +- [ ] Windows 11 安装测试。 +- [ ] 桌面端与浏览器功能一致性测试。 +- [ ] 卸载不删除用户证书和备份。 + +--- + +## 二十、阶段 15:平台服务和安装 + +### 20.1 Linux + +- [ ] 创建 `Scert` 服务运行用户。 +- [ ] 创建 `/scert`。 +- [ ] 创建 `/scert/conf`。 +- [ ] 创建 `/scert/log`。 +- [ ] 创建 `/scert/backups`。 +- [ ] 创建 `/ssl`。 +- [ ] 设置证书目录所有权。 +- [ ] 设置私钥文件权限。 +- [ ] 配置 `Scert` 与 `root` 共同受控管理私钥。 +- [ ] 创建 systemd 服务文件。 +- [ ] 配置自动启动、停止、重启。 +- [ ] Ubuntu 22.04 systemd 基线测试。 +- [ ] Ubuntu 24.04 测试。 +- [ ] Debian 测试。 +- [ ] CentOS/Rocky Linux 测试。 + +### 20.2 Windows + +- [ ] 支持选择自定义安装目录。 +- [ ] 创建 `Scert\ssl`。 +- [ ] 创建 `Scert\data`。 +- [ ] 创建 `Scert\config`。 +- [ ] 创建 `Scert\logs`。 +- [ ] 创建 `Scert\backups`。 +- [ ] 设置 Windows 文件权限。 +- [ ] 创建 Windows Service。 +- [ ] 配置服务启动、停止和重启。 +- [ ] Windows 10 测试。 +- [ ] Windows 11 测试。 +- [ ] 升级不覆盖用户数据。 +- [ ] 卸载不删除证书和备份。 + +--- + +## 二十一、阶段 16:测试 + +### 21.1 单元测试 + +- [ ] 配置读写测试。 +- [ ] 配置校验测试。 +- [ ] 路径处理测试。 +- [ ] 数据库迁移测试。 +- [ ] Repository 测试。 +- [ ] 域名校验测试。 +- [ ] SAN 集合测试。 +- [ ] 证书解析测试。 +- [ ] 证书链校验测试。 +- [ ] 私钥匹配测试。 +- [ ] 任务状态机测试。 +- [ ] 重试策略测试。 +- [ ] HMAC 签名测试。 +- [ ] 通知请求构造测试。 +- [ ] SSH 主机指纹测试。 +- [ ] 部署回滚测试。 + +### 21.2 数据库兼容性测试 + +- [ ] MySQL 5.7 建库和迁移。 +- [ ] MySQL 5.7 CRUD 和事务。 +- [ ] MySQL 8.0 建库和迁移。 +- [ ] MySQL 8.0 CRUD 和事务。 +- [ ] SQLite 建库和迁移。 +- [ ] SQLite CRUD 和事务。 +- [ ] SQLite 并发访问。 +- [ ] SQLite WAL。 +- [ ] SQLite 数据备份和恢复。 + +### 21.3 集成测试 + +- [ ] 初始化完整流程。 +- [ ] 添加域名流程。 +- [ ] SAN 证书流程。 +- [ ] Let’s Encrypt Staging 申请流程。 +- [ ] DNS Provider 流程。 +- [ ] CNAME 委派流程。 +- [ ] 自动续期流程。 +- [ ] 多服务器部署流程。 +- [ ] 部署失败回滚流程。 +- [ ] 远程 HTTPS 校验流程。 +- [ ] HTTP 通知流程。 +- [ ] SMTP 通知流程。 +- [ ] CLI 与 Web 共用数据验证。 + +### 21.4 安全测试 + +- [ ] 管理员密码不可明文存储。 +- [ ] DNS 密钥不可明文输出。 +- [ ] SSH 私钥不可明文输出。 +- [ ] HTTP Token 不写入日志。 +- [ ] HMAC 密钥不写入日志。 +- [ ] 防止路径穿越。 +- [ ] 防止命令注入。 +- [ ] 防止未授权访问。 +- [ ] 防止越权操作。 +- [ ] 防止重复任务。 +- [ ] 防止证书错误覆盖。 +- [ ] 防止私钥权限过宽。 +- [ ] 防止 HTTP 通知重放。 + +--- + +## 二十二、阶段 17:构建、发布和最终验收 + +### 22.1 构建任务 + +- [ ] Windows amd64 构建。 +- [ ] Linux amd64 构建。 +- [ ] 后端单文件构建。 +- [ ] 前端生产构建。 +- [ ] Wails 桌面版构建。 +- [ ] 构建时注入版本信息。 +- [ ] 统一构建产物命名。 +- [ ] 生成构建产物校验和。 +- [ ] 编写构建说明。 + +### 22.2 发布文件 + +- [ ] Windows Service 安装包。 +- [ ] Windows 桌面版安装包。 +- [ ] Linux amd64 发布包。 +- [ ] Linux systemd 服务文件。 +- [ ] 默认配置模板。 +- [ ] 数据库迁移文件。 +- [ ] 升级说明。 +- [ ] 回滚说明。 +- [ ] 用户操作说明。 + +### 22.3 最终验收 + +- [ ] Web 可以添加域名并申请证书。 +- [ ] SAN 证书可以成功申请。 +- [ ] 泛域名证书可以成功申请。 +- [ ] 证书剩余 6 天时自动续期。 +- [ ] 续期成功后部署到多台服务器。 +- [ ] 部署后自动 reload Web 服务。 +- [ ] 部署后远程 HTTPS 校验成功。 +- [ ] 失败时保留原证书。 +- [ ] 失败时发送通知。 +- [ ] 用户证书可以上传和部署。 +- [ ] CLI 与 Web 数据一致。 +- [ ] Windows 10/11 可以运行。 +- [ ] Ubuntu 22.04 + Nginx 可以运行。 +- [ ] MySQL 5.7 可以运行。 +- [ ] MySQL 8.0 兼容性测试通过。 +- [ ] SQLite 单机模式可以运行。 +- [ ] Wails 桌面版可以运行。 + +--- + +## 二十三、首轮开发范围 + +首轮开发优先完成可运行的基础骨架,不直接进入完整证书申请和远程部署。 + +### 首轮任务 + +- [✓] 创建 Go 模块。 +- [✓] 创建 CLI 入口。 +- [✓] 创建配置模型。 +- [✓] 实现 SQLite 数据库连接。 +- [✓] 实现 MySQL 数据库连接。 +- [✓] 实现数据库迁移框架。 +- [✓] 实现基础数据表。 +- [✓] 实现日志系统。 +- [✓] 实现 HTTP 服务。 +- [✓] 实现 `/healthz` 健康检查接口。 +- [✓] 实现 `/api/v1/status` 状态接口。 +- [✓] 实现 `scert version`。 +- [✓] 实现 `scert init` 基础配置初始化。 +- [✓] 实现 `scert status` 基础状态查询。 +- [✓] 编写配置、数据库、健康检查测试。 +- [✓] 完成 Windows 编译和 Linux amd64 交叉编译。 + +### 首轮验收目标 + +```text +scert version 可以执行 +scert help 可以显示中文帮助 +scert init 可以生成初始配置 +scert status 可以显示服务状态 +scert serve 可以启动服务 +GET /healthz 返回成功 +GET /api/v1/status 返回服务状态 +SQLite 可以初始化和迁移 +MySQL 5.7 可以连接和迁移 +MySQL 8.0 可以连接和迁移 +基础单元测试通过 +Windows amd64 可以编译 +Linux amd64 可以交叉编译 +``` + +### 首轮暂不宣称完成 + +- [ ] ACME 证书申请。 +- [ ] DNS Provider 实际调用。 +- [ ] 自动续期。 +- [ ] SSH/SFTP 远程部署。 +- [ ] Nginx/Caddy/Apache 实际 reload。 +- [ ] 完整 Web 管理界面。 +- [ ] 完整 Wails 桌面版。 +- [ ] Windows Service。 +- [ ] Linux systemd。 + +--- + +## 二十四、开发执行规则 + +- [ ] 每开始一个阶段,将阶段状态标记为 `[~]`。 +- [ ] 阶段实现完成后,将任务标记为 `[x]`。 +- [ ] 完成测试并等待复审后,才标记为 `[✓]`。 +- [ ] 发现阻塞时标记为 `[!]`,并记录阻塞原因。 +- [ ] 不把未测试功能标记为复审通过。 +- [ ] 每个阶段完成后更新本文件。 +- [ ] 每个阶段完成后执行格式化、编译和测试。 +- [ ] 长时间任务每 5-10 分钟汇报一次进度。 +- [ ] 不使用脚本批量替换中文内容。 +- [ ] Git 提交信息使用中文。 +- [ ] 未经用户明确要求不提交和推送。 +- [ ] 不删除现有文件。 + +--- + +## 二十五、当前进度 + +| 项目 | 状态 | +|---|---| +| 需求确认 | `[✓]` 复审通过 | +| 技术架构确认 | `[✓]` 复审通过 | +| 开发任务清单 | `[✓]` 已生成,等待复审 | +| 项目代码开发 | `[~]` 进行中 | +| 首轮基础骨架 | `[✓]` 已完成,等待复审 | +| Git 提交 | `[ ]` 未开始 | +| Git 推送 | `[ ]` 未开始 | + +下一步默认从“阶段 1:项目基础工程”和“首轮开发范围”开始执行。 + +--- + +## 二十六、首轮开发执行记录 + +### 26.1 已完成,等待复审 + +- [✓] 建立 `backend` Go 模块和 `scert` CLI 入口。 +- [✓] 实现 JSON 配置模型、Windows/Linux 默认目录、配置保存、读取和校验。 +- [✓] 实现 `log/slog` 结构化日志输出,日志文件使用受限权限创建。 +- [✓] 实现 SQLite 和 MySQL 数据库打开、连接池和 Ping 检查。 +- [✓] 实现 SQLite/MySQL 首版迁移脚本,创建设置、域名、任务和审计日志基础表。 +- [✓] 实现域名领域模型和 SQL Repository,纳入单域名、泛域名和 SAN 基础校验。 +- [✓] 实现应用组装、资源关闭和数据库自动迁移。 +- [✓] 实现 `/healthz`、`/api/v1/status`、域名列表、域名创建和域名删除接口。 +- [✓] 实现 `version`、`help`、`init`、`status`、`serve`、`domain list` 和 `domain add` 命令。 +- [✓] 创建 Vue/Vite 中文前端占位页面和开发代理配置。 +- [✓] 补充根 README、后端 README、配置测试、数据库迁移测试和 HTTP API 测试。 + +### 26.2 验证结果 + +- [✓] `go fmt ./...` 通过。 +- [✓] `go vet ./...` 通过。 +- [✓] `go test ./...` 通过。 +- [✓] Windows amd64 可执行文件构建通过。 +- [✓] Linux amd64 交叉编译通过。 +- [✓] CLI 初始化、状态、域名添加和域名列表流程实测通过。 +- [✓] HTTP 服务启动、`/healthz` 和 `/api/v1/status` 接口实测通过。 + +### 26.3 后续阶段,不在本轮宣称完成 + +- [ ] 集成 `go-acme/lego`,完成 Let’s Encrypt Staging/Production 申请。 +- [ ] 接入 DNS-01 服务商和 CNAME 委派。 +- [ ] 实现自动续期任务调度和证书版本保留。 +- [ ] 实现 SSH/SFTP 推送、远程备份和 Nginx/Caddy/Apache reload。 +- [ ] 实现部署后的远程 HTTPS 证书链校验。 +- [ ] 实现 HTTP API、SMTP 出站通知及重试/HMAC/Bearer Token 配置。 +- [ ] 完成管理员认证、完整 Web 管理界面和操作日志页面。 +- [ ] 完成 Wails 桌面版、Windows Service 和 Linux systemd。 +- [!] 完成 MySQL 5.7/8.0 实例连接和迁移兼容性实测。 + +### 26.4 当前状态 + +| 项目 | 状态 | +|---|---| +| 首轮基础骨架 | `[✓]` 已完成,等待复审 | +| 首轮验证 | `[✓]` 已完成,等待复审 | +| 完整证书管理功能 | `[ ]` 未开始 | +| Git 提交 | `[ ]` 未开始 | +| Git 推送 | `[ ]` 未开始 | + +--- + +## 二十七、首轮开发复审记录 + +### 27.1 复审信息 + +- 复审日期:2026 年 8 月 26 日。 +- 复审范围:配置、日志、数据库连接、数据库迁移、域名领域模型、SQL Repository、HTTP API、CLI、Vue/Vite 前端占位页、Windows/Linux amd64 构建和运行流程。 +- 复审原则:仅将经过源码核对和实际验证的项目标记为 `[✓]`;缺少真实环境参数的兼容性测试保持 `[!]`。 + +### 27.2 复审发现并已修复 + +- [✓] 修复构建版本常量,统一程序版本为 `0.1.0`,并将配置版本单独作为 `config_version` 返回。 +- [✓] 修复 CLI 重复 `help`、默认 `completion` 和主要英文帮助标题,支持 `scert help domain`。 +- [✓] 修复 CLI JSON 编码错误被忽略的问题。 +- [✓] 修复 SAN 仅检查数量、主域名未稳定纳入完整 SAN 集合以及重复处理的问题。 +- [✓] 增加 SAN 逐项域名格式验证和去重测试。 +- [✓] HTTP API 不再向客户端返回底层 `err.Error()`,内部错误仅写入服务日志。 +- [✓] 状态接口同时返回程序版本和配置版本。 +- [✓] 未知数据库驱动不再回退到 SQLite,而是明确拒绝。 +- [✓] MySQL DSN 通过驱动解析器规范化,并强制启用 `parseTime` 和 UTC 时间位置。 +- [✓] MySQL 迁移不再依赖无法保证回滚的 DDL 事务;所有幂等 DDL 成功后才记录迁移版本。 +- [✓] SQLite 迁移继续使用事务,并验证重复迁移不会重复写入版本。 +- [✓] Repository 的 `GetByID`、`List`、`Delete` 增加空数据库保护,`IsNotFound` 改为基于 `errors.Is` 判断。 +- [✓] 配置版本不兼容时明确拒绝,配置文件覆盖保存和权限收紧通过测试。 +- [✓] 已有日志文件会重新收紧权限,结构化 JSON 日志写入通过测试。 +- [✓] HTTP 服务增加读取头、读取、写入和空闲超时。 +- [✓] 前端补充中文证书类型、域名状态和 HTTPS 模式显示,生产构建通过。 +- [✓] 增加 `.gitignore`,忽略后端构建目录、前端依赖目录、前端构建目录和日志文件。 + +### 27.3 新增测试覆盖 + +- [✓] 单域名、泛域名、非法证书类型和泛域名类型匹配测试。 +- [✓] SAN 自动包含主域名、去重、最少域名数量和非法 SAN 测试。 +- [✓] 非法数据库驱动、MySQL DSN 时间解析和 SQLite 迁移幂等性测试。 +- [✓] 四张基础表存在性检查。 +- [✓] 配置版本兼容性和覆盖保存测试。 +- [✓] Repository 空数据库保护、CRUD 和未找到判断测试。 +- [✓] CLI 中文帮助、单一 `help`、禁用 `completion`、子命令帮助和版本字段测试。 +- [✓] HTTP 状态版本、SAN 请求、404 和错误信息不泄露测试。 +- [✓] JSON 日志内容和非 Windows 权限断言测试。 + +### 27.4 本轮验证结果 + +- [✓] `gofmt` 检查通过。 +- [✓] `go vet ./...` 通过。 +- [✓] `go test ./...` 通过。 +- [✓] `go test -race ./...` 通过。 +- [✓] Windows amd64 复审构建通过:`backend/dist/scert-review-windows-amd64.exe`。 +- [✓] Linux amd64 复审交叉构建通过:`backend/dist/scert-review-linux-amd64`。 +- [✓] `npm.cmd install` 通过,安装 34 个依赖包,审计结果为 0 个已知漏洞。 +- [✓] `npm.cmd run build` 通过,Vue/Vite 生产产物已生成到 `frontend/dist`。 +- [✓] `scert version` 返回 `0.1.0`。 +- [✓] `scert help` 和 `scert help domain` 显示中文帮助,只有一个 `help`,不显示 `completion`。 +- [✓] `scert init`、`scert status`、`scert domain add` 和 `scert domain list` 实际流程通过。 +- [✓] `scert serve` 实际启动通过,`/healthz`、`/api/v1/status` 返回成功。 +- [✓] 严格 UTF-8、无 BOM、无 Unicode 替换字符和无连续乱码问号检查通过。 +- [✓] Git 远程名称为 `Scert`,地址为 `https://git.pcux.cn/xuans/Scert.git`。 + +### 27.5 阻塞和边界 + +- [!] MySQL 5.7 实例连接和迁移尚未实测。已确认客户端为 `E:\DB\5.7\bin\mysql.exe`,版本 `5.7.44`,但缺少明确 DSN、端口、账号和密码。 +- [!] MySQL 8.0 实例连接和迁移尚未实测。已确认客户端为 `E:\DB\8.0\bin\mysql.exe`,版本 `8.0.45`,但缺少明确 DSN、端口、账号和密码。 +- [!] Linux 文件权限当前完成代码实现和交叉构建,仍需在 Ubuntu 22.04 实机验证运行用户、目录属主和 `0600` 权限。 +- [!] Windows 安全 ACL 尚未实现;当前 `0600` 调用不能替代完整 Windows ACL 验收。 +- [!] 默认直接 HTTPS 和高级内部 HTTPS 仍属于后续阶段,当前 `serve` 仅为 HTTP 基础骨架。 +- [!] ACME/lego、DNS Provider、自动续期、远程部署、通知、认证、完整 Web 和 Wails 均未进入本轮完成范围。 + +### 27.6 复审结论 + +| 项目 | 状态 | +|---|---| +| 首轮基础骨架代码 | `[✓]` 复审通过 | +| SQLite 本地流程 | `[✓]` 复审通过 | +| CLI 和 HTTP 基础流程 | `[✓]` 复审通过 | +| Vue/Vite 前端占位页 | `[✓]` 复审通过 | +| Windows/Linux amd64 构建 | `[✓]` 复审通过 | +| MySQL 5.7/8.0 实例兼容性 | `[!]` 等待明确连接参数 | +| 首轮完整环境验收 | `[!]` 尚未全部完成 | +| Git 提交 | `[ ]` 未开始 | +| Git 推送 | `[ ]` 未开始 | + +当前代码可以继续进入下一阶段开发,但不能宣称 MySQL 5.7/8.0 真实实例兼容性、HTTPS 双模式或完整证书生命周期已经验收通过。 \ No newline at end of file diff --git a/frontend/index.html b/frontend/index.html new file mode 100644 index 0000000..f2b3f70 --- /dev/null +++ b/frontend/index.html @@ -0,0 +1,12 @@ + + + + + + Scert SSL 证书管理 + + +
+ + + diff --git a/frontend/package-lock.json b/frontend/package-lock.json new file mode 100644 index 0000000..bf49b75 --- /dev/null +++ b/frontend/package-lock.json @@ -0,0 +1,1382 @@ +{ + "name": "scert-frontend", + "version": "0.1.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "scert-frontend", + "version": "0.1.0", + "dependencies": { + "vue": "^3.5.0" + }, + "devDependencies": { + "@vitejs/plugin-vue": "^5.2.0", + "vite": "^6.0.0" + } + }, + "node_modules/@babel/helper-string-parser": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.29.7.tgz", + "integrity": "sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-identifier": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.29.7.tgz", + "integrity": "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/parser": { + "version": "7.29.8", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.8.tgz", + "integrity": "sha512-E8lTAYNB1KW+FH+VGJuZM1ioAx2E6oVlvQFRrf5P8ZZmsiJXYAD9vTFV7yyEURNzgh1dFqMZuO6tUwcARbqFCA==", + "license": "MIT", + "dependencies": { + "@babel/types": "^7.29.8" + }, + "bin": { + "parser": "bin/babel-parser.js" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@babel/types": { + "version": "7.29.8", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.8.tgz", + "integrity": "sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg==", + "license": "MIT", + "dependencies": { + "@babel/helper-string-parser": "^7.29.7", + "@babel/helper-validator-identifier": "^7.29.7" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@esbuild/aix-ppc64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.25.12.tgz", + "integrity": "sha512-Hhmwd6CInZ3dwpuGTF8fJG6yoWmsToE+vYgD4nytZVxcu1ulHpUQRAB1UJ8+N1Am3Mz4+xOByoQoSZf4D+CpkA==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.25.12.tgz", + "integrity": "sha512-VJ+sKvNA/GE7Ccacc9Cha7bpS8nyzVv0jdVgwNDaR4gDMC/2TTRc33Ip8qrNYUcpkOHUT5OZ0bUcNNVZQ9RLlg==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.25.12.tgz", + "integrity": "sha512-6AAmLG7zwD1Z159jCKPvAxZd4y/VTO0VkprYy+3N2FtJ8+BQWFXU+OxARIwA46c5tdD9SsKGZ/1ocqBS/gAKHg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.25.12.tgz", + "integrity": "sha512-5jbb+2hhDHx5phYR2By8GTWEzn6I9UqR11Kwf22iKbNpYrsmRB18aX/9ivc5cabcUiAT/wM+YIZ6SG9QO6a8kg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.25.12.tgz", + "integrity": "sha512-N3zl+lxHCifgIlcMUP5016ESkeQjLj/959RxxNYIthIg+CQHInujFuXeWbWMgnTo4cp5XVHqFPmpyu9J65C1Yg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.25.12.tgz", + "integrity": "sha512-HQ9ka4Kx21qHXwtlTUVbKJOAnmG1ipXhdWTmNXiPzPfWKpXqASVcWdnf2bnL73wgjNrFXAa3yYvBSd9pzfEIpA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.25.12.tgz", + "integrity": "sha512-gA0Bx759+7Jve03K1S0vkOu5Lg/85dou3EseOGUes8flVOGxbhDDh/iZaoek11Y8mtyKPGF3vP8XhnkDEAmzeg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.25.12.tgz", + "integrity": "sha512-TGbO26Yw2xsHzxtbVFGEXBFH0FRAP7gtcPE7P5yP7wGy7cXK2oO7RyOhL5NLiqTlBh47XhmIUXuGciXEqYFfBQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.25.12.tgz", + "integrity": "sha512-lPDGyC1JPDou8kGcywY0YILzWlhhnRjdof3UlcoqYmS9El818LLfJJc3PXXgZHrHCAKs/Z2SeZtDJr5MrkxtOw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.25.12.tgz", + "integrity": "sha512-8bwX7a8FghIgrupcxb4aUmYDLp8pX06rGh5HqDT7bB+8Rdells6mHvrFHHW2JAOPZUbnjUpKTLg6ECyzvas2AQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ia32": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.25.12.tgz", + "integrity": "sha512-0y9KrdVnbMM2/vG8KfU0byhUN+EFCny9+8g202gYqSSVMonbsCfLjUO+rCci7pM0WBEtz+oK/PIwHkzxkyharA==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-loong64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.25.12.tgz", + "integrity": "sha512-h///Lr5a9rib/v1GGqXVGzjL4TMvVTv+s1DPoxQdz7l/AYv6LDSxdIwzxkrPW438oUXiDtwM10o9PmwS/6Z0Ng==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-mips64el": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.25.12.tgz", + "integrity": "sha512-iyRrM1Pzy9GFMDLsXn1iHUm18nhKnNMWscjmp4+hpafcZjrr2WbT//d20xaGljXDBYHqRcl8HnxbX6uaA/eGVw==", + "cpu": [ + "mips64el" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ppc64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.25.12.tgz", + "integrity": "sha512-9meM/lRXxMi5PSUqEXRCtVjEZBGwB7P/D4yT8UG/mwIdze2aV4Vo6U5gD3+RsoHXKkHCfSxZKzmDssVlRj1QQA==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-riscv64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.25.12.tgz", + "integrity": "sha512-Zr7KR4hgKUpWAwb1f3o5ygT04MzqVrGEGXGLnj15YQDJErYu/BGg+wmFlIDOdJp0PmB0lLvxFIOXZgFRrdjR0w==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-s390x": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.25.12.tgz", + "integrity": "sha512-MsKncOcgTNvdtiISc/jZs/Zf8d0cl/t3gYWX8J9ubBnVOwlk65UIEEvgBORTiljloIWnBzLs4qhzPkJcitIzIg==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.25.12.tgz", + "integrity": "sha512-uqZMTLr/zR/ed4jIGnwSLkaHmPjOjJvnm6TVVitAa08SLS9Z0VM8wIRx7gWbJB5/J54YuIMInDquWyYvQLZkgw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.25.12.tgz", + "integrity": "sha512-xXwcTq4GhRM7J9A8Gv5boanHhRa/Q9KLVmcyXHCTaM4wKfIpWkdXiMog/KsnxzJ0A1+nD+zoecuzqPmCRyBGjg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.25.12.tgz", + "integrity": "sha512-Ld5pTlzPy3YwGec4OuHh1aCVCRvOXdH8DgRjfDy/oumVovmuSzWfnSJg+VtakB9Cm0gxNO9BzWkj6mtO1FMXkQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.25.12.tgz", + "integrity": "sha512-fF96T6KsBo/pkQI950FARU9apGNTSlZGsv1jZBAlcLL1MLjLNIWPBkj5NlSz8aAzYKg+eNqknrUJ24QBybeR5A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.25.12.tgz", + "integrity": "sha512-MZyXUkZHjQxUvzK7rN8DJ3SRmrVrke8ZyRusHlP+kuwqTcfWLyqMOE3sScPPyeIXN/mDJIfGXvcMqCgYKekoQw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openharmony-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.25.12.tgz", + "integrity": "sha512-rm0YWsqUSRrjncSXGA7Zv78Nbnw4XL6/dzr20cyrQf7ZmRcsovpcRBdhD43Nuk3y7XIoW2OxMVvwuRvk9XdASg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/sunos-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.25.12.tgz", + "integrity": "sha512-3wGSCDyuTHQUzt0nV7bocDy72r2lI33QL3gkDNGkod22EsYl04sMf0qLb8luNKTOmgF/eDEDP5BFNwoBKH441w==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.25.12.tgz", + "integrity": "sha512-rMmLrur64A7+DKlnSuwqUdRKyd3UE7oPJZmnljqEptesKM8wx9J8gx5u0+9Pq0fQQW8vqeKebwNXdfOyP+8Bsg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-ia32": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.25.12.tgz", + "integrity": "sha512-HkqnmmBoCbCwxUKKNPBixiWDGCpQGVsrQfJoVGYLPT41XWF8lHuE5N6WhVia2n4o5QK5M4tYr21827fNhi4byQ==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.25.12.tgz", + "integrity": "sha512-alJC0uCZpTFrSL0CCDjcgleBXPnCrEAhTBILpeAp7M/OFgoqtAetfBzX0xM00MUsVVPpVjlPuMbREqnZCXaTnA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@jridgewell/sourcemap-codec": { + "version": "1.5.5", + "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz", + "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==", + "license": "MIT" + }, + "node_modules/@napi-rs/lzma-linux-x64-gnu": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/@napi-rs/lzma-linux-x64-gnu/-/lzma-linux-x64-gnu-1.5.1.tgz", + "integrity": "sha512-oTXEIha4SsuXdTA4Iyskj0kpdx2yVXdhd75c2v3xGrHFfVMsbhTPZU/nMPL4sWKo4pBHm3aucLaqGlF696dTyQ==", + "cpu": [ + "x64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^22.20 || ^24.12 || >=25" + } + }, + "node_modules/@rollup/rollup-android-arm-eabi": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.63.0.tgz", + "integrity": "sha512-70TeIFezKKy65LgAVyQh+w94/gjWhvPWaLaGGeMEgVrPkQhuj/M5bAYYZzIFUj9Y69oHyTm5Um/R6gcLh4A8JA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-android-arm64": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.63.0.tgz", + "integrity": "sha512-YC86tYIHK6M1IV+wbzO+Bxk8RCBr6ZyWYgWxUCzaZD8mc8rrFoIJDNzDrkHBYRc/wKdrsIXmm6/F7NzrAO+OrA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-darwin-arm64": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.63.0.tgz", + "integrity": "sha512-oI+ECtUcli0y0fi4xpW82GdPIXdTkI8G8DSjG2LRuw09fPAGykaWYH/hXxiKuTxiAjiPSTIIuYUqof5Z2hShWw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-darwin-x64": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.63.0.tgz", + "integrity": "sha512-NwV+1s7TiKrMe4owHyKB/dTLD7ZJD0YEBEhIz+hvav1Cu1GReJjF+rsdNwjzENQeIAbE/CoNiaAc5Vz2h5DPAA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-freebsd-arm64": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.63.0.tgz", + "integrity": "sha512-tWtHBTu5gOPK4u4Urtk4qAHW3zZ9rQAmbssO8gp7ELvGTGI3aCiq6NqyTQ0PCIg7KbHJF2UkGDDs77YZGxfjCA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-freebsd-x64": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.63.0.tgz", + "integrity": "sha512-2qPoJiwTvtHQ27NnYvTnsgk8laXWYuVmNESG8WFZBcEPKLfZ3I27qBJarjVRQtwGeYyRfq5ZowHXih9lm2BItw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-linux-arm-gnueabihf": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.63.0.tgz", + "integrity": "sha512-FQwsTRvLNuHoTdICABJQfbPUSEueISGmnpT06tXTMpfprf5NiKLSXKA0A+w45wJnCmZAnzgqBwbt6ARFuyOi5w==", + "cpu": [ + "arm" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm-musleabihf": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.63.0.tgz", + "integrity": "sha512-BBVTXziw8mY1a4ZbWME9tZyfzqXCDPqaC7Z3heQ29p5dkvXzwL0NwelO8zLa8c3RBKvl3YTuSnBgsBhYBtwjIw==", + "cpu": [ + "arm" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-gnu": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.63.0.tgz", + "integrity": "sha512-w2Iyy9+RqKwx3d9qWMKsJg0FfRBsY0/pXNv0mCQ3ueRvJI6+QAScfD4nrMlzFLs2HNVW6Ew+mtZfDl9b7Ew5/Q==", + "cpu": [ + "arm64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-musl": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.63.0.tgz", + "integrity": "sha512-YK++KtrFRHYE0P6/RtYEAy9t8F37znP+K03RrIuLPYOL6SVlObRumf/0OE4V/h63xL9DwkWbNssZfmA9hawuDA==", + "cpu": [ + "arm64" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-gnu": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.63.0.tgz", + "integrity": "sha512-aBfOG6fP7YkkPmTqPwufRJeFyz7WPpECv9XNbnsk9+vg7rxdih0lbtEel7jcRng4LZrrmU3FfitCFyEj4BWDWg==", + "cpu": [ + "loong64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-musl": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.63.0.tgz", + "integrity": "sha512-LGaHEOeHNAag9VuS1Crs5DFg4RrU9MPi2nVnNJk9DTePx/B6RRYKVmrIXt2h7YOJlwjaFJ6lwtFDliZxScTLrQ==", + "cpu": [ + "loong64" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-gnu": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.63.0.tgz", + "integrity": "sha512-jClvk+J0FC3b7Udvegiw5/4hErbHtmsNsQgENnKXDWtNCJXsJYZH5WURvu7imDOO38xYml24eeh5x3A04ppwCw==", + "cpu": [ + "ppc64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-musl": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.63.0.tgz", + "integrity": "sha512-0OJlaGK+8+B777Ql5okIpD7ua5Ro9+VB9Ve0OKa28OQJZ1RbuUBVNHK/e3pr4BROqsyPl1JrPO1ZxJseCNffcA==", + "cpu": [ + "ppc64" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-gnu": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.63.0.tgz", + "integrity": "sha512-Ygsx+HoNH7afwi1bTIXbnTvVnsO+zurPLSYxybV1hHFVU72OWOCl6v05ql/z0hkpAPx+DK7Kn9Bi7MayCcjLTA==", + "cpu": [ + "riscv64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-musl": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.63.0.tgz", + "integrity": "sha512-pDQxtMGb+OvG3fLwR2OkZlSd47hW+kWg4BYMG/++sR6RqorQccwPTDsxda5hPwiIeIErAnCF9ma3SAU06bdQtQ==", + "cpu": [ + "riscv64" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-s390x-gnu": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.63.0.tgz", + "integrity": "sha512-0BnUG9mS8I4SSHr3XsxVhuCMEiu+rX61xxZF5vujso4LaiAGFZFxvDjg6Xn6tLPNTUAfuCvQYas4LMQMVsKRSQ==", + "cpu": [ + "s390x" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-gnu": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.63.0.tgz", + "integrity": "sha512-Adu/VttB1dpPNW+FEacrZ+xVm9tFty84+RrFzsqlFaPxoJB+9XXyDGtp5dCOoBwGBIEVH0To7lExFXEx0BIF4A==", + "cpu": [ + "x64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-musl": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.63.0.tgz", + "integrity": "sha512-NQ3bDvjUbFKmP23671xUlXtKmqVsUBd6M4PQCvbmNtOy06hnQIdKHy8oG/6S3R/S6He1JgPk6A5VT+prAJMYEw==", + "cpu": [ + "x64" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-openbsd-x64": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.63.0.tgz", + "integrity": "sha512-u2eDAl4+0aFvA13GxlGBtTI3SS3sdgwgtV0HyjZ0QaQVCgNE+jqNGey+GtxWiq+wxr/UycAx/OnfJzApCFamvA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ] + }, + "node_modules/@rollup/rollup-openharmony-arm64": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.63.0.tgz", + "integrity": "sha512-XvRb5vfW3wAZQ+ZUG21AnHHDKtNcw99eigzEhjr//NZ3u7SoBaPP0seSc7FgP7p1epAEdAoZckMW9WY/+4w70w==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ] + }, + "node_modules/@rollup/rollup-win32-arm64-msvc": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.63.0.tgz", + "integrity": "sha512-iZPmniy4kNBf5yo2RezbkYNNK5HPbXE9+g+twnbqSng7dtLEJy1SKoxiE/ni4FDacjyuZpEeb9U054N4EoKHYw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-ia32-msvc": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.63.0.tgz", + "integrity": "sha512-mFBBd+LF37fnE8JnYUOH+imj0aPFPK30vpar4ehJkgnLj9sZn8ZxiRENmLtgIwxK7TC8klF6N57fxdNBwQoqOA==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-gnu": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.63.0.tgz", + "integrity": "sha512-ujeqEY3B+zbGn3Z4Q03cUBG/LGWnBJncVT36WER31LcOsQk9+1dmINKKtvmmfChUvRbK1G0R8OhMWFgHgaZtAw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-msvc": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.63.0.tgz", + "integrity": "sha512-hncn90N4sOky0L2LKE5oESKLbxCPeVo4eLA2LSMoDzM+879ml4WSr+Rr4DWknNIVVvS1Hirkc9hx02W6YxS8rQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@types/estree": { + "version": "1.0.9", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz", + "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@vitejs/plugin-vue": { + "version": "5.2.4", + "resolved": "https://registry.npmjs.org/@vitejs/plugin-vue/-/plugin-vue-5.2.4.tgz", + "integrity": "sha512-7Yx/SXSOcQq5HiiV3orevHUFn+pmMB4cgbEkDYgnkUWb0WfeQ/wa2yFv6D5ICiCQOVpjA7vYDXrC7AGO8yjDHA==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^18.0.0 || >=20.0.0" + }, + "peerDependencies": { + "vite": "^5.0.0 || ^6.0.0", + "vue": "^3.2.25" + } + }, + "node_modules/@vue/compiler-core": { + "version": "3.5.41", + "resolved": "https://registry.npmjs.org/@vue/compiler-core/-/compiler-core-3.5.41.tgz", + "integrity": "sha512-q0Xtv/F9w2YO/7htQhtiL+Ev2WCJbe5N2hc+XfgyKkEKqWpSxknmT8QOuGdEKNdjPq0c3F7rNpFkTo3Kfrm7pg==", + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.29.8", + "@vue/shared": "3.5.41", + "entities": "^7.0.1", + "estree-walker": "^2.0.2", + "source-map-js": "^1.2.1" + } + }, + "node_modules/@vue/compiler-dom": { + "version": "3.5.41", + "resolved": "https://registry.npmjs.org/@vue/compiler-dom/-/compiler-dom-3.5.41.tgz", + "integrity": "sha512-oKacVfNglLvGjnS6BXOlGL7EyG2h8X03pqXCjzotRZUaXGjbrTJUnVAQjrCqUnS+lyu31nwQjZY/d817GmCnfw==", + "license": "MIT", + "dependencies": { + "@vue/compiler-core": "3.5.41", + "@vue/shared": "3.5.41" + } + }, + "node_modules/@vue/compiler-sfc": { + "version": "3.5.41", + "resolved": "https://registry.npmjs.org/@vue/compiler-sfc/-/compiler-sfc-3.5.41.tgz", + "integrity": "sha512-XJhip7R2wy6vX3knCxdZN4KracFaZUef58s1KYewqluedHIJaPIVfXoYT7MF1F8nCvv6k8bWWxDC8opMkg1VTQ==", + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.29.8", + "@vue/compiler-core": "3.5.41", + "@vue/compiler-dom": "3.5.41", + "@vue/compiler-ssr": "3.5.41", + "@vue/shared": "3.5.41", + "estree-walker": "^2.0.2", + "magic-string": "^0.30.21", + "postcss": "^8.5.19", + "source-map-js": "^1.2.1" + } + }, + "node_modules/@vue/compiler-ssr": { + "version": "3.5.41", + "resolved": "https://registry.npmjs.org/@vue/compiler-ssr/-/compiler-ssr-3.5.41.tgz", + "integrity": "sha512-U3v5OejKEGqOI0Wy0+Sz7hGuIFZHA4LSXzrNM3IMIeDyJEBBfTpX26n3SDgToRpP2bLc9FfI2j/kSgcJ8Emq5A==", + "license": "MIT", + "dependencies": { + "@vue/compiler-dom": "3.5.41", + "@vue/shared": "3.5.41" + } + }, + "node_modules/@vue/reactivity": { + "version": "3.5.41", + "resolved": "https://registry.npmjs.org/@vue/reactivity/-/reactivity-3.5.41.tgz", + "integrity": "sha512-rznsqKM0np0x18EjzF8x88MpEhdNsffbvFbckLL5+oUKz1BxAImEmO7J1ArRYSyo6aQaVoBDp7jEkT91OOxydA==", + "license": "MIT", + "dependencies": { + "@vue/shared": "3.5.41" + } + }, + "node_modules/@vue/runtime-core": { + "version": "3.5.41", + "resolved": "https://registry.npmjs.org/@vue/runtime-core/-/runtime-core-3.5.41.tgz", + "integrity": "sha512-Vcry58hiAKwGen9Z1jUZE0feFsNArPCMOImYI8el48A9Idf6DuQYD0U05zZIF2Iad1hGhPSvcbBbAOhNr55fhg==", + "license": "MIT", + "dependencies": { + "@vue/reactivity": "3.5.41", + "@vue/shared": "3.5.41" + } + }, + "node_modules/@vue/runtime-dom": { + "version": "3.5.41", + "resolved": "https://registry.npmjs.org/@vue/runtime-dom/-/runtime-dom-3.5.41.tgz", + "integrity": "sha512-3vVBahVBS9+U6cmXBLyb8nE6/yYo4J/CGI9eVFs3KiMc0YHuudwKyShTD65jtJy/L9PUUxNAFu4cj4LiJ0UFbw==", + "license": "MIT", + "dependencies": { + "@vue/reactivity": "3.5.41", + "@vue/runtime-core": "3.5.41", + "@vue/shared": "3.5.41", + "csstype": "^3.2.3" + } + }, + "node_modules/@vue/server-renderer": { + "version": "3.5.41", + "resolved": "https://registry.npmjs.org/@vue/server-renderer/-/server-renderer-3.5.41.tgz", + "integrity": "sha512-n6hx/pNFfbD6SuyeuMVkvqox8bwf/ET9JlA/kAz/imw8sw++wkqKe2mHX5KutjPpbKE4Z56yTHszoOjGMI9igQ==", + "license": "MIT", + "dependencies": { + "@vue/compiler-ssr": "3.5.41", + "@vue/runtime-dom": "3.5.41", + "@vue/shared": "3.5.41" + } + }, + "node_modules/@vue/shared": { + "version": "3.5.41", + "resolved": "https://registry.npmjs.org/@vue/shared/-/shared-3.5.41.tgz", + "integrity": "sha512-IOnwSCma8j+9xJT6b8H0dEYidC80NsYmNMlZxRsukYcSoGaDBohog5hDxzeUXdFeGWFA++vWvxqOmrr96VlqMA==", + "license": "MIT" + }, + "node_modules/csstype": { + "version": "3.2.3", + "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz", + "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==", + "license": "MIT" + }, + "node_modules/entities": { + "version": "7.0.1", + "resolved": "https://registry.npmjs.org/entities/-/entities-7.0.1.tgz", + "integrity": "sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.12" + }, + "funding": { + "url": "https://github.com/fb55/entities?sponsor=1" + } + }, + "node_modules/esbuild": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.12.tgz", + "integrity": "sha512-bbPBYYrtZbkt6Os6FiTLCTFxvq4tt3JKall1vRwshA3fdVztsLAatFaZobhkBC8/BrPetoa0oksYoKXoG4ryJg==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=18" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.25.12", + "@esbuild/android-arm": "0.25.12", + "@esbuild/android-arm64": "0.25.12", + "@esbuild/android-x64": "0.25.12", + "@esbuild/darwin-arm64": "0.25.12", + "@esbuild/darwin-x64": "0.25.12", + "@esbuild/freebsd-arm64": "0.25.12", + "@esbuild/freebsd-x64": "0.25.12", + "@esbuild/linux-arm": "0.25.12", + "@esbuild/linux-arm64": "0.25.12", + "@esbuild/linux-ia32": "0.25.12", + "@esbuild/linux-loong64": "0.25.12", + "@esbuild/linux-mips64el": "0.25.12", + "@esbuild/linux-ppc64": "0.25.12", + "@esbuild/linux-riscv64": "0.25.12", + "@esbuild/linux-s390x": "0.25.12", + "@esbuild/linux-x64": "0.25.12", + "@esbuild/netbsd-arm64": "0.25.12", + "@esbuild/netbsd-x64": "0.25.12", + "@esbuild/openbsd-arm64": "0.25.12", + "@esbuild/openbsd-x64": "0.25.12", + "@esbuild/openharmony-arm64": "0.25.12", + "@esbuild/sunos-x64": "0.25.12", + "@esbuild/win32-arm64": "0.25.12", + "@esbuild/win32-ia32": "0.25.12", + "@esbuild/win32-x64": "0.25.12" + } + }, + "node_modules/estree-walker": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-2.0.2.tgz", + "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==", + "license": "MIT" + }, + "node_modules/fdir": { + "version": "6.5.0", + "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz", + "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "picomatch": "^3 || ^4" + }, + "peerDependenciesMeta": { + "picomatch": { + "optional": true + } + } + }, + "node_modules/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", + "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/magic-string": { + "version": "0.30.21", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz", + "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==", + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.5" + } + }, + "node_modules/nanoid": { + "version": "3.3.18", + "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.18.tgz", + "integrity": "sha512-DTg4MJbGMWkfi6VZFdNt2/caMbQy4Ou+Op/hJQvGEWcnVfoA1QA+xzRKAzw9jD6+GVOOeYr/mIcuDSdug6F6+w==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "bin": { + "nanoid": "bin/nanoid.cjs" + }, + "engines": { + "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1" + } + }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "license": "ISC" + }, + "node_modules/picomatch": { + "version": "4.0.7", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.7.tgz", + "integrity": "sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/postcss": { + "version": "8.5.26", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.26.tgz", + "integrity": "sha512-u82N74LFzG8ca+dD8puPnplTXoGH4fTPpVGuIbt36G3qvNlkvfD0lEAZSxaly3KX8TS/L1A1gsCEmvKmBcVbkQ==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/postcss" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "nanoid": "^3.3.17", + "picocolors": "^1.1.1", + "source-map-js": "^1.2.1" + }, + "engines": { + "node": "^10 || ^12 || >=14" + } + }, + "node_modules/rollup": { + "version": "4.63.0", + "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.63.0.tgz", + "integrity": "sha512-T5vnZ2y4QqC3/4P+w2+JO+Q/OVdnPsv4XcSYJYMEn0R9/jjl5AgLwO9LAZMzP2lN71O6pypn91rB7lDstUkfrQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/estree": "1.0.9" + }, + "bin": { + "rollup": "dist/bin/rollup" + }, + "engines": { + "node": ">=18.0.0", + "npm": ">=8.0.0" + }, + "optionalDependencies": { + "@napi-rs/lzma-linux-x64-gnu": "1.5.1", + "@rollup/rollup-android-arm-eabi": "4.63.0", + "@rollup/rollup-android-arm64": "4.63.0", + "@rollup/rollup-darwin-arm64": "4.63.0", + "@rollup/rollup-darwin-x64": "4.63.0", + "@rollup/rollup-freebsd-arm64": "4.63.0", + "@rollup/rollup-freebsd-x64": "4.63.0", + "@rollup/rollup-linux-arm-gnueabihf": "4.63.0", + "@rollup/rollup-linux-arm-musleabihf": "4.63.0", + "@rollup/rollup-linux-arm64-gnu": "4.63.0", + "@rollup/rollup-linux-arm64-musl": "4.63.0", + "@rollup/rollup-linux-loong64-gnu": "4.63.0", + "@rollup/rollup-linux-loong64-musl": "4.63.0", + "@rollup/rollup-linux-ppc64-gnu": "4.63.0", + "@rollup/rollup-linux-ppc64-musl": "4.63.0", + "@rollup/rollup-linux-riscv64-gnu": "4.63.0", + "@rollup/rollup-linux-riscv64-musl": "4.63.0", + "@rollup/rollup-linux-s390x-gnu": "4.63.0", + "@rollup/rollup-linux-x64-gnu": "4.63.0", + "@rollup/rollup-linux-x64-musl": "4.63.0", + "@rollup/rollup-openbsd-x64": "4.63.0", + "@rollup/rollup-openharmony-arm64": "4.63.0", + "@rollup/rollup-win32-arm64-msvc": "4.63.0", + "@rollup/rollup-win32-ia32-msvc": "4.63.0", + "@rollup/rollup-win32-x64-gnu": "4.63.0", + "@rollup/rollup-win32-x64-msvc": "4.63.0", + "fsevents": "~2.3.2" + } + }, + "node_modules/source-map-js": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz", + "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==", + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/tinyglobby": { + "version": "0.2.17", + "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz", + "integrity": "sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==", + "dev": true, + "license": "MIT", + "dependencies": { + "fdir": "^6.5.0", + "picomatch": "^4.0.4" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/SuperchupuDev" + } + }, + "node_modules/vite": { + "version": "6.4.3", + "resolved": "https://registry.npmjs.org/vite/-/vite-6.4.3.tgz", + "integrity": "sha512-NTKlcQjlAK7MlQoyb6LgaqHc8sso/pVyUJYWMws3jg21uTJw/LddqIFPcPqP6PzpgbIcZyKI85sFE4HBrQDA8A==", + "dev": true, + "license": "MIT", + "dependencies": { + "esbuild": "^0.25.0", + "fdir": "^6.4.4", + "picomatch": "^4.0.2", + "postcss": "^8.5.3", + "rollup": "^4.34.9", + "tinyglobby": "^0.2.13" + }, + "bin": { + "vite": "bin/vite.js" + }, + "engines": { + "node": "^18.0.0 || ^20.0.0 || >=22.0.0" + }, + "funding": { + "url": "https://github.com/vitejs/vite?sponsor=1" + }, + "optionalDependencies": { + "fsevents": "~2.3.3" + }, + "peerDependencies": { + "@types/node": "^18.0.0 || ^20.0.0 || >=22.0.0", + "jiti": ">=1.21.0", + "less": "*", + "lightningcss": "^1.21.0", + "sass": "*", + "sass-embedded": "*", + "stylus": "*", + "sugarss": "*", + "terser": "^5.16.0", + "tsx": "^4.8.1", + "yaml": "^2.4.2" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + }, + "jiti": { + "optional": true + }, + "less": { + "optional": true + }, + "lightningcss": { + "optional": true + }, + "sass": { + "optional": true + }, + "sass-embedded": { + "optional": true + }, + "stylus": { + "optional": true + }, + "sugarss": { + "optional": true + }, + "terser": { + "optional": true + }, + "tsx": { + "optional": true + }, + "yaml": { + "optional": true + } + } + }, + "node_modules/vue": { + "version": "3.5.41", + "resolved": "https://registry.npmjs.org/vue/-/vue-3.5.41.tgz", + "integrity": "sha512-2laE0p+aK+/AOPG/XL/WepOs/GlK755LJ1XECi9kDUrz1FKNw8rb2Xzlw9JS1rqEV55nb0ttsKxVlTCcd+R5cg==", + "license": "MIT", + "dependencies": { + "@vue/compiler-dom": "3.5.41", + "@vue/compiler-sfc": "3.5.41", + "@vue/runtime-dom": "3.5.41", + "@vue/server-renderer": "3.5.41", + "@vue/shared": "3.5.41" + }, + "peerDependencies": { + "typescript": "*" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + } + } +} diff --git a/frontend/package.json b/frontend/package.json new file mode 100644 index 0000000..c5e8048 --- /dev/null +++ b/frontend/package.json @@ -0,0 +1,18 @@ +{ + "name": "scert-frontend", + "private": true, + "version": "0.1.0", + "type": "module", + "scripts": { + "dev": "vite", + "build": "vite build", + "preview": "vite preview" + }, + "dependencies": { + "vue": "^3.5.0" + }, + "devDependencies": { + "@vitejs/plugin-vue": "^5.2.0", + "vite": "^6.0.0" + } +} diff --git a/frontend/src/App.vue b/frontend/src/App.vue new file mode 100644 index 0000000..87a7c4e --- /dev/null +++ b/frontend/src/App.vue @@ -0,0 +1,79 @@ + + + diff --git a/frontend/src/main.js b/frontend/src/main.js new file mode 100644 index 0000000..fe5bae3 --- /dev/null +++ b/frontend/src/main.js @@ -0,0 +1,5 @@ +import { createApp } from 'vue' +import App from './App.vue' +import './style.css' + +createApp(App).mount('#app') diff --git a/frontend/src/style.css b/frontend/src/style.css new file mode 100644 index 0000000..b180292 --- /dev/null +++ b/frontend/src/style.css @@ -0,0 +1,34 @@ +:root { font-family: Inter, "Microsoft YaHei", sans-serif; color: #172033; background: #f4f7fb; font-synthesis: none; } +* { box-sizing: border-box; } +body { margin: 0; min-width: 320px; } +button { font: inherit; cursor: pointer; } +.page-shell { max-width: 1180px; margin: 0 auto; padding: 42px 28px 70px; } +.topbar, .panel-heading { display: flex; align-items: center; justify-content: space-between; gap: 20px; } +.eyebrow { margin: 0 0 9px; color: #687792; font-size: 11px; font-weight: 800; letter-spacing: .15em; } +h1, h2, p { margin-top: 0; } +h1 { margin-bottom: 0; font-size: clamp(30px, 5vw, 52px); letter-spacing: -.05em; } +h2 { margin-bottom: 10px; font-size: clamp(24px, 4vw, 38px); letter-spacing: -.04em; } +.secondary-button { border: 1px solid #d5ddea; border-radius: 12px; background: #fff; color: #32405a; padding: 11px 16px; font-weight: 700; } +.hero-card { display: flex; align-items: center; justify-content: space-between; min-height: 250px; margin: 36px 0 18px; padding: 36px 42px; border-radius: 28px; color: #fff; background: linear-gradient(120deg, #182b5b, #315aaa); box-shadow: 0 20px 45px rgba(42, 75, 145, .2); } +.hero-card p { max-width: 650px; margin-bottom: 0; color: #d5e1ff; line-height: 1.8; } +.status-label { font-size: 13px; font-weight: 800; } +.status-dot { display: inline-block; width: 9px; height: 9px; margin-right: 8px; border-radius: 50%; background: #ffba58; } +.status-dot.online { background: #5ee0a0; box-shadow: 0 0 0 5px rgba(94, 224, 160, .15); } +.hero-mark { display: grid; place-items: center; width: 112px; height: 112px; border: 1px solid rgba(255,255,255,.35); border-radius: 32px; color: #cfe0ff; font-size: 62px; font-weight: 900; } +.error-banner { margin: 18px 0; padding: 14px 18px; border: 1px solid #f0c4c4; border-radius: 12px; color: #9c3b3b; background: #fff2f2; } +.metrics-grid { display: grid; grid-template-columns: repeat(4, 1fr); gap: 14px; margin-bottom: 18px; } +.metric-card, .panel { border: 1px solid #e2e8f2; border-radius: 20px; background: rgba(255,255,255,.86); box-shadow: 0 10px 30px rgba(31, 50, 87, .04); } +.metric-card { padding: 22px; } +.metric-card span, .domain-row span, .muted { color: #7a879d; font-size: 13px; } +.metric-card strong { display: block; margin-top: 13px; font-size: 28px; } +.panel { padding: 28px; } +.panel-heading { margin-bottom: 22px; } +.panel-heading h2 { margin-bottom: 0; font-size: 26px; } +.empty-state { padding: 36px 10px; color: #7a879d; text-align: center; } +code { padding: 2px 6px; border-radius: 6px; background: #eef2f8; font-family: Consolas, monospace; } +.domain-list { display: grid; gap: 10px; } +.domain-row { display: flex; align-items: center; justify-content: space-between; padding: 15px 16px; border: 1px solid #edf0f5; border-radius: 13px; } +.domain-row strong, .domain-row span { display: block; } +.domain-row strong { margin-bottom: 5px; } +.tag { padding: 5px 10px; border-radius: 99px; background: #fff3d8; color: #9b6a1a !important; font-size: 12px !important; } +@media (max-width: 760px) { .page-shell { padding: 26px 16px 48px; } .hero-card { align-items: flex-start; padding: 28px; } .hero-mark { display: none; } .metrics-grid { grid-template-columns: repeat(2, 1fr); } .panel { padding: 20px; } } diff --git a/frontend/vite.config.js b/frontend/vite.config.js new file mode 100644 index 0000000..01688af --- /dev/null +++ b/frontend/vite.config.js @@ -0,0 +1,13 @@ +import { defineConfig } from 'vite' +import vue from '@vitejs/plugin-vue' + +export default defineConfig({ + plugins: [vue()], + server: { + port: 5173, + proxy: { + '/api': 'http://127.0.0.1:8080', + '/healthz': 'http://127.0.0.1:8080', + }, + }, +})