项目开发报价方案.md 26 KB

哈哈智能售卖柜平台 — 软件开发报价方案

文档版本: V1.0 编制日期: 2026年05月07日 保密级别: 商业机密


目录


一、项目概述

1.1 项目背景

本项目旨在构建一套完整的智能售卖柜无人零售平台,覆盖用户扫码购物、设备管理、商品管理、订单支付、营销活动、分销推广、补货管理等全业务链路。

1.2 项目组成

序号 子系统 说明 技术栈
1 后端服务(双应用) 运营平台后端 + 小程序后端 Java 21 / Spring Boot 4 / MyBatis-Plus / Sa-Token
2 运营管理平台(Web) 运营人员使用的后台管理系统 Vue 3 / Element Plus / TypeScript / Vite / Pinia
3 用户端微信小程序 面向消费者的购物小程序 UniApp / Vue 3 / TypeScript / 微信支付分
4 管理端微信小程序 补货员/合作商使用的管理工具 UniApp / Vue 3 / TypeScript
5 哈哈设备SDK 与智能售卖机设备平台的对接层 Java / MQTT

1.3 核心业务流程

用户扫码 → 支付分鉴权 → 远程开门 → 选购商品 → 关门结算
    → AI识别商品 → 设备端计算金额 → 优惠券自动扣减 → 支付分扣费
    → 订单完成 → 分销佣金计算 → 邀请奖励激活

二、技术方案

2.1 后端架构

项目 技术选型
开发语言 Java 21
基础框架 Spring Boot 4.0.3(Jakarta 命名空间)
ORM框架 MyBatis-Plus 3.5.16
权限认证 Sa-Token 1.45.0
数据库 MySQL 8.0+
缓存 Redis 7.0+
消息队列 MQTT(设备通信)
构建工具 Maven
容器化 Docker

双应用架构

haha-admin(运营平台,端口7070)
    └── 共享 haha-service → haha-mapper → haha-entity → haha-common
haha-miniapp(小程序,端口7077)
    └── 共享 haha-service → haha-mapper → haha-entity → haha-common
haha-sdk(独立设备对接模块)

2.2 前端架构

应用 技术栈 构建工具
运营管理平台 Web Vue 3.5 + Element Plus 2.12 + TypeScript 5.9 + Tailwind CSS 4 Vite 7
用户端小程序 UniApp 3.0 + Vue 3.5 + TypeScript 4.9 + Pinia 3 Vite 5
管理端小程序 UniApp 3.0 + Vue 3.5 + TypeScript 4.9 + Pinia 3 Vite 5

2.3 集成服务

服务 用途
微信支付(JSAPI) 小程序内支付
微信支付分 免密支付(先享后付)
微信登录 手机号快速登录
高德地图 门店选址、附近门店搜索
阿里云OSS / 腾讯云COS 商品图片、视频存储
哈哈设备平台 智能售卖机设备对接(开门/状态/商品/订单回调)

三、开发范围与功能清单

3.1 后端服务功能

编号 功能模块 功能描述
B-01 设备管理 设备信息CRUD、在线/离线状态追踪、门状态监控、远程开门、温度/音量控制
B-02 门店管理 门店CRUD、设备关联、省市区选择、经纬度选址、营业时间、附近门店搜索
B-03 商品管理 商品CRUD、分类管理、图片管理、与哈哈平台同步、新品申请审核
B-04 订单管理 订单创建/查询/列表/详情、多维筛选、三级金额体系(原价/优惠/实付)
B-05 支付体系 微信支付(JSAPI)、微信支付分(免密支付)、支付宝支付、退款管理、支付回调
B-06 设备回调处理 AI识别回调、订单金额回调、设备状态回调、在线状态回调、声音/新品/商品合并回调
B-07 营销活动 首单立减/折扣/满减三种活动类型、活动状态流转、适用范围配置、预算控制
B-08 定时折扣 固定折扣/阶梯折扣/固定价格、按时段自动执行、临期清库存策略
B-09 优惠券体系 满减券/折扣券/立减券/商品券四种类型、有效期管理、库存防超卖、自动扣减
B-10 邀请有礼 邀请活动配置、邀请码生成、邀请关系绑定、首单激活奖励、双向发券
B-11 分销管理 合作商CRUD、推荐记录、佣金计算(含冻结期)、提现申请与审核、月度报表
B-12 库存管理 设备库存查询(货架/货道维度)、库存预警、出入库日志
B-13 补货员管理 独立补货员CRUD、微信扫码绑定、设备权限分配、补货操作记录
B-14 用户/客户管理 用户列表/详情、订单历史、消费统计
B-15 权限与系统管理 管理员管理、角色管理(含菜单/权限分配)、菜单管理、部门管理、字典管理、操作日志、公告管理
B-16 公告管理 公告CRUD、发布/下架、小程序端推送

