实战复盘：基于Vue3+Flask的教务排课与劳务核算系统开发记录

#创作灵感# 记录工作实践、项目复盘 | 写技术笔记巩固知识要点 | 独立开发者产品分享

最近终于把手头的这个教务ERP系统熬到了v8.7版本，基本稳定下来了。

做这个东西的初衷是因为接触到一些教育培训机构，发现他们在线下排课、代课考勤，特别是月底算老师工资（涉及底薪、不同课程的代课费、梯度扣税等）时非常繁琐，人工核算极易出错。为了解决这些实际痛点，我花了不少时间打磨了这套系统。这里简单做个技术复盘，聊聊架构设计和踩过的一些坑。

一、 技术栈与轻量化架构选型

选型思路上，核心诉求是轻量、极简部署。很多线下机构没有专业的服务器，软件往往只能跑在普通的Windows前台电脑上。

• 前端： Vue 3.0 + Tailwind CSS。直接走 CDN 引入，免去了 Node.js 编译打包的麻烦，极大降低了客户机的环境要求，同时保留了现代化的响应式交互体验。

• 后端： Python 3.11 + Flask + concurrent.futures。

• 存储方案： 考虑到使用场景和部署成本，我放弃了 MySQL 和 Redis，直接采用本地 JSON 切片存储加上内存缓存。为了防止多端并发操作时把 JSON 文件写坏，我在底层加了 I/O 锁和异步队列来保证数据的绝对安全。

二、 几个关键技术点的实现思路

在一个人包揽前后端的过程中，遇到了几个比较典型的技术挑战，分享一下我的解决思路：

1. 面向非技术人员的“一键部署”脚本

给教务老师用的系统，不能指望他们会配环境，必须做到双击即用。所以我花了不少精力写了一个 start.bat 脚本：

• 环境检测与自动拉取： 脚本会自动检测 Python 环境。如果没有，会通过 Powershell 下载安装包。为了防网络波动，我写了华为云、阿里 NPM 镜像和 Python 官方三大节点的降级切换机制。

• 静默挂载： 通过 /quiet InstallAllUsers=0 PrependPath=1 参数实现后台静默安装，并热重载环境变量。客户基本只需双击鼠标，所有依赖就能自动配置好。

2. 本地JSON的高并发读写与队列锁

因为没用传统关系型数据库，直接操作本地 JSON 文件在遇到高频点击时很容易出现文件撕裂和脏数据。 解决办法是在后端单开了一个异步 I/O 写入队列守护进程：

# 核心思路展示（非全量代码）
class AsyncIOWorker(threading.Thread):
    def __init__(self):
        super().__init__(daemon=True)
        self.task_queue = queue.Queue()

    def run(self):
        # 守护线程持续监听队列
        while True:
            task_type, payload = self.task_queue.get()
            if task_type == 'month':
                # 原子级硬写盘，先写入 .tmp 文件，再 os.replace 覆盖
                self._write_json_atomic(...) 
            self.task_queue.task_done()

前端高频触发保存时，后端会直接把写盘动作压入 task_queue。守护线程在后台从容地进行文件原子级替换（先写临时文件再替换原文件）。实测下来，吞吐量和并发安全性都达到了预期。

3. 断网环境下的前端脱机降级

线下机构网络经常不稳定，但业务数据不能丢。 我在 Vue 的网络请求拦截层加了逻辑：一旦检测到后端宕机或断网（ping 接口失败），系统会自动无缝切换至本地脱机模式。业务逻辑会转而接管浏览器的 localStorage 继续运作。为了防止存储溢出，还手写了一个基于时间戳的 LRU（最近最少使用）机制来定时清理旧数据。

三、 核心业务场景与效果展示

1. 排课表交互与冗余清理

前端手搓了类似 Excel 的交互体验（支持表头和左侧列冻结）。 排课逻辑里有个比较隐蔽的需求：当一门常规课程被修改或提前结课后，用户下次点击“一键智能排课”时，后端会根据底层追踪的关联 ID 自动扫描，将未来失效的“幽灵数据”清剿干净，同时严格保留已经发生的历史考勤印记。

(交互上支持双击快捷填充、多人联授配置以及临时插课覆盖)

2. 多线程的代课薪资核算

算工资是业务里最容易绕晕的地方。我在后端用 ThreadPoolExecutor 开辟了多线程池来跑核算逻辑。 这里的核心算法在于区分“直属授课”与“临时代课”。如果系统识别到某节课是代课老师上的，会自动穿透遍历该门课程的历史档案，提取该班级原讲师中最高的薪资标准赋予这位代课老师（即代课按最高标准结算），随后自动计算个税，并生成详细的脱机审计日志。

(生成可视化月度财务对账单，支持导出 CSV 进行归档)

3. 全量数据快照与恢复

提供了一个类似数据时光机的功能，可以一键将全校、所有历史月份的数据打包为物理 JSON 快照下载。遇到严重误操作时，可以导入快照逆转恢复。

四、 写在最后

一个人从头到尾搓完这套系统，确实把前后端、并发存储甚至税法计算的坑都踩了一遍，不过看到系统能在实际场景里跑起来解决问题，还是挺有成就感的。

由于代码包含了我个人的核心业务逻辑和算法实现，暂时不考虑完全开源，仅提供有偿源码。

如果您对具体的实现细节（比如多级薪资匹配算法的具体代码、前端纯本地存储设计）感兴趣，或者恰好有教务排课、讲师薪资核算等定制化开发的需求，欢迎交流探讨。

联系方式：

• 微信号：_Violet--Evergarden

• (添加时请备注：CSDN 教务系统)