从配置到工程:学生请假审批系统的 pro-code 重构与故障复盘

Kant
Kant Lv.1 新人创作者

Lv.1 新人创作者

在十月的时候,我在社区写过一篇帖子,记录怎么用多维表和灵犀结合快速搭建学生因病缺勤登记系统。多维表格本身也不怎么需要代码,依靠字段、公式、视图和收集表完成。

严格说这不叫重构,因为原系统没有留下任何可复用的代码,实际是重写。之所以用词,是因为真正花时间的不是敲代码,而是逐环节判断哪些保留、哪些推翻,依据现实世界的需求思考业务逻辑如何关联。

多维表格已经能满足绝大部分的应用场景,这是无可否认的事实,除了写论文等等特殊场景的需求,我校几乎所有老师日常都使用WPS,而多维表格在学工管理方面能够落地非常多的应用项目。在之前使用WPS多维表格尝试接入请假销假这种高频业务流动场景的时候,我们发现,方便的点在于:有官方背书;有新增的申请数据可以及时通过官方小程序、公众号通知处理工单,这是最便利的一点,因为即便自建SQLite,通知的触达也是个大问题——教育类应用会触发前置审查。

本帖接着之前的多维表格,再和大家分享一下利用云犀和大模型的能力自建业务系统的历程。以下的分享是依据我校学工管理的现实需求写成,会有个别比较个性、特殊的需求。

一、起因:三处约束缺位

最麻烦的一处是状态约束。

目前请假单有六个状态:待审批、已通过、已驳回、待销假、已销假、逾期。多维表能记录状态,也能按状态建视图,但拦不住非法转移。学生在上一张单未销假时提交新单,表里两条记录并存,没有任何机制阻止;班主任把逾期单继续往下批,系统同样不干预。这类约束在制度文本里写得很清楚,落到表结构上就消失了。

第二处是对账。请假销假走一个表格,因病缺勤又走另一个收集表,两边没有主键关联。月底统计时缺勤天数偏大,只能逐条核对。数据本身没错,缺的是两个系统之间的引用关系。(后来添加了关联,将一切病假记录同时登记为因病缺勤)

第三处是口径变更。上级调整疾病分类后,主表公式、统计表公式、仪表盘维度要同步改。改完还会遇到另一个问题:公式字段修改表达式后,存量记录不重算,只有新记录走新逻辑。变通办法是删掉字段重建,让全量记录重新算一遍。

三处问题性质不同,结论指向一处:多维表在「记录」这一层做得足够好,在「约束」这一层能力有限。它承担了大部分工作量,剩下的部分恰好是流程类系统最要紧的部分。

二、划分边界

在实际动手之前做了一次逐环节评估:

环节

留在多维表

搬到 H5

学生名册维护

✅

🔴

每日缺勤填报

🔴

✅

请假发起

🔴

✅

多级审批

🔴

✅

销假与逾期核销

🔴

✅

病假材料留存

🔴

✅

缺勤统计导出

🔴

✅

其中两条是硬指标:数据结构是否稳定、是否需要拦截非法操作。第三类(材料留存)介于两者之间——它本身不需要状态机,但需要文件级授权,而表附件的权限粒度不够用。

按这套标准,我们将学生名册留置在WPS中进行维护;请假到销假(含因病缺勤登记)整条链路,以及由它派生的统计导出,搬出来做。

三、技术选型

一共分为四层。

nginx 负责 TLS、静态资源和入口限流;gunicorn 以多线程监听回环地址;Flask 同时承担服务端渲染和 JSON 接口;数据落在 SQLite 单文件。

没有上云数据库,理由是量级不匹配。一千七百余名学生,一学期可能不到一千条请假记录,读写比高,按照之前多维表格的情况来看写入集中在早晨。SQLite 在这个量级不存在性能问题;引入云数据库要多付一个网络依赖、一套连接池配置,以及一份可能出现的不一致。这套系统上一次因数据库不可用而中断是什么时候,我一时想不起来——这本身就是不引入远程依赖的理由。

没有做前后端分离,原因在迭代成本。三个角色三套页面,数据基本一次取全,交互集中在表单提交和列表翻页。服务端渲染加少量原生 JS,改完保存即生效,不需要构建、不需要发布流程、也不需要处理前后端版本对齐。一个人维护的项目,工具链长度直接决定故障面。

单机的代价要说清楚:没有横向扩展,也没有故障转移。并发再上一个量级,或者要支持多校区多实例,这套架构就得推翻重来。按现在的规模它够用,而且出问题时排查路径短——日志、代码、数据库都在同一台机器上。

