This commit is contained in:
1 parent
b7d4805402
commit
c33b8bbc2f
6 files changed
+232
-14
No files matched your search
+48
-9
@@ -13,14 +13,21 @@
|
||||
|
||||
- `[✓]` 修改前的文档基线已提交并推送。
|
||||
- `[✓]` 源码指纹和产物 SHA-256 校验已加入构建、部署入口。
|
||||
- `[x]` 开发启动入口固定使用 `yunx-test`,移除跳过编译选项,等待迁移后运行复审。
|
||||
- `[x]` Vite 仅在服务端从 `yunx-test/config` 读取域名、证书引用,等待真实页面复审。
|
||||
- `[~]` 完整构建、最新产物部署和回归验证。
|
||||
- `[ ]` 配置事务与历史备份改存状态数据库。
|
||||
- `[ ]` 密钥、TLS、DKIM、ACME 和审计日志迁到最终目录。
|
||||
- `[ ]` 内置插件合并进发布产物并保持隔离机制。
|
||||
- `[ ]` 停服备份、无损迁移到 `yunx-test`。
|
||||
- `[ ]` 新目录开发、生产模拟运行和浏览器验收。
|
||||
- `[✓]` 开发启动入口固定使用 `yunx-test`,没有沿用旧后端;日志与进程路径已核对。
|
||||
- `[✓]` Vite 从原 `frontend` 源码启动,使用模拟部署目录的域名和证书;浏览器已确认加载开发客户端。
|
||||
- `[✓]` 停服备份、无损迁移到 `yunx-test`,原配置、证书、账号库和备份全部保留。
|
||||
- `[✓]` 配置事务与历史备份迁入 `data/smail-state.db`,五个 JSON 仍是生效配置文件。
|
||||
- `[✓]` 密钥、TLS、DKIM、ACME 和审计日志迁到最终目录,目录检查通过。
|
||||
- `[✓]` 三个内置插件已编译并嵌入主程序;运行解包目录位于操作系统临时目录,不混入部署根目录。
|
||||
- `[✓]` 迁移后的完整构建、产物哈希校验、前端 131 项测试及全量 Go 测试通过。
|
||||
- `[✓]` Windows 标准构建与后端测试入口共用工作区互斥量,4 项部署回归通过。
|
||||
- `[✓]` 新目录开发运行、登录后刷新保持会话、配置读取和配置审计 CSV Blob 验收通过。
|
||||
- `[✓]` HTTPS Cookie 属性及 CSRF 缺失、错误、正确令牌分支已实际验证。
|
||||
- `[~]` 构建互斥修复后的完整部署及重启复查。
|
||||
- `[!]` Windows 生产模拟启动受管理员恢复 Named Pipe 权限限制,未降级或绕过保护。
|
||||
- `[!]` Windows 生产插件隔离尚不可用,不能把插件打包成功视为真实插件运行验收。
|
||||
- `[ ]` 配置保存后文件与历史状态数据库的浏览器写入验收。
|
||||
- `[ ]` 全新初始化、忘记密码、二次验证、强制改密与普通用户权限的独立完整流程验收。
|
||||
|
||||
## 已实现入口
|
||||
|
||||
@@ -40,6 +47,38 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File deploy/start-dev.ps1 -Se
|
||||
|
||||
构建收据保存在 `out/build-state.json`,不混入部署根目录。已有程序被覆盖前备份至 `out/deployment-history/`。历史前端编译目录归档至 `out/build-history/`,不删除生成物,也不将历次散列资源重复嵌入新程序。
|
||||
|
||||
## 构建与测试互斥
|
||||
|
||||
Windows 下,`deploy/build.ps1` 与 `node test/run.mjs backend` 共用工作区命名互斥量。构建计算指纹、归档嵌入资源之前就获取锁,测试从调用 Go 到退出始终持锁。遇到冲突立即拒绝执行并给出中文提示,不能继续移动资源或使用历史产物冒充成功。
|
||||
|
||||
锁标识由源码目录生成:同一登录会话内,不同工作区可并行;同工作区必须串行。正常退出和进程异常结束均不需要删除锁文件。不同 Windows 登录会话、直接调用 `go test`、直接调用 Vite 或单独插件构建不在该锁的保证范围内,不能与完整构建并发执行。
|
||||
|
||||
```powershell
|
||||
# 前端、部署回归和后端依次执行,记录统一进入 test-log。
|
||||
node test/run.mjs all -p 2 ./...
|
||||
|
||||
# 只检查构建互斥及后端参数转发。
|
||||
node test/run.mjs deployment
|
||||
```
|
||||
|
||||
新增的 PowerShell 文件使用 UTF-8 BOM,以便 Windows PowerShell 5.1 正确解析中文提示;JavaScript、Go 和 JSON 不因此添加 BOM。
|
||||
|
||||
前端热更新只更新源码开发页面,不会自动重编嵌入前端的主程序。源码修改完成后,仍须通过标准完整部署/重启入口刷新 `yunx-test`,不能只刷新浏览器就宣称运行包已更新。
|
||||
|
||||
## 2026-09-08 实测记录
|
||||
|
||||
- 迁移备份与核对收据:`test-log/deployment-migration-20260908-183213/receipt.json`。
|
||||
- 互斥修复后的完整自动化测试:`test-log/run-2026-09-08T10-57-18-160Z-42364/`,前端 131 项、部署 4 项、Go 全量测试均通过。
|
||||
- 浏览器页面为 `https://xuans.com/#/`,前端 80 跳转 HTTPS 443,后端开发接口监听 5201。
|
||||
- 浏览器真实登录后强制忽略缓存刷新,收件箱与用户信息接口仍正常。配置状态、基础、邮件、证书、历史备份及插件列表读取成功。
|
||||
- 配置审计导出返回 `text/csv` Blob;仅确认响应,不代表下载文件落盘验收。
|
||||
- 缺失或错误 CSRF 请求头均返回业务错误码 `100`,提示“请求来源校验失败”;当前接口使用 HTTP 200 包装业务错误,不能只看 HTTP 状态判断成功。
|
||||
- 正确 CSRF 请求返回 CSV;HTTPS 登录响应中会话 Cookie 为 `Secure/HttpOnly/SameSite=Lax`,CSRF Cookie 为 `Secure/SameSite=Strict`。后者允许前端读取用于请求头,不应加 `HttpOnly`。
|
||||
- Cookie 响应验证使用独立临时登录会话,结束后已退出;未将密码、Cookie 值或令牌写入测试记录。
|
||||
- 生产模拟失败记录:`test-log/production-runtime-20260908.log`。开发运行明确停用管理员恢复通道,生产不能复用这一豁免。
|
||||
|
||||
## 验收边界
|
||||
|
||||
构建通过不代表目录迁移、登录持久化、插件、TLS 和管理员恢复通道均已验收。迁移完成前,不能使用旧布局的测试结果证明新布局正确。
|
||||
此次是保留现有业务数据的迁移验收,未清空数据库,不是生产首次初始化验收。旧根目录的 `config/`、`data/`、`ssl/` 是保留的迁移来源,不是当前服务的生效目录。
|
||||
|
||||
生产管理员恢复、Windows 插件隔离、其他完整账号流程仍有未通过或未验证项目。编辑器异步包仍有约 809 kB 的 Vite 体积告警;不能宣称全部功能或全部优化均已完成。
|
||||
Reference in new issue
Block a user