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

核心功能亮点

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

可视化排程日历

直观的周/月日历视图。支持添加项目小时预订，通过不同的颜色代表不同的项目与状态，更有极致统一的悬停高亮交互与轻量化紧凑设计的修改预览，完美支撑跨项目人力调配。

工作范围细分 (Scopes)

支持将项目拆分为多个工作范围（如前端、设计、测试等）。排程与工时填报可精确追踪到工作范围，实现细颗粒度的人力管控。

实际工时表 (Timesheets)

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

多维度报表与下钻分析

内置人员饱和度与利用率计算。项目工时表支持按人员和工作范围（Scope）双维度进行下钻（Drill-down）分析，并支持高格式 Excel 导出。

项目协同管理 (Co-management)

管理员可为项目经理分配协同管理项目。副项目经理与主负责人拥有同等排班、工作范围编辑和查看数据报表的权限，便于团队协作。

多租户与时区体系

基于企业代码隔离数据。拥有 Admin/Manager/Basic 三级角色。支持企业统一定时区管理（如北京/东京/伦敦/纽约/UTC），使创建与更新记录的时间展示完美对齐。

休假联动与节假日更新

人员休假计划在日历上智能体现。自动抓取下一年节假日，并支持一键为团队成员录入指定时间段内所有周一至周五的法定假期，排班录工更省心。

IM 协同与企微深度同步

集成微信/钉钉/飞书群机器人，发生排班变动即刻发送群消息。同时支持通过自建应用一键同步企业微信的组织架构并推送个人卡片通知。

快速上手指南

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;

            }