四、流程与几处刻意的克制

目前业务有四个环节:学生发起、班主任审批、学生科复核、销假核验。

三个入口,学生端和班主任端是 H5,管理端是桌面版,当然也都做了手机版和PC版的界面适配,这个让灵犀去做就行了。

流程本身不复杂。值得记录的是砍掉的那几处设计,做减法比加功能难。

代学生发起是班主任提的需求:学生生病在家,未必有条件操作手机。功能做了,但没加「学生二次确认」。我们对这个业务模块的兜底依据是追责链路——工单上记录了代发起人,后台可查,出了问题找得到责任人;加一步确认,等于要求学生带病打开手机点一下,把老师的好意抵消掉。(也会有旷课的学生,不回信息、不接电话,那为了保证老师的一些合理的权益,就让他在上面给他记上旷课,而不会被记录成因为老师的原因导致的缺勤)

逾期处理也改过两次。第一版是只提醒不拦截,结果逾期单持续堆积,没人清;第二版改成硬阻塞,一张逾期单就能卡住整个班级的其他审批。现在只拦「通过」这一个动作,驳回、确认销假、补办销假全部放行,逾期清完之后正常流程自动恢复。另外给长期未归的情况留了出口:选「旷课未返」结案,不再计入逾期,同时解除班级锁定。

这两处的共同判断落在拦截位置上:约束应该加在会产生错误结果的节点,不该加在会让人放弃使用系统的节点。

五、故障复盘

下面六个问题有个共同特征:失败是静默的。不抛异常、不写错误日志、不返回非 200,功能只是不生效。这类问题用桌面浏览器加刷新自测,几乎存在必然漏过的问题。

  1. 静态资源缓存导致的前后端错配

改完 h5.js 部署上线,本机刷新一切正常。但是次日班主任反馈某个按钮点了没反应。

排查按接口、网络、终端的顺序走了一遍,服务端日志全是 200。最后确认是静态资源命中本地缓存:/static/ 设了七天过期,页面 HTML 更新了,JS 还是七天前那份。两边函数名对不上,事件绑定落空,点击既不跳转也不报错。

改了两处。模板引用统一带版本参数;部署脚本增加一项校验,静态文件的修改时间与模板中的引用版本不一致时中止发布。

  1. 安全策略转正,登录按钮静默失效

内容安全策略从 Report-Only 转正式之后,登录页按钮失效。原因是页面里还有内联脚本,严格策略直接把它们拦了。被拦截的脚本不产生任何用户可见提示,只在控制台留一行报告——学生看不到控制台,只会说「点不动」。

整改范围比预想的大:二十余个内联脚本块、约 195 KB 需要外置;其中八处含模板变量的,改用 data 属性注入 JSON;一千三百余处内联事件改为事件委托,全站收敛到单个监听器。现在正式策略全站生效,只在少数路径保留观察模式,当作新页面的探测器。

这里的教训其实与安全配置无关,是验收方式:桌面浏览器加刷新不能作为安全策略转正的验收手段,必须在真机上把完整流程走一遍。

  1. 备份文件存在,但是却打不开

这个问题的麻烦在于,它不会自己暴露。

备份脚本原本只有一条 cp。文件每天按时生成,大小看着正常。直到一次恢复演练,才发现拷出来的库根本打不开。

原因是数据库使用回滚日志模式,写事务进行中直接复制文件,会拷到写了一半的页面。备份看起来成功,实际是废的。

改成 VACUUM INTO 生成一致性快照,快照后立即执行完整性检查,不通过就保留现场并以非零码退出。宁可备份任务失败触发告警,也不要留下一个形式正确的坏备份。顺带调整两处:备份文件权限收到 600、目录 700(原来是所有本地账户可读);备份与数据库分离到不同位置,避免一块盘故障同时丢掉两份。

  1. 弹窗里点取消,整个表单被关掉

老师在详情弹窗中点「补办销假」,上传完材料,原先填好的表单被清空,弹窗自己关了。

查后端日志,那次请求的字段确实是空的,说明提交之前状态就已经丢了。

定位到公共的图片选择组件:它把拍照/相册选择层挂载到主弹窗容器,关闭时调用统一的遮罩关闭函数。这个组件在详情页用了很久都没问题,因为在那儿它本身就是最外层;只有从表单内部调用时,关闭动作才作用到调用方身上。

约束很清楚:可复用组件只操作自己创建的节点,不碰调用方容器。「关闭自身」和「关闭整个弹窗」是两个动作,合并实现早晚出事。

  1. sqlite3.Row 没有 .get()

后台某页面偶发 500。