3.2 运营管理平台 Web

编号 页面 功能描述
W-01 登录页 账号密码登录、手机验证码登录、二维码登录
W-02 仪表盘/工作台 核心指标卡片、销售趋势图表、快捷入口
W-03 设备管理 设备列表(分页/筛选/搜索)、设备详情、远程开门、温度/音量设置
W-04 门店管理 门店列表、新增/编辑(地图选址)、门店详情(设备数/在线数)
W-05 商品管理 商品列表(多条件筛选)、新增/编辑、图片管理/预览、新品申请审核
W-06 订单管理 订单列表(状态/设备/门店/时间多维筛选)、订单详情(金额/商品/视频)、退款审核
W-07 库存管理 设备库存查询、库存预警列表、出入库记录
W-08 营销中心 营销活动管理、优惠券模板管理、用户优惠券查询、定时折扣管理、邀请有礼管理、营销数据统计
W-09 分销管理 合作商列表/详情、推荐记录、佣金记录、提现审核、月度报表、分销配置
W-10 补货员管理 补货员列表、新增/编辑、生成微信绑定码、设备权限分配
W-11 客户管理 用户列表、用户详情(消费记录/优惠券/统计)
W-12 数据统计 销售概览、设备统计、商品统计、门店统计、品类分析、复购率、利润分析
W-13 系统管理 管理员管理、角色管理(菜单权限+操作权限分配)、菜单管理(树形)、部门管理、字典管理
W-14 操作日志 操作日志查询(模块/操作人/时间筛选)
W-15 公告管理 公告列表/新增/编辑/发布/删除
W-16 个人中心 个人资料、修改密码、主题切换(亮色/暗黑)

3.3 用户端微信小程序

编号 页面 功能描述
M-01 登录页 微信手机号快速登录(open-type="getPhoneNumber")
M-02 首页 扫码入口、附近门店/设备、公告轮播、快捷入口
M-03 扫码购物 扫码→开门→购物页商品展示→关门自动结算(完整闭环)
M-04 支付分 支付分开通引导、服务授权、信用记录
M-05 订单列表 全部/待支付/已完成/已关闭 分类筛选
M-06 订单详情 商品明细、三级金额(原价/优惠/实付)、支付状态、识别视频
M-07 退款申请 退款申请(7天内)、退款状态跟踪
M-08 领券中心 优惠券浏览、领取(防超卖)、领取状态
M-09 我的优惠券 未使用/已使用/已过期 分类、券详情
M-10 邀请有礼 邀请海报/链接生成、邀请记录、奖励记录
M-11 公告中心 公告列表、公告详情
M-12 个人中心 个人信息、订单入口、优惠券入口、邀请入口、客服、设置
M-13 协议页面 隐私政策、用户服务协议

3.4 管理端微信小程序

编号 页面 功能描述
A-01 登录/绑定 微信绑定码绑定、静默登录、补货员身份校验
A-02 工作台首页 核心指标、待办事项、快捷入口
A-03 补货工作台 绑定设备列表、设备库存查看、执行补货操作
A-04 设备管理 设备列表、设备详情(含库存/状态)
A-05 订单管理 订单列表(按设备/状态筛选)、订单详情
A-06 库存管理 库存查询、库存预警列表
A-07 分销工作台 合作商面板、推荐列表、佣金记录、提现申请与记录
A-08 邀请管理 邀请活动、邀请记录查看
A-09 客户管理 用户列表、用户详情
A-10 门店管理 门店列表、门店详情
A-11 统计概览 关键数据看板

