独立开发者三周交付企业级系统:从需求到部署的完整复盘
说出来有点不好意思,1000块在这个行业里确实不算什么。随便一个外包报价单都是两三万起,我也见过去现场改个接口就收一千五的同行。但我要聊的这1000块,是我从零到一独立做完一整套企业级系统之后收到的第一笔钱。
它不高,但让我完整地把"客户需求、方案设计、开发、部署、验收、售后"这条链路走了一遍。很多开发者写了不少年代码,却从没走完过这条链路,而我用三周走完了。如果你也想一个人接单、想拿业余时间验证自己能不能独立做出东西,这篇复盘就是给你看的。我尽量把所有细节都说清楚,包括那些不太光彩的翻车瞬间。
1. 这单是怎么来的:从一次闲聊到一页纸需求清单
1.1 客户原话和我的翻译
这单的客户是朋友介绍的一个建材批发老板,我们叫他王老板吧。他两个门店,十来号人,之前靠Excel加微信群管理订单,库存对不上是常态,订单漏发也不是一次两次。他见过一个外包公司,报价2.8万,也见过个人团队的报价1.5万,都觉得贵,而且都不含售后,一直没下定决心。
朋友拉我去聊的那个下午,王老板的原话是:"整一个系统,能管住订单和库存就行,别太复杂。"
这句话我后来琢磨了很久。几乎每个老板在买软件时都会说"别太复杂",但这句话的潜台词不是"功能要少",而是"操作要简单,但业务上的事都得能管"。如果不把这句话翻译清楚就开始写代码,那项目必死。
我把他的话翻译成了这样一版需求:
- 人员权限:老板、销售、库管、财务四个角色,销售不能看成本价,库管不能改订单金额
- 客户档案、供应商档案、商品档案三类基础资料,支持Excel导入
- 销售订单全流程:销售建单、老板审核、库管出库、自动扣库存
- 采购入库登记,采购记录可查
- 库存查询、库存流水、库存预警
- 销售报表、进货报表,老板按月和按产品看汇总
- 操作日志,能查谁在什么时候改过什么东西
四五个小时聊下来,我把这些内容列成了一页纸发给王老板,说:您看看,是不是这些意思。他回复"差不多"的时候,我心里那块石头才算落了地。因为把模糊的口头需求变成白纸黑字的功能清单,是这种小项目后期扯皮少的最重要一步。
1.2 把模糊需求变成功能清单的关键方法
很多人接单时容易掉进一个坑:客户说"弄一个订单系统",你就闷头开始建表。但客户心里的订单系统和你理解的根本不是一回事。王老板管订单,他要的不只是"录一张订单"那么简单,他要的是订单状态走到哪一步、谁负责、库存扣了没有、钱有没有算清楚。他之所以用微信群,是因为每次都要问"这个订单发货了吗",老板想要的是自己打开页面就能看到全部。
我常用的方法是把每个功能写成"输入、动作、输出"三段式:
- 销售录订单(输入),点保存后系统自动校验库存并生成待审核单(动作),老板在首页看到待办提醒(输出)
- 库管点出库(输入),系统扣减库存并生成出库流水(动作),老板在报表里看到该订单已出库(输出)
这样每一段都对应页面上的真实操作。客户不懂技术,但能看懂"谁在什么页面点什么按钮会出现什么结果",确认起需求来效率特别高。
1.3 1000块的报价逻辑:这单我到底图什么
聊完需求,王老板小心翼翼问了一句:"大概多少钱?"
我说:1000块,前后端加部署,加一个月的免费维护,行就行,不行就当聊聊天。他当场爽快转了500定金,说剩下的验收后给。
说实话,1000块在市场上确实属于"地板价",它连这个项目的市场成本都不够。但我是刻意报这个价的。原因很简单。
首先,我没接过这种"真实业务环境下使用的系统",我需要一个真实客户来检验能力。练手项目写得再好,没有真人用、没有真数据、没有真骂街,成长就是假的。其次,我需要一个案例。王老板这个建材批发场景太典型了,订单、库存、审批、报表齐全,做成了就是一块很好的招牌。第三,我在赌后续收益。系统上线后,他一定会提新需求,新需求可以单独报价,而且他身边做生意的朋友大概率需要类似的东西。
低价单不是贱卖,是差异化获客。王老板花1000块拿到一套定制系统,我花三周时间买到一个完整案例和客户口碑,双方都不亏。事实证明后来这笔账算得还不错,这个放到最后再讲。
2. 一个人做"企业级"系统的技术选型与架构取舍
2.1 先定义什么叫企业级系统
一说"企业级",很多人第一反应是微服务、高并发、多租户、分布式事务,这其实是把概念想偏了。对于王老板这种十来个人的贸易公司,企业级的含义是:系统稳定能跑、权限划分清楚、数据可追溯、出了问题有人负责,报表能支撑决策。
一台2核4G的云服务器跑他们全场业务,并发最高的时刻也就是上午十点几个销售同时录单,连每秒10个请求都到不了。你给他上个微服务,还把服务拆成订单、库存、用户三个端,光运维和学习成本就把自己拖死了。微服务是给团队和复杂组织用的,不是给独狼用的。
所以我在文章里一直强调的"一个人做企业级系统",核心不是技术多高级,而是流程完整。从权限到审批,从订单到库存,从日志到报表,每一个企业关心的点都有对应功能,这才是王老板眼中的企业级。
2.2 技术栈选择:能一个人长期维护的方案才是好方案
我选的技术栈是这样一套:
- 后端:Java 17 + Spring Boot 3 + MyBatis-Plus + MySQL 8.0
- 前端:Vue 3 + Element Plus + Vite 2,构建后部署到Nginx
- 部署:一台云服务器,Docker Compose编排应用、Nginx、MySQL三个容器
- 认证:JWT做登录态,接口按角色做拦截
- 备份:服务器cron定时mysqldump,备份文件上传到对象存储
选Java这套不是我只会这个,而是算过账的。第一,Spring Boot的生态在国内非常丰富,遇到问题搜一下就有答案,这对单人作战太重要了。第二,客户听到"Java""MySQL"会觉得正规,后面想扩展功能也好找第三方维护。第三,MyBatis-Plus帮我省了大量单表CRUD代码,很多时候连SQL都不用手写。
有人说这个场景用PHP或者Node更快,我承认。但一个人做项目,快不是唯一标准,稳和可维护才是。"我写的代码以后有没有新人能接手""我踩坑时网上能不能搜到答案",这俩问题决定了我敢不敢接下一单。
2.3 砍需求清单:哪些"企业级功能"我做了减法
和王老板确认的原始需求里,有三块我主动砍了或做了简化:
第一,砍掉了工作流引擎。市面上成熟的工作流引擎如Flowable确实强大,但给十来个人的小公司配一个流程引擎就是杀鸡用牛刀。我直接用一个字段加一个角色判断搞定审批逻辑:订单状态为0代表待审核,老板角色能看到"审核"按钮,点击后状态变1,销售和库管看到对应的下一步操作。够用,而且出问题好排查。
第二,简化了权限模型。真正的RBAC会建用户、角色、菜单、权限四张表加关联关系,我把它砍成了一刀流:用户表带一个role字段,角色枚举写死在代码里。为什么敢这么干?因为这家公司一共就四种角色,权限差异也不交叉,硬搞多对多反而是过度设计。
第三,库存预警没有做实时推送。王老板一开始说"库存低了要提醒我",但实现实时推送要引入WebSocket或者短信服务,成本一下子上来了。我改成:登录后首页自动显示预警列表,库存低于安全值的产品标红。效果完全不差,客户满意,代码量少了不止一半。
2.4 数据库核心设计与一条关键SQL
这套系统的表我建了大概十几张,核心是这几张:
- user(用户):id、姓名、手机号、密码、角色、状态
- customer(客户)、supplier(供应商)、product(商品)、category(分类)
- sales_order(销售订单主表)、order_item(订单明细表)
- stock_flow(库存流水,记录每次出入库的来龙去脉)
- login_log(登录日志)、operate_log(操作日志)
我印象最深的是订单主表的设计,因为这一张表扛住了整个核心业务:
想强调的是deleted这个软删除字段。以前我自己练手项目从不加这个,但真实业务里误删订单是家常便饭,有软删除才能找回数据。就这一个字段,不知道帮我和客户省了多少麻烦。
扣库存那条SQL也是踩坑之后才改明白的,这个放到后面专门讲。
3. 开发期的项目管理:我把自己拆成了半个团队
3.1 两周排期怎么排:模块、优先级和每晚的任务清单
这个项目合同定的周期是三周:两周开发出Demo,一周联调加部署。实际上我没有脱产做,白天还要上班,只能用晚上和周末,所以排期做得非常细。
我的排期是这样的:
- 第1-3天:搭工程、建库表、写登录认证、权限拦截
- 第4-5天:商品、客户、供应商三个基础资料模块
- 第6-8天:订单主流程,建单到审核到出库
- 第9天:库存流水和库存预警
- 第10-11天:报表和操作日志
- 第12天:自测加造数
- 第13-14天:留白,给意外情况用的
每天晚上固定两到三小时,周六日全天。这里有个经验:排期一定要留出20%到30%的缓冲时间,因为永远会出现你意想不到的事。比如我第9天才发现框架里的事务注解失效了,排查了半天,这种问题不在缓冲期里安排根本扛不住。
3.2 自测的笨办法:造数脚本与角色走查清单
一个人开发的短板就是没法站在多个角色角度去测试。我的解决办法是两个。
第一个是写造数脚本。我写了一个Java的main方法,用随机数据生成200个客户、500个商品、3000条历史订单,分布在不同月份和不同销售名下。为什么要造这么多数据?因为报表页面、订单列表的分页、搜索、汇总统计,只有在数据量大时才能暴露性能问题和逻辑错误。空表测试永远测不出问题来。
第二个是角色走查清单。我把自己当成四个角色,每个角色开一个浏览器无痕窗口,按提前写好的测试用例逐条点过去。比如销售角色应该能看到客户的商品价格,但看不到成本价;库管角色应该能看到所有订单的待出库状态,但点不了"审核"按钮;老板角色能看到销售报表,但看不到客户详情页里的联系人手机号。每一类操作我都记在Excel里,过完一条打一个勾。
这种自测方式笨,但非常有效。后来请两个朋友用不同角色账号帮忙乱点一通,结果真让他们发现了不少问题,最离谱的是一个朋友在订单详情里把商品数量改成了负数,居然提交成功了。这个bug让我学会了一个原则:前端校验只是提高体验,后端校验才是底线。从那以后我所有接口都做了参数校验,金额、数量必须是正数。
3.3 印象最深的bug:并发扣库存
这个bug值得单独说,因为它特别典型。
第一版扣库存代码是这样写的:
看着没什么问题,但它是一个典型的多线程并发bug。假设库存还剩10件,两个销售同时下单各要8件,两个请求都读到了库存10,都判断库存够,都执行了减8的操作,最后库存变成了2。实际应该是第一个请求成功,第二个请求报"库存不足"。
解决办法是用一条原子SQL替代"先读后写":
stock >= #{quantity}这个条件让数据库自己来判断库存是否够,更新行数为0说明不够。这样即使并发进来,数据库的行锁也会让两个请求排队执行。代码还顺便加上了库存流水记录,每次扣减成功都写一条stock_flow,方便以后追溯。
这个bug让我明白了为什么数据库的事务和锁是"企业级系统"必须过的一关,也是这一单给我最大的技术收获。
3.4 进度同步:每周两次给客户发"一句话进展报告"
跟客户的沟通节奏也很重要。那种闷头写俩月、突然拿一个半成品丢给客户的接单方式,是最容易翻车的方式。我的经验是每周固定两次给王老板发一个进展消息,内容保持简单直接:
- 这周完成了订单模块,销售录单和您的审核流程已经能跑通
- 下周做库存预警和报表
- 目前一切正常,按计划下周可以看Demo
这么做的好处是客户始终知道你在干活,不会焦虑,也方便他随时提意见。王老板有一次就回复说:"那个订单号,最好能按日期生成,这样我看手机号尾号就知道是哪天的单。"这种需求提前被发现,比做完了再返工便宜得多。
4. 部署上线的真实现场
4.1 部署方案:一台云服务器和一套脚本
系统开发完到部署阶段,我选了一台2核4G的云服务器。这个配置跑这套系统绰绰有余,新用户第一年也就几百块,性价比很高,客户也觉得这个成本能接受。
部署用Docker Compose而不是裸机装环境,核心原因是可复现和可回滚。我把Spring Boot应用、Nginx、MySQL三个服务都写进docker-compose.yml,以后换服务器只需要把目录复制过去执行docker-compose up -d,再也不用担心环境不一致的问题。
Nginx负责两件事:托管前端静态文件,反向代理后端接口。我申请了免费版HTTPS证书,给客户配了一个域名。这里有个最容易被忽视的细节:直接暴露公网IP给客户使用,现在很多主流浏览器会做一些限制,体验不好,而且服务器被扫的风险也大,域名加HTTPS是最低成本的体面配置。
数据库备份脚本是上线前就写好的,我用的方案是cron定时任务加对象存储上传:
同时保留最近30天的备份,老备份自动删除。这脚本没啥高深技术,但它是"出了事能救回来"的最后一道防线。之后有一次王老板误删了一批客户数据,就是靠这个备份恢复的,他再也没提过"花1000块买系统亏不亏"这句话。
4.2 现场演示翻车记
第一轮Demo演示,我是直接去王老板店里,用他店里的电脑投屏到电视上给大家看的。结果翻车了。
第一次打开页面,白屏。我当时脑子嗡的一下。排查了半天发现是Nginx配置的问题,前端静态资源打包后的路径和Nginx的root路径对不上,导致index.html加载了但JS和CSS全部404。这个低级错误在本地开发环境根本发现不了,因为本地开发服务器帮我把路径都处理好了,只有部署到Nginx才暴露出来。
第二次翻车是登录环节。王老板手边的店员试了三次密码都不对,后来发现是他记忆中的管理员密码和实际初始密码不一致。从那天起,我做了一个"演示环境检查清单":提前一天把部署环境完整跑一遍、确认静态资源路径正确、确认所有角色的初始密码已重置、演示前先自己无痕窗口登录一次。这套清单后来每次交付都复用,救了我很多次。
4.3 给客户的运维文档:连小白都能照着操作
服务器这种东西,小公司的老板基本不会碰,但系统在线运行总得有人管。我花了一下午写了一本十几页的运维文档,跟着截图一步步来,涵盖了:
- 怎么用浏览器打开系统,怎么看首页的预警
- 怎么重置员工密码、怎么新增员工账号
- 服务器登录方式,以及如何查看磁盘空间
- 备份文件在哪里、出了问题怎么从对象存储下载恢复
- 重启服务的方法:一条命令
docker compose restart
不要嫌这种文档麻烦。我见过很多外包项目交付完几个月就烂尾的原因,不是代码坏了,而是客户没人会用、出点小状况没人能处理。一份好的运维文档能让客户觉得你专业,也能大幅度减少你后面接到的无意义电话。
5. 交付不是终点:验收、售后和复利
5.1 验收签字的标准流程
开发完不代表项目完了,验收才算。我准备了一份验收清单,就是把最初确认的功能点逐条列成表格,每条后面留出"通过/不通过"两列,后面还留了"备注"。
王老板拿着清单,我坐在旁边看着他在电脑上操作。他每点一个模块,我就解释这个功能对应他当初的哪句话,他点完说"行",我在一边做记录。遇到他皱眉的地方,我当场判断是bug还是需求理解偏差。是bug当场改,是需求偏差现场讨论是否纳入后续维护范围。
全部过完,王老板在验收单上签了字,然后把剩下的500块尾款转了过来。到账那一下,我心里还是有点小激动的,毕竟这是第一笔完完整整赚到手的项目款。
5.2 1000块的第一层复利:续费需求
交付后第一个月,王老板提了一个新需求:月底对账的时候,他想把订单明细导出成Excel,而且要带他的采购价来做利润分析。我在验收单时承诺过新需求单独报价,所以这个我报价800块,王老板没有犹豫就答应了。我花半天时间加了一个导出功能,复用原来的权限逻辑,财务角色才能看到利润列。
这个数字对比很说明问题:整个系统主工程1000块,一个导出功能800块。不是客户傻,而是他一开始只愿意为"没看到的系统"付低价,等系统用顺手了,让他实实在在节省了时间,他才愿意为增量价值买单。这也是我做这个低价单最重要的商业逻辑:第一单赚的是信任,后续需求是无限可挖掘的。
5.3 1000块的第二层复利:转介绍
王老板有一个朋友老周,开了个五金加工厂,也是订单和报价混乱的老问题。王老板在饭桌上跟我聊过一次系统的好处,老周没过几天就来问,说要弄一个"带报价功能的管理系统",还得让车间工人和办公室销售各看各的数据。
这个单我报价6000,设计的方案基本就是把第一套系统改改:订单流程变成报价流程,库存管理加上原材料批次,权限结构调整成办公区和车间两个视角。因为脚手架和框架完全复用,实际只花了一周业余时间就做完了。6000和1000的报价差异,不是因为劳动量变了六倍,而是因为第一单证明了我不只是能写代码,还能管好整个交付过程。
后来的感受是,独立开发者接单,最值钱的资产不是某段代码,而是你和客户之间的信任关系。一次成功交付带来的转介绍,比在任何平台投一百次简历都管用。
5.4 踩过坑之后的几点忠告
最后说几条我自己总结的教训,都是给同样想一个人接单做系统的同行看的。
第一,低价单可以做,但只能做一次,而且要当成获客成本来看待。常态化低价接单只会把你拖进无限改需求的泥潭里,因为客户的期望值会被你的价格拉低。记住,系统上线前的"顺手改个需求"是常态,上线后的每一次改动都是利润。
第二,所有需求变更必须落到文字。口头说的"再加一个小功能"是最软的钉子。我的做法是:客户说了需求,我在微信里用一句话复述并确认"这个需要新加,属于本期之外,报价X元",对方回复确认之后才开始做。这个习惯帮我过滤掉了大量无效需求。
第三,交付时一定要签署纸质或电子验收单。功能清单列清楚,客户签了字,以后再扯皮你手里有依据。我见过太多同行跟客户口头约定后,客户一句"我当时可没说要这个"就把他堵得无话可说。
第四,不要被"企业级"三个字吓住,也别把自己绕进去。一个人接单时,思维要始终保持在"能不能用最简方案解决真实业务问题"上。客户关心的是系统稳、能查、不崩、有人管,你用什么架构他不知道也不关心。把精力花在把审批流程、库存逻辑、权限边界这些真实业务规则做对,比纠结要不要上个消息队列重要一百倍。
回过头来,现在我的服务器上已经挂着好几套类似的系统了,报价也从1000涨到了几万块。但每次想到那1000块,我都会提醒自己三件事:客户的"就这点需求",翻译成系统永远是八张表起步;一个人做事,稳定比炫技值钱;第一单可以便宜,但绝不能马虎,因为那个客户嘴里说出的每一句"系统还不错",都会变成下一个报价单上的加分项。