步步为营 - 复杂APP开发统一技能
核心理念：每步必测、每层必验、环环相扣、层层守护
融合来源：敏捷开发原则 + 步步为营铁律 + Scrum/Agile + CI/CD + DevOps
一、核心铁律
步步为营五守则
- 每改必构 - 任何代码修改后必须重新构建
- 构建必验 - 每次构建必须验证成功
- 重启必查 - 每次重启必须检查日志
- 验证必测 - 每次验证必须执行功能测试
- 上线必监 - 每次上线必须开启监控
开发铁律速查
改代码 → 重新构建 → 重启服务 → 验证功能 → 检查日志
↓ ↓ ↓ ↓ ↓
必须做 必须做 必须做 必须做 必须看
二、模块化架构（四层模型）
公共层 (P0-P1)
基础层 (P0-P1)
业务层 (P0-P1)
支撑层 (P2)
模块开发顺序
P0核心模块: 日志记录 → 异常处理 → 用户认证 → 内容管理 → 播放引擎
P1重要模块: 配置管理 → 用户画像 → 互动社区 → 推荐算法
P2增强模块: 消息通知 → 支付结算 → 数据分析
全局联调 → 最终锁定
三、敏捷开发流程
Scrum迭代周期
需求规划 → 迭代计划 → 迭代开发 → 敏捷回顾
↑ │
└────────────────────────────────────┘
需求层次结构
Epic → Feature → User Story → Task
优先级管理 (MoSCoW)
| 优先级 | 含义 | 交付要求 |
|---|
| P0/Must | 必须有 | 绝对交付 |
| P1/Should | 应该有 | 尽量交付 |
| P2/Could | 可以有 | 选择交付 |
四、质量保障体系
CI/CD流水线
代码提交 → 静态检查 → 自动构建 → 自动化测试 → 质量门禁 → 部署发布
变更验证流程
修改代码 → 重新构建 → 重启服务 → 功能测试 → 检查日志
自动化测试层级
| 类型 | 覆盖范围 | 执行频率 |
|---|
| 单元测试 | 函数/方法级 | 每次提交 |
| 集成测试 | 模块间接口 | 每次构建 |
| E2E测试 | 完整业务流程 | 每日/发布前 |
五、自检清单
前端修改自检
| 检查项 | 验证方式 |
|---|
| API路径修改 | 检查dist目录是否更新 |
| 组件修改 | 验证浏览器是否刷新 |
| 样式修改 | 检查构建日志 |
后端修改自检
| 检查项 | 验证方式 |
|---|
| 新增路由 | 访问 /docs 检查路由 |
| 数据库修改 | 检查表结构 |
| Model修改 | 测试API端点 |
打包修改自检
| 检查项 | 验证方式 |
|---|
| 源码修改 | 必须重新构建 |
| 配置修改 | 必须重新打包 |
| 端口修改 | 必须重启所有服务 |
六、API验证四步法
Step 1: 后端测试
└─ curl http://localhost:7860/api/v1/xxx
Step 2: 前端构建
└─ npm run build:renderer
Step 3: 打包更新
└─ npx asar pack dist resources/app.asar
Step 4: 应用重启
└─ 完全退出后重新启动
常见错误排查
| 错误 | 根因 | 解决 |
|---|
| 404 Not Found | 路径不匹配 | 检查router prefix |
| 端口被占用 | 重复启动 | 添加端口检测 |
| EPIPE错误 | stdout已关闭 | 禁用console.log |
七、DevOps工具链
| 阶段 | 工具 |
|---|
| 版本控制 | Git |
| CI服务器 | Jenkins/GitHub Actions |
| 容器化 | Docker |
| 监控 | Prometheus/Grafana |
| 日志 | ELK Stack |
关键监控指标
| 指标 | 告警阈值 |
|---|
| 服务 uptime | < 99.9% |
| 响应时间 P99 | > 500ms |
| API错误率 | > 1% |
八、团队协作规范
每日站会（三问）
- 昨天完成了什么？
- 今天计划做什么？
- 遇到什么阻碍？
代码评审要点
九、版本发布规范
发布检查清单
回滚策略
- 确认回滚决策（2分钟内）
- 执行回滚脚本
- 验证服务恢复
- 通知相关方
- 问题定位修复
十、常用命令速查
# 检查端口占用
netstat -ano | findstr 7860
# 构建前端
npm run build:renderer
# 打包应用
npx asar pack dist resources/app.asar
# 查看日志
type logs\app-2026-03-24.log
版本: 1.0.0 | 融合: 敏捷开发 + CI/CD + DevOps + 步步为营铁律