# 劳动用工合规助手 — 需求规格说明书 > **文档编号**: 0-req.md > **版本**: v2.0 > **日期**: 2026-07-23 > **状态**: 草案 > **修订**: v2.0 — 面向中小企业优化 UI/UX 与交互逻辑，强调极简易用 > **修订**: v3.0 — 升级为 SaaS 多租户架构，支持注册登录/多用户/云端存储 --- ## 1. 背景与问题分析 ### 1.1 劳动仲裁高发领域 根据司法大数据及各地仲裁委公开统计，劳动争议仲裁案件集中在以下三大领域，占比超过 **85%**： | 领域 | 典型争议点 | 占比（约） | |------|-----------|-----------| | **劳动合同签订** | 未签书面合同（双倍工资）、逾期签订、到期未续签、违法约定试用期 | 30% | | **工资与加班费** | 拖欠/克扣工资、加班费计算基数错误、未支付加班费、未足额支付 | 35% | | **解聘/离职** | 违法解除劳动合同、未支付经济补偿金/赔偿金、程序不合规、未提前通知 | 20% | ### 1.2 中小企业特殊痛点 - **没有专职 HR**：很多中小企业由老板或行政兼任，完全不懂劳动法 - **Excel 都嫌麻烦**：现有管理方式靠记忆和纸质文件，连 Excel 都没用好 - **请不起法律顾问**：遇到问题不知道找谁，也不知道合不合规 - **系统太复杂学不会**：市面上的 HR 系统功能太多，上手成本高，中小企业用不起来 - **怕出事但不知道怎么防**：知道劳动仲裁麻烦，但不知道从哪里开始预防 ### 1.3 系统定位 构建一个 **中小企业也能用起来的极简用工合规工具**： 1. **像计算器一样简单** — 打开就能用，不需要培训 2. **像导航一样引导** — 该做什么、怎么做，一步步引导 3. **像警报器一样提醒** — 有风险自动弹窗，不怕遗漏 4. **像顾问一样解释** — 每个风险都附上法律依据和操作建议，不用自己查法条 --- ## 2. 目标用户 **核心用户**：中小企业老板 / 行政兼 HR / 初级 HR | 用户画像 | 典型场景 | |---------|---------| | **老板兼管 HR**（10-30人企业） | 偶尔打开看看有没有风险，解聘时算一下补偿金 | | **行政兼 HR**（30-80人企业） | 每天花5分钟看看待办，合同到期前续签，每月算加班费 | | **初级 HR**（80-200人企业） | 日常合同管理、工资计算、解聘流程走查 | **用户特征假设**： - 不懂劳动法，需要系统主动告知合规要求 - 不愿看长文，偏好"告诉我该做什么" - 可能第一次用类似系统，需要新手引导 - 手机/平板也会用，不能只考虑桌面端 --- ## 3. UI/UX 设计原则 ### 3.1 核心原则：三看三不用 | 原则 | 含义 | 设计要求 | |------|------|---------| | **看一眼就懂** | 不需要说明书 | 每个页面标题用大白话，不用法律术语 | | **看一眼会点** | 知道下一步做什么 | 每个页面有且只有一个主操作按钮（蓝色高亮） | | **看一眼放心** | 知道当前状态 | 用红/黄/绿三色信号灯表示风险状态 | | **不用记法条** | 系统自动判断合规 | 风险自动检测，附人话版法律解释 | | **不用手算** | 系统自动计算 | 输入最少信息，自动算出结果 | | **不用怕漏掉** | 系统主动提醒 | 到期/风险自动弹窗 + 角标提醒 | ### 3.2 交互设计规范 **信息层级 — 渐进式披露**： ``` 第一眼：看到什么 → 数字 + 信号灯（绿/黄/红） 第二眼：想知道为什么 → 点击展开风险说明 第三眼：想知道怎么办 → 展开操作建议 + 法律依据 ``` **操作流 — 一屏一焦点**： - 每个页面只做一件事，不堆砌功能 - 主操作按钮固定在视觉焦点位置（右上角或底部居中） - 次要操作收起在"更多"菜单中 - 表单分步填写，一屏不超过 5 个输入项 **视觉语言 — 信号灯体系**： | 颜色 | 含义 | 使用场景 | |------|------|---------| | 🟢 绿色 | 合规/正常 | 合同在签、工资正常、无风险 | | 🟡 黄色 | 需关注 | 合同即将到期、加班超时、待处理 | | 🔴 红色 | 有风险 | 未签合同、到期未续签、违法解聘 | | ⚪ 灰色 | 不适用 | 离职员工、已完成事项 | **文案风格 — 说人话**： | ❌ 法律术语 | ✅ 人话版本 | |------------|-----------| | 「依据《劳动合同法》第82条」 | 「入职1个月没签合同，员工可以要求双倍工资」 | | 「经济补偿金N」 | 「需要赔 X 个月工资，共 ¥XX,XXX」 | | 「非过失性解除」 | 「员工没犯错但要辞退」 | | 「法定节假日300%」 | 「国庆节加班1天 = 平时3天工资」 | ### 3.3 新手引导 - **首次打开**：3 步引导弹窗（"这里看风险"→"这里管合同"→"这里算钱"） - **空数据状态**：展示示例截图 + "添加第一个员工"按钮，不让用户面对空白页 - **关键操作前**：简短提示卡片（如解聘前提示"建议先咨询律师"） --- ## 4. 功能需求 ### 4.1 模块总览 #### 当前版本（v1.0 — 劳动合规基础 + AI 顾问 + 员工参与） **管理端（HR/老板使用）**： ``` ┌──────────────────────────────────────────────────────────────┐ │ 劳动用工合规助手（管理端） │ ├───────────┬──────────┬──────────┬──────────┬────────────┬─────┤ │ 风险总览 │ 合同管理 │ 钱的计算 │ 解聘助手 │ AI合规顾问 │设置 │ │ (首页) │ │ │ │ │ │ │ 红黄绿信号灯│ 员工合同 │ 加班费 │ 补偿金计算│ 智能问答 │企业 │ │ 待办清单 │ 到期提醒 │ 双倍工资 │ 合规检查 │ 风险预测 │用户 │ │ 一句话风险 │ 一键续签 │ 经济补偿 │ 流程引导 │ 合同审查 │套餐 │ │ AI风险预测 │纸质/电子 │ │ │ 案例匹配 │ │ └───────────┴──────────┴──────────┴──────────┴────────────┴─────┘ ↓ 所有风险汇总到首页 ↓ ``` **员工端（员工使用，独立入口）**： ``` ┌──────────────────────────────────────────────┐ │ 员工端（手机号验证码登录） │ ├──────────┬──────────┬──────────────────────┤ │ 工资条 │ 我的合同 │ 入职填报/合同确认 │ │ │ │ │ │ 月度工资 │ 合同信息 │ 扫码填报基本信息 │ │ 加班明细 │ 签订记录 │ 电子合同签署确认 │ │ 确认已阅 │ 下载查看 │ HR审核后入库 │ └──────────┴──────────┴──────────────────────┘ ``` #### 演进路线图 ``` v1.0 (当前) v2.0 (近期) v3.0 (中期) ┌───────────────────────────┐ ┌────────────────┐ ┌──────────────────┐ │ 劳动合规基础 + AI + 员工参与 │ ──→ │ + 社保公积金 │ ──→ │ + 人力成本分析 │ │ 合同/工资/解聘 │ │ 五险一金计算 │ │ 成本报表/趋势 │ │ AI 问答/风险预测/审查 │ │ 缴费基数/比例 │ │ 部门成本/人均 │ │ 员工端：工资条/合同/入职填报 │ │ │ │ │ └───────────────────────────┘ └────────────────┘ └──────────────────┘ v4.0 (远期) ┌────────────────┐ │ + 员工自助门户 │ │ 考勤/请假/调薪 │ │ 在线审批流程 │ └────────────────┘ ``` **精简策略**： - v1.0 聚焦劳动仲裁三大高发领域 + AI 合规顾问 + 员工参与，管理端 5 个页面 + 员工端 3 个页面 - 架构上预留扩展接口，后续模块即插即用，不重构现有代码 - 每个页面最多 2 层深度，避免复杂导航 --- ### 4.2 首页：风险总览（极简版） **目标**：打开就知道有没有事、该做什么 **页面布局**： ``` ┌─────────────────────────────────────────────┐ │ 👋 早上好！今天有 3 件事需要处理 │ │ │ │ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │ │ │ 12 │ │ 🔴 2 │ │ 🟡 3 │ │ ¥8k │ │ │ │ 员工 │ │ 高风险│ │ 待办 │ │加班费│ │ │ └──────┘ └──────┘ └──────┘ └──────┘ │ │ │ │ 📋 今日待办 │ │ ┌─────────────────────────────────────┐ │ │ │ 🔴 张三入职35天未签合同 → 去处理 │ │ │ │ 🟡 李四合同还有20天到期 → 去续签 │ │ │ │ 🟡 王五上月加班48小时超标 → 查看 │ │ │ └─────────────────────────────────────┘ │ │ │ │ 📊 风险分布 │ │ ┌─────────────────────────────────────┐ │ │ │ 合同风险 ████████ 5项 │ │ │ │ 工资风险 ████ 2项 │ │ │ │ 解聘风险 ██ 1项 │ │ │ └─────────────────────────────────────┘ │ └─────────────────────────────────────────────┘ ``` **设计要点**： - 顶部一句话总结：「今天有 X 件事需要处理」，让用户立刻知道是否有事 - 4 个数字卡片：员工总数 / 高风险数 / 待办数 / 本月加班费 - 待办列表：每条一行，红/黄信号灯 + 一句话描述 + 「去处理」按钮 - 风险分布：用简单进度条代替复杂图表，一眼看出哪类问题多 - **无风险时**：显示绿色大勾「✅ 暂无风险，继续保持！」 - **首次使用空状态**：展示「添加第一个员工」引导卡片 --- ### 4.3 合同管理 **目标**：不用记日期，不怕忘签，风险自动提醒 #### 4.3.1 员工合同列表（极简表格） **列表只显示 5 列**（避免信息过载）： | 姓名 | 部门 | 入职日期 | 合同状态 | 操作 | |------|------|---------|---------|------| | 张三 | 技术部 | 2026-06-18 | 🔴 未签合同(35天) | 签订 / 详情 | | 李四 | 销售部 | 2025-08-01 | 🟡 即将到期(20天) | 续签 / 详情 | | 王五 | 财务部 | 2024-03-15 | 🟢 正常 | 详情 | - 状态列用信号灯 + 简短文字，一眼看出问题 - 点击「签订」/「续签」直接弹出表单，不需要进详情页 - 搜索框 + 部门筛选，支持快速查找 - **批量操作**：全选 → 批量续签（适合到期合同多的情况） #### 4.3.2 添加/编辑员工（分步表单） **Step 1 — 基本信息（4 项）**： ``` 姓名 *： [___________] 部门 *： [下拉选择___] 入职日期 *：[日期选择器__] 月工资 *： [___________] 元 ``` **Step 2 — 合同信息（5 项，可跳过）**： ``` 合同类型： ○ 固定期限 ○ 无固定期限 ○ 暂未签订 签订方式： ○ 纸质合同 ○ 电子合同 签订日期： [日期选择器__] 合同期限： [下拉：1年/2年/3年/无固定] 试用期： [下拉：无/1个月/2个月/3个月/6个月] ``` - 如果选「暂未签订」，系统自动标记为高风险并提醒 - 试用期下拉自动校验合法性（选了1年合同但选6个月试用期 → 红色提示） - **智能默认值**：合同期限默认3年，试用期默认1个月，减少选择成本 - **必填项最小化**：只有姓名和入职日期是必填，其他都可以后补 **签订方式说明**： | 方式 | 说明 | 系统支持 | |------|------|---------| | **纸质合同** | 打印后双方线下签字盖章 | 记录签订日期 + 可上传扫描件/拍照存档 | | **电子合同** | 在线签署电子合同（如通过第三方电子签平台） | 记录签订日期 + 可填写电子合同链接/编号 | - 选择「纸质合同」时，显示「上传扫描件」按钮（可选），支持拍照或选择文件上传 - 选择「电子合同」时，显示「电子合同编号」输入框（可选）和「合同链接」输入框（可选） - 两种方式法律效力等同，系统不强制选择，默认为「纸质合同」 #### 4.3.3 合规风险检查规则（后台自动运行） | 规则 | 检查内容 | 信号灯 | 人话提示 | |------|---------|--------|---------| | C-01 | 入职超1个月未签合同 | 🔴 | 「张三入职35天了还没签合同，要赔双倍工资」 | | C-02 | 入职超1年未签合同 | 🔴 | 「超过1年没签合同，法律上等于已签无固定期限合同」 | | C-03 | 合同30天内到期 | 🟡 | 「李四合同还有20天到期，该准备续签了」 | | C-04 | 合同到期未续签仍用工 | 🔴 | 「合同已到期但还在上班，要赔双倍工资」 | | C-05 | 试用期超法定上限 | 🔴 | 「1年期合同试用期最多2个月，当前3个月不合法」 | | C-06 | 试用期工资过低 | 🟡 | 「试用期工资不能低于转正工资的80%」 | | C-07 | 两次固定期限后应签无固定 | 🔴 | 「已经签了2次固定合同，第3次应签无固定期限」 | #### 4.3.4 一键续签 - 合同到期前30天，列表出现「续签」按钮 - 点击后弹出确认弹窗： ``` ┌───────────────────────────────┐ │ 续签李四的劳动合同？ │ │ │ │ 原合同：2025-08-01 ~ 2026-07-31│ │ 新合同期限：[3年 ▼] │ │ 新到期日：2029-07-31 │ │ 试用期：无 │ │ 签订方式：○ 纸质合同 ○ 电子合同 │ │ │ │ [取消] [确认续签] │ └───────────────────────────────┘ ``` - 续签时选择签订方式（纸质/电子），默认沿用上次签订方式 - 续签后自动更新状态为 🟢 正常，风险消除 --- ### 4.4 钱的计算（Tab 切换，一页搞定） **目标**：输入最少信息，立刻算出该赔多少、该付多少 **页面结构**：3 个 Tab，共享一个页面 ``` ┌─────────────────────────────────────────────┐ │ [ 加班费计算 ] [ 双倍工资 ] [ 经济补偿金 ] │ ├─────────────────────────────────────────────┤ │ │ │ （当前 Tab 的计算器内容） │ │ │ └─────────────────────────────────────────────┘ ``` #### 4.4.1 加班费计算器（Tab 1） **界面设计**：左输入右结果，实时计算 ``` ┌──────────────────┬──────────────────────┐ │ 填写信息 │ 计算结果 │ │ │ │ │ 月工资：[8000__] │ 📊 加班费明细 │ │ 元 │ │ │ │ 小时工资：¥46.00 │ │ 工作日加班： │ │ │ [__10__] 小时 │ 工作日 ¥690 (10h×1.5) │ │ │ 休息日 ¥736 (8h×2.0) │ │ 休息日加班： │ 节假日 ¥552 (4h×3.0) │ │ [__8___] 小时 │ │ │ │ ─────────────────── │ │ 节假日加班： │ 💰 合计：¥1,978 │ │ [__4___] 小时 │ │ │ │ ⚠️ 月加班22小时， │ │ [计算] │ 未超36小时上限 ✅ │ └──────────────────┴──────────────────────┘ ``` **交互优化**： - 输入数字后**实时计算**，不需要点「计算」按钮 - 结果区固定在右侧，输入时数字实时跳动更新 - 超过36小时/月时，结果区显示黄色警告 - 可选关联员工：选择员工后自动填入月工资 **计算规则**（后台自动，用户不需要知道公式）： ``` 小时工资 = 月工资 ÷ 21.75 ÷ 8 工作日加班费 = 小时工资 × 1.5 × 小时数 休息日加班费 = 小时工资 × 2.0 × 小时数 节假日加班费 = 小时工资 × 3.0 × 小时数 ``` #### 4.4.2 双倍工资计算器（Tab 2） **界面设计**： ``` ┌──────────────────┬──────────────────────┐ │ 填写信息 │ 计算结果 │ │ │ │ │ 月工资：[8000__] │ ⚠️ 风险提示 │ │ 元 │ │ │ │ 入职日期：2026-06-01 │ │ 入职日期： │ 合同签订：未签订 │ │ [2026-06-01] │ │ │ │ 双倍工资起算： │ │ 合同签订日期： │ 2026-07-02 │ │ [未签订 ▼] │ │ │ 或选择日期 │ 双倍工资截止： │ │ │ 2027-05-31 │ │ │ │ │ │ 💰 需赔：¥88,000 │ │ │ （11个月 × ¥8,000） │ │ │ │ │ │ 📌 法律规定：入职1个月 │ │ │ 没签合同，从第2个月起 │ │ │ 要付双倍工资，最多11个月│ └──────────────────┴──────────────────────┘ ``` **交互优化**： - 「合同签订日期」默认显示「未签订」，也可选择日期 - 如果已签订但逾期，自动计算逾期月数的双倍工资 - 结果区用醒目大字显示金额 - 底部附「人话版」法律解释 #### 4.4.3 经济补偿金计算器（Tab 3） **界面设计**： ``` ┌──────────────────┬──────────────────────┐ │ 填写信息 │ 计算结果 │ │ │ │ │ 入职日期： │ 📊 补偿金计算 │ │ [2022-03-01] │ │ │ │ 工作年限：4年2个月 │ │ 离职日期： │ → 按4.5个月计算 │ │ [2026-05-15] │ │ │ │ 月工资：¥8,000 │ │ 月平均工资： │ │ │ [8000___] 元 │ 💰 经济补偿金： │ │ │ ¥36,000 │ │ 离职原因： │ (4.5 × 8,000) │ │ [协商解除 ▼] │ │ │ │ ⚠️ 如果是违法解除： │ │ 当地社平工资： │ 赔偿金 = ¥72,000 │ │ [8000___] 元 │ (补偿金 × 2) │ │ (选填，用于封顶) │ │ │ │ 📌 6个月以上算1年， │ │ │ 不满6个月算半个月 │ └──────────────────┴──────────────────────┘ ``` **交互优化**： - 「离职原因」用下拉选择，选项用人话： - 「协商解除（双方同意）」 - 「员工犯错被辞退」 - 「员工没犯错但干不了」 - 「公司裁员」 - 「公司单方面违法辞退」 - 根据离职原因自动判断是否需要支付补偿金 - 「当地社平工资」选填，不填则跳过封顶计算 - 结果同时显示正常补偿金和违法解除赔偿金（×2） #### 4.4.4 工资合规自动检查（后台规则） | 规则 | 检查内容 | 信号灯 | 人话提示 | |------|---------|--------|---------| | S-01 | 工资低于当地最低工资 | 🔴 | 「工资不能低于当地最低工资标准」 | | S-02 | 加班超36小时/月 | 🟡 | 「月加班超过36小时有法律风险」 | | S-03 | 试用期工资过低 | 🟡 | 「试用期工资至少是转正工资的80%」 | --- ### 4.5 解聘助手（向导式流程） **目标**：一步步引导完成合规解聘，不怕漏步骤 **设计理念**：不展示复杂清单，而是用**向导式流程**，一次只看一步 #### 4.5.1 解聘向导（5 步） ``` ┌─────────────────────────────────────────────┐ │ 解聘助手 ●●○○○ │ │ ───────────────────────────────────────── │ │ │ │ Step 1/5：为什么解聘？ │ │ │ │ ○ 协商解除（双方同意分开了） │ │ ○ 员工犯错被辞退（严重违纪/失职等） │ │ ○ 员工没犯错但干不了（生病/不胜任等） │ │ ○ 公司裁员（经营困难/技术调整等） │ │ ○ 合同到期不续签 │ │ │ │ 💡 选不同原因，后续步骤和法律要求不同 │ │ │ │ [下一步 →] │ └─────────────────────────────────────────────┘ ``` **5 步流程**： | 步骤 | 标题 | 内容 | 交互 | |------|------|------|------| | Step 1 | 为什么解聘？ | 选择解聘原因（用人话选项） | 单选 | | Step 2 | 员工信息 | 选择员工 → 自动带入入职日期/工资 → 填写解聘日期 | 下拉 + 日期 | | Step 3 | 合规检查 | 根据解聘原因自动展示相关检查项（3-5项） | 逐项勾选 | | Step 4 | 算钱 | 自动计算补偿金/代通知金，展示金额 | 自动计算 | | Step 5 | 确认完成 | 汇总检查结果 + 金额 + 风险评估 → 保存记录 | 确认按钮 | **关键交互**： - 顶部进度条 `●●○○○` 直观显示进度 - 每步只有 1 个主操作「下一步」 - Step 3 合规检查根据 Step 1 的选择**动态展示**： - 选「协商解除」→ 只检查「是否支付补偿金」「是否签协议」 - 选「员工犯错」→ 检查「是否有规章制度依据」「是否有证据」「是否通知工会」 - 选「裁员」→ 检查「是否提前30天说明」「是否听取意见」「是否报劳动部门」 - 检查项用人话描述，不是法条原文 - Step 5 如果有未通过检查项，显示红色警告但**不阻止保存**（尊重用户决策） #### 4.5.2 禁止解聘情形检查（自动弹出） 在 Step 2 选择员工后，自动检查是否属于**不得解除**情形： | 检查项 | 触发条件 | 提示 | |--------|---------|------| | 孕期/产期/哺乳期 | 员工标记为女性 + 在孕期/哺乳期 | 🔴 「该员工在孕期，法律禁止解除」 | | 工伤期间 | 员工标记为工伤 | 🔴 「工伤期间不得解除劳动合同」 | | 医疗期 | 员工在规定的医疗期内 | 🔴 「医疗期内不得解除」 | - 如果触发禁止情形，弹出醒目红色警告框 - **不阻止继续操作**，但要求用户确认「我已了解风险，继续操作」 #### 4.5.3 解聘记录 - 完成向导后自动生成解聘记录 - 记录包含：员工信息、解聘原因、检查结果、补偿金额、操作日期 - 可在解聘助手页面底部查看历史记录 - 支持导出单条记录为 PDF（可选） --- ### 4.6 AI 合规顾问 **目标**：像有个法律顾问在身边，随时问、自动查、提前预警 **设计理念**：不是冷冰冰的搜索框，而是对话式交互，用户用大白话提问，AI 用大白话回答 #### 4.6.1 智能问答 **界面设计**：聊天式对话界面 ``` ┌─────────────────────────────────────────────┐ │ 🤖 AI 合规顾问 │ │ │ │ ┌─────────────────────────────────────┐ │ │ │ 🤖 你好！我是你的用工合规顾问， │ │ │ │ 有什么劳动法问题可以直接问我。 │ │ │ │ │ │ │ │ 你可以问我： │ │ │ │ · 员工入职没签合同怎么办？ │ │ │ │ · 加班费怎么算？ │ │ │ │ · 辞退员工需要赔多少？ │ │ │ └─────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────┐ │ │ │ 👤 试用期最长可以约定几个月？ │ │ │ └─────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────┐ │ │ │ 🤖 根据《劳动合同法》第19条： │ │ │ │ │ │ │ │ · 合同期 3个月~1年 → 试用期最多1个月 │ │ │ │ · 合同期 1年~3年 → 试用期最多2个月 │ │ │ │ · 合同期 3年以上 → 试用期最多6个月 │ │ │ │ │ │ │ │ ⚠️ 你的员工王五：合同2年但试用期3个月│ │ │ │ 超过法定上限，建议调整为2个月 │ │ │ └─────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────┐ │ │ │ [输入问题...] [发送] │ │ │ └─────────────────────────────────────┘ │ └─────────────────────────────────────────────┘ ``` **交互特点**： - 聊天式界面，支持多轮对话（上下文记忆） - 回答时**关联本企业数据**（如「你的员工王五试用期超限」） - 回答附法律依据引用（可折叠查看法条原文） - 预设常见问题快捷按钮（「没签合同怎么办」「加班费怎么算」等） - 支持语音输入（移动端） #### 4.6.2 风险预测 **界面设计**：首页风险总览中的智能分析卡片 ``` ┌─────────────────────────────────────────────┐ │ 🔮 AI 风险预测 │ │ │ │ ⚠️ 未来30天预计新增 3 个风险： │ │ │ │ · 李四合同7月31日到期 → 续签提醒 │ │ · 张三入职将满1年 → 未签合同风险升级 │ │ · 上月加班总时长上升40% → 超时风险 │ │ │ │ 💡 建议：本周优先处理合同到期和未签问题 │ └─────────────────────────────────────────────┘ ``` - 基于企业当前数据（合同到期日、入职日期、加班趋势）预测未来风险 - 每日自动刷新，展示在首页风险总览下方 - 给出优先级建议（先处理什么） #### 4.6.3 合同审查 **功能**：上传合同文本或粘贴条款，AI 审查合法性 ``` ┌─────────────────────────────────────────────┐ │ 📄 合同审查 │ │ │ │ [粘贴合同条款文本...] │ │ [或上传合同文件(.txt/.docx)] │ │ │ │ [开始审查] │ │ │ │ ──────────── 审查结果 ──────────── │ │ │ │ 🔴 试用期6个月超过法定上限（合同期2年最多2月）│ │ 🟡 竞业限制未约定补偿标准 │ │ 🟡 加班费计算基数未明确约定 │ │ 🟢 社保缴纳条款符合规定 │ │ 🟢 工资支付条款符合规定 │ │ │ │ 📊 合规评分：72/100 │ └─────────────────────────────────────────────┘ ``` - 逐条审查合同条款，标注红/黄/绿 - 给出修改建议（人话版） - 合规评分直观展示合同整体合法程度 #### 4.6.4 案例匹配 **功能**：输入争议情况，匹配相似仲裁案例，评估败诉风险 ``` ┌─────────────────────────────────────────────┐ │ ⚖️ 案例匹配 │ │ │ │ 描述你的情况： │ │ [员工入职3个月没签合同，现在要辞退他...] │ │ │ │ [分析] │ │ │ │ ──────────── 相似案例 ──────────── │ │ │ │ 📋 案例1：某科技公司 vs 员工张某 │ │ · 情形：入职3个月未签合同后辞退 │ │ · 结果：企业败诉，赔双倍工资+违法解除赔偿 │ │ · 赔偿金额：¥XX,XXX │ │ · 相似度：92% │ │ │ │ 📋 案例2：某贸易公司 vs 员工李某 │ │ · 情形：未签合同 + 协商解除 │ │ · 结果：企业赔双倍工资差额 │ │ · 赔偿金额：¥XX,XXX │ │ · 相似度：85% │ │ │ │ ⚠️ 你的败诉风险：高（90%） │ │ 💡 建议：先补签合同再协商解除，可降低风险 │ └─────────────────────────────────────────────┘ ``` - 内置劳动仲裁案例库（公开裁判文书） - AI 语义匹配相似案例，计算相似度 - 评估败诉概率和预估赔偿金额 - 给出风险降低建议 #### 4.6.5 技术方案 | 组件 | 方案 | |------|------| | **LLM** | 阿里通义千问（Qwen），通过 DashScope API 调用，中文劳动法领域表现优秀 | | **模型选择** | qwen-plus（日常问答）/ qwen-max（合同审查/案例匹配等复杂任务） | | **API Key** | 通过环境变量 `DASHSCOPE_API_KEY` 注入，不硬编码 | | **RAG 知识库** | 劳动法/劳动合同法/司法解释/地方条例 向量化存储 | | **向量数据库** | Supabase pgvector（与业务数据库共用，减少依赖） | | **Embedding** | DashScope text-embedding-v2（中文支持好，与 Qwen 生态统一） | | **上下文关联** | 每次问答注入当前企业数据摘要（员工数/风险项/合同状态） | | **案例库** | 爬取公开裁判文书，结构化存储 + 向量检索 | | **流式输出** | DashScope SSE 流式返回，打字机效果，提升体验 | | **安全过滤** | 敏感问题兜底回复（「建议咨询专业律师」） | #### 4.6.6 使用限制 | 套餐 | AI 问答次数/月 | 合同审查次数/月 | 案例匹配次数/月 | |------|---------------|---------------|---------------| | free | 10 | 3 | 3 | | pro | 100 | 20 | 20 | | enterprise | 无限 | 无限 | 无限 | ### 4.7 员工参与（员工端，独立入口） **目标**：让员工也能查看自己的合同和工资，参与入职填报和合同确认，减少 HR 沟通成本 **设计理念**：员工端独立入口，不需要注册账号，手机号验证码登录，极简操作 #### 4.7.1 员工登录 - **入口**：独立页面 `/portal/login`，与管理端完全分离 - **登录方式**：支持两种方式，员工可自由选择 - **方式一：手机号 + 密码**（推荐，无需短信服务） - HR 创建员工时设置初始密码，员工首次登录后可修改 - 密码 6 位以上，支持数字+字母组合 - **方式二：手机号 + 验证码**（无需记密码） - v1.0 方案：页面内显示验证码（暂不接入短信服务，降低成本） - 后续版本：接入阿里云短信服务，发送真实短信验证码 - **验证码发送**：优先通过页面内验证码（暂不接入短信服务，降低成本） - v1.0 方案：HR 通过微信分享员工端二维码/链接，员工扫码进入后输入手机号，系统发送验证码（页面内弹窗显示验证码，后续版本再接入短信） - 后续版本：接入阿里云短信服务，发送真实短信验证码 - **身份识别**：根据手机号匹配企业员工记录，自动关联 orgId - **安全**：验证码 5 分钟有效，同一手机号每小时最多 5 次；密码错误 5 次锁定 30 分钟 ``` ┌─────────────────────────────────────────────┐ │ 🏢 用工合规助手 — 员工端 │ │ │ │ [密码登录] [验证码登录] ← 切换 Tab │ │ │ │ ── 密码登录 ── │ │ 手机号：[___________] │ │ 密码： [___________] │ │ [登录] │ │ │ │ ── 验证码登录 ── │ │ 手机号：[___________] │ │ [获取验证码] 验证码：[______] │ │ [登录] │ │ │ │ 📱 也可扫描 HR 发送的二维码直接进入 │ └─────────────────────────────────────────────┘ ``` **HR 端生成员工端二维码**： - HR 在管理端可生成员工端入口二维码，扫码直接打开 `/portal/login` - 二维码可保存为图片，HR 通过微信发给员工 - 员工扫码后选择密码登录或验证码登录 - HR 创建员工时设置初始密码，可通过微信单独告知员工 #### 4.7.2 工资条查看 **页面**：`/portal/payslip` ``` ┌─────────────────────────────────────────────┐ │ 💰 我的工资条 │ │ │ │ 月份选择：[2026年7月 ▼] │ │ │ │ ┌─────────────────────────────────────┐ │ │ │ 基本工资： ¥8,000 │ │ │ │ 加班费： ¥1,978 │ │ │ │ └ 工作日加班： ¥690 (10h) │ │ │ │ └ 休息日加班： ¥736 (8h) │ │ │ │ └ 节假日加班： ¥552 (4h) │ │ │ │ ───────────────────────── │ │ │ │ 应发合计： ¥9,978 │ │ │ └─────────────────────────────────────┘ │ │ │ │ [确认已阅] │ └─────────────────────────────────────────────┘ ``` - 按月查看工资明细，包含基本工资和加班费拆分 - 加班费明细可展开查看工作日/休息日/节假日分类 - 「确认已阅」按钮，记录员工已查看该月工资条（时间 + IP） - HR 端可查看哪些员工已确认、哪些未确认 #### 4.7.3 我的合同 **页面**：`/portal/contract` ``` ┌─────────────────────────────────────────────┐ │ 📄 我的劳动合同 │ │ │ │ 合同类型：固定期限 │ │ 签订方式：纸质合同 │ │ 签订日期：2026-03-15 │ │ 合同期限：2026-03-15 ~ 2029-03-14（3年） │ │ 试用期：2个月（2026-03-15 ~ 2026-05-14） │ │ 试用期工资：¥6,400 │ │ 转正工资：¥8,000 │ │ │ │ 📎 合同扫描件：劳动合同_张三.pdf [查看] │ │ │ │ ──────────── 签署记录 ──────────── │ │ ✅ 已确认签署（2026-03-15 14:32） │ │ 确认IP：192.168.x.x │ └─────────────────────────────────────────────┘ ``` - 查看自己的劳动合同信息（只读） - 可查看合同扫描件（纸质）或电子合同链接（电子） - 展示签署确认记录（时间 + IP） - 如合同即将到期，顶部显示提示「您的合同还有 XX 天到期」 #### 4.7.4 员工入职填报 **页面**：`/portal/onboarding?token=xxx` **使用场景**：HR 在管理端添加员工时选择「生成填报二维码」，员工扫码填写（HR 通过微信发送二维码图片或链接） ``` ┌─────────────────────────────────────────────┐ │ 📝 入职信息填报 │ │ │ │ 欢迎加入 XX公司！请填写以下信息： │ │ │ │ 姓名 *： [___________] │ │ 手机号 *： [___________] │ │ 身份证号 *：[___________] │ │ 紧急联系人：[___________] │ │ 联系电话： [___________] │ │ 住址： [___________] │ │ 银行卡号： [___________] │ │ 开户行： [___________] │ │ │ │ [提交] │ │ │ │ 📌 提交后 HR 将审核您的信息 │ └─────────────────────────────────────────────┘ ``` - HR 端创建员工时可选「生成填报二维码」或「自己填写」 - 选择「生成填报二维码」后，页面显示二维码图片 + 链接，HR 可： - 保存二维码图片，通过微信发给员工 - 复制链接，通过微信直接发给员工 - 填报链接含一次性 token，有效期 24 小时 - 员工填写的信息进入「待审核」状态，HR 审核后正式入库 - 填报信息加密传输（HTTPS） - **暂不接入短信服务**，降低初期成本，后续版本可增加短信通知 #### 4.7.5 电子合同签署确认 **页面**：`/portal/contract-confirm?token=xxx` **使用场景**：HR 在管理端录入电子合同后，生成确认二维码/链接，通过微信发给员工 ``` ┌─────────────────────────────────────────────┐ │ ✍️ 合同签署确认 │ │ │ │ XX公司 与 张三 的劳动合同 │ │ │ │ 合同类型：固定期限（3年） │ │ 合同期限：2026-03-15 ~ 2029-03-14 │ │ 试用期：2个月 │ │ 试用期工资：¥6,400 │ │ 转正工资：¥8,000 │ │ │ │ 📎 查看合同文件：[点击查看] │ │ │ │ ┌─────────────────────────────────────┐ │ │ │ ☐ 我已阅读合同内容，确认签署 │ │ │ └─────────────────────────────────────┘ │ │ │ │ [确认签署] │ │ │ │ 📌 确认后将记录签署时间和 IP 地址 │ └─────────────────────────────────────────────┘ ``` - 员工查看合同内容后勾选确认 + 点击「确认签署」 - 系统记录确认时间、IP 地址、设备信息 - HR 端合同状态自动更新为「已确认签署」 - 确认链接含一次性 token，有效期 7 天 - HR 生成确认二维码后，可保存图片通过微信发给员工，或复制链接直接发送 - **暂不接入短信服务**，通过微信发送二维码/链接即可 - **法律效力说明**：此确认为员工知情确认，正式电子签章需接入第三方电子签平台（后续版本） ### 4.8 风险提醒（融入首页，不单独成页） **设计理念**：风险不需要单独页面，直接在首页和各模块中展示 **风险展示位置**： | 位置 | 展示方式 | |------|---------| | 首页 | 待办列表 + 风险分布进度条 | | 合同管理 | 列表状态列信号灯 + 详情页风险卡片 | | 钱的计算 | 计算结果区的警告提示 | | 解聘助手 | 向导 Step 3/5 的检查结果 | | **顶部导航栏** | 红色角标显示待处理风险总数，点击跳转首页 | **风险处理**： - 在首页待办列表中，每条风险右侧有「去处理」按钮 - 点击直接跳转到对应模块的操作页面 - 处理完成后风险自动消除（如签了合同，未签风险消失） - 也可手动标记「已忽略」并填写备注（记录决策原因） --- ## 5. 数据模型（SaaS 多租户） ### 5.0 多租户基础表 #### Organization（企业/组织） ```typescript interface Organization { id: string; name: string; // 企业名称 plan: 'free' | 'pro' | 'enterprise'; // 套餐 maxEmployees: number; // 套餐对应人数上限 createdAt: string; } ``` #### User（用户） ```typescript interface User { id: string; orgId: string; // 所属企业 phone: string; // 手机号（登录用） email?: string; // 邮箱（选填） passwordHash: string; // bcrypt 加密密码 name: string; // 用户姓名 role: 'admin' | 'hr' | 'viewer'; // 角色 createdAt: string; lastLoginAt?: string; } ``` **角色权限**： | 角色 | 权限 | |------|------| | admin | 全部操作 + 用户管理 + 套餐管理 | | hr | 合同/加班/解聘的增删改查 | | viewer | 只能查看，不能修改 | ### 5.1 员工信息 (Employee) — 精简字段 ```typescript interface Employee { id: string; orgId: string; // 所属企业（多租户隔离） name: string; // 姓名（必填） department: string; // 部门（必填） hireDate: string; // 入职日期（必填） monthlySalary: number; // 月工资标准（必填，加密存储） status: 'active' | 'resigned'; // 在职/离职 gender?: 'male' | 'female'; // 性别（选填，用于禁止解聘检查） isPregnant?: boolean; // 是否在孕期/哺乳期（选填） isInMedicalPeriod?: boolean; // 是否在医疗期（选填） isWorkInjured?: boolean; // 是否工伤期间（选填） phone?: string; // 联系电话（选填） createdBy: string; // 创建人 userId createdAt: string; updatedAt: string; } ``` **精简策略**：必填字段仅 4 个（姓名/部门/入职日期/月工资），其余选填 ### 5.2 劳动合同 (LaborContract) ```typescript interface LaborContract { id: string; orgId: string; // 所属企业 employeeId: string; // 关联员工 signDate: string | null; // 签订日期（null=未签订） startDate: string; // 合同起始日期 endDate: string | null; // 到期日期（null=无固定期限） contractType: 'fixed' | 'unfixed' | 'unsigned'; // 简化：固定/无固定/未签 signMethod: 'paper' | 'electronic'; // 签订方式：纸质/电子 contractYears: number; // 合同年限（1/2/3等，无固定=0） probationMonths: number; // 试用期月数（0=无试用期） probationSalary: number; // 试用期工资（0=无试用期） renewalCount: number; // 续签次数 attachmentName?: string; // 纸质合同扫描件文件名（可选） attachmentUrl?: string; // 扫描件存储 URL（可选） electronicContractNo?: string; // 电子合同编号（可选） electronicContractUrl?: string; // 电子合同链接（可选） createdBy: string; createdAt: string; updatedAt: string; } ``` **精简策略**：去掉 `task` 类型（中小企业极少使用）、去掉 `status`（由系统自动计算） **签订方式支持**：`signMethod` 区分纸质/电子，纸质可上传扫描件存档，电子可记录合同编号和链接 ### 5.3 加班记录 (OvertimeRecord) ```typescript interface OvertimeRecord { id: string; orgId: string; // 所属企业 employeeId: string; month: string; // YYYY-MM weekdayHours: number; // 工作日加班小时 weekendHours: number; // 休息日加班小时 holidayHours: number; // 法定节假日加班小时 calculatedPay: number; // 应付加班费（自动计算） createdBy: string; createdAt: string; } ``` **精简策略**：去掉 `overtimePay`（中小企业通常不记录已付金额，只算应付） ### 5.4 解聘记录 (TerminationRecord) ```typescript interface TerminationRecord { id: string; orgId: string; // 所属企业 employeeId: string; terminationDate: string; reason: 'negotiated' | 'fault' | 'nonfault' | 'layoff' | 'expired'; compensation: number; // 经济补偿金（自动计算） checklistResult: { // 向导检查结果 item: string; passed: boolean; remark?: string; }[]; riskLevel: 'safe' | 'warning' | 'danger'; createdBy: string; createdAt: string; } ``` **精简策略**：去掉 `reasonDetail`（向导中已选择）、去掉 `noticeType`（由向导检查项覆盖）、去掉单独的 `hasProofIssued`/`hasArchiveTransferred`（合并到 checklistResult） ### 5.5 风险项 (RiskItem) ```typescript interface RiskItem { id: string; orgId: string; // 所属企业 type: 'contract' | 'salary' | 'termination'; level: 'high' | 'medium' | 'low'; title: string; // 人话标题 description: string; // 人话描述 suggestion: string; // 人话建议 legalBasis: string; // 法律依据（折叠展示） employeeId?: string; status: 'pending' | 'resolved' | 'ignored'; actionUrl?: string; // 点击跳转的处理页面路由 createdAt: string; resolvedAt?: string; resolvedBy?: string; } ``` ### 5.6 操作审计日志 (AuditLog) ```typescript interface AuditLog { id: string; orgId: string; userId: string; // 操作人 action: string; // 操作类型（如 'contract.sign', 'termination.create'） target: string; // 操作对象（如 'employee:张三'） detail: string; // 操作详情 ipAddress: string; // IP 地址 createdAt: string; } ``` **新增 `actionUrl`**：风险项可以直接跳转到对应的处理页面，一键操作 --- ## 6. 系统架构（SaaS 版） ### 6.1 技术架构 ``` ┌─────────────────────────────────────────────────────┐ │ 前端（React 18） │ │ Vite + TailwindCSS + Recharts + React Router │ │ 部署：Vercel / Netlify │ ├─────────────────────────────────────────────────────┤ │ API 层（RESTful） │ │ Axios 请求 → JWT Token 认证 → 路由守卫 │ ├─────────────────────────────────────────────────────┤ │ 后端（Node.js） │ │ Express + Prisma ORM + JWT 认证 + Zod 校验 │ │ 部署：Railway / Render │ ├─────────────────────────────────────────────────────┤ │ 数据库（PostgreSQL） │ │ 多租户隔离（org_id） + 全文搜索 + 自动备份 │ │ 部署：Railway / Supabase / Neon │ └─────────────────────────────────────────────────────┘ ``` ### 6.2 多租户架构 **隔离策略**：共享数据库 + 行级隔离（`org_id` 字段） - 每个企业注册后创建一个 Organization（组织） - 所有业务数据表均包含 `orgId` 字段 - 所有 API 请求自动注入当前用户的 `orgId`，只能访问本企业数据 - Prisma 中间件自动过滤 `orgId`，防止越权 ### 6.3 认证体系 | 功能 | 说明 | |------|------| | 注册 | 企业手机号/邮箱注册，创建 Organization + Admin 用户 | | 登录 | 手机号/邮箱 + 密码登录，返回 JWT Token | | Token 管理 | Access Token（2h 过期）+ Refresh Token（7d 过期） | | 路由守卫 | 前端 React Router 守卫，未登录跳转登录页 | | API 拦截 | 后端中间件校验 JWT，提取 userId + orgId | | 角色权限 | admin（管理员）/ hr（HR 操作员）/ viewer（只读） | ### 6.4 安全要求 | 类别 | 要求 | |------|------| | **密码存储** | bcrypt 加密，不存明文 | | **数据传输** | 全站 HTTPS | | **JWT 密钥** | 环境变量管理，不硬编码 | | **SQL 注入** | Prisma ORM 参数化查询，杜绝注入 | | **XSS 防护** | React 自动转义 + CSP 头 | | **数据隔离** | 每个请求校验 orgId，禁止跨企业访问 | | **敏感数据** | 工资字段加密存储（AES-256） | | **操作日志** | 关键操作（解聘/合同变更）记录审计日志 | | **速率限制** | 登录接口限流（5次/分钟），防止暴力破解 | ### 6.5 非功能需求 | 类别 | 要求 | |------|------| | **前端技术栈** | React 18 + Vite + TailwindCSS + Recharts | | **后端技术栈** | Node.js + Express + Prisma ORM + Zod | | **数据库** | PostgreSQL，支持多租户行级隔离 | | **认证** | JWT（Access Token + Refresh Token） | | **响应式** | 桌面端（1280px+）/ 平板端（768px+）/ 手机端（375px+） | | **语言** | 全简体中文，文案用「人话」避免法律术语 | | **性能** | 首屏加载 < 2s，API 响应 < 500ms | | **浏览器** | Chrome / Edge / Safari 最新版 | | **部署** | 前端 Vercel + 后端 Railway + 数据库 Neon/Supabase | | **可用性** | 99.5%+，数据库每日自动备份 | | **可扩展** | 后期可加 Redis 缓存、CDN 加速 | --- ## 7. 界面规划 ### 7.1 整体布局（顶部导航，非侧边栏） **设计理由**：中小企业用户更习惯顶部导航（类似常用网站），侧边栏对小屏幕不友好 ``` ┌──────────────────────────────────────────────────────────────┐ │ 🏢 用工合规助手 [总览] [合同] [算钱] [解聘] [AI顾问] 🔴3 👤张总 │ ├──────────────────────────────────────────────────────────────┤ │ │ │ │ │ 主内容区 │ │ （最多 960px 居中） │ │ │ │ │ └─────────────────────────────────────────────────────┘ ``` **布局规范**： - 顶部导航栏：Logo + 5 个 Tab + 风险角标 + 用户头像下拉菜单（设置/退出），固定不滚动 - 主内容区：最大宽度 960px，居中，避免宽屏下内容过散 - 移动端：导航栏变为底部 Tab Bar（类似 App） - **无侧边栏**：减少视觉干扰，5 个 Tab 足够 ### 7.2 页面清单 **管理端认证页面（未登录可访问）**： | 页面 | 路由 | 说明 | |------|------|------| | 登录 | `/login` | 手机号/邮箱 + 密码登录 | | 注册 | `/register` | 企业名称 + 手机号 + 密码，注册即创建组织 | | 忘记密码 | `/forgot-password` | 手机验证码重置密码 | **管理端业务页面（登录后访问）**： | 页面 | 路由 | 导航名称 | 说明 | |------|------|---------|------| | 风险总览 | `/` | 总览 | 一句话状态 + 数字卡片 + 待办列表 + 风险分布 | | 合同管理 | `/contracts` | 合同 | 员工合同列表 + 添加/编辑 + 一键续签 + 发送填报/确认链接 | | 钱的计算 | `/money` | 算钱 | 3 个 Tab：加班费 / 双倍工资 / 经济补偿金 | | 解聘助手 | `/termination` | 解聘 | 5 步向导 + 历史记录 | | AI 合规顾问 | `/ai-assistant` | AI顾问 | 智能问答 + 合同审查 + 案例匹配 | | 系统设置 | `/settings` | 设置 | 企业信息 + 用户管理 + 套餐 | **员工端页面（独立入口，手机号验证码登录）**： | 页面 | 路由 | 说明 | |------|------|------| | 员工登录 | `/portal/login` | 手机号 + 短信验证码登录 | | 工资条 | `/portal/payslip` | 按月查看工资明细 + 确认已阅 | | 我的合同 | `/portal/contract` | 查看合同信息 + 扫描件/电子链接 | | 入职填报 | `/portal/onboarding?token=xxx` | 填写入职信息（一次性链接） | | 合同确认 | `/portal/contract-confirm?token=xxx` | 确认签署电子合同（一次性链接） | **设置页面子 Tab**： - 企业信息：名称、地区（用于最低工资/社平工资默认值） - 用户管理：添加/移除用户，分配角色（admin/hr/viewer） - 套餐信息：当前套餐、人数上限、升级套餐 ### 7.3 配色方案 | 用途 | 颜色 | 说明 | |------|------|------| | 主色 | `#2563EB`（蓝色） | 主操作按钮、导航高亮、链接 | | 危险/高风险 | `#EF4444`（红色） | 高风险信号灯、危险提示 | | 警告/中风险 | `#F59E0B`（橙黄） | 待办提醒、中风险信号灯 | | 安全/正常 | `#22C55E`（绿色） | 合规状态、完成状态 | | 背景 | `#F8FAFC`（浅灰） | 页面背景，减少视觉疲劳 | | 卡片 | `#FFFFFF`（白色） | 内容卡片背景 | | 文字主 | `#1E293B`（深灰） | 主要文字 | | 文字次 | `#64748B`（中灰） | 辅助说明文字 | ### 7.4 组件规范 | 组件 | 规范 | |------|------| | 按钮 | 主按钮蓝色填充，次按钮白色边框，危险按钮红色填充 | | 卡片 | 白底 + 圆角12px + 轻阴影（`shadow-sm`），不用重阴影 | | 表格 | 无边框简约表格，行间用浅灰分隔线，hover 高亮 | | 表单 | 输入框圆角8px，focus 时蓝色边框，错误时红色边框 + 提示 | | 弹窗 | 居中模态框，圆角16px，遮罩半透明黑色 | | 信号灯 | 圆点12px + 文字，不用复杂图标 | | 空状态 | 插图 + 引导文字 + 主操作按钮 | --- ## 8. 实施计划 | 阶段 | 内容 | 优先级 | |------|------|--------| | P0 | 项目搭建：前端 Vite + React + TailwindCSS，后端 Express + Prisma + PostgreSQL，项目结构 + 路由骨架 | 高 | | P1 | 认证体系：注册/登录/JWT Token + 路由守卫 + 多租户中间件 | 高 | | P2 | 首页风险总览（信号灯 + 待办 + 分布） | 高 | | P3 | 合同管理（列表 + 添加/编辑 + 一键续签 + 纸质/电子合同 + 风险标注） | 高 | | P4 | 钱的计算（3 Tab 计算器 + 实时计算） | 高 | | P5 | 解聘助手（5 步向导 + 禁止情形检查 + 记录） | 高 | | P6 | AI 合规顾问（智能问答 + 风险预测 + 合同审查 + 案例匹配 + RAG 知识库） | 高 | | P7 | 员工端（验证码登录 + 工资条 + 我的合同 + 入职填报 + 合同确认） | 高 | | P8 | 系统设置（企业信息 + 用户管理 + 套餐） | 中 | | P9 | 新手引导 + 空状态 + 移动端适配 | 中 | | P10 | 部署上线（Vercel + Railway + Neon）+ 联调验证 | 中 | --- ## 9. 法律依据索引 | 法律法规 | 关键条款 | 涉及模块 | |---------|---------|---------| | 《劳动法》 | 第36/41/44/48/50条 | 工资加班费 | | 《劳动合同法》 | 第10/14/19/20/39-42/46-47/50/82条 | 合同/解聘/双倍工资 | | 《劳动合同法实施条例》 | 第6/7/25/27条 | 双倍工资/补偿金 | | 《工资支付暂行规定》 | 第13/15/18条 | 加班费/工资支付 | | 最高人民法院劳动争议司法解释（一） | 第44/45条 | 举证责任 | --- ## 10. 约束与假设 1. **SaaS 多租户**：共享数据库 + 行级隔离（`orgId`），每家企业数据互不可见 2. **法律时效性**：系统内置规则基于现行法律法规，如法律更新需手动更新规则 3. **地区差异**：最低工资标准、社平工资等参数需用户自行设置（提供常用城市默认值） 4. **非替代法律意见**：系统提供合规参考，不构成正式法律意见，重大决策建议咨询专业律师 5. **套餐限制**：free 套餐限 20 人，pro 套餐限 200 人，enterprise 无限制 6. **数据备份**：PostgreSQL 数据库每日自动备份，保留 30 天 7. **合同附件存储**：纸质合同扫描件上传至云存储（Supabase Storage / S3），数据库只存 URL 8. **数据导出**：支持导出全部数据为 JSON/Excel，用户可随时备份 9. **后续可扩展**：预留 API 接口，后期可接入电子签平台（如 e签宝、法大大）实现在线签署 --- ## 11. 系统扩展架构 ### 11.1 设计原则：插件化模块架构 系统采用**模块化插件架构**，每个业务模块独立开发、独立注册、独立路由，互不依赖： ``` ┌─────────────────────────────────────────────────────┐ │ 前端框架层 │ │ 路由 / 导航 / 认证 / 布局 / 信号灯体系 / UI 组件库 │ ├─────────────────────────────────────────────────────┤ │ 模块注册中心 (Module Registry) │ │ 每个模块注册：路由前缀 / 导航菜单项 / 权限 / 图标 │ ├──────┬──────┬──────┬──────┬──────┬──────┬──────────┤ │ 合同 │ 工资 │ 解聘 │ 社保 │ 成本 │ 考勤 │ ... │ │ 模块 │ 模块 │ 模块 │ 模块 │ 分析 │ 模块 │ 模块 │ ├──────┴──────┴──────┴──────┴──────┴──────┴──────────┤ │ 共享数据层 (Prisma) │ │ Employee / Organization / User / AuditLog │ └─────────────────────────────────────────────────────┘ ``` **核心机制**： - **模块注册**：每个模块通过统一接口注册路由、导航菜单、权限要求 - **共享数据**：Employee/Organization/User 为核心共享表，所有模块复用 - **模块独立**：新增模块不影响现有模块，可独立上线/下线 - **渐进式加载**：前端按模块懒加载（React.lazy），不影响首屏性能 ### 11.2 后端 API 扩展规范 ``` /api/v1/ /auth ← 认证模块（v1.0） /employees ← 员工管理（v1.0） /contracts ← 合同管理（v1.0） /overtime ← 加班记录（v1.0） /termination ← 解聘管理（v1.0） /risks ← 风险预警（v1.0） /social-insurance ← 社保公积金（v2.0 预留） /cost-analysis ← 人力成本分析（v3.0 预留） /attendance ← 考勤管理（v4.0 预留） ``` - 所有 API 遵循 RESTful 规范，统一 `/api/v1/` 前缀 - 统一响应格式：`{ success: boolean, data: any, error?: string }` - 统一鉴权中间件，所有路由自动校验 JWT + orgId - 新增模块只需添加路由文件 + Prisma model，不改现有代码 ### 11.3 数据库扩展策略 - 核心表（Employee/Organization/User）稳定不变 - 新模块新增独立表，通过 `employeeId` / `orgId` 关联 - Prisma schema 按模块分文件管理（Prisma 多 schema 支持） - 数据库迁移使用 Prisma Migrate，增量迁移不破坏现有数据 --- ## 12. 后续模块规划 ### 12.1 v2.0 — 社保公积金模块 **目标**：自动计算五险一金缴费金额，防止少缴/漏缴风险 | 功能 | 说明 | |------|------| | 缴费基数设置 | 各城市社保/公积金缴费基数上下限默认值 | | 五险一金计算 | 养老/医疗/失业/工伤/生育 + 公积金，企业/个人分担 | | 缴费明细表 | 按员工/按月生成缴费明细 | | 合规检查 | 缴费基数低于最低标准预警、断缴提醒 | | 对账单导出 | 导出社保公积金月度对账单 | **数据模型预留**： ```typescript interface SocialInsuranceRecord { id: string; orgId: string; employeeId: string; month: string; // YYYY-MM base: number; // 缴费基数 pension: { company: number; personal: number }; medical: { company: number; personal: number }; unemployment: { company: number; personal: number }; workInjury: { company: number; personal: number }; maternity: { company: number; personal: number }; housingFund: { company: number; personal: number }; total: { company: number; personal: number }; } ``` **页面路由**：`/social-insurance`（导航名称：社保） ### 12.2 v3.0 — 人力资源成本分析模块 **目标**：可视化人力成本结构，辅助经营决策 | 功能 | 说明 | |------|------| | 成本总览 Dashboard | 月度/季度/年度人力成本总览 | | 成本构成分析 | 工资/社保/公积金/加班费/补偿金 占比饼图 | | 部门成本对比 | 各部门人力成本柱状图对比 | | 人均成本趋势 | 人均成本月度趋势折线图 | | 成本预警 | 人力成本占比超过营收 X% 预警 | | 报表导出 | 导出 Excel/PDF 成本报表 | **数据模型预留**： ```typescript interface CostReport { id: string; orgId: string; period: string; // YYYY-MM 或 YYYY-Q1 等 totalSalary: number; // 工资总额 totalOvertimePay: number; // 加班费总额 totalSocialInsurance: number; // 社保企业部分 totalHousingFund: number; // 公积金企业部分 totalCompensation: number; // 解聘补偿金 totalCost: number; // 人力成本合计 headcount: number; // 人数 avgCostPerPerson: number; // 人均成本 } ``` **页面路由**：`/cost-analysis`（导航名称：成本分析） ### 12.3 v3.0 — 员工自助门户增强 **目标**：在 v1.0 员工端基础上增加考勤、请假等自助功能 | 功能 | 说明 | |------|------| | 考勤记录 | 查看个人考勤/加班记录 | | 请假申请 | 在线请假审批流程 | | 调薪记录 | 查看历史调薪记录 | | 在线咨询 | 员工端直接问 AI 顾问 | **页面路由**：`/portal`（扩展已有员工端） **注**：v1.0 已包含员工端基础功能（工资条查看、合同查看、入职填报、合同确认），v3.0 在此基础上增强