Vue / 系统课时

项目需求与领域拆分

项目需求与领域拆分

企业管理后台最容易失控的地方,不是页面数量,而是把“用户、权限、导航和业务数据”混在同一个模块里。本节先把需求还原为领域对象,再确定页面、状态与模块边界,得到后续可以直接落地的项目结构。

学习目标

  • 区分用户、角色、菜单与业务资源各自负责的数据和行为
  • 根据业务动作确定页面边界,而不是按接口数量拆页面
  • 用依赖方向检查模块划分,避免权限、导航和业务代码互相耦合

从业务动作反推领域

先不要从“要做几个列表页”开始,而是列出管理员真正要完成的动作:创建用户、给用户分配角色、给角色授权菜单、维护业务资源、查看操作结果。动作的主语和对象稳定下来后,领域边界通常会比页面名称更清楚。

这里要特别区分四类对象。用户表示可登录主体,角色承载一组权限,菜单负责前端导航和可见入口,业务资源则是订单、客户、项目等真正被管理的数据。菜单是否可见与资源是否可操作有关,但二者不是同一个概念。

用户、角色、菜单与业务资源的领域关系

建立领域对象与页面边界

页面应围绕一个完整管理任务,而不是围绕单个接口。列表、筛选、详情、编辑如果共同服务于同一对象,可以归在一个领域模块中;跨领域的授权动作则应由明确的编排页面承接。

领域 主要职责 典型页面
用户 账号资料、状态、角色绑定 用户列表、用户详情或编辑
角色 角色信息、成员范围、权限集合 角色列表、角色授权
菜单 导航树、路由入口、显示顺序 菜单树维护
业务资源 领域数据及其业务操作 订单、客户、项目等资源页面

例如“给用户分配角色”可以放在用户详情中,因为操作入口属于用户上下文;“给角色分配菜单权限”则属于角色授权,因为权限集合的拥有者是角色。这样划分后,页面职责与领域对象的所有权保持一致。

领域关系可以进一步收敛成最小数据结构。下面是片段示例,只表达所有权和引用方向,不包含接口实现。

ts
type Id = string

interface User {
  id: Id
  roleIds: Id[]
}

interface Role {
  id: Id
  menuIds: Id[]
  permissions: ResourcePermission[]
}

interface MenuItem {
  id: Id
  routeName: string
}

interface ResourcePermission {
  resource: 'customer' | 'order' | 'project'
  actions: Array<'read' | 'create' | 'update' | 'delete'>
}

这里让用户只保存角色标识,让角色持有菜单标识和资源权限,而菜单本身不反向保存角色。验证这种结构是否合理,可以尝试新增一种业务资源:如果只需要扩展 ResourcePermission 和对应领域模块,而不必修改用户结构,说明边界方向基本正确。

用用户故事校验拆分

把需求写成可验收的用户故事,再检查每个故事是否只跨越必要的边界。一个适合本项目的最小集合可以是:

  1. 管理员能创建用户,并启用或停用账号。
  2. 管理员能为用户分配一个或多个角色。
  3. 管理员能维护角色,并配置该角色可访问的菜单。
  4. 管理员能进入某个业务模块,对资源执行查看、创建或修改操作。
  5. 当权限不足时,导航入口与业务操作都必须被正确限制。

如果某个故事需要一个页面同时直接修改用户、角色、菜单和业务资源四套状态,通常说明页面承担了过多职责。更稳妥的做法是让页面负责流程编排,领域模块分别负责自己的数据、校验和请求。

固定模块依赖方向

领域模块之间应尽量通过标识符和明确的用例协作,而不是互相读写内部 Store。用户模块可以保存 roleIds,但不应该直接维护角色模块的完整权限树;角色模块可以保存 menuIds,但菜单树的结构和排序规则仍由菜单模块负责。

跨领域复用的请求封装、错误处理、日期格式化和通用组件放入共享层;只属于某个领域的类型、Store、API 和页面则留在对应领域。这样新增一个业务资源时,只需要增加自己的模块,并接入既有权限与公共能力,而不必修改用户或菜单模块的内部实现。

形成可执行需求清单

进入编码前,至少要确定四类产物:领域对象及主键、页面清单及入口、关键业务动作、权限控制点。对每个页面还要能回答“它管理谁的状态”“它调用哪个领域能力”“失败时由谁反馈”。

这份清单的价值在于把后续架构决策变成可验证约束:页面可以增加,但领域所有权不能随意漂移;公共能力可以复用,但不能反向依赖具体业务模块。做到这一点,项目规模扩大后仍能保持清晰的模块边界。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

项目需求与领域拆分

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通