adspecs 0.1.12

package/references/antd-front-demo/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "sie-front-demo",
+  "private": true,
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "lint": "eslint .",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@ant-design/icons": "^6.2.3",
+    "@ant-design/pro-components": "^3.1.3-0",
+    "antd": "^6.4.3",
+    "axios": "^1.16.1",
+    "dayjs": "^1.11.13",
+    "i18next": "^26.2.0",
+    "i18next-resources-to-backend": "^1.2.1",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "react-i18next": "^17.0.8",
+    "react-router": "^7.15.1",
+    "react-router-dom": "^7.15.1",
+    "zustand": "^5.0.13"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.4",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/node": "^24.12.2",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.2",
+    "eslint": "^9.39.4",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "eslint-plugin-react-refresh": "^0.5.2",
+    "globals": "^17.5.0",
+    "jsdom": "^29.1.1",
+    "msw": "^2.13.4",
+    "typescript": "~6.0.2",
+    "typescript-eslint": "^8.58.2",
+    "vite": "^8.0.9",
+    "vitest": "^4.1.7"
+  },
+  "msw": {
+    "workerDirectory": [
+      "public"
+    ]
+  }
+}

package/references/antd-front-demo/public/favicon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100">
+  <rect width="100" height="100" rx="20" fill="#1677ff"/>
+  <text x="50" y="65" text-anchor="middle" fill="white" font-size="48" font-weight="bold" font-family="Arial">S</text>
+</svg>

package/references/antd-front-demo/public/mockServiceWorker.js

