每周总结02

学习时间7小时 写代码时间11小时
本周完成的工作

本周主要推进了三个方向：公文流转系统前端演示开发、教学平台功能完善，以及科目一理论学习。

公文流转系统方面，我在本地搭建了一个基于 Vue 3 + Vite + Element Plus 的 Web 前端演示系统，实现了统一后台布局和基于角色的菜单权限控制，共完成十个预设账号和十七个页面的开发。核心业务流程已全部跑通，涵盖部门拟稿、办公室修改流转、副厂长审核、厂长审签、办公室发送和部门签收，全部接收部门签收后公文状态自动变更为已完成。系统使用 Pinia 配合本地存储实现演示数据的持久化，并补充了项目说明文档。

教学平台方面，这是一个已经从前端演示升级为实际可运行系统的项目，技术栈为 Node.js + Express + MySQL，当前运行在本地三千端口。教师端功能已较为完整，包括课程班级管理、学生手工添加与批量导入、自动与手动分组、多步骤任务与模板管理、任务发布归档、材料包上传与在线预览、学生进度查看与评分反馈、同伴互评管理、课堂实时事件监控、AI 服务配置等。学生端支持账号登录、课堂链接进入、任务提交与草稿保存、截止时间与字数校验、引导式 AI 对话、多轮互评、查看教师反馈等。管理端实现了账户管理、角色分配、研究授权与数据导出等功能。

此外，我还利用碎片时间推进了科目一题库的学习和练习。

遇到的问题及解决

公文系统开发中遇到的首要问题是设计文档为特定格式且原始路径包含中文，直接用脚本读取出现编码错误，解决方式是将文档复制到工作目录下再解析。本地搜索命令曾被系统拒绝执行，改用 PowerShell 的 Select-String 替代。自动化测试时 Playwright 自带依赖不完整，在项目内安装开发依赖并指定本地浏览器通道后解决。业务逻辑方面，发现流转日志刷新后不完整的 bug，原因是有操作未统一持久化，在日志新增方法内统一执行持久化后修复。流程配置没有真正参与审核人推荐的缺陷也已修正。发送公文时旧回执残留的问题通过同步清理未选中接收人记录解决。查询功能从仅支持拟稿机构筛选扩展为同时支持拟稿和接收机构。

教学平台方面，本机没有安装 Docker，执行容器编排命令失败，改用本机已安装的数据库服务直接连接。三千端口曾出现访问失败，排查后确认是旧进程占用，终止旧进程后重启解决。项目早期只有静态演示数据，后续增加了完整接口、数据库和权限控制。任务页面在中等屏幕宽度下出现严重布局错位，标题被压缩成逐字竖排，已为任务卡片实现独立响应式布局并验证多种分辨率。图标库原来从远程加载，外网不可用时阻塞本地脚本，已改为本地依赖。研究快照人数统计因过滤逻辑导致总数偏小，调整查询后队列总人数与参与人数分别计算。多轮互评在学生端显示不完整的问题也已修复，现已显示轮次信息。

下周计划

下周的首要目标是推动公文系统进入后端与数据库阶段，计划搭建基于 Node.js + Express 的后端项目结构，设计并创建数据库表包括用户、角色、部门、公文、流转记录、签收回执、权限和流程配置，实现真实登录认证、权限校验，并将前端模拟操作全部替换为接口调用。教学平台方面，下一阶段应从功能完整转向正式课堂试用，配置真实 AI 服务地址，完善数据库备份与监控机制，整理正式部署和使用手册。同时继续推进科目一的学习进度，争取完成全部题库练习并开始模拟考试。