@_tc/template-core 0.0.1-bate.37 → 0.0.1-bate.38

package/fe/frontend/dash/dash.entry.js

@@ -16,15 +16,27 @@ const baseRoutes = [
                 path: `/testPage`,
                 component: renderImportComponent(import('../testPage')),
             },
+            //
             {
                 path: `todo`,
                 component: renderImportComponent(import('../widgets/defaultPages/Todo')),
             },
+            // sidebarRoutes 追加在这
+            // {
+            //   path: "/iframe",
+            //   component: renderImportComponent(import("../defaultPages/Iframe")),
+            // },
+            // {
+            //   path: "/schema",
+            //   component: renderImportComponent(import("../defaultPages/Schema")),
+            // },
+            // 插入自定义路由
         ],
     },
 ];
 const sidebarRoutes = [
     {
+        // path: `/:${QK.k}/:${QK.sk}`,
         path: `/:${QK.k}/*`,
         component: renderImportComponent(import('../widgets/defaultPages/SidebarSlotPage')),
         children: [
@@ -36,6 +48,11 @@ const sidebarRoutes = [
                 path: `:${QK.sk}`,
                 component: renderImportComponent(import('../widgets/defaultPages/SlotPage')),
             },
+            // {
+            //   path: "schema",
+            //   component: renderImportComponent(import("../defaultPages/Schema")),
+            // },
+            // 插入自定义路由
         ],
     },
     {
@@ -54,7 +71,8 @@ const sidebarRoutes = [
     },
 ];
 const getDefaultPageRoutes = () => {
-    baseRoutes[0].children?.push(...sidebarRoutes);
+    //   getBusinessRoutes(baseRoutes, sidebarRoutes[0]?.childrens ?? []);
+    baseRoutes[0]?.children?.push(...sidebarRoutes);
     return [...baseRoutes];
 };
 initApp(({ children }) => _jsx("div", { className: "dash", children: children }), {

package/fe/frontend/main.js

@@ -12,5 +12,7 @@ export const initApp = (RootComponent, options) => {
     if (usedRouter) {
         routerDom = generateRouter(routes, routerType);
     }
+    // 创建路由
+    // 挂载 根节点
     root.render(_jsx(RootComponent, { children: routerDom }));
 };

package/fe/frontend/widgets/common/CRUD/CRUD.js

@@ -88,6 +88,7 @@ export class FetchAxios {
             });
         });
         let currentConfig = merged;
