# 中心配置管理系统 - 功能总览

## 系统架构

中心配置管理系统分为两大模块：**租户管理** 和 **用户管理**

```
中心配置管理系统
├── 租户管理
│   ├── 企业审核
│   ├── 审核历史
│   ├── 企业信息
│   └── 用户管理
└── 用户管理
    ├── 员工管理
    ├── 角色管理
    ├── 菜单管理
    └── 权限配置管理
```

---

## 一、租户管理

### 1. 企业审核
**角色：** 超级管理员

超级管理员可通过该模块全面管理系统内所有企业的注册与变更审核流程。支持查看企业详细信息列表（含企业名称、社会信用代码、联系人、状态等关键信息），并可根据企业名称、状态等多条件进行高效检索。管理员可详细核查企业提交的资质文件与信息完整性，执行审核通过或驳回操作，确保入驻企业合规可信，有效提升平台企业质量与安全性。所有审核操作均留有详细日志，满足审计要求。

**关键功能：**
- 企业详细信息查看
- 多条件高效检索
- 审核通过/驳回操作
- 审核日志记录
- 企业资质核查

---

### 2. 审核历史
**角色：** 超级管理员

超级管理员可追溯查询全部企业的历史审核记录，完整涵盖审核时间、操作人员、审核结果及备注信息。支持按企业名称、审核时间、审核结果等条件进行灵活检索与筛选，便于审计核查与流程回溯，为企业资质管理提供全生命周期可视化追踪。

**关键功能：**
- 历史审核记录追溯
- 多维度灵活检索
- 审核流程时间线
- 审核记录导出
- 全生命周期追踪

---

### 3. 企业信息
**角色：** 企业管理员、企业员工

企业用户可通过清晰表单化界面查看本企业的详细注册信息及当前审核状态。企业管理员有权对部分企业信息进行更新维护，修改后需重新提交至超级管理员端审核，确保企业信息实时准确且变更过程规范受控，强化企业自治与平台监管的平衡。

**关键功能：**
- 企业信息查看
- 信息更新维护
- 审核状态查看
- 重新提交审核
- 变更记录追踪

---

### 4. 用户管理
**角色：** 超级管理员

超级管理员具备对平台所有用户账户的集中管理权限，支持跨租户查看用户列表、新增用户（手动或批量导入）、编辑用户属性、多维度搜索（用户名、手机号、企业等）、查看详情、重置密码，以及执行账户的冻结、解冻或删除操作。提供完备的用户账号生命周期管理能力，保障系统访问安全与用户体验。

**关键功能：**
- 跨租户用户管理
- 用户新增（手动/批量）
- 多维度搜索
- 密码重置
- 账户状态管理

---

## 二、用户管理

### 1. 员工管理
**角色：** 企业管理员

企业管理员可全面管理本企业下的员工账户体系，包括查看员工账户列表、新增员工账号、修改员工基本信息、搜索指定员工、查看详情、执行密码重置，以及进行账户的冻结、解冻和删除等操作。支持批量导入导出，有效提升中大型企业人员管理的效率，确保内部用户体系安全有序。

**关键功能：**
- 员工账户列表
- 新增员工账号
- 修改基本信息
- 密码重置
- 账户状态控制
- 批量导入导出

---

### 2. 角色管理
**角色：** 超级管理员、企业管理员

实现基于角色的访问控制（RBAC），支持按职能划分系统角色，灵活配置各角色可访问的系统、功能菜单及数据权限。提供角色列表查看、新增角色、编辑权限集、角色检索、删除角色、配置关联用户、定义角色首页视图及导入导出等功能，满足不同企业复杂权限管理需求，实现权限分配的标准化与高效化。

**关键功能：**
- 角色列表查看
- 新增角色
- 编辑权限集
- 角色检索
- 配置关联用户
- 定义角色首页视图
- 导入导出

**预置角色：**
- 超级管理员 (super_admin)
- 企业管理员 (enterprise_admin)
- 操作员 (operator)
- 维修员 (maintenance)

---

### 3. 菜单管理
**角色：** 超级管理员

以树形结构可视化配置各个业务系统的菜单体系，支持菜单项的添加、编辑、删除、排序及快速检索。可细粒度设置菜单名称、图标、路由、权限标识等属性。提供一致且灵活的导航管理基础，助力多系统集成下的统一用户体验与高效菜单维护。

**关键功能：**
- 树形菜单结构
- 菜单项添加/编辑/删除
- 菜单排序
- 权限标识设置
- 快速检索

**菜单层级：**
- 系统菜单（7个）
- 一级菜单
- 二级菜单
- 按钮权限

---

### 4. 权限配置管理
**角色：** 超级管理员

