docs: add cell storage protocol modules design for 2.2.6–2.2.10

Co-authored-by: Cursor <cursoragent@cursor.com>

web-admin/src/api/admin.ts

@@ -79,17 +79,15 @@ export function fetchDeleteTenant(id: string) {
 }
 
 // ---------------------------------------------------------------------------
-// 用户
+// 用户管理
 // ---------------------------------------------------------------------------
 
-export function fetchUserList(params: {
+export function fetchUserList(params?: {
   page?: number
   pageSize?: number
   keyword?: string
-  role?: string
-  roleIn?: string
-  regionId?: string
-  isActive?: boolean
+  deptId?: string
+  status?: string
 }) {
   return request.get<{
     list: Api.User.UserItem[]
@@ -104,84 +102,67 @@ export function fetchUserList(params: {
 }
 
 export function fetchUserDetail(id: string) {
-  return request.get<Api.User.UserDetail>({
+  return request.get<Api.User.UserItem>({
     url: `/web/admin/users/${id}`
   })
 }
 
 export function fetchCreateUser(data: {
-  username: string
+  userNo: string
+  nickName: string
   password: string
-  realName: string
-  phone?: string
-  role: string
-  regionId?: string
-  regionIds?: string[]
-  avatarUrl?: string | null
+  deptId?: string
+  email?: string
+  phoneNo?: string
+  sex?: string
+  avatar?: string
+  status?: string
+  orderNum?: number
+  remark?: string
+  roleIds?: string[]
+  postIds?: string[]
 }) {
   return request.post({
     url: '/web/admin/users',
-    data
+    data,
+    showSuccessMessage: true
   })
 }
 
 export function fetchUpdateUser(
   id: string,
   data: Partial<{
-    realName: string
-    phone?: string
-    role: string
-    regionId?: string
-    regionIds?: string[]
-    isActive: boolean
-    avatarUrl?: string | null
+    nickName: string
+    deptId: string
+    email: string
+    phoneNo: string
+    sex: string
+    avatar: string
+    status: string
+    orderNum: number
+    remark: string
+    roleIds: string[]
+    postIds: string[]
   }>
 ) {
   return request.put({
     url: `/web/admin/users/${id}`,
-    params: data
-  })
-}
-
-export function fetchAssignableMenuCodes() {
-  return request.get<{
-    list: Array<{
-      id: string
-      code: string
-      name: string
-      parentId?: string
-      sortOrder?: number
-    }>
-  }>({
-    url: '/web/admin/menus/assignable-codes'
-  })
-}
-
-export function fetchUserMenuScopes(userId: string) {
-  return request.get<{
-    userId: string
-    menuCodes: string[]
-  }>({
-    url: `/web/admin/users/${userId}/menu-scopes`
-  })
-}
-
-export function fetchUpdateUserMenuScopes(userId: string, menuCodes: string[]) {
-  return request.post({
-    url: `/web/admin/users/${userId}/menu-scopes`,
-    data: { menuCodes }
+    data,
+    showSuccessMessage: true
   })
 }
 
 export function fetchDeleteUser(id: string) {
   return request.del({
-    url: `/web/admin/users/${id}`
+    url: `/web/admin/users/${id}`,
+    showSuccessMessage: true
   })
 }
 
 export function fetchResetPassword(id: string) {
   return request.post({
-    url: `/web/admin/users/${id}/reset-password`
+    url: `/web/admin/users/${id}/reset-password`,
+    showSuccessMessage: true
   })
 }
 
@@ -572,3 +553,294 @@ export function fetchSaveProductParameterValues(
     params: { productId, values }
   })
 }
+
+// ---------------------------------------------------------------------------
+// 字典类型
+// ---------------------------------------------------------------------------
+
+export function fetchDictTypeList(params?: {
+  page?: number
+  pageSize?: number
+  keyword?: string
+}) {
+  return request.get<{
+    list: Api.Dict.DictTypeItem[]
+    total: number
+    page: number
+    pageSize: number
+    totalPages: number
+  }>({
+    url: '/web/admin/dict-types',
+    params
+  })
+}
+
+export function fetchCreateDictType(data: {
+  dictName: string
+  dictType: string
+  orderNum?: number
+  remark?: string
+}) {
+  return request.post({ url: '/web/admin/dict-types', params: data })
+}
+
+export function fetchUpdateDictType(
+  id: string,
+  data: Partial<{
+    dictName: string
+    dictType: string
+    orderNum: number
+    remark: string
+  }>
+) {
+  return request.put({ url: `/web/admin/dict-types/${id}`, params: data })
+}
+
+export function fetchDeleteDictType(id: string) {
+  return request.del({ url: `/web/admin/dict-types/${id}` })
+}
+
+// ---------------------------------------------------------------------------
+// 字典数据
+// ---------------------------------------------------------------------------
+
+export function fetchDictDataList(params?: {
+  page?: number
+  pageSize?: number
+  dictType?: string
+  keyword?: string
+}) {
+  return request.get<{
+    list: Api.Dict.DictDataItem[]
+    total: number
+    page: number
+    pageSize: number
+    totalPages: number
+  }>({
+    url: '/web/admin/dict-data',
+    params
+  })
+}
+
+export function fetchCreateDictData(data: {
+  dictLabel: string
+  dictValue: string
+  dictType: string
+  orderNum?: number
+  remark?: string
+}) {
+  return request.post({ url: '/web/admin/dict-data', params: data })
+}
+
+export function fetchUpdateDictData(
+  id: string,
+  data: Partial<{
+    dictLabel: string
+    dictValue: string
+    orderNum: number
+    remark: string
+  }>
+) {
+  return request.put({ url: `/web/admin/dict-data/${id}`, params: data })
+}
+
+export function fetchDeleteDictData(id: string) {
+  return request.del({ url: `/web/admin/dict-data/${id}` })
+}
+
+export function fetchDictDataOptions(dictType: string) {
+  return request.get<Api.Dict.DictDataOption[]>({
+    url: '/web/admin/dict-data/options',
+    params: { dictType }
+  })
+}
+
+// ---------------------------------------------------------------------------
+// 组织管理
+// ---------------------------------------------------------------------------
+
+export function fetchDeptTree(params?: { keyword?: string }) {
+  return request.get<Api.Dept.DeptItem[]>({
+    url: '/web/admin/depts',
+    params
+  })
+}
+
+export function fetchCreateDept(data: {
+  parentId?: string
+  deptName: string
+  deptCategoryCode?: string
+  status?: string
+  leader?: string
+  leaderPhone?: string
+  orderNum?: number
+  remark?: string
+}) {
+  return request.post({ url: '/web/admin/depts', params: data })
+}
+
+export function fetchUpdateDept(
+  id: string,
+  data: Partial<{
+    deptName: string
+    deptCategoryCode: string
+    status: string
+    leader: string
+    leaderPhone: string
+    orderNum: number
+    remark: string
+  }>
+) {
+  return request.put({ url: `/web/admin/depts/${id}`, params: data })
+}
+
+export function fetchDeleteDept(id: string) {
+  return request.del({ url: `/web/admin/depts/${id}` })
+}
+
+// ---------------------------------------------------------------------------
+// 站点管理
+// ---------------------------------------------------------------------------
+
+export function fetchSiteList(params?: { page?: number; pageSize?: number; keyword?: string }) {
+  return request.get<{ list: Api.Site.SiteItem[]; total: number; page: number; pageSize: number; totalPages: number }>({ url: '/web/admin/sites', params })
+}
+export function fetchCreateSite(data: { siteName: string; siteCode: string; siteType?: string; status?: string; address?: string; contactName?: string; contactPhone?: string; businessScope?: string; orderNum?: number; remark?: string }) {
+  return request.post({ url: '/web/admin/sites', params: data })
+}
+export function fetchUpdateSite(id: string, data: Partial<{ siteName: string; siteCode: string; siteType: string; status: string; address: string; contactName: string; contactPhone: string; businessScope: string; orderNum: number; remark: string }>) {
+  return request.put({ url: `/web/admin/sites/${id}`, params: data })
+}
+export function fetchDeleteSite(id: string) {
+  return request.del({ url: `/web/admin/sites/${id}` })
+}
+
+// ---------------------------------------------------------------------------
+// 职位管理
+// ---------------------------------------------------------------------------
+
+export function fetchPostList(params?: { page?: number; pageSize?: number; keyword?: string }) {
+  return request.get<{ list: Api.Post.PostItem[]; total: number; page: number; pageSize: number; totalPages: number }>({ url: '/web/admin/posts', params })
+}
+export function fetchCreatePost(data: { postName: string; postCode: string; status?: string; orderNum?: number; remark?: string }) {
+  return request.post({ url: '/web/admin/posts', params: data })
+}
+export function fetchUpdatePost(id: string, data: Partial<{ postName: string; postCode: string; status: string; orderNum: number; remark: string }>) {
+  return request.put({ url: `/web/admin/posts/${id}`, params: data })
+}
+export function fetchDeletePost(id: string) {
+  return request.del({ url: `/web/admin/posts/${id}` })
+}
+
+// ---------------------------------------------------------------------------
+// 物品单位管理
+// ---------------------------------------------------------------------------
+
+export function fetchItemUnitList(params?: { page?: number; pageSize?: number; keyword?: string }) {
+  return request.get<{ list: Api.ItemUnit.ItemUnitItem[]; total: number; page: number; pageSize: number; totalPages: number }>({ url: '/web/admin/item-units', params })
+}
+export function fetchCreateItemUnit(data: { unitCode: string; unitName: string; orderNum?: number; remark?: string }) {
+  return request.post({ url: '/web/admin/item-units', params: data })
+}
+export function fetchUpdateItemUnit(id: string, data: Partial<{ unitCode: string; unitName: string; orderNum: number; remark: string }>) {
+  return request.put({ url: `/web/admin/item-units/${id}`, params: data })
+}
+export function fetchDeleteItemUnit(id: string) {
+  return request.del({ url: `/web/admin/item-units/${id}` })
+}
+
+// ---------------------------------------------------------------------------
+// 快递公司管理
+// ---------------------------------------------------------------------------
+
+export function fetchExpressCompanyList(params?: { page?: number; pageSize?: number; keyword?: string }) {
+  return request.get<{ list: Api.ExpressCompany.ExpressCompanyItem[]; total: number; page: number; pageSize: number; totalPages: number }>({ url: '/web/admin/express-companies', params })
+}
+export function fetchCreateExpressCompany(data: { expressCode: string; expressName: string; orderNum?: number; remark?: string }) {
+  return request.post({ url: '/web/admin/express-companies', params: data })
+}
+export function fetchUpdateExpressCompany(id: string, data: Partial<{ expressCode: string; expressName: string; orderNum: number; remark: string }>) {
+  return request.put({ url: `/web/admin/express-companies/${id}`, params: data })
+}
+export function fetchDeleteExpressCompany(id: string) {
+  return request.del({ url: `/web/admin/express-companies/${id}` })
+}
+
+// ---------------------------------------------------------------------------
+// 菜单管理
+// ---------------------------------------------------------------------------
+
+export function fetchMenuTree(params?: { keyword?: string }) {
+  return request.get<Api.Menu.MenuItem[]>({
+    url: '/web/admin/menus',
+    params
+  })
+}
+
+export function fetchCreateMenu(data: {
+  menuName: string
+  parentId?: string
+  menuType?: string
+  path?: string
+  component?: string
+  perms?: string
+  isFrame?: number
+  visible?: string
+  status?: string
+  orderNum?: number
+  remark?: string
+}) {
+  return request.post({ url: '/web/admin/menus', params: data })
+}
+
+export function fetchUpdateMenu(
+  id: string,
+  data: Partial<{
+    menuName: string
+    parentId: string
+    menuType: string
+    path: string
+    component: string
+    perms: string
+    isFrame: number
+    visible: string
+    status: string
+    orderNum: number
+    remark: string
+  }>
+) {
+  return request.put({ url: `/web/admin/menus/${id}`, params: data })
+}
+
+export function fetchDeleteMenu(id: string) {
+  return request.del({ url: `/web/admin/menus/${id}` })
+}
+
+// ---------------------------------------------------------------------------
+// 角色管理
+// ---------------------------------------------------------------------------
+
+export function fetchRoleList(params?: { page?: number; pageSize?: number; keyword?: string }) {
+  return request.get<{ list: Api.Role.RoleItem[]; total: number; page: number; pageSize: number; totalPages: number }>({ url: '/web/admin/role-management', params })
+}
+export function fetchCreateRole(data: { roleName: string; dataScope?: string; status?: string; orderNum?: number; remark?: string }) {
+  return request.post({ url: '/web/admin/role-management', params: data, showSuccessMessage: true })
+}
+export function fetchUpdateRole(id: string, data: Partial<{ roleName: string; dataScope: string; status: string; orderNum: number; remark: string }>) {
+  return request.put({ url: `/web/admin/role-management/${id}`, params: data, showSuccessMessage: true })
+}
+export function fetchDeleteRole(id: string) {
+  return request.del({ url: `/web/admin/role-management/${id}`, showSuccessMessage: true })
+}
+export function fetchRoleMenuIds(roleId: string) {
+  return request.get<{ menuIds: string[] }>({ url: `/web/admin/role-management/${roleId}/menus` })
+}
+export function fetchUpdateRoleMenus(roleId: string, menuIds: string[]) {
+  return request.put({ url: `/web/admin/role-management/${roleId}/menus`, params: { menuIds }, showSuccessMessage: true })
+}
+export function fetchRoleDataScope(roleId: string) {
+  return request.get<{ dataScope: string; scopeDetails: Array<{ scopeType: string; scopeValue: string }> }>({ url: `/web/admin/role-management/${roleId}/data-scope` })
+}
+export function fetchUpdateRoleDataScope(roleId: string, data: { dataScope: string; scopeDetails?: Array<{ scopeType: string; scopeValue: string }> }) {
+  return request.put({ url: `/web/admin/role-management/${roleId}/data-scope`, params: data, showSuccessMessage: true })
+}