共享出行企业智能运营平台产品系统

共享电动车运营企业的人员、考勤、计件、薪资、进销存、能源数据原先分散在 Excel、微信群和多个孤立系统，考勤与工资靠人工逐月核对，数据来源与规则版本无法追溯，管理层拿不到可信的经营口径。项目目标是建立一个统一的企业内部运营平台：所有事实有来源、状态可解释、权限可验证、关键操作可审计。

覆盖 20+ 业务域：工作台、人员档案、考勤管理（月度考勤网格、异常标记、试岗规则）、计件管理、薪资管理（工资周期、模板、员工绑定）、进销存、能源运营、数据中心、审批中心、异常中心、导出中心、自定义报表、定时自动报告、月度结算与月报数据管道、知识库、通知、系统日志与系统设置。

AI 能力：统一 AI Gateway 接入，自然语言查询与报表草案生成（AI 仅出草案，由确定性执行器执行，核心业务不依赖大模型运行）。

集成：钉钉 H5 免登、钉钉考勤读取、库存系统对接。

权限：后端强制校验 + 主体/公司白名单，前端隐藏按钮不构成授权，关键操作写入审计。

架构：Monorepo（Web / API / Worker 三应用 + 共享包）。后端 FastAPI + SQLAlchemy +Alembic 模块化单体，前端 React + TypeScript + Vite，后台任务 Celery + Redis，核心数据 PostgreSQL 16，分析数据 ClickHouse，文件走 S3 兼容存储（MinIO）。

工程化：Docker Compose 部署 + Nginx 反向代理 + CI 流水线 + 每日备份与每周恢复校验；运行时版本锁定（Node 24 / Python 3.12 / PostgreSQL 16 / Redis 7），不一致不允许发布；159 个测试文件覆盖 API、Worker 与端到端。

关键难点：
1. 月度考勤网格按业务月生成 1..N 天，姓名/岗位固定列宽，旧标记在输入边界归一化；
2. 工资模板与员工绑定，试岗规则启用时禁止删除，停用后方可删且删除前写快照审计；
3. 权限默认拒绝并在后端执行，跨域数据按来源域复判权限；
4. 会话存储 Redis 化并显式失败，避免静默降级为内存态。