3.5 哈哈SDK与设备对接

编号 功能 说明
S-01 设备API封装 开门、状态查询、温度/音量设置
S-02 商品API封装 商品查询、同步
S-03 订单API封装 创建订单、查询订单
S-04 认证与签名 authToken认证、请求签名、回调签名验证
S-05 回调接收 设备状态/在线状态/AI识别/订单/音量/新品/商品合并共7种回调
S-06 AI识别处理 ORC_RESULT解析、sku_list处理、视频URL存储、幂等防重复
S-07 MQTT通信 设备消息实时订阅、状态变更推送

四、工作量估算明细

4.1 总览

大类 模块数 总工时(人天)
一、项目基础设施 9 22
二、后端核心服务 8个子模块 78
三、运营管理平台 Web 16 62
四、用户端小程序 13 35
五、管理端小程序 11 24
六、SDK与设备对接 7 18
七、联调测试与部署 3 18
合计 257 人天

4.2 详细工时分解

一、项目基础设施搭建(22 人天)

编号 功能点 工时 说明
1.1 Spring Boot 多模块项目初始化 2 Maven多模块、Java 21、Jakarta命名空间
1.2 数据库设计与建表(30+张表) 3 ER图设计、索引规划、雪花ID主键、建表SQL
1.3 公共模块开发(enums/constants/VO/Result/异常处理) 3 haha-common完整搭建
1.4 CI/CD与部署环境配置 2 开发/测试/生产环境、Docker、Nginx、域名SSL
1.5 三大前端项目脚手架搭建 3 Vue3+Vite+ElementPlus / UniApp+Vue3
1.6 统一HTTP请求封装与拦截 2 axios封装 + uni.request封装、Token管理、401处理
1.7 双认证体系搭建 3 运营端Sa-Token + 小程序微信登录
1.8 文件存储服务对接 2 阿里云OSS/腾讯云COS
1.9 操作日志AOP与监控 2 @Log注解、登录日志、接口调用日志
小计 22

二、后端核心服务(78 人天)

设备与门店模块(12人天)

功能点 工时
设备管理CRUD(含SN唯一校验、状态追踪) 2
设备状态管理(在线/离线/门状态/历史记录) 1.5
门店管理CRUD(含省市区、地图选址) 2
门店-设备关联(一对多绑定、设备转移) 1
附近门店查询(经纬度+距离排序) 1.5
设备远程控制(开门、温度、音量) 2
开关门记录(DoorRecord、时长统计、无消费标记) 2

订单与支付模块(24人天)

功能点 工时
订单CRUD(含多维筛选分页) 2
AI识别回调处理(解析、创建订单、幂等) 3
订单金额回调处理(商品明细保存) 2
三级金额体系设计与计算 1.5
支付策略架构(Strategy模式+渠道工厂) 3
微信支付对接(JSAPI支付+回调+验签) 3
微信支付分对接(开通+创单+扣款+撤销完整链路) 4
支付宝支付对接 2
退款管理(申请+审核+7天限制+流水) 2.5
订单状态流转(4状态状态机) 1

营销与优惠模块(22.5人天)

功能点 工时
营销活动CRUD(首单立减/折扣/满减三类型) 3
活动状态流转(5状态状态机) 2
活动适用范围(门店/设备/商品三级) 2
优惠券模板管理(满减/折扣/立减/商品券) 3
用户优惠券管理(领取/使用/过期) 2
领券中心(主动领取+限领+防超卖) 2.5
优惠券自动扣减(最早到期优先策略) 2
优惠叠加规则(活动+券叠加、上限) 1.5
定时折扣活动(固定/阶梯/固定价+自动执行) 3
统一活动管理(三套体系统一查询入口) 1.5

分销模块(11人天)

功能点 工时
合作商管理CRUD(含二维码) 2
推荐记录(关系绑定、首单追踪) 1.5
佣金计算(冻结期+结算) 2.5
提现管理(申请+冻结+审核+打款) 2.5
月度报表 1.5
合作商配置(佣金比例/提现门槛/冻结天数) 1

