值班系统 v1.1.0更新日志 (CHANGELOG)

本项目值班排班管理系统的版本更新记录。本文件遵循 [Keep a Changelog] 风格，日期格式为 YYYY-MM-DD。

[v1.1.0] - 2026-08-24

更新摘要

基于 v1.0.0 值班排班管理系统，本次 v1.1.0 版本新增「页面加载自动跳转当前月份」与「人员名称自定义 + 浏览器 localStorage 持久化」两项功能，涉及全栈改动。共修改 5 个文件，新增 479 行代码，删除 41 行代码（提交哈希：4696ac6）。

新增功能

1. 页面加载自动跳转当前月份

• 修改前：页面固定显示 1 月排班，用户需手动切换到当前月份。
• 修改后：页面加载时用 new Date() 自动定位到当前年份和月份，打开即看到本月排班。
• 涉及文件：static/js/app.js
• 实现要点：
  • currentYear 和 currentMonth 改为从 new Date() 动态获取；
  • 新增 initYearSelect() 函数，确保当前年份在下拉框中并自动选中。

2. 人员名称自定义 + 浏览器 localStorage 持久化

• 修改前：人员姓名硬编码在代码中，无法自定义。
• 修改后：用户可通过「👥 人员设置」模态框修改固定 6 人 + 额外 2 人的姓名。
  • 自定义名称保存在浏览器 localStorage（key：scheduler_custom_people），刷新不丢失；
  • 不同用户各自浏览器独立存储，互相不会冲突。
• 涉及文件：全栈（scheduler.py、app.py、index.html、app.js、style.css）
• 实现要点：
  • 后端：Scheduler 类新增 fixed_people / extra_people 可选参数；API 接受自定义人员名参数；缓存 key 包含人员姓名以避免冲突。
  • 前端：新增 loadPeopleConfig() / savePeopleConfig() 读写 localStorage；请求排班时传自定义姓名；模态框交互（打开 / 保存 / 重置 / ESC 关闭）。

技术细节

• scheduler.py：FIXED_PEOPLE / EXTRA_PEOPLE 改为 DEFAULT_FIXED_PEOPLE / DEFAULT_EXTRA_PEOPLE；Scheduler.__init__ 接受可选参数；算法内部全部改用 self.fixed_people 等实例属性。
• app.py：新增 _normalize_people() 校验人员数量；缓存 key 从 year 改为 (year, tuple(fixed), tuple(extra))；/api/schedule 用 query params 传人员名，/api/regenerate 用 JSON body。
• app.js：新增 initYearSelect()、buildScheduleUrl()、人员模态框全套交互逻辑。
• index.html：新增人员设置按钮和模态框 HTML 结构。
• style.css：新增 179 行模态框样式（遮罩层、弹窗、输入框、按钮），与现有渐变主题一致。

文件变更统计

变更文件清单

• scheduler.py
• app.py
• templates/index.html
• static/js/app.js
• static/css/style.css

[v1.0.0] - 初始版本

值班排班管理系统初始版本，提供按月生成值班排班、月份 / 年份切换、排班算法等基础功能。