神马排班 CrewBoard — 团队资源排程与工时管理系统

核心功能亮点

CrewBoard 通过极简、高性能的前后端架构，实现了传统排班软件难以企及的流畅体验与高开发灵活性。

可视化排程日历

直观的周/月日历视图。支持添加项目小时预订，通过不同的颜色代表不同的项目与状态，完美支撑跨项目人力调配。

实际工时追踪 (Timesheets)

支持员工每天按项目填报实际耗时。提供「从排程复制」的快捷功能，将规划工时一键转为实际填报，极大地简化日常报工流程。

多维度报表分析与 Excel 导出

内置人员饱和度与利用率计算，以及项目累计投入分析。支持多 Sheet 高格式的 Excel 导出，方便向决策层和财务团队汇报。

人员与项目库配置

快速建立客户、项目库以及团队资源的匹配。管理员可以通过专属色标、部门/团队分类来标识人员，便于在大团队中快速过滤和查找。

多租户与权限体系

基于企业代码隔离多企业数据。拥有 Admin（全权所有者）、Manager（创建/编辑负责项目）、Basic（只读查看自己排程）三级角色控制。

休假联动与节假日更新

人员休假计划在排程日历上智能体现。系统集成了年度节假日抓取脚本，每年 12 月自动抓取下一年的法定节假日与调休，排班永不冲突。

快速上手指南

CrewBoard 依靠嵌入式的 SQLite 数据库和无打包的前端设计，使得部署成本极低。请选择您的运行环境：

bash - Local Server

            # 1. 安装项目运行依赖项

            npm install

            # 2. 写入演示数据（包含8名员工、5个项目、跨3周排班和演示账号）

            # macOS / Linux / Git Bash

            SEED_DEMO=1 node server.js

            # Windows CMD

            set SEED_DEMO=1 && node server.js

            # 3. 启动本地开发服务 (默认访问 http://127.0.0.1:3000)

            npm run dev

            # 演示账号: admin@company.com / 密码: admin123
          
            # 1. 在生产环境，安装 Node 进程管理器 PM2

            npm install pm2 -g

            # 2. 启动 PM2 守护进程 (使用 fork 模式启动避免 SQLite 并发写锁)

            npm run pm2:start

            # 3. 优雅热重载服务 (实现零停机拉取代码更新)

            pm2 startOrReload ecosystem.config.js --update-env

            # 4. 查看服务运行状态

            pm2 status crewboard
          
            # 在 Nginx 配置文件中加入对 API 接口和 SSE 同步长连接的代理：

            location /api/ {

                proxy_pass http://127.0.0.1:3000;

                proxy_http_version 1.1;

                # SSE 长连接核心参数，防止超时断开

                proxy_set_header Connection "";

                proxy_read_timeout 3600s;

                proxy_buffering off;

                proxy_cache off;

            }