adspecs 0.1.12

package/references/antd-front-demo/src/api/auth.ts

@@ -0,0 +1,41 @@
+import request from '@/utils/request';
+import type { ApiResponse } from '@/types/api';
+import type {
+  LoginParams,
+  LoginResult,
+  AuthPermissionInfo,
+  UserInfo,
+  UpdateProfileParams,
+  UpdatePasswordParams,
+  RegisterParams,
+  ResetPasswordParams,
+} from '@/types/auth';
+
+export const loginApi = (params: LoginParams) =>
+  request.post<unknown, ApiResponse<LoginResult>>('/system/auth/login', params);
+
+export const logoutApi = () =>
+  request.post<unknown, ApiResponse<null>>('/system/auth/logout');
+
+export const getAuthPermissionInfoApi = () =>
+  request.get<unknown, ApiResponse<AuthPermissionInfo>>('/system/auth/get-permission-info');
+
+export const getUserProfileApi = () =>
+  request.get<unknown, ApiResponse<UserInfo>>('/system/user/profile/get');
+
+export const updateUserProfileApi = (data: UpdateProfileParams) =>
+  request.put<unknown, ApiResponse<boolean>>('/system/user/profile/update', data);
+
+export const updateUserPasswordApi = (data: UpdatePasswordParams) =>
+  request.put<unknown, ApiResponse<boolean>>('/system/user/profile/update-password', data);
+
+export const registerApi = (data: RegisterParams) =>
+  request.post<unknown, ApiResponse<null>>('/system/auth/register', data);
+
+export const resetPasswordApi = (data: ResetPasswordParams) =>
+  request.post<unknown, ApiResponse<null>>('/system/auth/reset-password', data);
+
+export const refreshAccessTokenApi = (refreshToken: string) =>
+  request.post<unknown, ApiResponse<LoginResult>>(
+    `/system/auth/refresh-token?refreshToken=${refreshToken}`,
+  );

package/references/antd-front-demo/src/api/mdm/codeRule.ts

@@ -0,0 +1,23 @@
+import request from '@/utils/request';
+import type { ApiResponse, PageResult } from '@/types/api';
+import type { CodeRuleVO, CodeRuleSaveParams, CodeRulePageParams } from '@/types/mdm/codeRule';
+
+/** Paginated code-rule list */
+export const getCodeRulePage = (params: CodeRulePageParams) =>
+  request.get<unknown, ApiResponse<PageResult<CodeRuleVO>>>('/mdm/code-rule/page', { params });
+
+/** Get single code-rule by id */
+export const getCodeRule = (id: number) =>
+  request.get<unknown, ApiResponse<CodeRuleVO>>(`/mdm/code-rule/get?id=${id}`);
+
+/** Create code-rule */
+export const createCodeRule = (data: CodeRuleSaveParams) =>
+  request.post<unknown, ApiResponse<number>>('/mdm/code-rule/create', data);
+
+/** Update code-rule */
+export const updateCodeRule = (data: CodeRuleSaveParams) =>
+  request.put<unknown, ApiResponse<boolean>>('/mdm/code-rule/update', data);
+
+/** Delete code-rule */
+export const deleteCodeRule = (id: number) =>
+  request.delete<unknown, ApiResponse<boolean>>(`/mdm/code-rule/delete?id=${id}`);

package/references/antd-front-demo/src/api/mdm/coding-system.ts

