基础功能

VJSP 框架内置了一套完整的企业级基础功能模块，涵盖用户管理、组织架构、权限控制、数据字典、系统日志等核心能力。开发者基于该框架构建应用时，无需重复开发通用功能，只需聚焦于自身业务逻辑与数据模型的设计与实现，大幅提升开发效率与系统一致性。

所有基础功能均经过统一权限管控、支持多语言与主题定制，并与工作流、表单引擎等高级模块无缝集成，为复杂企业应用场景提供坚实支撑。

1. 用户管理

功能说明

用户管理模块用于统一维护系统操作人员的人员信息与系统账号，二者采用“分离绑定”设计：

• 人员信息：描述员工或操作者的组织属性（如姓名、所属部门等），独立于登录行为。

• 系统账号：用于身份认证和权限控制，包含登录凭证与角色授权。

人员信息可独立变更（如调岗、更名），不影响其绑定的登录账号；反之，账号状态（启用/禁用）仅影响登录能力，不删除人员档案。

主要操作

1. 新增人员

• 进入【人员管理】页面，点击“新增”。

• 填写姓名、所属部门、联系方式等基本信息，保存后生成唯一人员记录。

2. 编辑/删除人员信息

• 支持修改人员基本信息（如部门调整、姓名更正）。

• 删除人员前需确认未绑定任何启用状态的账号。或者账号和人员一起删除。

3. 新增系统账号

• 在系统账号页，创建登录账号。

• 设置登录账号（唯一）、账号名称、初始密码，并分配至少一个角色。

4. 分配角色

• 在账号新建或者编辑界面，从角色列表中勾选一个或多个角色。

• 账号将继承所选角色的菜单权限、操作权限及数据权限范围。

5. 状态管理

• 账号状态：支持“启用”或“禁用”。禁用后，该账号无法登录系统，但历史操作记录保留。

• 人员状态：主要用于组织架构展示与数据权限过滤，不影响账号登录（除非账号本身被禁用）。

6. 重置密码

• 管理员可为任意账号强制重置密码。

7. 删除账号

• 可删除不在使用的系统账号。

• 删除账号不会自动删除关联的人员信息，保障组织架构完整性。

2. 部门管理

功能说明

维护企业的多级组织架构（如公司 → 事业部 → 部门），以树形结构可视化展示，并作为数据权限隔离的基础单元。

主要操作

• 新增/编辑部门：设置部门编号、名称、上级部门，部门级别，部门排序，状态。

• 调整组织层级：通过修改上级部门，灵活调整部门隶属关系。

⚠️ 注意：删除部门前需确保其下无用户或子部门。

3. 菜单管理

功能说明

配置系统左侧导航菜单结构，并定义每个菜单项及按钮的操作权限标识（Permission Code），实现前端路由与后端权限的联动控制。

主要操作

• 新增菜单项：设置菜单名称、上级菜单、图标、打开方式、排序、状态、URL链接。

• 权限配置：为页面上设置增删改查的权限。

🔒 权限生效逻辑：用户仅能访问其角色所授权的菜单及按钮，未授权项将自动隐藏或禁用。

4. 角色管理

功能说明

角色管理：通过角色对用户进行分组管理，统一配置其可访问的菜单、操作权限及数据权限范。

流程角色： 通过对流程角色设置，来定义在工作流审批中的角色部门。

流程角色配置： 通过对流程角色人员配置，来定义在工作流审批中的人员。

主要操作

• 新增角色：输入角色编号，名称并选择状态。

• 修改角色：修改角色编号，名称并选择状态。

• 删除角色：删除不需要的角色信息。

• 角色权限分配：选择角色允许访问的菜单及按钮权限。

• 流程角色配置：设置工作流角色人员。

场景示例：配置多部门人员会签节点

在某些审批流程中，某一环节需多个部门的不同人员同时参与审核（即“会签”），且所有被选中的人员均需处理该任务后，流程方可继续流转。

配置步骤

1. 创建会签角色

   • 进入【流程角色管理】页面，点击“新增角色”。
   • 角色名称建议命名为“会签”或“XX业务会签组”。
   • 在“成员选择方式”中，选择 “按人员划分”（而非按角色或部门自动匹配）。

