xiaobaijizhang/docs/QUALITY_AND_MAINTENANCE.md

质量与维护规则

发布门禁

任何正式版本必须满足：

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

测试层级

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

功能进入流程

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

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

可维护性

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

用户验收方式

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