@@ -0,0 +1,130 @@
+import request from '@/utils/request';
+import type { ApiResponse, PageResult } from '@/types/api';
+import type {
+  CodeRuleVO,
+  CodeRuleSaveParams,
+  CodeRulePageParams,
+  CodeLogVO,
+  CodeLogPageParams,
+  CodeMappingVO,
+  CodeMappingSaveParams,
+  CodeMappingPageParams,
+  ApprovalVO,
+  SyncRecordVO,
+  VariableDictVO,
+  SeqPoolVO,
+} from '@/types/mdm/coding-system';
+
+// ========== 编码规则 ==========
+
+/** 编码规则分页 */
+export const getCodeRulePage = (params: CodeRulePageParams) =>
+  request.get<unknown, ApiResponse<PageResult<CodeRuleVO>>>('/mdm/code-rule/page', { params });
+
+/** 编码规则详情 */
+export const getCodeRule = (id: number) =>
+  request.get<unknown, ApiResponse<CodeRuleVO>>(`/mdm/code-rule/get?id=${id}`);
+
+/** 创建编码规则 */
+export const createCodeRule = (data: CodeRuleSaveParams) =>
+  request.post<unknown, ApiResponse<number>>('/mdm/code-rule/create', data);
+
+/** 更新编码规则 */
+export const updateCodeRule = (data: CodeRuleSaveParams) =>
+  request.put<unknown, ApiResponse<boolean>>('/mdm/code-rule/update', data);
+
+/** 删除编码规则 */
+export const deleteCodeRule = (id: number) =>
+  request.delete<unknown, ApiResponse<boolean>>(`/mdm/code-rule/delete?id=${id}`);
+
+// ========== 编码生成日志 ==========
+
+/** 编码生成日志分页 */
+export const getCodeLogPage = (params: CodeLogPageParams) =>
+  request.get<unknown, ApiResponse<PageResult<CodeLogVO>>>('/mdm/code-log/page', { params });
+
+// ========== 编码对照 ==========
+
+/** 编码对照分页 */
+export const getCodeMappingPage = (params: CodeMappingPageParams) =>
+  request.get<unknown, ApiResponse<PageResult<CodeMappingVO>>>('/mdm/code-mapping/page', { params });
+
+/** 创建编码对照 */
+export const createCodeMapping = (data: CodeMappingSaveParams) =>
+  request.post<unknown, ApiResponse<number>>('/mdm/code-mapping/create', data);
+
+/** 删除编码对照 */
+export const deleteCodeMapping = (id: number) =>
+  request.delete<unknown, ApiResponse<boolean>>(`/mdm/code-mapping/delete?id=${id}`);
+
+// ========== 审批管理 ==========
+
+/** 审批任务分页（待审批/已审批/我提交的） */
+export const getApprovalPage = (params: { pageNo: number; pageSize: number; tab?: string }) =>
+  request.get<unknown, ApiResponse<PageResult<ApprovalVO>>>('/mdm/approval/page', { params });
+
+// ========== 同步管理 ==========
+
+/** 同步记录分页 */
+export const getSyncRecordPage = (params: { pageNo: number; pageSize: number; system?: string; status?: string }) =>
+  request.get<unknown, ApiResponse<PageResult<SyncRecordVO>>>('/mdm/sync-record/page', { params });
+
+/** 重新同步 */
+export const retrySync = (id: number) =>
+  request.post<unknown, ApiResponse<boolean>>(`/mdm/sync-record/retry?id=${id}`);
+
+// ========== 变量字典 ==========
+
+/** 变量字典分页 */
+export const getVariableDictPage = (params: { pageNo: number; pageSize: number; scope?: string }) =>
+  request.get<unknown, ApiResponse<PageResult<VariableDictVO>>>('/mdm/variable-dict/page', { params });
+
+/** 获取单个变量 */
+export const getVariableDict = (id: number) =>
+  request.get<unknown, ApiResponse<VariableDictVO>>(`/mdm/variable-dict/get?id=${id}`);
+
+/** 保存变量 */
+export const saveVariableDict = (data: Partial<VariableDictVO>) =>
+  request.post<unknown, ApiResponse<boolean>>('/mdm/variable-dict/save', data);
+
+/** 停用变量 */
+export const disableVariableDict = (id: number) =>
+  request.post<unknown, ApiResponse<boolean>>(`/mdm/variable-dict/disable?id=${id}`);
+
+// ========== 序列池 ==========
+
+/** 根据规则编码查序列池 */
+export const getSeqPoolByRule = (ruleCode: string) =>
+  request.get<unknown, ApiResponse<SeqPoolVO[]>>(`/mdm/seq-pool/list?ruleCode=${ruleCode}`);
+
+// ========== 批量导入 ==========
+
+/** 导入历史编码 */
+export const importHistoryCodes = (file: File) => {
+  const formData = new FormData();
+  formData.append('file', file);
+  return request.post<unknown, ApiResponse<{ successCount: number; failCount: number; errors?: Array<{ row: number; field: string; value: string; error: string }> }>>('/mdm/code-log/import', formData, {
+    headers: { 'Content-Type': 'multipart/form-data' },
+  });
+};
+
+/** 导入编码对照 */
+export const importCodeMappings = (file: File) => {
+  const formData = new FormData();
+  formData.append('file', file);
+  return request.post<unknown, ApiResponse<{ successCount: number; failCount: number; errors?: Array<{ row: number; field: string; value: string; error: string }> }>>('/mdm/code-mapping/import', formData, {
+    headers: { 'Content-Type': 'multipart/form-data' },
+  });
+};
+
+/** 下载模板 */
+export const downloadTemplate = (type: 'history' | 'mapping') =>
+  request.get<unknown, Blob>(`/mdm/template/download?type=${type}`, { responseType: 'blob' });
+
+/** 导出编码规则 */
+export const exportCodeRules = (params?: Record<string, unknown>) =>
+  request.get<unknown, Blob>('/mdm/code-rule/export', { params, responseType: 'blob' });
+
+/** 导出编码日志 */
+export const exportCodeLogs = (params?: Record<string, unknown>) =>
+  request.get<unknown, Blob>('/mdm/code-log/export', { params, responseType: 'blob' });