2. 指定会签人员

   • 进入【流程设计】或【流程角色配置】页面，找到对应流程的会签节点。
   • 在该节点绑定的角色字段中，选择刚创建的“会签”角色。
   • 点击角色名称后的 “姓名”输入框，双击打开人员选择器。
   • 在弹出的组织架构树中，跨部门勾选 N 个具体人员（支持搜索、多选）。
   • 确认后，所选人员将作为该节点的固定会签人。

3. 流程运行效果

   • 当单据流转至该会签节点时，所有被选中的 N 位人员将同时收到待办任务。
   • 根据流程策略（如“全部同意才通过”或“一人同意即通过”），系统等待满足条件后自动推进至下一节点。
   • 每位会签人可在自己的“待办任务”中查看并处理该单据。

✅ 优势说明
此方式适用于临时性、跨部门、非固定角色的协作场景（如项目评审、合规联审等），无需为每次审批新建角色，也避免了因组织变动频繁调整流程定义。

⚠️ 注意事项

• 若后续人员发生变动（如离职、调岗），需手动更新该流程角色中的会签人员列表。
• 建议在流程说明中注明会签规则（如是否需全员同意），便于参与者理解处理要求。

5. 数据字典

功能说明

数据字典用于集中管理业务系统中高频使用、相对固定的枚举类基础数据（如用户状态、性别、审批类型、单据状态等）。通过统一维护字典类别与字典项，确保前后端数据一致性，提升配置灵活性，并支持多语言标签扩展。

✅ 典型应用场景：下拉框选项、状态标签展示、报表分类维度等。

核心概念

术语	说明
字典类别（Dictionary Type）	字典的分类标识，在代码中引用（如 user_status、gender），建议使用英文小写+下划线命名。
字典名称（Dictionary Name）	字典类别的中文描述，仅用于界面展示（如“用户状态”、“性别”）。
字典项（Dictionary Item）	某个字典类别下的具体取值项，包含键（key）、值（label）、排序等属性。

主要操作

1. 新增字典类别

• 进入【数据字典】管理页面，点击“新增”。
• 填写以下信息：
  • 字典类别：系统内部唯一标识（如 approval_type），不可重复，建议使用英文。
  • 字典名称：面向用户的显示名称（如“审批类型”）。
  • 状态：启用后，该类别及其字典项才可在业务中使用。
  • 备注（可选）：说明用途或使用范围。
  • 保存后，即可为该类别添加字典项。

🔒 命名规范建议：避免使用中文、空格或特殊字符；推荐格式：模块_用途（如 order_status, doc_category）。

2. 维护字典项

• 在字典详情页下面的明细表格里可对字典项进行设置。
• 可执行以下操作：
  • 新增字典项：填写：
    • 字典类型：前端展示的文本（如“已批准”）。
    • 字典键值：程序中实际使用的值（如 01）。
    • 排序号：控制下拉选项或列表的显示顺序（数值越小越靠前）。
    • 状态：启用/禁用该选项。
    • 备注：补充说明（如适用场景）。
  • 编辑/删除字典项：支持修改内容或移除不再使用的选项（删除前请确认无业务数据引用）。

3. 启用/禁用字典项或类别

• 禁用字典类别：该类别下所有字典项将不可被新业务表单选用，但历史数据仍可正常显示。

• 禁用字典项：该选项将从下拉列表中隐藏，用户无法选择，但已选中的历史记录不受影响。

⚠️ 注意：建议不要删除字典类别，以免造成（已被业务数据引用的字典项）数据展示异常。

💡 最佳实践

• 所有静态下拉选项应优先通过数据字典配置，避免硬编码。

• 字典变更后，建议通知相关开发或测试人员同步验证业务逻辑。

6. 系统日志

功能说明

自动记录用户关键操作行为与系统异常事件，支持按时间、用户、操作类型等条件查询，便于审计追踪与问题排查。

• 操作日志：记录用户登录、数据操作等行为。

查询与导出

• 支持按日期范围、操作人筛选日志。

🔍 安全提示：日志内容仅对具备“系统日志查看”权限的角色开放，确保敏感信息受控。