Django-快速迭代开发过程

这篇讲什么

  • 这篇不是 Django 的代码教程,而是「怎么把一个 Django 项目按天推进下去」的方法:怎么判断核心功能(OOPD)、怎么做技术方案设计与工作拆解、怎么保证交付质量并持续迭代。
  • 里面每个名词都会解释一遍(OOPD、0day、Fail fast、Buffer、灰度、A/B Test、Feature Flag),并且落到 Django 的具体做法上——迁移文件怎么支撑「逐步演进」、功能开关怎么实现、哪些检查该进 CI。
  • 这篇属于经验总结,没有需要实机验证的技术断言;文中提到的 Django 侧命令(迁移、测试、check --deploy、覆盖率)都在同目录的《Django-生产环境要注意哪些事项》《Django-云环境中的持续集成》里逐条实测过,这里只引用结论。
  • 工具名与书名按当前官方拼写校正过:Astash 应为 Astah,Lucid Chart 应为 Lucidchart,Widipedia 应为 Wikipedia。

快速迭代的价值与挑战

什么是快速迭代

以「天」甚至「小时」为单位持续把可用的改动交付到用户手里,并从中获得反馈的循环。反面是「攒三个月做一次大版本」。

1.2 价值

  • 时间是最贵的成本:机会窗口很短,早一步拿到市场反馈就早一步决定要不要继续投。
  • 快速验证需求:避免把资源投在用户其实不需要的功能上(Fail fast, fail better:尽早失败,并且失败得便宜)。
  • 快速验证方案:技术选型靠真实小实验,不靠会议室争论。
  • 缩短反馈回路:团队和自己能持续拿到「有进展」的正反馈,这本身就是效率来源。

1.3 挑战

  • 产品设计者要能理清业务流程、抓住重点需求,并把「客户想要什么」翻译成「系统要做什么」——这两句话经常不是一回事。
  • 开发者既要理解业务,又要能用足够简洁的方案做系统:复杂方案短期也能跑,但迭代速度会被它拖死。

根本挑战

  • 市场、用户、技术、环境变化快,开发节奏很难追上。
  • 几乎没有人能一开始就设计出「适应未来长期变化」的完美方案。
  • 也很少有人愿意承认「我现在的能力/条件还做不出完美产品」——于是把时间花在打磨细节上,而不是尽快拿到反馈。

用 OOPD 方法识别产品核心功能

OOPD 是什么

OOPD = Online and Offline Integrated Product Development(线上与线下结合的产品开发)。核心思路是:产品决策不靠内部讨论拍板,而是「线下想清楚 → 线上小步验证 → 用真实数据回到线下修正」的闭环。

Online and Offline integrated Product development

五条原则

原则 含义 落地做法
自助原则 自己做自己用的产品(eat your own dog food) 内部先用,团队是第一批用户
0day 原则 抓住核心问题、砍掉一切细节,第一天就发布 首版只做主流程跑通,其它一律排后
时限原则 设定时间盒,不给「写出 bug」留拖延空间 一个迭代 1~2 周,任务拆到 0.5~1 天
不完美原则 没有完美产品,别为完美消耗宝贵资源 明确「这版不解决什么」并写进文档
谦卑原则 承认自己的局限,靠用户反馈持续修正 建反馈入口,看数据不看面子

对 Django 项目来说,「0day 原则」最常见的落点就是:先把「一个模型 + 一个列表页 + 一个表单页」跑通上线,而不是先做权限体系、后台美化、导出报表。

技术方案设计与工作拆解

做设计的前提

  • 有明确的用户场景:用户怎么和产品交互,期望拿到什么结果。
  • 有清晰的业务流程:谁在什么时候做什么,数据从哪来到哪去。

缺这两条就开始画架构图,产出通常是「看起来专业但没人能照着写代码」的文档。

设计流程

技术方案设计流程

3.3 工具

常见工具:Visual Paradigm、Lucidchart、Visio、Gliffy、Draw.io、Astah、StarUML 等。

推荐工具:白板或白纸。不用工具往往是最好的工具——画得快的图才会被真的更新,精美的图往往在需求变更后就作废了。要留档再补到仓库里(Markdown + 简单流程图即可,和站内笔记的做法一致)。

技术方案文档的要素

  • 产品背景:用户场景、产品目标、引用的业务流程与需求文档。
  • 要解决的问题列表、明确不解决的问题列表、系统约束。
  • 不同方案的对比,以及每个主要问题最终怎么解决。
  • 整体流程图(序列图)、模块关系图、关键接口与实体的概念定义。
  • 功能之外的设计:安全、性能、可维护性、稳定性、监控、扩展性、易用性。

Google最早的搜索爬虫的设计

Django 项目里这一节最实际的产出是三样东西:实体关系(模型清单)、页面/接口清单、以及「哪些事情这版不做」。

工作拆解