package/references/antd-front-demo/src/api/system/dept.ts

@@ -0,0 +1,38 @@
+import request from '@/utils/request';
+import type { ApiResponse } from '@/types/api';
+
+export interface SystemDept {
+  id?: number;
+  name: string;
+  parentId: number;
+  status: number;
+  sort: number;
+  leaderUserId: number;
+  phone: string;
+  email: string;
+  createTime?: string;
+}
+
+/** Get full department tree (non-paginated) */
+export const getDeptList = () =>
+  request.get<unknown, ApiResponse<SystemDept[]>>('/system/dept/list');
+
+/** Simple (non-paginated) department list – used for dropdowns */
+export const getSimpleDeptList = () =>
+  request.get<unknown, ApiResponse<SystemDept[]>>('/system/dept/simple-list');
+
+/** Get single department by id */
+export const getDept = (id: number) =>
+  request.get<unknown, ApiResponse<SystemDept>>(`/system/dept/get?id=${id}`);
+
+/** Create department */
+export const createDept = (data: SystemDept) =>
+  request.post<unknown, ApiResponse<number>>('/system/dept/create', data);
+
+/** Update department */
+export const updateDept = (data: SystemDept) =>
+  request.put<unknown, ApiResponse<boolean>>('/system/dept/update', data);
+
+/** Delete department */
+export const deleteDept = (id: number) =>
+  request.delete<unknown, ApiResponse<boolean>>(`/system/dept/delete?id=${id}`);

package/references/antd-front-demo/src/api/system/dict-data.ts

@@ -0,0 +1,42 @@
+import request from '@/utils/request';
+import type { ApiResponse, PageParams, PageResult } from '@/types/api';
+
+export interface DictData {
+  id?: number;
+  sort: number;
+  label: string;
+  value: string;
+  dictType: string;
+  status: number;
+  colorType: string;
+  cssClass: string;
+  remark: string;
+  createTime?: string;
+}
+
+/** Paginated dict-data list */
+export const getDictDataPage = (params: PageParams) =>
+  request.get<unknown, ApiResponse<PageResult<DictData>>>('/system/dict-data/page', { params });
+
+/** Get single dict-data by id */
+export const getDictData = (id: number) =>
+  request.get<unknown, ApiResponse<DictData>>(`/system/dict-data/get?id=${id}`);
+
+/** Create dict-data */
+export const createDictData = (data: DictData) =>
+  request.post<unknown, ApiResponse<number>>('/system/dict-data/create', data);
+
+/** Update dict-data */
+export const updateDictData = (data: DictData) =>
+  request.put<unknown, ApiResponse<boolean>>('/system/dict-data/update', data);
+
+/** Delete dict-data */
+export const deleteDictData = (id: number) =>
+  request.delete<unknown, ApiResponse<boolean>>(`/system/dict-data/delete?id=${id}`);
+
+/**
+ * Get ALL dict data (non-paginated).
+ * Used by useDictStore on app init to populate the local cache.
+ */
+export const getSimpleDictDataList = () =>
+  request.get<unknown, ApiResponse<DictData[]>>('/system/dict-data/simple-list');

package/references/antd-front-demo/src/api/system/dict-type.ts

