# 质量与维护规则

## 发布门禁

任何正式版本必须满足：

- 类型检查通过
- 自动化测试通过
- 核心流程人工验收通过
- 数据库迁移和回退演练通过
- 安装、升级、卸载不损坏用户数据
- 没有未处理的严重级别错误
- 版本说明列出新增、修复、已知限制和恢复方式

## 测试层级

- 单元测试：金额、日期、去重、分类、规则边界
- 集成测试：文件导入、数据库迁移、模块接口
- 流程测试：建档到申报草稿的完整闭环
- 视觉测试：核心页面固定尺寸截图对比
- 恢复测试：断网、崩溃、升级失败、备份损坏
- 安全测试：权限、敏感日志、恶意文件、依赖漏洞

## 功能进入流程

需求说明 → 模块归属 → 影响分析 → 验收案例 → 开发 → 自动测试 → 功能开关 → 小范围启用 → 正式发布。

没有模块归属、没有验收案例或不能单独关闭的重要功能，不进入开发。

## 可维护性

- 每个模块包含用途、公开接口、数据结构和故障处理说明。
- 关键架构决定记录原因，而不只记录结论。
- 税务政策、提示文案和非核心分类规则优先配置化。
- 所有后台任务有状态、失败原因和安全重试入口。
- 客服通过用户主动生成的脱敏诊断包排查问题。
- 规则变更实行版本管理和双人审核。
- 每季度执行一次备份恢复演练和依赖升级评估。

## 用户验收方式

每次交付提供安装包、演示数据、测试清单、变化说明和已知限制。用户只需按业务语言反馈现象，技术侧负责定位原因、修复并补充防复发测试。