邀请有礼模块(7.5人天)

功能点 工时
邀请活动CRUD(双向奖励/日上限/首单门槛) 2.5
邀请码生成与分享 1.5
邀请关系绑定(扫码/链接+防重复) 1.5
邀请激活(首单完成+自动发券) 2

库存管理模块(4人天)

功能点 工时
设备库存查询(货架/货道维度) 1.5
库存预警(阈值+自动告警) 1.5
库存日志(出入库追溯) 1

补货员模块(9人天)

功能点 工时
补货员CRUD(独立表、姓名/手机/工号) 1.5
微信绑定流程(绑定码+Redis+扫码+openid) 2.5
设备权限绑定(手动/扫码/门店继承) 1.5
补货操作(扫码→查库存→逐项补货) 2
补货记录与明细(变更前后库存、统计) 1.5

公告模块(2.5人天)

功能点 工时
公告CRUD(创建/编辑/发布/删除) 1.5
小程序端公告推送 1

三、运营管理平台 Web(62 人天)

编号 功能模块 工时
3.1 登录与认证(账号/验证码/二维码三种方式) 2
3.2 布局框架(侧边栏/导航/标签页/面包屑/全屏/暗黑模式) 3
3.3 仪表盘/工作台(指标卡片+ECharts图表+快捷入口) 3
3.4 设备管理(列表/详情/远程控制) 4
3.5 门店管理(列表/新增编辑/详情/地图选址) 3
3.6 商品管理(列表/新增编辑/图片管理/新品申请审核) 4
3.7 订单管理(列表/详情/退款审核) 5
3.8 库存管理(设备库存查询/预警/出入库记录) 3
3.9 营销中心(活动+优惠券+定时折扣+邀请+统计) 8
3.10 分销管理(合作商+推荐+佣金+提现审核+报表) 6
3.11 补货员管理(列表/增删改/绑定码生成/权限分配) 3
3.12 客户管理(用户列表/详情/消费统计) 3
3.13 数据统计(7个维度统计面板) 5
3.14 系统管理(管理员/角色/菜单/部门/字典/日志/公告) 8
3.15 个人中心(资料/密码/安全) 2

四、用户端微信小程序(35 人天)

编号 功能模块 工时
4.1 登录模块(微信手机号登录+静默登录+登录态维持) 2
4.2 首页(扫码入口+附近门店+公告轮播+快捷入口) 3
4.3 扫码购物流程(完整闭环:扫码→开门→选购→结算) 5
4.4 支付分模块(开通引导+服务详情+信用记录) 3
4.5 订单模块(列表+详情+三级金额+状态追踪) 4
4.6 退款模块(申请+7天限制+状态跟踪) 2
4.7 领券中心(列表+领取+防超卖) 2
4.8 我的优惠券(四分类+使用记录) 2
4.9 邀请有礼(海报生成+记录+奖励) 2
4.10 公告中心(列表+详情) 1.5
4.11 个人中心(信息+入口聚合+客服+设置) 3
4.12 协议页面(隐私政策+服务协议) 1
4.13 全局组件(骨架屏+客服按钮+导航栏+空状态+加载动画) 2.5
4.14 设计与适配(品牌黄主题+Design Token+安全区+rpx适配) 2

五、管理端小程序(24 人天)

编号 功能模块 工时
5.1 登录/绑定(绑定码绑定+静默登录+身份校验) 2
5.2 工作台首页(指标概览+待办+快捷入口) 2
5.3 补货工作台(设备列表+库存查询+执行补货) 4
5.4 设备管理(列表+详情) 2
5.5 订单管理(列表+详情) 3
5.6 库存管理(查询+预警) 2
5.7 分销管理(面板+推荐+佣金+提现) 3
5.8 邀请管理(活动+记录) 1.5
5.9 客户管理(列表+详情) 1.5
5.10 门店管理(列表+详情) 1.5
5.11 统计概览(数据看板) 1.5

六、哈哈SDK与设备对接(18 人天)