@@ -0,0 +1,35 @@
+import request from '@/utils/request';
+import type { ApiResponse, PageParams, PageResult } from '@/types/api';
+
+export interface DictType {
+  id?: number;
+  name: string;
+  type: string;
+  status: number;
+  remark: string;
+  createTime?: string;
+}
+
+/** Paginated dict-type list */
+export const getDictTypePage = (params: PageParams) =>
+  request.get<unknown, ApiResponse<PageResult<DictType>>>('/system/dict-type/page', { params });
+
+/** Get single dict-type by id */
+export const getDictType = (id: number) =>
+  request.get<unknown, ApiResponse<DictType>>(`/system/dict-type/get?id=${id}`);
+
+/** Create dict-type */
+export const createDictType = (data: DictType) =>
+  request.post<unknown, ApiResponse<number>>('/system/dict-type/create', data);
+
+/** Update dict-type */
+export const updateDictType = (data: DictType) =>
+  request.put<unknown, ApiResponse<boolean>>('/system/dict-type/update', data);
+
+/** Delete dict-type */
+export const deleteDictType = (id: number) =>
+  request.delete<unknown, ApiResponse<boolean>>(`/system/dict-type/delete?id=${id}`);
+
+/** Simple (non-paginated) dict-type list – used for dropdowns */
+export const getSimpleDictTypeList = () =>
+  request.get<unknown, ApiResponse<DictType[]>>('/system/dict-type/simple-list');

package/references/antd-front-demo/src/api/system/menu.ts

@@ -0,0 +1,38 @@
+import request from '@/utils/request';
+import type { ApiResponse } from '@/types/api';
+
+export interface SystemMenu {
+  id?: number;
+  name: string;
+  permission: string;
+  type: number;
+  sort: number;
+  parentId: number;
+  path: string;
+  icon: string;
+  component: string;
+  status: number;
+  visible: boolean;
+  keepAlive: boolean;
+  createTime?: string;
+}
+
+/** Get full menu tree (non-paginated) */
+export const getMenuList = () =>
+  request.get<unknown, ApiResponse<SystemMenu[]>>('/system/menu/list');
+
+/** Get single menu by id */
+export const getMenu = (id: number) =>
+  request.get<unknown, ApiResponse<SystemMenu>>(`/system/menu/get?id=${id}`);
+
+/** Create menu */
+export const createMenu = (data: SystemMenu) =>
+  request.post<unknown, ApiResponse<number>>('/system/menu/create', data);
+
+/** Update menu */
+export const updateMenu = (data: SystemMenu) =>
+  request.put<unknown, ApiResponse<boolean>>('/system/menu/update', data);
+
+/** Delete menu */
+export const deleteMenu = (id: number) =>
+  request.delete<unknown, ApiResponse<boolean>>(`/system/menu/delete?id=${id}`);

package/references/antd-front-demo/src/api/system/post.ts

@@ -0,0 +1,15 @@
+import request from '@/utils/request';
+import type { ApiResponse } from '@/types/api';
+
+export interface SystemPost {
+  id?: number;
+  name: string;
+  code: string;
+  sort: number;
+  status: number;
+  createTime?: string;
+}
+
+/** Simple (non-paginated) post list – used for dropdowns */
+export const getSimplePostList = () =>
+  request.get<unknown, ApiResponse<SystemPost[]>>('/system/post/simple-list');

package/references/antd-front-demo/src/api/system/role.ts

@@ -0,0 +1,42 @@
+import request from '@/utils/request';
+import type { ApiResponse, PageParams, PageResult } from '@/types/api';
+
+export interface SystemRole {
+  id?: number;
+  name: string;
+  code: string;
+  sort: number;
+  status: number;
+  type: number;
+  dataScope: number;
+  dataScopeDeptIds: number[];
+  createTime?: string;
+}
+
+/** Paginated role list */
+export const getRolePage = (params: PageParams) =>
+  request.get<unknown, ApiResponse<PageResult<SystemRole>>>('/system/role/page', { params });
+
+/** Simple (non-paginated) role list – used for dropdowns */
+export const getSimpleRoleList = () =>
+  request.get<unknown, ApiResponse<SystemRole[]>>('/system/role/simple-list');
+
+/** Get single role by id */
+export const getRole = (id: number) =>
+  request.get<unknown, ApiResponse<SystemRole>>(`/system/role/get?id=${id}`);
+
+/** Create role */
+export const createRole = (data: SystemRole) =>
+  request.post<unknown, ApiResponse<number>>('/system/role/create', data);
+
+/** Update role */
+export const updateRole = (data: SystemRole) =>
+  request.put<unknown, ApiResponse<boolean>>('/system/role/update', data);
+
+/** Delete single role */
+export const deleteRole = (id: number) =>
+  request.delete<unknown, ApiResponse<boolean>>(`/system/role/delete?id=${id}`);
+
+/** Batch delete roles */
+export const deleteRoleList = (ids: number[]) =>
+  request.delete<unknown, ApiResponse<boolean>>('/system/role/delete-list', { data: { ids } });

package/references/antd-front-demo/src/api/system/user.ts