对系统内所有功能模块与操作按钮（如增删改查、导入导出、设备控制等）进行精细化权限划分与管理。支持界面元素级别权限控制，确保不同角色用户仅可访问被授权功能和数据，实现系统安全与功能灵活分配之间的高度平衡。

**关键功能：**
- 权限列表管理
- 精细化权限划分
- 界面元素级控制
- 权限检索
- 按类型筛选

**权限类型：**
- 查看 (view) - 查看数据和页面
- 新增 (add) - 添加新数据
- 编辑 (edit) - 修改数据
- 删除 (delete) - 删除数据
- 导出 (export) - 导出数据
- 导入 (import) - 导入数据
- 审核 (approve) - 审批操作
- 控制 (control) - 设备控制

---

## 权限体系架构

```
用户 (User)
  ├─ 所属企业 → 企业 (Enterprise)
  │              └─ 审核状态 → 审核记录 (Audit)
  └─ 分配角色 → 角色 (Role)
                  ├─ 菜单权限 → 菜单 (Menu)
                  └─ 功能权限 → 权限 (Permission)
```

### 用户类型
1. **超级管理员** - 系统最高权限，管理所有企业和用户
2. **企业管理员** - 管理本企业的员工和数据
3. **员工** - 普通用户，根据角色拥有不同权限

### 权限控制层级
1. **企业级** - 多租户数据隔离
2. **角色级** - 基于角色的访问控制
3. **功能级** - 菜单和操作权限控制
4. **数据级** - 精细化数据访问控制

---

## 数据存储

| 存储键 | 描述 |
|--------|------|
| `smart_agriculture_enterprises` | 企业信息 |
| `smart_agriculture_audit_records` | 审核历史记录 |
| `smart_agriculture_users` | 平台用户 |
| `smart_agriculture_employees` | 企业员工 |
| `smart_agriculture_roles` | 角色信息 |
| `smart_agriculture_permissions` | 权限配置 |

---

## 核心业务流程

### 企业入驻流程
```
企业注册 → 提交审核 → 超级管理员审核 → 审核通过 → 创建企业管理员 → 企业开始使用
                                   ↓
                              审核驳回 → 企业修改 → 重新提交
```

### 员工管理流程
```
企业管理员添加员工 → 分配角色 → 设置权限 → 员工账号激活 → 员工登录使用
```

### 权限分配流程
```
创建权限 → 创建角色 → 配置角色权限 → 为用户分配角色 → 权限生效
```

---

## 安全机制

### 1. 多级权限控制
- 企业级数据隔离
- 角色级权限授权
- 功能级访问控制
- 界面元素级权限

### 2. 账户安全
- 密码重置
- 账户冻结/解冻
- 登录日志
- 异常检测

### 3. 审计追踪
- 操作日志
- 审核历史
- 数据变更记录
- 完整追溯链

---

## 最佳实践

### 企业管理
1. 及时审核企业注册申请
2. 严格验证企业资质
3. 定期检查企业状态
4. 保持沟通渠道畅通

### 用户管理
1. 规范用户命名规则
2. 及时清理无效账号
3. 定期审查用户权限
4. 强制密码安全策略

### 角色配置
1. 按职能划分角色
2. 遵循最小权限原则
3. 职责分离原则
4. 定期审查角色权限

### 权限管理
1. 规范权限命名
2. 模块化权限设计
3. 粒度适中
4. 定期权限审计

---

## 技术特性

- ✅ React + TypeScript 类型安全开发
- ✅ Shadcn/ui 统一UI组件
- ✅ Tailwind CSS 响应式设计
- ✅ localStorage 数据持久化
- ✅ RBAC 权限模型
- ✅ 多租户架构
- ✅ 完整的审计日志
- ✅ 灵活的权限配置

---

## 版本信息

**当前版本：** v1.0.0

**发布日期：** 2024-10-14

**主要功能：**
- ✅ 租户管理完整功能
- ✅ 用户管理完整功能
- ✅ RBAC权限体系
- ✅ 审核历史追溯
- ✅ 批量导入导出
- ✅ 完整的CRUD操作

---

## 常见问题

**Q: 租户管理和用户管理有什么区别？**
A: 租户管理主要面向超级管理员，管理企业级别的审核、信息和用户；用户管理主要面向企业管理员，管理企业内部的员工、角色和权限配置。

**Q: 如何快速入门？**
A: 建议按照以下顺序：企业审核 → 用户管理 → 员工管理 → 角色管理 → 权限配置

**Q: 权限修改后何时生效？**
A: 权限修改后需要用户重新登录才能生效。

**Q: 如何导出数据？**
A: 在相应的管理页面点击"导出"按钮即可导出JSON格式数据。

---

## 支持与反馈

如有问题或建议，请联系系统管理员。

详细使用说明请参考：[USER_MANAGEMENT_README.md](./USER_MANAGEMENT_README.md)
