系统稳定性
- 超时配置必须预留系统开销缓冲。
- 关键接口必须有顶层异常捕获。
- 异常必须有完整日志记录。
- 前后端超时要协同设计，前端阈值略短于后端。
- 对外服务必须提供健康检查端点。
- 外部资源操作必须具备容错保护。
- 线上不可用时必须具备本地回归Fallback方案。
工程配置
- 文档、配置、代码必须保持同步。
- 可变策略必须外置到独立配置文件。
- 环境切换必须依赖统一配置机制。
数据安全
- 输入校验必须前置在业务逻辑之前。
- 服务端必须承担最终校验责任。
- 空值与未设置必须显式区分。
- 多用户写入必须绑定真实身份令牌。
- 未认证与无权限必须严格区分状态码。
持久化与版本
- 初始化与导入脚本必须支持幂等执行。
- 版本字段必须自动计算。
时间与时区
- 跨时区系统内部必须统一使用UTC。
- 时间输出必须采用带时区的标准格式。
- 时区策略必须在基础设施层统一配置。
- 时间函数选用必须与语义明确匹配。
- 无时区时间值转换前必须先绑定UTC。
测试工程
- 测试参数必须与测试逻辑分离。
- 测试环境必须与真实环境隔离。
- 边界条件测试必须系统覆盖。
- 集成测试必须避免脆弱的硬编码断言。
- 测试断言必须优先依赖结构化结果。
工程协作
- 核心文本文件必须统一无BOM的UTF-8编码。
- 跨平台项目必须统一使用LF换行符。
- 面向Linux的文本文件必须去除BOM头。