@@ -0,0 +1,361 @@
+/* eslint-disable */
+/* tslint:disable */
+
+/**
+ * Mock Service Worker.
+ * @see https://github.com/mswjs/msw
+ * - Please do NOT modify this file.
+ */
+
+const PACKAGE_VERSION = '2.15.0'
+const INTEGRITY_CHECKSUM = '03cb67ac84128e63d7cd722a6e5b7f1e'
+const IS_MOCKED_RESPONSE = Symbol('isMockedResponse')
+const activeClientIds = new Set()
+
+addEventListener('install', function () {
+  self.skipWaiting()
+})
+
+addEventListener('activate', function (event) {
+  event.waitUntil(self.clients.claim())
+})
+
+addEventListener('message', async function (event) {
+  const clientId = Reflect.get(event.source || {}, 'id')
+
+  if (!clientId || !self.clients) {
+    return
+  }
+
+  const client = await self.clients.get(clientId)
+
+  if (!client) {
+    return
+  }
+
+  const allClients = await self.clients.matchAll({
+    type: 'window',
+  })
+
+  switch (event.data) {
+    case 'KEEPALIVE_REQUEST': {
+      sendToClient(client, {
+        type: 'KEEPALIVE_RESPONSE',
+      })
+      break
+    }
+
+    case 'INTEGRITY_CHECK_REQUEST': {
+      sendToClient(client, {
+        type: 'INTEGRITY_CHECK_RESPONSE',
+        payload: {
+          packageVersion: PACKAGE_VERSION,
+          checksum: INTEGRITY_CHECKSUM,
+        },
+      })
+      break
+    }
+
+    case 'MOCK_ACTIVATE': {
+      activeClientIds.add(clientId)
+
+      sendToClient(client, {
+        type: 'MOCKING_ENABLED',
+        payload: {
+          client: {
+            id: client.id,
+            frameType: client.frameType,
+          },
+        },
+      })
+      break
+    }
+
+    case 'CLIENT_CLOSED': {
+      activeClientIds.delete(clientId)
+
+      const remainingClients = allClients.filter((client) => {
+        return client.id !== clientId
+      })
+
+      // Unregister itself when there are no more clients
+      if (remainingClients.length === 0) {
+        self.registration.unregister()
+      }
+
+      break
+    }
+  }
+})
+
+addEventListener('fetch', function (event) {
+  const requestInterceptedAt = Date.now()
+
+  // Bypass navigation requests.
+  if (event.request.mode === 'navigate') {
+    return
+  }
+
+  // Opening the DevTools triggers the "only-if-cached" request
+  // that cannot be handled by the worker. Bypass such requests.
+  if (
+    event.request.cache === 'only-if-cached' &&
+    event.request.mode !== 'same-origin'
+  ) {
+    return
+  }
+
+  // Bypass all requests when there are no active clients.
+  // Prevents the self-unregistered worked from handling requests
+  // after it's been terminated (still remains active until the next reload).
+  if (activeClientIds.size === 0) {
+    return
+  }
+
+  const requestId = crypto.randomUUID()
+  event.respondWith(handleRequest(event, requestId, requestInterceptedAt))
+})
+
+/**
+ * @param {FetchEvent} event
+ * @param {string} requestId
+ * @param {number} requestInterceptedAt
+ */
+async function handleRequest(event, requestId, requestInterceptedAt) {
+  const client = await resolveMainClient(event)
+  const requestCloneForEvents = event.request.clone()
+  const response = await getResponse(
+    event,
+    client,
+    requestId,
+    requestInterceptedAt,
+  )
+
+  // Send back the response clone for the "response:*" life-cycle events.
+  // Ensure MSW is active and ready to handle the message, otherwise
+  // this message will pend indefinitely.
+  if (client && activeClientIds.has(client.id)) {
+    const serializedRequest = await serializeRequest(requestCloneForEvents)
+
+    // Omit the body of server-sent event stream responses.
+    // Cloning such responses would prevent client-side stream cancelations
+    // from reaching the original stream (a teed stream only cancels its
+    // source once both of its branches cancel) and would buffer the
+    // entire stream into the unconsumed clone indefinitely.
+    const isEventStreamResponse = response.headers
+      .get('content-type')
+      ?.toLowerCase()
+      .startsWith('text/event-stream')
+
+    // Clone the response so both the client and the library could consume it.
+    const responseClone = isEventStreamResponse ? null : response.clone()
+
+    sendToClient(
+      client,
+      {
+        type: 'RESPONSE',
+        payload: {
+          isMockedResponse: IS_MOCKED_RESPONSE in response,
+          request: {
+            id: requestId,
+            ...serializedRequest,
+          },
+          response: {
+            type: response.type,
+            status: response.status,
+            statusText: response.statusText,
+            headers: Object.fromEntries(response.headers.entries()),
+            body: responseClone ? responseClone.body : null,
+          },
+        },
+      },
+      responseClone && responseClone.body
+        ? [serializedRequest.body, responseClone.body]
+        : [],
+    )
+  }
+
+  return response
+}
+
+/**
+ * Resolve the main client for the given event.
+ * Client that issues a request doesn't necessarily equal the client
+ * that registered the worker. It's with the latter the worker should
+ * communicate with during the response resolving phase.
+ * @param {FetchEvent} event
+ * @returns {Promise<Client | undefined>}
+ */
+async function resolveMainClient(event) {
+  const client = await self.clients.get(event.clientId)
+
+  if (activeClientIds.has(event.clientId)) {
+    return client
+  }
+
+  if (client?.frameType === 'top-level') {
+    return client
+  }
+
+  const allClients = await self.clients.matchAll({
+    type: 'window',
+  })
+
+  return allClients
+    .filter((client) => {
+      // Get only those clients that are currently visible.
+      return client.visibilityState === 'visible'
+    })
+    .find((client) => {
+      // Find the client ID that's recorded in the
+      // set of clients that have registered the worker.
+      return activeClientIds.has(client.id)
+    })
+}
+
+/**
+ * @param {FetchEvent} event
+ * @param {Client | undefined} client
+ * @param {string} requestId
+ * @param {number} requestInterceptedAt
+ * @returns {Promise<Response>}
+ */
+async function getResponse(event, client, requestId, requestInterceptedAt) {
+  // Clone the request because it might've been already used
+  // (i.e. its body has been read and sent to the client).
+  const requestClone = event.request.clone()
+
+  function passthrough() {
+    // Cast the request headers to a new Headers instance
+    // so the headers can be manipulated with.
+    const headers = new Headers(requestClone.headers)
+
+    // Remove the "accept" header value that marked this request as passthrough.
+    // This prevents request alteration and also keeps it compliant with the
+    // user-defined CORS policies.
+    const acceptHeader = headers.get('accept')
+    if (acceptHeader) {
+      const values = acceptHeader.split(',').map((value) => value.trim())
+      const filteredValues = values.filter(
+        (value) => value !== 'msw/passthrough',
+      )
+
+      if (filteredValues.length > 0) {
+        headers.set('accept', filteredValues.join(', '))
+      } else {
+        headers.delete('accept')
+      }
+    }
+
+    return fetch(requestClone, { headers })
+  }
+
+  // Bypass mocking when the client is not active.
+  if (!client) {
+    return passthrough()
+  }
+
+  // Bypass initial page load requests (i.e. static assets).
+  // The absence of the immediate/parent client in the map of the active clients
+  // means that MSW hasn't dispatched the "MOCK_ACTIVATE" event yet
+  // and is not ready to handle requests.
+  if (!activeClientIds.has(client.id)) {
+    return passthrough()
+  }
+
+  // Notify the client that a request has been intercepted.
+  const serializedRequest = await serializeRequest(event.request)
+  const clientMessage = await sendToClient(
+    client,
+    {
+      type: 'REQUEST',
+      payload: {
+        id: requestId,
+        interceptedAt: requestInterceptedAt,
+        ...serializedRequest,
+      },
+    },
+    [serializedRequest.body],
+  )
+
+  switch (clientMessage.type) {
+    case 'MOCK_RESPONSE': {
+      return respondWithMock(clientMessage.data)
+    }
+
+    case 'PASSTHROUGH': {
+      return passthrough()
+    }
+  }
+
+  return passthrough()
+}
+
+/**
+ * @param {Client} client
+ * @param {any} message
+ * @param {Array<Transferable>} transferrables
+ * @returns {Promise<any>}
+ */
+function sendToClient(client, message, transferrables = []) {
+  return new Promise((resolve, reject) => {
+    const channel = new MessageChannel()
+
+    channel.port1.onmessage = (event) => {
+      if (event.data && event.data.error) {
+        return reject(event.data.error)
+      }
+
+      resolve(event.data)
+    }
+
+    client.postMessage(message, [
+      channel.port2,
+      ...transferrables.filter(Boolean),
+    ])
+  })
+}
+
+/**
+ * @param {Response} response
+ * @returns {Response}
+ */
+function respondWithMock(response) {
+  // Setting response status code to 0 is a no-op.
+  // However, when responding with a "Response.error()", the produced Response
+  // instance will have status code set to 0. Since it's not possible to create
+  // a Response instance with status code 0, handle that use-case separately.
+  if (response.status === 0) {
+    return Response.error()
+  }
+
+  const mockedResponse = new Response(response.body, response)
+
+  Reflect.defineProperty(mockedResponse, IS_MOCKED_RESPONSE, {
+    value: true,
+    enumerable: true,
+  })
+
+  return mockedResponse
+}
+
+/**
+ * @param {Request} request
+ */
+async function serializeRequest(request) {
+  return {
+    url: request.url,
+    mode: request.mode,
+    method: request.method,
+    headers: Object.fromEntries(request.headers.entries()),
+    cache: request.cache,
+    credentials: request.credentials,
+    destination: request.destination,
+    integrity: request.integrity,
+    redirect: request.redirect,
+    referrer: request.referrer,
+    referrerPolicy: request.referrerPolicy,
+    body: await request.arrayBuffer(),
+    keepalive: request.keepalive,
+  }
+}

