先说结论小程序项目的工期与人力投入经常估不准根因不在评估技巧而在功能清单没有被拆成可数的工程维度。一份能用来估算的清单至少要能数出三样东西页面数、接口数、状态机条数。这三样数不出来估算就只能靠感觉误差常在两倍以上。这篇按工程量来源、端数乘数效应、架构边界与估算误差四段讲清楚从清单到人天的推导路径以及哪些因素会让同一个需求在两种架构下差出一倍工程量。一、工程量的来源清单必须拆到三个可数维度功能清单里写的用户中心订单管理是业务块不是工程量单位。要做估算先把它翻译成三类可数的东西页面与视图数每个用户可见的独立页面、弹层、状态页各算一个。列表页与详情页、编辑态与只读态通常要分开计——只看列表页三个字会漏掉空态、加载态、异常态三套处理接口与数据契约数每个页面背后是一到多个接口。接口数比页面数更能反映后端工作量因为它同时决定字段校验、幂等设计与异常分支状态机条数涉及流程的业务订单、工单、审核、支付要数主状态数乘异常分支数。状态机是这类项目里工作量很容易失控的部分“退单”“改派”超时每个分支都要落事件与补偿。估算的基本式人天 ≈ Σ(页面数 × 单页面系数) Σ(接口数 × 单接口系数) Σ(状态机分支数 × 单分支系数)。系数因团队复用程度而异但三类的比例关系是稳定的后端与联调通常占一半以上纯页面制作占比反而有限。配图位 · 图 5工程量拆解的三层结构页面视图 / 接口契约 / 状态机structure图注图 5功能清单拆成页面、接口、状态机三个可数维度估算才能收敛二、端数是乘数多端复用的真实边界一套代码多端发布是真实存在的但它的复用边界要说清楚否则会把多端当成简单相加来估。能复用的部分业务逻辑、数据模型、接口层、大部分状态管理不能完全复用的部分各端的页面结构与平台能力差异——小程序有订阅消息、App 有推送与后台常驻、H5 有浏览器兼容与分享形态、各平台小程序有各自的审核规范与开放能力差异需要单独投入的部分按端做 BFF 裁剪、平台能力适配支付、登录、分享、地图、多端打包与上架流程。多端项目里接口层要按端裁剪而不是一套接口硬喂所有端否则端一多就变成每个端都在打补丁。配图位 · 图 6从需求清单到人天估算的流水线flow清单 → 拆维度 → 定系数 → 估算 → 交叉复核图注图 6估算流水线——先拆维度再定系数再用两条独立路径交叉核对结论多端复用的收益体现在业务逻辑层成本集中在端适配层。端数每加一个适配与联调的工作量不是线性叠加而是按需适配的环节逐项追加。三、架构边界什么时候单端单体够用什么时候必须拆同一个需求在两种架构下的工程量可能相差一倍。判断边界看三件事端数与形态只做单端单体应用加清晰的分层足够一旦多端并发接口层就需要独立的适配层否则业务逻辑会被端差异污染角色与数据范围单角色或简单双角色权限用角色表即可表达出现多组织、多区域、多层级时权限要按数据范围模型设计且要预留字段级掩码——数据范围与操作权限必须分开评估混在一起写后期改不动对接面与外部系统的对接数量决定集成层的复杂度。每接一个系统都要设计出入参契约、异常重试、对账与幂等对接面越大越需要独立的集成层来隔离外部变化。配图位 · 图 7单端单体与多端分层的架构边界对照compare图注图 7两条架构路线的适用边界——端数与集成面决定要不要引入独立适配层四、估算误差的来源与收敛方法估算失准集中在四类原因漏项空态、异常态、权限态、多语言与多端差异这类看不到的页面占相当比例清单阶段不显式列出就会被整体漏掉状态机低估主干状态好估异常分支撤销、退回、超时、并发冲突常被忽略而它们恰恰是测试与返工的重灾区联调不可控第三方接口的可用性、文档质量与限流策略不由项目组决定联调周期要用缓冲而非乐观估计需求漂移原型确认后的变更如果没有变更流程工作量会随确认次数线性膨胀。收敛方法一是把清单拆到可数维度后再估二是用两条独立路径交叉核对比如按模块估与按角色估偏差超过一定比例就回去复查漏项三是把异常分支与联调缓冲显式写进估算而不是留作到时候再说。五、模块划分与估算速查模块核心职责估算关键约束页面与视图用户可见的页面、弹层、状态页空态 / 异常态 / 权限态要单独计接口与契约数据出入参、校验、幂等接口数比页面数更能反映后端工作量状态机流程主干与异常分支流转分支数乘异常处理迁移全落事件日志端适配层多端页面差异与平台能力按端裁剪接口不共用一套硬喂权限与数据范围数据可见范围与操作权限范围与动作分开评估预留字段级掩码集成与对账外部系统的出入参、重试、对账每个对接都要设计幂等与补偿小结小程序项目的工程量估算本质是把功能清单翻译成页面数、接口数、状态机分支数三个可数维度再叠加端适配与集成面的乘数效应。多端复用的收益在业务逻辑层成本在端适配层单端单体与多端分层的选择取决于端数与集成面估算误差主要来自漏项、状态机低估与联调不可控。把这三件事在动工前拆清楚估算会从拍脑袋变成可对账后续的范围变更也有了共同的度量口径。附图三张按工程量拆解、估算流水线、架构边界对照分别给出结构参考。
