Work — 01 Project

项目不在多,
在于能不能讲到底。

我就一个完整项目:毕业设计做的寝修宝宿舍报修小程序。从走访宿管定需求,到表结构、二十二个接口、 十个页面和二十五条测试用例,都是我一个人做的 —— 所以能一路讲到底,包括后来知道做错的地方。

Breakdown

拆开看,每个环节做了什么

六个切面,每个都标了做法与取舍。点进案例页能看到状态机、建表语句和接口清单。

01 / 需求梳理

把聊天记录变成状态机

原来报修在微信群喊一声,宿管记本子。我先跟宿管和 3 个维修师傅聊了两天,把口头流程画成泳道图,最后收敛成五种状态、四条规则。

状态 5 个 · 规则 4 条
02 / 数据库

表结构改了三版才对

第一版单表塞一切,查询要自己 JOIN 自己。后来按「一件事一张表」拆成用户、报修工单、送水订单三张,用四个时间戳回答「什么时候接的、什么时候完工的」。

核心表 3 张 · 索引 3 个
03 / 接口

蓝图拆完,接口才讲得清

Flask 按用户、工单、送水、统计拆成四个蓝图,返回体统一成 {code, msg, data}。查询用 GET、变更一律 POST,避开部分网络环境拦 PUT / DELETE。

接口 22 个 · 统一返回体
04 / 前端

一套模板支撑四类角色

学生看催单、取消、评价;维修工看开始处理、处理完成;宿管看指派;管理员多一个删除。同一个页面按角色编码与工单状态做条件渲染,没写四套界面。

10 个页面 · 代码少 60%
05 / 联调

手机打不开,卡了一下午

后端在本机 curl 正常,手机一直转圈。三个原因叠在一起:Flask 只监听 127.0.0.1、系统防火墙没放行 8080、手机和电脑不在同一网段。逐条排掉才通。

监听地址 · 防火墙 · 网段
06 / 复盘

如果重做,我会改什么

一开始就做服务端分页(现在检索在前端,几千条会卡);先写接口测试再写业务(25 条用例全是我手点的);图片别存本地磁盘,换服务器就丢。

测试 0% → 补测中

Skills

会什么,会到什么程度

按「能独立做完」和「看得懂但没实战」分开写,不夸大。

关于我
能独立完成
HTML / CSS(Flex · Grid · 响应式) 原生 JavaScript(ES6+ · DOM · fetch) Python / Flask 蓝图 MySQL 建表与基础优化 Git 分支与协作流程 Linux 常用命令 / Nginx 反代
做过但不多
Vue 3(组合式 API,写过两个小页面) Session / JWT 鉴权 浏览器 Performance API 正则与表单校验
正在学
React / Next.js App Router TypeScript 计算机网络(自顶向下方法) 测试:Vitest

Read The Code

想看实现细节?

案例页有表结构、状态机、接口约定和性能优化的完整过程。实验室里能直接跑起来。