package/references/antd-front-demo/src/App.tsx

@@ -0,0 +1,68 @@
+import { useEffect } from 'react';
+import { ConfigProvider, App as AntApp, theme } from 'antd';
+import { ProConfigProvider } from '@ant-design/pro-components';
+import { RouterProvider } from 'react-router';
+import zhCN from 'antd/locale/zh_CN';
+import enUS from 'antd/locale/en_US';
+import 'dayjs/locale/zh-cn';
+import { router } from './router';
+import { useAppStore } from './stores/useAppStore';
+import { setMessageApi } from './utils/messageHolder';
+
+const localeMap: Record<string, typeof zhCN> = {
+  'zh-CN': zhCN,
+  'en-US': enUS,
+};
+
+const MessageApiSetter: React.FC<{ children: React.ReactNode }> = ({ children }) => {
+  const { message } = AntApp.useApp();
+  useEffect(() => {
+    setMessageApi(message);
+  }, [message]);
+  return <>{children}</>;
+};
+
+const AppRoot: React.FC = () => {
+  const darkMode = useAppStore((s) => s.darkMode);
+  const language = useAppStore((s) => s.language);
+  const primaryColor = useAppStore((s) => s.primaryColor);
+  const componentSize = useAppStore((s) => s.componentSize);
+
+  return (
+    <ConfigProvider
+      locale={localeMap[language] ?? zhCN}
+      componentSize={componentSize}
+      theme={{
+        algorithm: darkMode ? theme.darkAlgorithm : theme.defaultAlgorithm,
+        token: {
+          colorPrimary: primaryColor,
+          padding: 10,
+          paddingLG: 12,
+          paddingMD: 8,
+          paddingSM: 6,
+        },
+        components: {
+          Form: {
+            itemMarginBottom: 10,  // 默认 24px → 10px
+          },
+          Card: {
+
+          },
+          Drawer: {
+          },
+        },
+      }}
+
+    >
+      <ProConfigProvider dark={darkMode}>
+        <AntApp>
+          <MessageApiSetter>
+            <RouterProvider router={router} />
+          </MessageApiSetter>
+        </AntApp>
+      </ProConfigProvider>
+    </ConfigProvider>
+  );
+};
+
+export default AppRoot;