任何事只要拆得足够细,你就能完成它。拆解原则:

  • 优先级:主流程上不确定的工作优先做(建议提前一个迭代做技术调研,把风险前置)。
  • 核心流程优先:先把主流程打通,再补边角。
  • 减少依赖:降低任务之间的人依赖,团队拆解保持透明,预留 20% 的 Buffer(缓冲时间,用来吸收估算误差与临时插入的事)。
  • 粒度:拆到每项 0.5~1 天,最长不超过 2 天;超过 2 天说明还没拆透。

对 Django 项目,一个自然的切分边界就是「一个模型 + 它的视图/表单/测试」,这样每个任务都能独立提交、独立评审、独立回滚。

怎么保证交付质量

  • 需求质量决定软件质量:需求含糊时,代码只是把模糊实现了一遍。
  • 架构方案要评审:系统设计决定实现质量,重大改动先写半页方案再动手。
  • 工程侧的持续交付实践:
实践 具体做法 备注
Code Review 每次提交都被评审;单次 commit 小于 200 行;提交要频繁 小提交才看得懂,也才好回滚
单元测试 项目第一天就建好测试机制,并在 CI 自动跑 基类怎么选、跑法与退出码见《Django-生产环境要注意哪些事项》第七节
自动化回归 对预发/线上做 API 或页面级自动测试(Postman、Robot Framework、Playwright 等) 覆盖「改 A 坏 B」
CI/CD 自动打包、测试、部署、线上验证 六条必跑命令见《Django-云环境中的持续集成》
  • 发布过程可监控、可回滚:先有指标和日志,再谈快速发布。
  • 灰度:用户量大的产品先放小比例流量。
  • 限流与降级:对意外并发做保护(Nginx limit_req 实测见《Django-生产环境中的安全》第九节)。
  • 配置开关(Feature Flag):功能能通过配置实时开/关,让「代码上线」与「功能上线」解耦。
  • A/B Test:用数据比较两个版本的效果,而不是靠感觉。
  • 一切自动化、一切代码化:配置即代码、部署流程即代码、基础设施即代码(声明式 API、CI Pipeline、K8s、Helm、Terraform)。

Django 里怎么实现功能开关

不必引入重型框架,一个配置表 + 缓存就够用:

core/models.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
class FeatureFlag(models.Model):
name = models.CharField("开关名", max_length=64, unique=True)
enabled = models.BooleanField("是否开启", default=False)

@classmethod
def is_on(cls, name):
from django.core.cache import cache

key = "flag:%s" % name
hit = cache.get(key)
if hit is None:
hit = cls.objects.filter(name=name, enabled=True).exists()
cache.set(key, hit, 60)
return hit
core/views.py
1
2
3
if FeatureFlag.is_on("new_checkout"):
return render(request, "checkout_v2.html")
return render(request, "checkout_v1.html")

要点:开关状态走缓存(实测 locmem 在多 worker 下各自一份,所以开关必须用 Redis 之类共享后端,否则不同实例表现不一致),并且每个开关都要有「关掉后的老路径」,否则它就不是开关而是发布。

用迁移支撑「逐步演进」

快速迭代意味着模型会一直变,Django 的 migrations 就是为这件事设计的:

  • 加字段先给默认值或允许为空,避免锁表和旧代码报错。

  • 删字段拆两次发布:先停用,再删除。

  • 数据修补写进 RunPython,配 atomic=True。

  • CI 用 python manage.py makemigrations --check --dry-run 拦住「改了模型忘了生成迁移」(实测退出码 1)。

把方法落到一周节奏里

一个可执行的最小节奏(两周迭代也能压缩成一周):

  1. 周一:确认本迭代要交付的 3~5 个「用户可见结果」,每个都能演示。

  2. 周一:为不确定的技术点排 0.5 天调研,结论写半页纸。

  3. 每天:小步提交(< 200 行)、当天被评审、CI 全绿才合。

  4. 周三:把已完成部分发到内部环境,团队自己先用(自助原则)。

  5. 周五:灰度上线 + 看指标;不达预期就关开关,而不是连夜改。

  6. 周五:15 分钟回顾——哪个估算错了、为什么,写进下一轮的 Buffer。

这份节奏的价值不在形式,而在于每个环节都有明确的失败信号:CI 红、指标不动、内部没人用,任一条出现就该停下来调整范围,而不是继续加功能。

常见误区

  • 把「拆得很细」当成「拆得好」:细碎但都依赖同一个人的任务表,等于没拆。
  • 用完美的架构图替代真实原型:图不会给你反馈,上线的东西才会。
  • 一上来就做权限体系、报表导出、后台美化:这些几乎都不是核心问题。
  • 把 Buffer 当成摸鱼时间:Buffer 是用来吸收意外的,不是用来塞新需求的。
  • 只有「大重构」没有「小步演进」:Django 项目里能靠迁移和开关解决的事,就不要憋成一次重写。
  • 忽略可观测性:迭代越快,越需要「出问题能立刻发现」,见《Django-接入监控告警》。

参考