编号 功能点 工时
6.1 SDK核心封装(设备/商品/订单API) 5
6.2 签名与认证(authToken+请求签名+回调验签) 3
6.3 回调接收与分发(7种回调+消息路由+幂等) 4
6.4 AI识别处理(ORC_RESULT解析+sku_list+视频+幂等) 3
6.5 MQTT消息推送(连接管理+订阅+实时更新) 3

七、联调测试与部署(18 人天)

编号 阶段 工时
7.1 前后端接口联调 5
7.2 功能测试+Bug修复(含2-3轮回归) 8
7.3 生产部署+小程序审核+文档交付 5

五、项目排期计划

5.1 人员配置建议

角色 人数 职责
后端开发工程师 2人 Java后端服务、SDK、设备对接、数据库
前端开发工程师 1-2人 运营管理平台Web
小程序开发工程师 1人 用户端+管理端两个小程序
项目经理(可选) 1人 需求对接、进度把控、验收

5.2 分阶段交付计划

阶段 周期 交付物 核心里程碑
阶段一:基础搭建 第1-2周 项目脚手架、数据库建表、公共模块、认证体系、三大前端框架 前后端工程可运行
阶段二:核心闭环 第3-5周 设备/门店/商品管理、扫码购物MVP、订单/支付(含支付分)、运营后台基础框架 可演示扫码购物完整闭环
阶段三:业务完善 第6-8周 营销/优惠券/定时折扣、分销/邀请体系、补货员系统、管理端小程序、数据统计 全业务功能开发完成
阶段四:测试上线 第9-10周 全量联调、功能测试、性能测试、生产部署、小程序审核、文档交付 正式上线运行
周次    1    2    3    4    5    6    7    8    9    10
────  ──┬──┬──┬──┬──┬──┬──┬──┬──┬──┬──
后端    ██  ██  ██  ██  ██  ██  ██  ██  ▒▒  ▒▒
前端Web      ██  ██  ██  ██  ██  ██  ▒▒  ▒▒
小程序                  ██  ██  ██  ██  ▒▒  ▒▒
SDK                 ██  ██  ██
测试                                       ▒▒  ▒▒
────  ──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──
      ██ = 开发    ▒▒ = 测试/部署

5.3 关键路径依赖

数据库设计 → 公共模块 → 认证体系
    ↓
设备/门店管理 → 扫码开门 → 支付分 → AI回调 → 订单支付 → 购物闭环
    ↓
营销/优惠券 → 分销/邀请 → 补货员 → 统计报表
    ↓
全量联调测试 → 上线部署

六、报价方案

6.1 方案对比

项目 基础版 标准版(推荐) 完整版
人员配置 4人(2后端+1前端+1小程序) 5人(2后端+2前端+1小程序) 6人(2后端+2前端+1小程序+1PM/测试)
开发周期 12-14周 10-12周 10周
总人天 257 257 257
人天单价 ¥1,200 ¥1,500 ¥1,800
开发总价 ¥308,400 ¥385,500 ¥462,600
项目管理费 含在单价中 含在单价中 含在单价中
功能完整度 核心功能 全部功能 全部功能+专业测试
测试覆盖 基础功能测试 功能+兼容性测试 功能+兼容性+性能+安全测试
文档交付 接口文档+部署文档 接口+部署+设计文档 全套技术文档+用户手册+运维手册
售后维护 1个月免费 3个月免费 6个月免费

推荐标准版:功能完整、周期合理、性价比最高。

6.2 报价总览(标准版)

费用项目 金额(元) 说明
后端服务开发 ¥231,000 后端双应用 + SDK + 设备对接(78+18=96人天 × ¥1,500)
运营管理平台 Web ¥93,000 62人天 × ¥1,500
用户端小程序 ¥52,500 35人天 × ¥1,500
管理端小程序 ¥36,000 24人天 × ¥1,500
基础设施搭建 ¥33,000 22人天 × ¥1,500
联调测试与部署 ¥27,000 18人天 × ¥1,500
售后维护(3个月) ¥0 标准版赠送
合计(含税) ¥472,500