查询结果从字典改为 sqlite3.Row 之后,代码里沿用了 row.get("字段")。字典有这个方法,Row 只有下标访问。主流程测过,恰好没覆盖到那条分支。

接口的返回结构一变,就得按全部消费方回归。最后靠端到端测试兜住:关键流程走真实路由,跑在数据库副本上。

  1. 配置写了,但没有生效

这一节里唯一不需要看代码的问题。

站点全路径都带 HSTS,唯独一条路径没有。翻配置发现那条路径确实写了响应头,问题正在于此——nginx 的 add_header 不具备继承性,子级一旦出现该指令,父级所有响应头整体失效,不是叠加。原本用它控制缓存,顺带把安全头一起关掉了,换成 expires 后恢复正常。

同类情况在 SSH 加固时出现过一次。配置文件的前缀写 00- 还是 99- 有区别:同一参数取首次出现的值,写成 99- 会被更早加载的云初始化配置整体覆盖。文件在那儿,规则一条没生效。

所以这类问题的排查顺序应该反过来:先确认配置有没有被读进去,再去查配置内容。

六、上线后的修补

我们的愿景是能交给老师和学生也能轻松上手。

ICP 备案与公安联网备案都办了,管局审核也挺快的,一共不到8天时间

传输层全站HTTPS,HSTS先设三十天观察,确认没有子域和老设备问题后提到一年;不加 includeSubDomains,也不提交预载列表——校内的老设备数量比预期多。

材料的访问控制改过一次。病假证明这类图片,原先靠文件名随机性保护,URL一被转发就等于泄露。后面改成后端签发带时效的签名地址,页面渲染时下发,直接访问裸地址返回403。

我在登录做了入口限流,但有个前提必须先说清楚:全校共用同一个出口IP。阈值设小了,一个班同时登录就会被误伤。实测连续八十次POST到登录接口,放行六十八次,正常使用不受影响。这条防护只能提高爆破成本,区分不了校内的攻击者和学生,账号级锁定得在应用层另做。

「记住密码」功能也修改过。原实现是把密码base64后写进localStorage,等同明文存储。改成只保存账号,并在读取旧结构时主动删掉残留的密码字段。

七、运行数据

系统运行至今累计处理936张请假单(截至11月10日),覆盖一千七百余名学生、三十四位班主任,数据库共十九张表。

请假类型分布上有明显季节性,病假请假量集中在换季那几周。知道这个规律后,学期初排值班、备材料就有依据,不必等报上来再手忙脚乱。

导出环节修正过两次。第一次是疾病名称匹配:用关键词自动匹配上级代码时,「过敏」「贫血」「痛经」三个词被错配进「其他传染病」。这个错误如果不改,报上去的数据就是失真的。现在这三个词按原文显示,「其他」「原因不明」统一记为未分类,不计入传染病。

第二次是去重键。原按「姓名+日期」去重,同班有两个同名学生的,同一天只保留一条,统计人数少一人。改成按学号区分后,与手工核对一致。

八、几点结论

低代码和自研之间的边界,判断标准可以收成三条:数据结构稳定、参与人少、只增不改的,留在平台;有状态流转、需要拦截非法操作的,自建;有材料留存、需要分级授权的,自建。

上一篇里我的角色是配置者,AI负责查文档、写公式。这一篇里角色变成需求方和验收方,代码由AI产出。

难度没有降低,只是转移了位置。AI不会怀疑自己的产出:静态资源不加版本号,它不会提醒我「老师手机上可能是旧版」;策略转正式,它不会提醒我页面里还有内联脚本;备份用 cp,完全符合「备份」两个字的字面含义。这些问题都不报错,只是安静地不生效,直到真人来点。

写这一侧的门槛确实降下来了。验这一侧没有捷径,只能靠真实数据、真实设备和真实用户操作。

没做好的地方一并列出:

  • 权限模型按单校区写死,多校区多学段要重做

  • 审计只覆盖登录和审批动作,字段级变更没有留痕

  • 弱网体验一般,分页和轮询间隔调过两轮,仍不理想

目前的定位手段是三样:nginx 与应用日志、跑在数据库副本上的端到端测试、以及每次发布前的真机验收。缺任何一样,上面六个问题里至少有三个查不出来。

广东省
浏览 100
收藏
点赞
分享
+1
1
+1
全部评论 1
 
Kant
Kant Lv.1 新人创作者

Lv.1 新人创作者

关于通知触达的问题,最后用邮箱的SMTP解决了。定时或积攒到一定请假销假工单数量的时候就会自动发送到预设好的对应的老师邮箱,提醒其及时处理。
   广东省
举报
0
0