openxiangda-devkit-core 2.11.0 → 2.13.0

package/dist/compiler/config.js

@@ -2441,7 +2441,7 @@ function validateCapabilityDeclarations(appCode, declarations, diagnostics) {
             diagnostics.push(diagnostic('APP_CONFIG_AUTHZ_CAPABILITY_DECLARATION_INVALID', '显式 capability 必须属于当前应用、code 唯一，并声明 backend/ui kind 与 name', path));
         }
         if (platformCapabilityCodes(appCode).has(code)) {
-            diagnostics.push(diagnostic('APP_CONFIG_AUTHZ_PLATFORM_CAPABILITY_RESERVED', '平台 capability 由平台保留 catalog 提供，应用不能重复声明', `${path}.code`));
+            diagnostics.push(diagnostic('APP_CONFIG_AUTHZ_PLATFORM_CAPABILITY_RESERVED', '平台 capability 由平台保留 catalog 提供，应用不能重复声明', `${path}.code`, `删除 capabilities 里的该声明，直接在角色中引用即可，例如 roles: [{ code: 'admin', capabilities: [directoryRead] }]，其中 directoryRead = app:${appCode}:directory:read`));
         }
         seen.add(code);
     });
@@ -2649,7 +2649,7 @@ function validateBackendOperations(rawOperations, declaredResources, declaredWor
                         Number(ai.timeoutMs) < 100 ||
                         Number(ai.timeoutMs) > 30000)) ||
                 aiKeys.some(key => !allowedAiKeys.has(key))) {
-                diagnostics.push(diagnostic('APP_CONFIG_BACKEND_OPERATION_AI_INVALID', 'AI 操作必须显式声明名称、说明、风险、现有资源、副作用和有界执行策略；GET 只能只读，写操作必须确认', `${path}.ai`));
+                diagnostics.push(diagnostic('APP_CONFIG_BACKEND_OPERATION_AI_INVALID', 'AI 操作必须显式声明名称、说明、风险、现有资源、副作用和有界执行策略；GET 只能只读，写操作必须确认', `${path}.ai`, '写操作的 ai.sideEffects 至少列一条具体副作用，例如 sideEffects: [\'更新报修单状态为处理中\', \'写入一条派工记录\']；resources 必须引用已声明资源（1-16 个）'));
             }
         }
         codes.add(code);
@@ -3297,6 +3297,13 @@ function validateApplicationAuthentication(config, diagnostics) {
         return [string(route.code), route];
     }));
     const routeCodes = new Set(routeByCode.keys());