@@ -0,0 +1,48 @@
+import request from '@/utils/request';
+import type { ApiResponse, PageParams, PageResult } from '@/types/api';
+
+export interface SystemUser {
+  id?: number;
+  username: string;
+  nickname: string;
+  deptId: number;
+  postIds: string[];
+  email: string;
+  mobile: string;
+  sex: number;
+  avatar: string;
+  loginIp: string;
+  status: number;
+  remark: string;
+  createTime?: string;
+  /** Added by mock / joined from dept table */
+  deptName?: string;
+}
+
+/** Paginated user list */
+export const getUserPage = (params: PageParams) =>
+  request.get<unknown, ApiResponse<PageResult<SystemUser>>>('/system/user/page', { params });
+
+/** Get single user by id */
+export const getUser = (id: number) =>
+  request.get<unknown, ApiResponse<SystemUser>>(`/system/user/get?id=${id}`);
+
+/** Create user */
+export const createUser = (data: SystemUser) =>
+  request.post<unknown, ApiResponse<number>>('/system/user/create', data);
+
+/** Update user */
+export const updateUser = (data: SystemUser) =>
+  request.put<unknown, ApiResponse<boolean>>('/system/user/update', data);
+
+/** Delete single user */
+export const deleteUser = (id: number) =>
+  request.delete<unknown, ApiResponse<boolean>>(`/system/user/delete?id=${id}`);
+
+/** Batch delete users */
+export const deleteUserList = (ids: number[]) =>
+  request.delete<unknown, ApiResponse<boolean>>('/system/user/delete-list', { data: { ids } });
+
+/** Update user status (enable / disable) */
+export const updateUserStatus = (id: number, status: number) =>
+  request.put<unknown, ApiResponse<boolean>>('/system/user/update-status', { id, status });

package/references/antd-front-demo/src/components/Access/index.tsx

@@ -0,0 +1,14 @@
+import type { ReactNode } from 'react';
+import { useAccess } from '@/hooks/useAccess';
+
+interface AccessProps {
+  code: string;
+  children: ReactNode;
+  fallback?: ReactNode;
+}
+
+export function Access({ code, children, fallback }: AccessProps) {
+  const hasAccess = useAccess(code);
+  if (hasAccess) return <>{children}</>;
+  return fallback ? <>{fallback}</> : null;
+}

package/references/antd-front-demo/src/components/DictTag/index.tsx

@@ -0,0 +1,29 @@
+import React from 'react';
+import { Tag } from 'antd';
+import { useDictStore } from '@/stores/useDictStore';
+
+interface DictTagProps {
+  type: string;
+  value: string | number | undefined;
+}
+
+const colorMap: Record<string, string> = {
+  default: 'default',
+  primary: 'blue',
+  success: 'green',
+  warning: 'orange',
+  danger: 'red',
+  info: 'cyan',
+};
+
+const DictTag: React.FC<DictTagProps> = ({ type, value }) => {
+  const getDictOptions = useDictStore((s) => s.getDictOptions);
+  if (value === undefined || value === null) return null;
+  const options = getDictOptions(type);
+  const item = options.find((d) => String(d.value) === String(value));
+  if (!item) return <span>{value}</span>;
+  const color = colorMap[item.colorType] || item.colorType || 'default';
+  return <Tag color={color}>{item.label}</Tag>;
+};
+
+export default DictTag;

package/references/antd-front-demo/src/components/Footer/index.tsx

@@ -0,0 +1,35 @@
+import { theme } from 'antd';
+
+interface Props {
+  /** Override the title shown next to the copyright. Defaults to VITE_APP_TITLE. */
+  title?: string;
+  /** Footer height in px. Defaults to 50. */
+  height?: number;
+}
+
+/**
+ * 全局页脚 — 居中显示版权信息（年份自动取当前）。
+ */
+const Footer: React.FC<Props> = ({ title, height = 50 }) => {
+  const { token } = theme.useToken();
+  const currentYear = new Date().getFullYear();
+  const text = title ?? import.meta.env.VITE_APP_TITLE ?? '';
+  return (
+    <div
+      style={{
+        height,
+        lineHeight: `${height}px`,
+        textAlign: 'center',
+        background: token.colorBgLayout,
+        color: token.colorTextPlaceholder,
+        overflow: 'hidden',
+      }}
+    >
+      <span style={{ fontSize: 14 }}>
+        Copyright ©{currentYear} {text}
+      </span>
+    </div>
+  );
+};
+
+export default Footer;