package/references/antd-front-demo/src/api/aps/coil.ts

@@ -0,0 +1,42 @@
+import request from '@/utils/request';
+import type { ApiResponse, PageResult } from '@/types/api';
+import type { CoilVO, CoilSaveParams, CoilPageParams } from '@/types/aps/coil';
+
+/** Paginated coil list */
+export const getCoilPage = (params: CoilPageParams) =>
+  request.get<unknown, ApiResponse<PageResult<CoilVO>>>('/aps/coil/page', { params });
+
+/** Get single coil by id */
+export const getCoil = (id: number) =>
+  request.get<unknown, ApiResponse<CoilVO>>(`/aps/coil/get?id=${id}`);
+
+/** Create coil */
+export const createCoil = (data: CoilSaveParams) =>
+  request.post<unknown, ApiResponse<number>>('/aps/coil/create', data);
+
+/** Update coil */
+export const updateCoil = (data: CoilSaveParams) =>
+  request.put<unknown, ApiResponse<boolean>>('/aps/coil/update', data);
+
+/** Delete coil */
+export const deleteCoil = (id: number) =>
+  request.delete<unknown, ApiResponse<boolean>>(`/aps/coil/delete?id=${id}`);
+
+/** Batch import coils from Excel */
+export const importCoils = (file: File) => {
+  const formData = new FormData();
+  formData.append('file', file);
+  return request.post<unknown, ApiResponse<{ successCount: number; failCount: number; errors: string[] }>>(
+    '/aps/coil/import',
+    formData,
+    { headers: { 'Content-Type': 'multipart/form-data' } }
+  );
+};
+
+/** Export coils to Excel */
+export const exportCoils = (params: Omit<CoilPageParams, 'pageNo' | 'pageSize'>) =>
+  request.get('/aps/coil/export', { params, responseType: 'blob' });
+
+/** Download import template */
+export const downloadCoilTemplate = () =>
+  request.get('/aps/coil/import-template', { responseType: 'blob' });

package/references/antd-front-demo/src/api/aps/order.ts

@@ -0,0 +1,42 @@
+import request from '@/utils/request';
+import type { ApiResponse, PageResult } from '@/types/api';
+import type { OrderVO, OrderSaveParams, OrderPageParams } from '@/types/aps/order';
+
+/** Paginated order list */
+export const getOrderPage = (params: OrderPageParams) =>
+  request.get<unknown, ApiResponse<PageResult<OrderVO>>>('/aps/order/page', { params });
+
+/** Get single order by id */
+export const getOrder = (id: number) =>
+  request.get<unknown, ApiResponse<OrderVO>>(`/aps/order/get?id=${id}`);
+
+/** Create order */
+export const createOrder = (data: OrderSaveParams) =>
+  request.post<unknown, ApiResponse<number>>('/aps/order/create', data);
+
+/** Update order */
+export const updateOrder = (data: OrderSaveParams) =>
+  request.put<unknown, ApiResponse<boolean>>('/aps/order/update', data);
+
+/** Delete order */
+export const deleteOrder = (id: number) =>
+  request.delete<unknown, ApiResponse<boolean>>(`/aps/order/delete?id=${id}`);
+
+/** Batch import orders from Excel */
+export const importOrders = (file: File) => {
+  const formData = new FormData();
+  formData.append('file', file);
+  return request.post<unknown, ApiResponse<{ successCount: number; failCount: number; errors: string[] }>>(
+    '/aps/order/import',
+    formData,
+    { headers: { 'Content-Type': 'multipart/form-data' } }
+  );
+};
+
+/** Export orders to Excel */
+export const exportOrders = (params: Omit<OrderPageParams, 'pageNo' | 'pageSize'>) =>
+  request.get('/aps/order/export', { params, responseType: 'blob' });
+
+/** Download import template */
+export const downloadOrderTemplate = () =>
+  request.get('/aps/order/import-template', { responseType: 'blob' });

