店长宝重构
概要
| 项目 | 内容 |
|---|---|
| 涉及终端 | 店长端、员工端、PC端、PDA端 |
| 功能属性 | 插件模式(代理商开启→分配商户/门店)、PC端角色控制权限 |
| 部署 | 服务器→零售系统(118.24.231.235)、数据库→零售云库 |
| 人员 | 徐滔(后端)/ 杨卓(PC后台:打卡/请假/任务/配送/维修)/ 嘉成(工资模块)/ 伟哥(PDA端:前端+迁移) |
| 模块 | 8个功能模块,按店长端管理/员工端操作两维度拆分 |
| 备注 | 现有数据库怎么迁移过去 |
一、涉及终端
| 终端 | 说明 |
|---|---|
| 🏪 店长端 | 店长使用的管理端 |
| 👤 员工端 | 店员使用的操作端 |
| 💻 PC端 | 后台管理(权限控制、配置) |
| 📱 PDA端 | 手持设备端 |
二、功能属性
- 插件式:需到代理商端开启,分配给指定商户 + 门店
- 权限体系:PC端后台控制具体角色的管理权限
三、部署规划
| 项目 | 位置 |
|---|---|
| 后台服务器 | 爱优零售系统服务器(118.24.231.235) |
| 数据库 | 爱优零售云数据库(TDSQL-C 读写实例) |
四、人员分工
| 负责人 | 职责 |
|---|---|
| 徐滔 | PHP 后端开发 |
| 杨卓 | PC后台:打卡、请假、任务、配送、维修 |
| 嘉成 | 工资模块(放到财务模块里面) |
| 伟哥 | PDA端:前端开发 + 其余功能逐步迁移 |
五、菜单规划
| # | 菜单 | 子功能 |
|---|---|---|
| 1 | 👥 人事管理 | 考勤、请假、工资表、新增员工、编辑 |
| 2 | 🚚 配送 | 统计 |
| 3 | 🔧 维修 | 统计 |
| 4 | 📦 租赁 | (后续再加) |
六、功能模块清单
| 模块 | 店长端 | 员工端 | PC后台 | PDA端 | 负责人 |
|---|---|---|---|---|---|
| 🕐 打卡 | 管理(查看/统计) | 操作(打卡) | 人事管理·考勤 | 前端展示 | 杨卓(PC后) → 伟哥(PDA前) |
| 📋 请假 | 管理(审批) | 操作(申请) | 人事管理·请假 | 前端展示 | 杨卓(PC后) → 伟哥(PDA前) |
| 📌 任务 | 管理+发布 | 接收/执行 | — | 前端展示 | 杨卓 |
| 🚚 配送 | 管理(查看/调度) | 操作(执行配送) | 配送·统计 | 前端展示 | 杨卓(PC后) → 伟哥(PDA前) |
| 🔧 维修 | 管理(查看/派单) | 操作(执行维修) | 维修·统计 | 前端展示 | 杨卓(PC后) → 伟哥(PDA前) |
| 💰 工资与提成 | 统计管理 | — | 人事管理·工资表(放财务模块) | — | 嘉成 |
| 🔗 其它功能 | — | 跳转 H5 | — | 逐步迁移 | 伟哥 |
七、功能模块逻辑详情
1. 🕐 打卡模块
1.1 PC后台 — 打卡设置管理(杨卓负责)
① WiFi打卡设置
- 功能:为每个门店配置可打卡的WiFi网络
- 操作:添加/编辑/删除WiFi
- 字段:WiFi名称(SSID)、MAC地址(BSSID)、备注
- 规则:一个门店可绑定多个WiFi,员工连接任一即可打卡
- 判定逻辑:员工打卡时自动检测当前连接的WiFi是否与门店配置的WiFi列表匹配
② 地点打卡设置
- 功能:为门店配置打卡地理位置
- 操作:添加/编辑/删除打卡地点
- 字段:地点名称、详细地址、经纬度(支持地图选点)、打卡半径(如 100m~500m,可配置)
- 规则:员工在指定半径范围内可打卡,超出范围判定为外勤打卡
③ 考勤时间设置
- 功能:设置门店的上下班打卡时间
- 字段:
- 早上上班卡时间(如
08:00 - 09:00,支持精确到分钟) - 晚上下班卡时间(如
17:30 - 18:30) - 迟到判定阈值(如:超过上班卡结束时间仍打卡 = 迟到)
- 早退判定阈值(如:早于下班卡开始时间打卡 = 早退)
- 可设置工作日(周一至周五 / 自定义)
- 可设置休息日是否允许打卡
- 规则:允许弹性时间范围,超出范围算异常打卡
1.2 店长端 — 打卡管理
- 日考勤报表:查看当日所有员工打卡状态(已打卡/未打卡/迟到/早退/外勤)
- 月打卡统计:按月汇总每个员工的出勤天数、迟到次数、早退次数、缺卡天数
- 打卡明细:查看具体打卡记录(员工姓名、时间、打卡方式[WiFi/地点]、打卡位置/WiFi名称)
- 异常标记:迟到/早退/缺卡标红提醒
1.3 员工端 — 打卡操作
- 双模式打卡:进入打卡页自动检测
- 🔵 WiFi打卡:自动识别当前WiFi,匹配门店WiFi列表 → 匹配成功直接打卡
- 🟢 地点打卡:获取GPS定位 → 计算与门店打卡地点的距离 → 在半径内可打卡,显示"已到达打卡范围";半径外则提示"您不在打卡范围内"
- 双模式备用:WiFi匹配失败自动降级为地点打卡
- 打卡结果反馈:
- 打卡成功:显示打卡时间、方式、状态(正常/迟到/早退)
- 打卡失败:显示失败原因
- 打卡记录查看:查看本人历史打卡记录
1.4 打卡流程图
[员工端打卡页]
│
├── WiFi打卡模式 ──→ 检测当前WiFi ──→ 匹配门店WiFi列表?
│ ├── 匹配 → 打卡成功(正常)
│ └── 不匹配 → 降级为地点打卡
│
└── 地点打卡模式 ──→ 获取GPS定位 ──→ 计算与门店距离
├── ≤ 半径 → 打卡成功(正常)
├── > 半径 → 提示"不在打卡范围"
└── 获取定位失败 → 提示"请开启定位"
[PC后台设置] ← 配置WiFi列表 / 打卡地点 / 半径 / 考勤时间
[店长端] ← 查看统计报表 / 异常标记
2. 📋 请假模块
2.1 PC后台 — 请假设置管理(杨卓负责)
① 请假类型管理
- 预置类型:病假、事假、年假、婚假、产假、丧假、调休
- 支持自定义新增请假类型
- 每个类型可设置是否扣除全勤、是否计入考勤统计
② 审批流程设置
- 为门店/部门指定审批人(可设置1级或多级审批)
- 审批人可设置为:店长、主管、指定管理员
③ 请假记录查询
- 按员工/部门/时间范围/请假类型/审批状态筛选查询
- 导出请假记录报表
2.2 员工端 — 请假申请
操作流程:
1. 选择员工:默认本人申请;管理员代申请时可选择指定员工
2. 选择请假类型:从预设类型下拉选择
3. 填写请假时间段:
- 开始日期 + 结束日期
- 支持按天请假或按半天请假(上午/下午)
-
自动计算请假天数
-
填写请假原因:文本备注
- 提交申请 → 进入审批流程
提交后状态流转:
待审批 → 审批中 → 已通过 / 已驳回
↘ 已撤销(申请人主动取消)
2.3 店长端 — 请假审批
- 待审批列表:展示所有待审批的请假申请
- 卡片/列表展示:申请人、请假类型、时间段、天数、原因
- 快速查看详情
- 审批操作:
- ✅ 通过:确认通过 → 更新状态为"已通过",生成请假记录
- ❌ 驳回:填写驳回原因 → 更新状态为"已驳回",通知申请人
- 审批记录:查看已处理的审批历史(通过/驳回,含操作时间)
- 批量审批:支持勾选多条待审批记录批量通过/驳回
2.4 请假记录
- 生成规则:审批通过后自动生成
- 记录字段:
| 字段 | 说明 |
|---|---|
| 员工姓名 | 请假人 |
| 请假类型 | 病假/事假/年假等 |
| 开始时间 | 请假开始日期+时段 |
| 结束时间 | 请假结束日期+时段 |
| 请假天数 | 自动计算 |
| 请假原因 | 备注内容 |
| 审批人 | 谁审核的 |
| 审批时间 | 审核时间 |
| 审批状态 | 已通过/已驳回 |
- 查询入口:店长端、PC后台均可查看
- 导出:支持导出Excel
2.5 请假流程图
[员工端提交请假申请]
│
├── 选择员工(默认本人)
├── 选择请假类型
├── 选择时间段(开始~结束,支持半天)
├── 填写请假原因
└── 提交
│
▼
[店长端审批列表]
│
┌────┴────┐
▼ ▼
[通过] [驳回]
│ │
▼ ▼
生成请假记录 通知申请人+驳回原因
3. 📌 任务模块
3.1 任务类型定义
| 任务类型 | 周期 | 说明 | 示例 |
|---|---|---|---|
| 📅 日任务 | 每日一次 | 每天需完成一次的固定任务 | 日报、日大扫除、晨会记录 |
| 📆 周任务 | 每周一次 | 每周需完成一次的任务 | 周报、周大扫除、周库存盘点 |
| 🗓️ 月任务 | 每月一次 | 每月需完成一次的任务 | 月报、月度盘点、月度对账 |
| 📊 季度任务 | 每季度一次 | 每季度需完成一次的任务 | 季度总结、季度库存大盘 |
| 🔖 一次性任务 | 仅一次 | 临时发布、不重复的单项任务 | 临时布置、突击检查 |
3.2 PC后台 — 任务设置管理(杨卓负责)
① 任务模板管理
- 创建任务模板:任务名称、任务类型(日/周/月/季度/一次性)、任务描述
- 任务模板与门店/岗位关联(不同岗位的任务模板可不同)
- 支持上传附件/拍照要求说明(如:大扫除需拍前后对比照)
② 任务发布与指派
-
发布流程:
-
选择任务模板(或直接新建任务)
- 选择任务类型(日/周/月/季度/一次性)
-
设置任务周期规则:
- 日任务:执行时间段(如 08:00-09:00 / 17:00-18:00)
- 周任务:指定周几执行(如 每周五)
- 月任务:指定每月几号执行(如 每月1号)
- 季度任务:指定季度末月份(如 3/6/9/12月 最后一天)
- 一次性任务:设定截止日期
-
指定执行员工:可指定单个员工或多个员工(一个任务可指派给多人)
- 设置是否需要提交照片/附件
- 设置审批人(可选:无需审批 / 指定审批人)
- 发布
③ 任务记录查询
- 按员工/门店/任务类型/时间范围/完成状态筛选
- 查看每个任务的完成详情(提交内容、照片、时间)
- 导出任务完成统计报表
3.3 店长端 — 任务管理
- 任务看板:展示门店所有任务的总览
- 今日待完成(日任务)
- 本周待完成(周任务)
- 本月待完成(月/季度/一次性任务)
- 任务审批:
- 待审批列表:展示员工提交的任务完成记录
- ✅ 通过:确认任务完成
- ❌ 驳回:填写驳回原因,员工可重新提交
- 完成统计:按员工维度查看任务完成率、准时率、超期未完成数
- 催办功能:对超时未完成的任务可一键催办
3.4 员工端 — 任务执行
操作流程:
1. 任务列表:展示指派给我的任务(按时间排序,未完成优先)
- 日任务:只显示今日待完成
- 周任务:本周待完成
- 月任务:本月待完成
-
季度/一次性:按截止日期展示
-
任务详情与执行:
-
查看任务名称、描述、截止时间
- 填写任务完成说明(文本)
- 拍照上传:如有要求,可拍照上传(如大扫除前后对比照、盘点现场照)
-
支持上传多张照片
-
提交:
-
提交后状态变为"待审批"(如设置了审批人)
-
或提交后状态变为"已完成"(无需审批模式)
-
历史记录:查看本人已完成的任务记录
3.5 任务状态流转
[PC后台/店长端发布任务]
│
▼
[指派给员工 · 待执行]
│
▼
[员工端查看任务]
│
┌────┴────┐
│ │
填写文本 拍照上传
│ │
└────┬────┘
▼
[提交完成记录]
│
┌────┴────┐
│ │
无需审批 需审批
│ │
▼ ▼
[已完成] [店长端·待审批]
│
┌────┴────┐
│ │
[通过] [驳回]
│ │
▼ ▼
[已完成] [待返工·重新提交]
3.6 任务流程图
┌─────────────────────────────┐
│ PC后台 / 店长端 │
│ ┌─────────────────────┐ │
│ │ 发布任务 │ │
│ │ ·选类型(日/周/月/季/次) │
│ │ ·设周期规则 │ │
│ │ ·指定执行员工 │ │
│ │ ·设置审批人 │ │
│ └─────────┬───────────┘ │
└──────────────┼──────────────┘
│
▼
┌─────────────────────────────┐
│ 员工端 · 待执行任务列表 │
│ ┌─────────────────────┐ │
│ │ 执行任务 │ │
│ │ ·填写完成说明 │ │
│ │ ·拍照上传 │ │
│ │ ·提交 │ │
│ └─────────┬───────────┘ │
└──────────────┼──────────────┘
│
┌────────────┴────────────┐
▼ ▼
┌─────────────┐ ┌─────────────┐
│ 无需审批 │ │ 需审批 │
│ → 已完成 │ │ → 店长审批 │
└─────────────┘ └──────┬──────┘
│
┌──────┴──────┐
▼ ▼
┌──────────┐ ┌──────────┐
│ 通过 │ │ 驳回 │
│ →已完成 │ │ →待返工 │
└──────────┘ └──────────┘
八、注意事项
- 工资模块放到财务模块里面,由嘉成负责
- 菜单按以上规划落地,租赁菜单后续再加
- 数据库迁移:现有店长宝数据如何迁移到零售云库,需明确方案
- 打卡异常处理:员工端若因网络/定位异常导致无法打卡,应有补卡/申诉机制(待细化)
- 请假与考勤关联:已通过的请假应自动关联到考勤统计,不影响打卡记录