6.3 付款方式建议

阶段 比例 金额(标准版) 支付节点
项目启动款 30% ¥141,750 合同签订后3个工作日内
中期款 30% ¥141,750 阶段二完成(购物闭环可演示)
尾款 40% ¥189,000 全部功能验收通过、正式上线后7个工作日内

七、交付物清单

类别 交付物 说明
源代码 全部项目源码 含后端双应用、Web管理后台、两个小程序、SDK
数据库 数据库建表脚本 含初始化数据(字典、默认角色、菜单等)
部署 Docker镜像 + docker-compose 一键部署脚本
文档 接口文档(Swagger/OpenAPI) 全部REST API接口说明
数据库设计文档 ER图 + 表结构说明
部署运维文档 环境要求、部署步骤、常见问题
业务模块说明文档 已有8份模块设计文档 + 补充
用户操作手册 运营后台使用说明
测试 测试报告 功能测试覆盖清单 + 测试结果
培训 远程培训 运营人员使用培训(2小时)

八、售后与运维服务

8.1 免费维护期(标准版:上线后3个月)

服务内容 说明
Bug修复 开发方原因导致的Bug免费修复
技术咨询 工作时间内的远程技术支持
小范围调整 界面文案、配置参数等视情况免费调整

8.2 年度运维服务(可选,另签合同)

服务内容 说明 参考费用
服务器运维 健康监控、日志清理、证书续期、安全补丁 开发总价10%-15%/年
功能迭代 新增小型功能、业务流程优化 按实际人天 ¥1,500/天
紧急响应 7×24小时紧急问题响应 含在年费中

九、费用说明

9.1 报价包含

  • 全部功能的设计、开发、测试、部署
  • 项目管理和需求沟通
  • 上线后免费维护期内的Bug修复

9.2 报价不包含

项目 说明
服务器费用 云服务器/数据库/Redis/OSS等资源采购
域名与SSL证书 域名注册、SSL证书购买与续费
第三方服务费 微信支付手续费、支付宝手续费、高德地图API调用费、短信验证码费用
微信认证费用 小程序认证费(¥300/年)
硬件设备 智能售卖柜硬件采购与调试
需求变更 合同签订后新增或重大变更的功能需求
异地差旅 如需现场部署或培训产生的差旅费

十、合作流程

1. 需求确认
   ├── 双方沟通确认功能范围
   └── 确认报价方案与交付周期

2. 合同签订
   ├── 签署软件开发合同
   └── 支付项目启动款(30%)

3. 设计阶段
   ├── UI/UX设计稿确认
   └── 数据库详细设计评审

4. 开发阶段
   ├── 按阶段计划开发
   ├── 每周进度同步
   └── 阶段交付物验收

5. 测试阶段
   ├── 内部功能测试
   ├── 需求方UAT验收测试
   └── 支付中期款(30%)

6. 上线部署
   ├── 生产环境部署
   ├── 数据迁移(如有)
   ├── 小程序提交审核
   └── 正式上线

7. 项目交付
   ├── 全部文档交付
   ├── 操作培训
   └── 支付尾款(40%)

8. 售后维护
   └── 免费维护期开始

附录

A. 技术名词解释

名词 说明
UniApp 跨平台小程序开发框架,一套代码可发布到微信/支付宝等多平台
Sa-Token 轻量级Java权限认证框架
MyBatis-Plus MyBatis增强工具,简化数据库操作
支付分 微信支付分(先享后付),用户无需预充值即可购物,关门后自动扣款
雪花算法 分布式唯一ID生成算法,用于数据库主键
MQTT 物联网通信协议,用于设备与服务器之间的消息推送
回调 设备端主动向服务端推送事件(如开关门、AI识别结果)
OSS/COS 阿里云/腾讯云对象存储服务,用于图片和视频文件存储

B. 联系方式

角色 联系方式
项目负责人 (待填写)
技术负责人 (待填写)
商务对接 (待填写)

声明:本报价方案基于当前需求分析,实际开发过程中如发生需求变更,双方协商后可对报价和排期进行调整。本方案有效期为发出之日起30个自然日。