# 组织架构相关功能

> 模块编码：org
> 端侧：微信小程序
> 关联文档：01-模块划分.md（v4.0）、02-功能清单-小程序端.md（§6）、03-业务流转逻辑-小程序端.md（§6）、05-接口规范.md（§9）、06-项目技术要求.md

## 功能概览

| 项目 | 说明 |
|------|------|
| 菜单名称 | 组织架构 |
| 子菜单 | 我的班组 / 我的排班 |
| 功能编号 | MP-OR-01 ~ MP-OR-02 |
| 权限编码 | org:team:view、org:schedule:view |

## 页面清单

### 页面1：我的班组

- **页面路径**：`/pages/org/my-team`
- **适用角色**：全部
- **页面元素**：
  - 班组信息卡片（班组名称、所属部门、班组长）
  - 班组成员列表
  - 成员详情弹窗
- **查询条件**：无（自动加载本人所在班组）
- **列表字段**：

| 字段 | 类型 | 说明 |
|------|------|------|
| 姓名 | 文本 | 成员姓名 |
| 职位 | 标签 | 岗位/职位 |
| 联系电话 | 文本 | 手机号（脱敏显示） |
| 技能标签 | 标签组 | 专业技能标签 |

- **界面布局**：
  - 顶部：班组信息卡片（班组名、部门、班组长）
  - 中部：成员列表（头像 + 姓名 + 职位 + 电话）
  - 底部：无操作栏
- **操作按钮**：
  - 「拨打电话」→ 调用手机拨号功能
  - 「查看详情」→ 显示成员详情弹窗

**数据来源**：物业管理员在Web端配置的班组信息

**需求追溯**：

| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|------------|----------|----------|----------|----------|
| MP-OR-01 | 我的班组 | 02-小程序端 §6 | 无 | 组织架构（Web端）、通讯录 |

---

### 页面2：我的排班

- **页面路径**：`/pages/org/my-schedule`
- **适用角色**：全部
- **页面元素**：
  - 月历视图（排班日历）
  - 每日排班标记（颜色条）
  - 点击日期显示排班详情
  - 图例说明
- **查询条件**：
  - 月份切换（左右滑动）
- **列表字段**：无（日历模式）
- **界面布局**：
  - 顶部：月份切换
  - 中部：月历网格，每日格子中用颜色条标记排班类型
    - 蓝色条：白班
    - 绿色条：夜班
    - 橙色条：全天班
    - 灰色条：休息
  - 底部：图例说明
- **操作按钮**：
  - 「点击日期」→ 显示当日排班详情弹窗
    - 排班类型
    - 上班时间
    - 下班时间
    - 打卡点

**数据来源**：物业管理员在Web端配置的排班数据

**需求追溯**：

| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|------------|----------|----------|----------|----------|
| MP-OR-02 | 我的排班 | 02-小程序端 §6 | 无 | 考勤打卡、组织架构排班（Web端） |

---

## 业务规则

1. **数据只读**：小程序端组织架构信息为只读，修改需在Web端操作
2. **数据来源**：班组信息和排班数据均由物业管理员在Web端配置
3. **权限限制**：员工只能查看本人所在班组信息和排班
4. **电话脱敏**：通讯录中电话号码中间4位脱敏显示（如138****5678），点击拨号时显示完整号码
5. **排班实时同步**：Web端修改排班后，小程序端实时更新
6. **考勤关联**：排班数据与考勤打卡关联，排班中的打卡点与蓝牙打卡验证一致

## 状态流转

本模块为只读查看功能，无状态流转。