1 parent
99988bdebc
commit
e9981cff70
16 files changed
+649
-256
No files matched your search
+16
-6
@@ -854,9 +854,19 @@ go vet ./...
|
||||
|
||||
## 2026-08-30 配置快照发布失败重试整改记录
|
||||
|
||||
- **本轮状态**?`[x] 已完成?等待复审`
|
||||
- **实施内容**?统一配置启动加载?配置应用?配置回滚?数据库切换和插件 Secret 迁移的运行时快照发布入口?当磁盘事务已成功提交但运行时快照暂不可用时?保留可重试状态并将配置服务标记为降级?
|
||||
- **接口提示**?新增稳定错误码 `CONFIG_RUNTIME_SNAPSHOT_UNAVAILABLE`?返回 HTTP 503?并明确提示配置已保存?运行时尚未切换?可稍后重试应用?
|
||||
- **新增测试**?覆盖应用阶段快照发布失败后的磁盘代次?运行时旧快照?降级状态和再次应用成功?保留回滚票据失败重试及并发保护测试?
|
||||
- **验证结果**?服务端 `go test ./... -count=1 -timeout 30m` 和 `go vet ./...` 通过?未将真实 MySQL?PostgreSQL?Ubuntu?Windows?浏览器和生产部署验收标记为完成?
|
||||
- **遗留边界**?事务提交后快照发布失败的跨进程恢复仍依赖服务重载或后续重试?真实多数据库复制?校验?原子切换和部署联调继续按实机清单验收?
|
||||
- **本轮状态**:`[x] 已完成,等待复审`
|
||||
- **实施内容**:统一配置启动加载、配置应用、配置回滚、数据库切换和插件 Secret 迁移的运行时快照发布入口;当磁盘事务已成功提交但运行时快照暂不可用时,保留可重试状态并将配置服务标记为降级。
|
||||
- **接口提示**:新增稳定错误码 `CONFIG_RUNTIME_SNAPSHOT_UNAVAILABLE`,返回 HTTP 503,并明确提示配置已保存、运行时尚未切换,可稍后重试应用。
|
||||
- **新增测试**:覆盖应用阶段快照发布失败后的磁盘代次、运行时旧快照、降级状态和再次应用成功;保留回滚票据失败重试及并发保护测试。
|
||||
- **验证结果**:服务端 `go test ./... -count=1 -timeout 30m` 和 `go vet ./...` 通过;未将真实 MySQL、PostgreSQL、Ubuntu、Windows、浏览器和生产部署验收标记为完成。
|
||||
- **遗留边界**:事务提交后快照发布失败的跨进程恢复仍依赖服务重载或后续重试;真实多数据库复制、校验、原子切换和部署联调继续按实机清单验收。
|
||||
|
||||
## 2026-08-31 IMAP 删除语义增量复审
|
||||
|
||||
- **关联任务**:SEC-020,以及统一复审清单中的用户隔离、静态检查和回归测试项目。
|
||||
- **状态**:`[x] 已完成,等待真实客户端和部署环境复审`。
|
||||
- **实施内容**:为 `user_email` 增加持久化 `is_deleted` 标志和版本 14 数据库迁移;`SELECT`、UID/序列号 `FETCH` 和 `STORE` 统一返回或更新 `\Seen`、`\Deleted`;普通 `EXPUNGE` 仅清除当前邮箱中已标记删除的邮件,`UID EXPUNGE` 仅清除指定 UID 集合中已标记删除的邮件。
|
||||
- **边界加固**:所有查询和更新同时限制当前用户与当前邮箱;修复 UID FETCH 返回错误序列号的问题;按序列号降序发送 EXPUNGE 响应;支持 `*` 和 `n:*` 动态 UID 范围,限制单次最多展开 10000 个 UID,防止超大范围占用资源。
|
||||
- **修改范围**:`server/models/user_email.go`、`server/db/migration/imap_flags.go`、`server/services/list/list.go`、`server/services/del_email/del_email.go`、`server/listen/imap_server/session_*.go` 及相关测试。
|
||||
- **自动化验证**:`go test ./services/list ./listen/imap_server ./db/migration ./services/del_email -count=1 -timeout 10m` 已通过;本轮最终提交前继续执行服务端全量测试、竞态测试、`go vet`、前端 ESLint 和生产构建。
|
||||
- **开放项**:HSTS 与 Nginx 反向代理的实际上线行为、真实 IMAP 客户端兼容性、Ubuntu/Windows 部署和真实 MySQL/PostgreSQL 迁移仍需实机复审,不据此升级为最终发布通过。
|
||||
@@ -1395,3 +1395,34 @@ AD-065 + CG-053~CG-056 → AD-066 → CG-057
|
||||
- **本地验证**:服务端全量 `go test ./... -count=1` 通过;插件控制器和 HTTP 安全头专项测试通过。
|
||||
- **未完成真实验收**:超级管理员本机重置通道仍需在 Ubuntu 22.04、Windows 部署端和实际权限模型中复审;邮箱验证码、SMTP 投递、WebAuthn、真实浏览器和多实例流程不得标记为最终通过。
|
||||
- **复审日期**:2026-08-29(本机自动化复审)。
|
||||
|
||||
## 2026-08-31 全量代码状态复核
|
||||
|
||||
> 本节是 2026-08-31 对当前代码库的增量状态口径。原任务条目中的“未开始”保留为历史计划文本,不再代表当前实现状态;未完成真实平台或外部系统验收的任务不得标记为 `[✓]`。
|
||||
|
||||
| 任务范围 | 当前状态 | 复核结论 |
|
||||
|---|---|---|
|
||||
| AD-001~AD-008 | `[x] 已完成,等待复审` | 进程模型、权限矩阵、威胁模型、敏感字段、测试矩阵、独立管理程序、严格命令解析和部署管理员检查均已有实现与自动化测试。 |
|
||||
| AD-009~AD-011 | `[x] 已完成,等待实机复审` | systemd、Windows 服务/ACL、版本绑定和升级约束已有代码或部署文件;真实 Ubuntu 与 Windows 服务环境尚未验收。 |
|
||||
| AD-012~AD-021 | `[x] 已完成,等待实机复审` | 最小控制协议、UDS、Named Pipe、一次性 nonce、统一密码策略、事务重置、凭据撤销、审计及 Web 超级管理员恢复拒绝均已有实现和负向测试。 |
|
||||
| AD-022~AD-025 | `[x] 已完成,等待复审` | 外部邮箱模型、加密存储、独立指纹、归属校验、脱敏查询和绑定失效事务已实现。 |
|
||||
| AD-026~AD-031 | `[x] 已完成,等待复审` | 临时 HMAC 密钥、容量上限、验证码生成、用途绑定、恒定比较、原子消费、统一清理和重启失效已实现。 |
|
||||
| AD-032~AD-037 | `[x] 已完成,等待外部系统复审` | SMTP Relay 接入、验证码不落盘投递、失败分类、多维限流、运营数据和 14 天分批清理已实现并具备自动化测试。 |
|
||||
| AD-038 | `[!] 暂缓或存在阻塞` | 三数据库清理代码和方言已具备;真实 MySQL、PostgreSQL 的清理、空间复用和故障恢复尚未执行。 |
|
||||
| AD-039~AD-059 | `[x] 已完成,等待浏览器与 SMTP 复审` | 统一登录标识、受限会话、二次验证策略、防枚举恢复、分角色恢复、一次性授权、V1 API、前端页面、审计和告警边界均已有实现。 |
|
||||
| AD-060 | `[x] 已完成,等待复审` | 单元、并发和故障路径自动化测试已建立。 |
|
||||
| AD-061~AD-064 | `[!] 暂缓或存在阻塞` | 真实三数据库、Ubuntu、Windows、真实浏览器三角色流程需要对应环境和人工交互验收。 |
|
||||
| AD-065 | `[x] 已完成,等待独立安全复审` | 关键负向、重放、越权、枚举、降级和敏感数据测试已覆盖;生产观测链路仍需复核。 |
|
||||
| AD-066 | `[!] 暂缓或存在阻塞` | 最终发布评审依赖 AD-038、AD-061~AD-064 以及真实 SMTP、多实例和生产安全审查。 |
|
||||
|
||||
### 当前实现证据
|
||||
|
||||
- 管理程序与本机控制通道:`server/cmd/smail-admin`、`server/services/adminreset`、`deploy/systemd`。
|
||||
- 外部邮箱与验证码:`server/services/externalemail`、`server/services/verification`。
|
||||
- 恢复和强认证:`server/services/recovery`、`server/services/webauthn`、`server/services/totp`、`server/services/credentials`。
|
||||
- API 与前端:`server/controllers/security.go`、`server/controllers/webauthn.go`、`server/listen/http_server/api_v1_compat.go`、`fe/src/views` 下登录验证、密码恢复、账户安全和强制改密页面。
|
||||
- 自动化复核:服务端全量、竞态和静态检查以及前端 ESLint、生产构建在本轮最终提交前统一执行并记录。
|
||||
|
||||
### 发布结论
|
||||
|
||||
三份清单要求的可在当前工作区完成的代码实现已进入待复审状态;真实 Ubuntu 22.04/24.04、Windows Service/ACL/Named Pipe、真实 SMTP Relay、MySQL、PostgreSQL、浏览器三角色、多实例和最终发布安全评审保持阻塞。超级管理员自身重置仍只允许受保护的 UDS 或 Named Pipe,本轮未增加 HTTP、localhost TCP、局域网或公网 TCP 重置入口。
|
||||
+41
-6
@@ -1265,9 +1265,44 @@ CG-053~CG-056 → AD-066 → CG-057
|
||||
|
||||
## 2026-08-30 配置快照发布失败重试整改记录
|
||||
|
||||
- **本轮状态**?`[x] 已完成?等待复审`
|
||||
- **实施内容**?统一配置启动加载?配置应用?配置回滚?数据库切换和插件 Secret 迁移的运行时快照发布入口?当磁盘事务已成功提交但运行时快照暂不可用时?保留可重试状态并将配置服务标记为降级?
|
||||
- **接口提示**?新增稳定错误码 `CONFIG_RUNTIME_SNAPSHOT_UNAVAILABLE`?返回 HTTP 503?并明确提示配置已保存?运行时尚未切换?可稍后重试应用?
|
||||
- **新增测试**?覆盖应用阶段快照发布失败后的磁盘代次?运行时旧快照?降级状态和再次应用成功?保留回滚票据失败重试及并发保护测试?
|
||||
- **验证结果**?服务端 `go test ./... -count=1 -timeout 30m` 和 `go vet ./...` 通过?未将真实 MySQL?PostgreSQL?Ubuntu?Windows?浏览器和生产部署验收标记为完成?
|
||||
- **遗留边界**?事务提交后快照发布失败的跨进程恢复仍依赖服务重载或后续重试?真实多数据库复制?校验?原子切换和部署联调继续按实机清单验收?
|
||||
- **本轮状态**:`[x] 已完成,等待复审`
|
||||
- **实施内容**:统一配置启动加载、配置应用、配置回滚、数据库切换和插件 Secret 迁移的运行时快照发布入口;当磁盘事务已成功提交但运行时快照暂不可用时,保留可重试状态并将配置服务标记为降级。
|
||||
- **接口提示**:新增稳定错误码 `CONFIG_RUNTIME_SNAPSHOT_UNAVAILABLE`,返回 HTTP 503,并明确提示配置已保存、运行时尚未切换,可稍后重试应用。
|
||||
- **新增测试**:覆盖应用阶段快照发布失败后的磁盘代次、运行时旧快照、降级状态和再次应用成功;保留回滚票据失败重试及并发保护测试。
|
||||
- **验证结果**:服务端 `go test ./... -count=1 -timeout 30m` 和 `go vet ./...` 通过;未将真实 MySQL、PostgreSQL、Ubuntu、Windows、浏览器和生产部署验收标记为完成。
|
||||
- **遗留边界**:事务提交后快照发布失败的跨进程恢复仍依赖服务重载或后续重试;真实多数据库复制、校验、原子切换和部署联调继续按实机清单验收。
|
||||
|
||||
## 2026-08-31 全量代码状态复核
|
||||
|
||||
> 本节是 2026-08-31 对当前实现的增量状态口径。原任务条目中的旧状态保留为实施历史;以下状态优先用于判断当前代码完成度,但不能替代真实平台和生产发布验收。
|
||||
|
||||
| 任务范围 | 当前状态 | 复核结论 |
|
||||
|---|---|---|
|
||||
| CG-001 | `[✓] 复审通过` | 需求、边界和依赖关系已经冻结。 |
|
||||
| CG-002~CG-007 | `[x] 已完成,等待复审` | 敏感字段、显式迁移、测试基线、配置模型、严格解析和验证器均已实现。 |
|
||||
| CG-008~CG-009 | `[✓] 复审通过` | CredentialVault 和不可变运行时快照已有测试证据。 |
|
||||
| CG-010~CG-014 | `[x] 已完成,等待复审` | ConfigManager、事务恢复、备份回滚、状态/审计/受控重启、旧配置迁移均已有实现和自动化测试。 |
|
||||
| CG-015 | `[x] 已完成,等待实机复审` | SSL 分区和受控存储已实现;真实证书、Nginx 和平台权限仍需验收。 |
|
||||
| CG-016~CG-021 | `[✓] 复审通过` | 插件目录、授权、专属配置下发和三个插件源码整改已有本机自动化复审证据。 |
|
||||
| CG-022~CG-044 | `[x] 已完成,等待复审` | SMTP/邮箱策略、三级角色、统一认证、密码、部署端重置、恢复仓储、密保、恢复码、WebAuthn、恢复状态机、API 和前端页面均已有实现。 |
|
||||
| CG-045 | `[!] 暂缓或存在阻塞` | 真实浏览器三角色、可访问性和完整交互流程尚未人工验收。 |
|
||||
| CG-046~CG-050 | `[x] 已完成,等待部署复审` | setupState、初始化授权、V1 兼容、功能开关和旧写路径收敛已有代码和测试。 |
|
||||
| CG-051 | `[!] 暂缓或存在阻塞` | Windows、Ubuntu、MySQL、PostgreSQL 和 SQLite 真实部署矩阵尚未全部完成。 |
|
||||
| CG-052~CG-055 | `[x] 已完成,等待独立复审` | 自动化回归、故障路径以及配置、认证、插件安全审查已形成代码和测试证据。 |
|
||||
| CG-056~CG-057 | `[!] 暂缓或存在阻塞` | 浏览器数据泄露复审和最终发布验收依赖真实环境、人工交互及生产安全评审。 |
|
||||
|
||||
### 过时记录修正
|
||||
|
||||
旧记录中“真实数据库复制执行器尚未接入”的结论已经过时。当前已存在 `server/services/dbmigration/sql_executor.go`、`sqlite_executor.go`、运行时执行器工厂、复制校验、配置切换和相关测试。该修正只表示代码已接入,不表示真实 MySQL/PostgreSQL 数据复制、失败回滚和原子切换已经实机通过。
|
||||
|
||||
### 当前实现证据
|
||||
|
||||
- 配置核心:`server/config/model.go`、`parser.go`、`validator.go`、`secret.go`、`snapshot.go`、`manager.go`、`manager_v2.go`、`transaction.go`、`storage.go`。
|
||||
- 备份、审计和迁移:`server/config/manager_backups.go`、`audit_store.go`、`audit_query.go`、`database_migration.go`。
|
||||
- 数据库复制与切换:`server/services/dbmigration/service.go`、`sql_executor.go`、`sqlite_executor.go`。
|
||||
- 受控重启和接口:`server/services/restart`、`server/controllers/config.go`、`config_audit.go`、`database_migration.go`、`restart.go`。
|
||||
- 自动化复核:服务端全量测试、竞态检测、`go vet`、前端 ESLint 和生产构建在本轮最终提交前统一执行并记录。
|
||||
|
||||
### 发布结论
|
||||
|
||||
配置系统重构的工作区代码已进入待复审状态,但 CG-045、CG-051、CG-056 和 CG-057 仍受真实浏览器、跨平台、三数据库、多实例和生产发布评审阻塞。不得将“代码完成”表述为“生产验收完成”。
|
||||
Reference in new issue
Block a user