+        // 执行拦截器
         for (let i = 0; i < chain.length; i++) {
             const item = chain[i];
             const { fulfilled, rejected } = item;

package/fe/frontend/widgets/common/importComponent.js

@@ -2,6 +2,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { lazy, Suspense } from 'react';
 export const renderImportComponent = (c, fallback) => {
     const Component = lazy(() => c);
+    // TODO 加上页面级 loading
     const showFallback = typeof fallback !== 'undefined' ? fallback : 'loading';
     return (_jsx(Suspense, { fallback: showFallback, children: _jsx(Component, {}) }));
 };

package/fe/frontend/widgets/common/language.js

@@ -1,6 +1,7 @@
 import { i18n } from '../../../packages/ui/react/i18n';
 const useI18nKey = '$i18n_';
 export const getText = (key) => {
+    // 如果有占位符号
     if (key.includes(useI18nKey)) {
         return i18n(key);
     }

package/fe/frontend/widgets/common/menu.d.ts

@@ -9,9 +9,21 @@ type MenuItem = {
     }>;
 };
 export declare const enum QK {
+    /**
+     * project key
+     */
     pk = "projk",
+    /**
+     * key topMenu key
+     */
     k = "key",
+    /**
+     * sidebar key leftMenu key
+     */
     sk = "sidek",
+    /**
+     * 自定义 页面的key
+     */
     ck = "custk"
 }
 export declare const leftSidebarBasePath = "_sidebar_";

package/fe/frontend/widgets/common/menu.js

@@ -1,9 +1,21 @@
 import { modeStore } from "../../widgets/store/mode";
 export var QK;
 (function (QK) {
+    /**
+     * project key
+     */
     QK["pk"] = "projk";
+    /**
+     * key topMenu key
+     */
     QK["k"] = "key";
+    /**
+     * sidebar key leftMenu key
+     */
     QK["sk"] = "sidek";
+    /**
+     * 自定义 页面的key
+     */
     QK["ck"] = "custk";
 })(QK || (QK = {}));
 export const leftSidebarBasePath = "_sidebar_";
@@ -40,9 +52,11 @@ const generateMenuItem = (item) => {
                 let path = `/${item.key}`;
                 let search = new URLSearchParams(query).toString();
                 if (item.moduleType === "sidebar") {
+                    // query[QK.sk] = item.sidebarConfig.menu[0].key;
                     const sfMenu = findMenuItem(item.sidebarConfig.menu, item.sidebarConfig.menu[0].key);
                     path += `${sfMenu.path.pathname}`;
                     search = sfMenu.path.search ?? "";
+                    // path += `/pending`;
                 }
                 data = {
                     ...item,
@@ -61,6 +75,13 @@ const generateMenuItem = (item) => {
 export const findMenuItem = (menuData, key) => {
     let data = undefined;
     const useFirstAvailableMenu = typeof key === "undefined";
+    /**
+     *  url query 分为
+     *
+     *  projk 为项目key
+     *  key  当前选择的top菜单key
+     *  sidek 为侧边栏选中的key
+     */
     for (const item of menuData) {
         if (item.menuType === "module") {
             if (useFirstAvailableMenu || item.key === key) {

package/fe/frontend/widgets/common/request.d.ts

@@ -16,6 +16,9 @@ export interface BaseResponse<T> {
     code: number;
     message: string;
 }
+/**
+ * GET/DELETE 不发送 body；统一把 data 转到 params。
+ *  */
 export declare function get<T = unknown, D = unknown>(url: string, data?: D, config?: RequestConfig<D>): Promise<ResponseConfig<BaseResponse<T>, D>>;
 export declare function post<T = unknown, D = unknown>(url: string, data?: D, config?: RequestConfig<D>): Promise<ResponseConfig<BaseResponse<T>, D>>;
 export declare function put<T = unknown, D = unknown>(url: string, data?: D, config?: RequestConfig<D>): Promise<ResponseConfig<BaseResponse<T>, D>>;

package/fe/frontend/widgets/common/request.js

@@ -24,6 +24,7 @@ const removeBaseurlFromURL = (config) => {
     const pathname = requestURL.pathname.slice(basePath.length) || '/';
     config.url = `${pathname}${requestURL.search}${requestURL.hash}`;
 };
+// ---- Request Interceptors ----
 api.interceptors.request.use(async (config) => {
     removeBaseurlFromURL(config);
     const token = await getAuthToken();
@@ -47,6 +48,7 @@ api.interceptors.request.use((config) => {
     console.debug(`[API] ${config.method?.toUpperCase()} ${config.url}`);
     return config;
 });
+// ---- Response Interceptors ----
 api.interceptors.response.use((res) => res, async (err) => {
     const axiosErr = err;
     if (axiosErr.response?.status === 401) {
@@ -62,6 +64,7 @@ api.interceptors.response.use((res) => res, async (err) => {
     });
     return Promise.reject(err);
 });
+// ---- Helpers ----
 function extractErrorMessage(err) {
     if (!(err instanceof Error))
         return 'Unknown error';
@@ -82,6 +85,9 @@ function extractErrorMessage(err) {
         return 'Request timed out';
     return 'Network error';
 }
+/**
+ * GET/DELETE 不发送 body；统一把 data 转到 params。
+ *  */
 export function get(url, data, config) {
     const hasDataParams = data !== undefined && data !== null && typeof data === 'object';
     const getConfig = hasDataParams

package/fe/frontend/widgets/components/BasePage/HeaderView.js

@@ -9,6 +9,8 @@ const headerThemeStyle = {
 };
 const HeaderView = (props) => {
     const { title, menu, userArea, children } = props ?? defaultProps;
-    return (_jsxs("div", { className: "header-view", style: headerThemeStyle, children: [_jsxs("header", { className: cn("header flex h-16 items-center border-b", "shadow-[0_10px_30px_var(--header-shadow)]"), children: [_jsx("div", { className: "brand flex w-60 items-center border-r border-[hsl(var(--theme-bg)/0.14)] px-6 text-base font-semibold tracking-[0.02em] text-(--header-fg)", children: title ?? defaultTitle }), _jsx("div", { className: "top-menu flex flex-1 items-center px-6 text-(--header-fg)", children: menu }), _jsx("div", { className: "user-area flex items-center justify-end border-l border-[hsl(var(--theme-bg)/0.14)] px-6 text-(--header-fg)", children: userArea })] }), children] }));
+    return (_jsxs("div", { className: "header-view", style: headerThemeStyle, children: [_jsxs("header", { className: cn("header flex h-16 items-center border-b", 
+                // "border-[hsl(var(--theme-bg)/0.14)] bg-(--header-bg) text-(--header-fg)",
+                "shadow-[0_10px_30px_var(--header-shadow)]"), children: [_jsx("div", { className: "brand flex w-60 items-center border-r border-[hsl(var(--theme-bg)/0.14)] px-6 text-base font-semibold tracking-[0.02em] text-(--header-fg)", children: title ?? defaultTitle }), _jsx("div", { className: "top-menu flex flex-1 items-center px-6 text-(--header-fg)", children: menu }), _jsx("div", { className: "user-area flex items-center justify-end border-l border-[hsl(var(--theme-bg)/0.14)] px-6 text-(--header-fg)", children: userArea })] }), children] }));
 };
 export default HeaderView;

package/fe/frontend/widgets/defaultPages/Schema/components/CallCom/PopFrom.js

@@ -62,6 +62,16 @@ const PopForm = memo((props) => {
     const { schema, config, api } = useComConfig({ comName: props.comName });
     const formRef = useRef(null);
     const [loading, setLoading] = useState(false);
+    /**
+     * 1. 生成 schemas
+     * 2. 根据config 获取相关展示内容、请求数据
+     * 3. 支持 create、edit
+     *
+     *
+     * 交互结束时 通知上层 清除show component
+     *
+     *
+     */
     const schemas = useMemo(() => {
         return generateSchemas(schema);
     }, [schema]);
@@ -73,6 +83,9 @@ const PopForm = memo((props) => {
         };
     const defaultValue = useMemo(() => generateDefaultValue(schema, props.data), [schema, props.data]);
     useExecuteOnce(async () => {
+        /**
+         * 编辑弹窗需要 获取一下数据
+         */
         if (props.comName === 'editForm' && 'fetchKey' in config) {
             const { fetchKey } = config;
             const params = {
@@ -87,6 +100,7 @@ const PopForm = memo((props) => {
     }, { executionPhase: 'mount' });
     const handleSubmit = useCallback(async (v) => {
         setSubmitting(true);
+        // 逻辑处理
         let fetchFn = put;
         if (props.comName === 'createForm') {
             fetchFn = post;
@@ -94,6 +108,7 @@ const PopForm = memo((props) => {
         try {
             const res = await handlingRequestErrors(fetchFn(api, v));
             if (res.data.code === 0) {
+                // 通知
                 schemaEventBus.getState().emitCom({
                     type: merge(eventsInfo.closeCom, eventsInfo.initTable, props.comName === 'createForm' ? eventsInfo.resetSearch : eventsInfo.none),
                 });

package/fe/frontend/widgets/defaultPages/Schema/components/SchemaSearch/index.js

@@ -7,6 +7,10 @@ import { memo, useState } from 'react';
 import { schemaEventBus } from '../../stores/schemaEventBus';
 import { useSchemaStore } from '../../stores/schemaStore';
 const generateSchemas = (config) => {
+    // TODO ? 是否需要缓存
+    // const { comSchemaCache } = schemaStore.getState()
+    // if (comSchemaCache.has(schemaKey)) {
+    // }
     const keys = Object.keys(config);
     const schemas = [];
     let defaultValue = undefined;
@@ -31,6 +35,7 @@ const generateSchemas = (config) => {
     return { schemas, defaultValue };
 };
 const SchemaSearch = memo(() => {
+    // 暂时没有 config
     const schema = useSchemaStore((s) => s.searchSchema);
     const [schemas, setSchemas] = useState([]);
     const [defaultValue, setSchemaDefaultValue] = useState(undefined);

package/fe/frontend/widgets/defaultPages/Schema/components/SchemaTable/index.js

@@ -21,11 +21,14 @@ const generateColumns = (config) => {
     keys.forEach((k) => {
         const fieldInfo = config[k];
         if (fieldInfo?.option) {
-            const { ...fieldProps } = fieldInfo.option;
+            const { 
+            // comType = 'input', default: defaultFieldValue,
+            ...fieldProps } = fieldInfo.option;
             columns.push({
                 title: getText(fieldInfo.label),
                 key: k,
                 ...fieldProps,
+                // fieldProps,
             });
         }
     });
@@ -36,12 +39,15 @@ const generateRowActions = (btnConfigs, rowData, api) => {
         const { eventKey, eventOption } = btnConfig;
         switch (eventKey) {
             case 'callComponent':
+                // 与  schemaPage通信
                 const { emitTable } = schemaEventBus.getState();
                 emitTable({ ...rowData, comName: eventOption.comName });
                 break;
             case 'remove':
+                // 调用api
                 if (api) {
                     const apiParams = Object.entries(eventOption.params).reduce((o, [k, v]) => {
+                        // 使用当前行的某个数据
                         if (('' + v).includes(VALUE_KEY)) {
                             const valueKey = ('' + v).split(VALUE_KEY)[1];
                             o[k] = rowData[valueKey];
@@ -114,15 +120,19 @@ const SchemaTable = memo(({ ref }) => {
         const actionColumn = [];
         if (params.config) {
             const { rowButtons, headerButtons } = params.config;
+            // 处理row交互
             if (rowButtons) {
                 actionColumn.push({
                     key: 'action',
                     title: getText('操作'),
                     actions: (_value, _record, index) => [
                         ...generateRowActions(rowButtons, _record, params.api),
+                        // { key: `text-${index}`, label: 'text' },
+                        // { key: `link-${index}`, label: 'link' },
                     ],
                 });
             }
+            // 处理page 交互
             setHandleBtn(headerButtons?.map((c) => {
                 const { label, eventKey, eventOption, ...props } = c;
                 return {
@@ -132,10 +142,12 @@ const SchemaTable = memo(({ ref }) => {
                             schemaEventBus.getState().emitTable(eventOption);
                         }
                         else {
+                            // 不存在这种用法
                         }
                     },
                     ...props,
                 };
+                // }
             }) ?? []);
         }
         uColumns(contextColumns.concat(actionColumn));

package/fe/frontend/widgets/defaultPages/Schema/data/eventInfo.js

@@ -1,6 +1,6 @@
 export const eventsInfo = {
-    none: 0b00000000000000,
-    closeCom: 0b00000000000001,
-    initTable: 0b00000000000010,
-    resetSearch: 0b00000000000010,
+    none: /**      */ 0b00000000000000,
+    closeCom: /**     */ 0b00000000000001,
+    initTable: /** */ 0b00000000000010,
+    resetSearch: /** */ 0b00000000000010,
 };

package/fe/frontend/widgets/defaultPages/Schema/index.js

@@ -27,6 +27,9 @@ const Schema = memo(() => {
         setShowCompoentKey(comName);
     }, []);
     const comDone = useCallback(({ type }) => {
+        /**
+         * 解析出需要执行的操作
+         */
         if (isAllowed(type, eventsInfo.closeCom)) {
             setShowCompoentKey(undefined);
             setComProps(undefined);
@@ -38,11 +41,15 @@ const Schema = memo(() => {
         }
     }, []);
     useInit(() => {
+        // schema数据分离
         schemaConversion(menu.schemaConfig, menu.key);
     });
     useExecuteOnce(() => {
+        // 关联search
         schemaEventBus.getState().subscribeSearch(onSearch);
+        // 订阅组件消息
         schemaEventBus.getState().subscribeCom(comDone);
+        // 关联table
         schemaEventBus.getState().subscribeTable(callCom);
     }, { executionPhase: executionPhaseType.mount });
     useExecuteOnce(() => {

package/fe/frontend/widgets/defaultPages/Schema/schemaType.d.ts

@@ -13,7 +13,13 @@ export type NonOptionKey = {
 }[AllFieldKeys];
 export type StoreSchemaType = UsedConfigSchema<BaseOption<FieldType[`${AllOptionsPreNames}${SuffixKey}`]>>;
 export type NamedSchemaType<N extends `${AllOptionsPreNames}${SuffixKey}`> = UsedConfigSchema<BaseOption<FieldType[N]>>;
+/**
+ * 获取具体名称的 components options 配置
+ */
 export type NamedComOption<N extends CallComNames> = ComponentType<ComponentConfig>[N];
+/**
+ * 获取具名 组件配置
+ */
 export type NamedComponentConfig<N extends CallComNames> = ComponentConfig[N];
 type ComponentC<C extends ComponentConfig> = {
     [K in keyof C]: {
@@ -33,6 +39,9 @@ export declare const enum ComEventType {
     close = 0
 }
 export type SchemaComEventInfo = {
+    /**
+     * 操作权限合集
+     */
     type: number;
 };
 export type CallComponent<T> = {

package/fe/frontend/widgets/defaultPages/Schema/stores/schemaEventBus.d.ts

@@ -1,4 +1,11 @@
 import { SchemaComEventInfo, SchemaDefaultValue, SchemaTableEmitData } from '../schemaType';
+/**
+ * 消费方 subscribeSearch(fn)
+ *      unSubscribeSearch(fn)
+ *
+ * 通知方 emitSearch (value)
+ *
+ */
 type WatchFn<V = SchemaDefaultValue | undefined> = (value: V) => void;
 declare const enum SubscribeEnum {
     search = "search",
@@ -7,13 +14,25 @@ declare const enum SubscribeEnum {
 }
 interface SchemaEventBusStore {
     readonly Subscribers: Map<WatchFn, SubscribeEnum>;
+    /**
+     * 订阅 Search 变化
+     */
     subscribeSearch: (fn: WatchFn) => void;
     unSubscribeSearch: (fn: WatchFn) => void;
     emitSearch: (v: SchemaDefaultValue | undefined) => void;
+    /**
+     * 订阅 Table 变化
+     */
     subscribeTable: (fn: WatchFn<SchemaTableEmitData>) => void;
     unSubscribeTable: (fn: WatchFn<SchemaTableEmitData>) => void;
     emitTable: (v: SchemaTableEmitData) => void;
+    /**
+     * 通用 call
+     */
     emitCall: (v: SchemaDefaultValue | undefined, type: SubscribeEnum) => void;
+    /**
+     * 订阅组件变化
+     */
     subscribeCom: (fn: WatchFn<SchemaComEventInfo>) => void;
     unSubscribeCom: (fn: WatchFn<SchemaComEventInfo>) => void;
     emitCom: (v: SchemaComEventInfo) => void;

package/fe/frontend/widgets/defaultPages/Schema/stores/schemaEventBus.js

@@ -9,6 +9,7 @@ var SubscribeEnum;
 export const schemaEventBus = createStore((set, get) => {
     return {
         Subscribers: new Map(),
+        // com
         subscribeCom(fn) {
             get().Subscribers.set(fn, SubscribeEnum.com);
         },
@@ -24,6 +25,7 @@ export const schemaEventBus = createStore((set, get) => {
         emitCom(v) {
             get().emitCall(v, SubscribeEnum.com);
         },
+        // table
         subscribeTable(fn) {
             get().Subscribers.set(fn, SubscribeEnum.table);
         },
@@ -47,6 +49,7 @@ export const schemaEventBus = createStore((set, get) => {
                 }
             }
         },
+        // search
         subscribeSearch(fn) {
             get().Subscribers.set(fn, SubscribeEnum.search);
         },
@@ -62,5 +65,6 @@ export const schemaEventBus = createStore((set, get) => {
         emitSearch(v) {
             get().emitCall(v, SubscribeEnum.search);
         },
+        //
     };
 });

package/fe/frontend/widgets/defaultPages/Schema/stores/schemaStore.d.ts

@@ -15,14 +15,28 @@ interface ComSchemaCache {
 }
 interface SchemaStoreState extends Partial<FunctionalData> {
     readonly schemaStoreAvailable: boolean;
+    /**
+     *  页面schema 配置
+     */
     readonly schemaCache: LRUCache<FunctionalData>;
+    /**
+     *  组件schema缓存配置
+     */
     readonly comSchemaCache: LRUCache<ComSchemaCache>;
 }
 interface SchemaStoreActions {
     setSchemaState: (data: Partial<MOmit<SchemaStoreState, 'schemaStoreAvailable' | 'schemaCache'>>) => void;
+    /**
+     *
+     * 更新 key schema 缓存
+     */
     updateSchemaCache: (data: FunctionalData & {
         schemaKey: string;
     }) => void;
+    /**
+     *
+     * 更新 组件 配置
+     */
     updateComSchemaCache: (data: ComSchemaCache & {
         schemaKey: string;
     }) => void;

package/fe/frontend/widgets/defaultPages/Schema/stores/schemaStore.js

@@ -11,11 +11,13 @@ export const schemaStore = createStore((set, get) => ({
         set({ schemaStoreAvailable: !!get().api });
     },
     updateSchemaCache: (data) => {
+        // 直接设置值
         const { schemaKey, ...params } = data;
         const { schemaCache } = get();
         schemaCache.set(schemaKey, params);
     },
     updateComSchemaCache: (data) => {
+        // 直接设置值
         const { schemaKey, ...params } = data;
         const { comSchemaCache } = get();
         comSchemaCache.set(schemaKey, params);

package/fe/frontend/widgets/defaultPages/Schema/utils/schemaConversion.js

@@ -1,5 +1,9 @@
 import { suffixKey } from '../data';
 import { schemaStore } from '../stores/schemaStore';
+/**
+ *
+ * 构建出需要optios + 其他字段
+ */
 const buildSchema = (schema, fieldType) => {
     if (!schema.properties)
         return;
@@ -12,11 +16,14 @@ const buildSchema = (schema, fieldType) => {
         const fieldInfo = schema.properties[key];
         const fieldKeys = Object.keys(fieldInfo);
         temSchema.properties[key] = fieldKeys.reduce((o, fieldKey) => {
+            // 为xxxoption
             if (fieldKey.indexOf(suffixKey) !== -1) {
+                // 需要的option
                 if (fieldKey === `${fieldType}${suffixKey}`) {
                     o['option'] = fieldInfo[fieldKey];
                 }
             }
+            // 其余属性
             else {
                 ;
                 o[fieldKey] = fieldInfo[fieldKey];
@@ -26,21 +33,57 @@ const buildSchema = (schema, fieldType) => {
     }
     return temSchema;
 };
+// properties 构建
+// const buildSchema = (data: FieldType, fieldType: AllOptionsPreNames) => {
+//   console.log(data);
+//   const keys = Object.keys(data) as (keyof FieldType)[];
+//   type TargetOptionKey = `${typeof fieldType}${typeof suffixKey}`;
+//   type NewState = Partial<{
+//     [K in NonOptionKey]: FieldType[K];
+//   }> & {
+//     option?: FieldType[TargetOptionKey];
+//   };
+//   const newData = produce<NewState>(data, (temData) => {
+//     const newState: NewState = {
+//       option: undefined,
+//     } as unknown as NewState;
+//     keys.forEach((k) => {
+//       // 是 Option
+//       if (k.indexOf(suffixKey) !== -1) {
+//         // 需要的options
+//         if (k === (`${fieldType}${suffixKey}` as const)) {
+//           newState["option"] = (temData as FieldType)[k];
+//         }
+//       } else {
+//         (newState as any)[k] = (temData as FieldType)[
+//           k
+//         ] as NewState[keyof NewState];
+//       }
+//     });
+//     return newState;
+//   });
+//   return newData;
+// };
 export const schemaConversion = (schema, schemaKey) => {
+    // 存在缓存直接跳过
     const { schemaCache, setSchemaState } = schemaStore.getState();
     if (schemaCache.has(schemaKey)) {
+        // 应用缓存
         setSchemaState({
             ...schemaCache.get(schemaKey),
         });
         return;
     }
     const { api, schema: schemaMetadata = {}, componentConfig, tableConfig, searchConfig } = schema;
+    //   整个schema 进行移动
     const tableSchema = buildSchema(JSON.parse(JSON.stringify(schemaMetadata)), 'table');
     const searchSchema = buildSchema(JSON.parse(JSON.stringify(schemaMetadata)), 'search');
     let components = {};
+    //  page components
     if (componentConfig) {
         const componentKeys = Object.keys(componentConfig ?? {});
         components = componentKeys.reduce((o, comKey) => {
+            // 获取组件的 schema
             const comSchema = buildSchema(JSON.parse(JSON.stringify(schemaMetadata)), comKey);
             o[comKey] = {
                 schema: comSchema,

package/fe/frontend/widgets/defaultPages/Schema/utils/validator.d.ts

@@ -1,4 +1,7 @@
 import { Ajv } from 'ajv';
 export declare const ajvInstance: Ajv;
+/**
+ * 创建验证器
+ */
 export declare function createAjvValidator(schema: object): (rule: object, value: unknown, callback: (errors?: string[]) => void) => void;
 //# sourceMappingURL=validator.d.ts.map

package/fe/frontend/widgets/defaultPages/Schema/utils/validator.js

@@ -1,5 +1,9 @@
 import { Ajv } from 'ajv';
+// 初始化 AJV (全局复用)
 export const ajvInstance = new Ajv({ allErrors: true, verbose: true, strict: false });
+/**
+ * 创建验证器
+ */
 export function createAjvValidator(schema) {
     const validate = ajvInstance.compile(schema);
     return (rule, value, callback) => {
@@ -13,6 +17,7 @@ export function createAjvValidator(schema) {
         }
     };
 }
+// 格式化错误信息
 function formatError(error) {
     const path = error.instancePath.replace(/^\//, '') || 'value';
     switch (error.keyword) {

package/fe/frontend/widgets/defaultPages/SidebarSlotPage/SidebarSlotContainer.js

@@ -10,7 +10,12 @@ const SidebarSlotContainer = (props) => {
     const params = useRouterParams();
     const [SK, uSK] = useState(params[QK.sk]);
     const nav = useNavigate();
+    //  menu 初始化选中
     useEffect(() => {
+        /**
+         * 如果没有 sidebar key 说明当前是 自定义路由
+         * 则需要获取 query 中的 ck 来查找 menuinfo
+         */
         if (!params[QK.sk]) {
             if (params[QK.ck]) {
                 const m = findMenuItem(rawMenuData, params[QK.ck]);
@@ -19,6 +24,8 @@ const SidebarSlotContainer = (props) => {
                     return;
                 }
             }
+            // 运行到这 说明
+            // 异常路径
             logPageNotFound();
         }
     }, [rawMenuData, params]);

package/fe/frontend/widgets/defaultPages/SidebarSlotPage/index.js

@@ -7,6 +7,7 @@ import { useParams } from "react-router-dom";
 import SidebarSlotContainer from "./SidebarSlotContainer";
 const SidebarSlotPage = () => {
     const params = useParams();
+    // top left 从当前路由中获取到 sidebarConfig中的数据
     const { menu: parentMenuInfo } = useCurrentMenuData();
     const prefixPath = useMemo(() => `/${params[QK.k]}`, [params[QK.k]]);
     const menuItem = generateMenuItemData(parentMenuInfo?.sidebarConfig?.menu ?? []);

package/fe/frontend/widgets/defaultPages/SlotPage/index.js

@@ -14,6 +14,8 @@ const SlotPage = memo(() => {
             return _jsx(Schema, {});
         }
         else {
+            // 运行到这 说明异常路径
+            // 自定义路径会在进入这之前被拦截;
             logPageNotFound();
             return _jsx("div", { children: "404" });
         }