package/references/antd-front-demo/src/api/aps/param.ts

@@ -0,0 +1,19 @@
+import request from '@/utils/request';
+import type { ApiResponse } from '@/types/api';
+import type { ProcessParamVO, ProcessParamSaveParams } from '@/types/aps/param';
+
+/** Get all process parameters */
+export const getParamList = () =>
+  request.get<unknown, ApiResponse<ProcessParamVO[]>>('/aps/param/list');
+
+/** Batch save process parameters */
+export const saveParams = (params: ProcessParamSaveParams[]) =>
+  request.post<unknown, ApiResponse<boolean>>('/aps/param/save', params);
+
+/** Get single parameter by name */
+export const getParamByName = (paramName: string) =>
+  request.get<unknown, ApiResponse<ProcessParamVO>>(`/aps/param/get?paramName=${paramName}`);
+
+/** Reset parameters to default values */
+export const resetParams = () =>
+  request.post<unknown, ApiResponse<boolean>>('/aps/param/reset');

package/references/antd-front-demo/src/api/aps/plan.ts

@@ -0,0 +1,30 @@
+import request from '@/utils/request';
+import type { ApiResponse, PageResult } from '@/types/api';
+import type { CuttingPlanVO, PlanDetailVO, PlanPageParams } from '@/types/aps/plan';
+
+/** Get paginated plan list */
+export const getPlanPage = (params: PlanPageParams) =>
+  request.get<unknown, ApiResponse<PageResult<CuttingPlanVO>>>('/aps/plan/page', { params });
+
+/** Get plan detail by planId */
+export const getPlanDetail = (planId: string) =>
+  request.get<unknown, ApiResponse<PlanDetailVO>>(`/aps/plan/detail?planId=${planId}`);
+
+/** Get plans by coilId */
+export const getPlansByCoilId = (coilId: string) =>
+  request.get<unknown, ApiResponse<CuttingPlanVO[]>>(`/aps/plan/list?coilId=${coilId}`);
+
+/** Delete plan */
+export const deletePlan = (planId: string) =>
+  request.delete<unknown, ApiResponse<boolean>>(`/aps/plan/delete?planId=${planId}`);
+
+/** Confirm plan (lock coil) */
+export const confirmPlan = (planId: string) =>
+  request.post<unknown, ApiResponse<boolean>>(`/aps/plan/confirm?planId=${planId}`);
+
+/** Export work instruction (Excel/PDF) */
+export const exportWorkInstruction = (planId: string, format: 'excel' | 'pdf' = 'excel') =>
+  request.get(`/aps/plan/export`, {
+    params: { planId, format },
+    responseType: 'blob'
+  });

package/references/antd-front-demo/src/api/aps/task.ts

@@ -0,0 +1,31 @@
+import request from '@/utils/request';
+import type { ApiResponse, PageResult } from '@/types/api';
+import type { OptimizationTaskVO, TaskSubmitParams, TaskPageParams } from '@/types/aps/task';
+
+/** Submit single coil plan task */
+export const submitSingleCoilTask = (params: TaskSubmitParams) =>
+  request.post<unknown, ApiResponse<string>>('/aps/task/single-coil/submit', params);
+
+/** Submit global optimization task */
+export const submitGlobalTask = (params: TaskSubmitParams) =>
+  request.post<unknown, ApiResponse<string>>('/aps/task/global/submit', params);
+
+/** Get task status */
+export const getTaskStatus = (taskId: string) =>
+  request.get<unknown, ApiResponse<OptimizationTaskVO>>(`/aps/task/status?taskId=${taskId}`);
+
+/** Get paginated task list */
+export const getTaskPage = (params: TaskPageParams) =>
+  request.get<unknown, ApiResponse<PageResult<OptimizationTaskVO>>>('/aps/task/page', { params });
+
+/** Cancel task */
+export const cancelTask = (taskId: string) =>
+  request.post<unknown, ApiResponse<boolean>>(`/aps/task/cancel?taskId=${taskId}`);
+
+/** Resume task */
+export const resumeTask = (taskId: string) =>
+  request.post<unknown, ApiResponse<boolean>>(`/aps/task/resume?taskId=${taskId}`);
+
+/** Delete task */
+export const deleteTask = (taskId: string) =>
+  request.delete<unknown, ApiResponse<boolean>>(`/aps/task/delete?taskId=${taskId}`);