+    // 生成式用户标准面的路由码（仅参与登录默认路由解析，不占用声明码空间）。
+    const declaredResources = (Array.isArray(object(config.data).resources)
+        ? object(config.data).resources
+        : []);
+    const userSurfaceResourceCodes = new Set(declaredResources
+        .filter(raw => object(object(raw).userSurface))
+        .map(raw => string(object(raw).code)));
     const claimedShapes = new Map(generatedPlatformRouteClaims(config).map(claim => [
         canonicalFrontendRouteShape(claim.path),
         claim,
@@ -3309,7 +3316,21 @@ function validateApplicationAuthentication(config, diagnostics) {
         const routeCode = string(surface.routeCode);
         const routePath = string(surface.path);
         const defaultRouteCode = string(surface.defaultRouteCode);
-        const defaultRoute = routeByCode.get(defaultRouteCode);
+        const generatedUserRoute = /^user:([a-z][a-z0-9-]{0,62}):(records|submit)$/.exec(defaultRouteCode);
+        const defaultRoute = generatedUserRoute
+            ? userSurfaceResourceCodes.has(generatedUserRoute[1])
+                ? {
+                    surface: 'user',
+                    path: generatedUserRoute[2] === 'records'
+                        ? device === 'mobile'
+                            ? `/m/my/${generatedUserRoute[1]}`
+                            : `/my/${generatedUserRoute[1]}`
+                        : device === 'mobile'
+                            ? `/m/my/${generatedUserRoute[1]}/submit`
+                            : `/my/${generatedUserRoute[1]}/submit`,
+                }
+                : undefined
+            : routeByCode.get(defaultRouteCode);
         const shape = canonicalFrontendRouteShape(routePath);
         const expectedPath = device === 'mobile' ? '/m/login' : '/login';
         const invalid = Object.keys(surface).some(key => !['routeCode', 'path', 'defaultRouteCode'].includes(key)) ||
@@ -3730,6 +3751,12 @@ export function resourceReadPolicy(input) {
 }
 export function materializeDataResource(appCode, declaration) {
     const capabilities = resourceCapabilityCodes(appCode, declaration.code);
+    // audit.read: true 是声明糖：绑定本资源的 read 能力。
+    const auditRead = declaration.audit === undefined || declaration.audit.read === false
+        ? false
+        : declaration.audit.read === true
+            ? [capabilities.read]
+            : [...declaration.audit.read];
     const mutationOwner = declaration.mutationOwner || 'native';
     const nativeMutations = mutationOwner === 'native';
     const generated = {
@@ -3876,6 +3903,7 @@ export function materializeDataResource(appCode, declaration) {
         ...(declaration.dataPolicyCode
             ? { dataPolicyCode: declaration.dataPolicyCode }
             : {}),
+        ...(declaration.userSurface ? { userSurface: { ...declaration.userSurface } } : {}),
         ...(declaration.detailRouteCode
             ? { detailRouteCode: { ...declaration.detailRouteCode } }
             : {}),
@@ -3890,7 +3918,7 @@ export function materializeDataResource(appCode, declaration) {
                 },
             ])),
             ...(declaration.audit === undefined ? {} : Object.fromEntries(DATA_AUDIT_METADATA_FIELDS.map(code => [code, {
-                    read: declaration.audit.read === false ? [] : [...declaration.audit.read],
+                    read: auditRead === false ? [] : [...auditRead],
                 }]))),
         },
     };
@@ -3915,6 +3943,7 @@ export function validateAppDeclaration(value) {
         'mobile',
         'dataPolicyCode',
         'detailRouteCode',
+        'userSurface',
         'audit',
     ]);
     const fieldKeys = new Set([
@@ -3960,10 +3989,21 @@ export function validateAppDeclaration(value) {
             const read = audit.read;
             if (!resource.audit || typeof resource.audit !== 'object' || Array.isArray(resource.audit) ||
                 Object.keys(audit).some(key => key !== 'read') ||
-                (read !== false && (!Array.isArray(read) || read.length < 1 || read.length > 20 ||
+                (read !== false && read !== true && (!Array.isArray(read) || read.length < 1 || read.length > 20 ||
                     read.some(value => typeof value !== 'string' || !value.trim()) || new Set(read).size !== read.length))) {
                 auditValid = false;
-                diagnostics.push(diagnostic('APP_CONFIG_DATA_AUDIT_READ_INVALID', 'audit.read 必须为 false 或不重复的非空 capability 数组（最多 20 项）', `${resourcePath}.audit`));
+                diagnostics.push(diagnostic('APP_CONFIG_DATA_AUDIT_READ_INVALID', 'audit.read 必须为 true（绑定资源读能力）、false 或不重复的非空 capability 数组（最多 20 项）', `${resourcePath}.audit`, `audit: { read: true } 会把审计读取绑定到本资源的 read 能力；需要更细粒度时写能力数组，例如 audit: { read: ['app:${appCode}:data:<resource>:read'] }`));
+            }
+        }
+        const userSurface = resource.userSurface;
+        if (userSurface !== undefined) {
+            const surface = object(userSurface);
+            const keys = Object.keys(surface).filter(key => !['home', 'listLabel', 'submitLabel'].includes(key));
+            const labels = [surface.listLabel, surface.submitLabel];
+            if (keys.length ||
+                (surface.home !== undefined && typeof surface.home !== 'boolean') ||
+                labels.some(label => label !== undefined && (typeof label !== 'string' || !label.trim() || label.length > 64))) {
+                diagnostics.push(diagnostic('APP_CONFIG_DATA_USER_SURFACE_INVALID', 'userSurface 只接受 home 布尔与 listLabel/submitLabel（1-64 字符）', `${resourcePath}.userSurface`, `例如 userSurface: { home: true, listLabel: '我的领用', submitLabel: '新建领用' }；直接在 CRUD 视图上写 user: true 即可自动生成`));
             }
         }
         const mutationOwner = string(resource.mutationOwner) || 'native';
@@ -4215,6 +4255,23 @@ export function defineOpenXiangdaApp(declaration) {
             data: { resources: [...(declaration.data?.resources || []), ...projected.resources] },
         } : {}),
     });
+    // 生成式用户标准面：登录默认路由仍是模板占位时，指向首页资源的标准页。
+    const homeResourceCode = (normalizedDeclaration.data?.resources || [])
+        .filter(resource => resource.userSurface)
+        .sort((left, right) => left.code.localeCompare(right.code))
+        .find(resource => resource.userSurface?.home === true)?.code
+        || (normalizedDeclaration.data?.resources || [])
+            .filter(resource => resource.userSurface)
+            .sort((left, right) => left.code.localeCompare(right.code))[0]?.code;
+    if (homeResourceCode && normalizedDeclaration.frontend.authentication) {
+        const surfaces = normalizedDeclaration.frontend.authentication.surfaces;
+        if (surfaces.desktop.defaultRouteCode === 'application-home') {
+            surfaces.desktop.defaultRouteCode = `user:${homeResourceCode}:records`;
+        }
+        if (surfaces.mobile.defaultRouteCode === 'application-home-mobile') {
+            surfaces.mobile.defaultRouteCode = `user:${homeResourceCode}:records`;
+        }
+    }
     const declarationDiagnostics = validateAppDeclaration(normalizedDeclaration);
     if (declarationDiagnostics.length > 0) {
         throw new AppConfigValidationError(declarationDiagnostics);