cabloy 5.1.98 → 5.1.99

package/vona/src/suite/a-training/modules/training-record/src/entity/record.tsx

@@ -89,11 +89,8 @@ export class EntityRecord extends EntityBase {
     ZovaRender.order(7),
     ZovaRender.field('basic-image:formFieldImage', {
       imageScene: 'training-record:sceneImage',
-      multiple: true,
-      maxCount: 9,
+      maxCount: 3,
       relationName: 'sceneImages',
-      accept: ['image/png', 'image/jpeg', 'image/webp'],
-      maxSize: 2 * 1024 * 1024,
       enableCrop: false,
       resize: {
         width: 1280,
@@ -108,6 +105,20 @@ export class EntityRecord extends EntityBase {
   )
   sceneImageIds?: TableIdentity[];
 
-  @Api.field(v.title($locale('Description')), v.optional(), ZovaRender.order(8))
+  @Api.field(
+    v.title($locale('DossierFiles')),
+    v.optional(),
+    ZovaRender.order(8),
+    ZovaRender.field('basic-file:formFieldFile', {
+      fileScene: 'training-record:dossierFile',
+      relationName: 'dossierFiles',
+      maxCount: 3,
+    }),
+    ZovaRender.cell('basic-file:file', { relationName: 'dossierFiles' }),
+    v.array(v.tableIdentity()),
+  )
+  dossierFileIds?: TableIdentity[];
+
+  @Api.field(v.title($locale('Description')), v.optional(), ZovaRender.order(9))
   description?: string;
 }

package/vona/src/suite/a-training/modules/training-record/src/index.ts

@@ -1,4 +1,6 @@
+export * from './bean/fileScene.dossierFile.ts';
 export * from './bean/imageScene.sceneImage.ts';
+export * from './dto/recordDossierFileView.ts';
 export * from './lib/index.ts';
 export * from './.metadata/locales.ts';
 export * from './.metadata/index.ts';

package/vona/src/suite/a-training/modules/training-record/src/lib/index.ts

@@ -1,2 +1,3 @@
 export * from './onEffectForAverageScore.tsx';
 export * from './onEffectForTrainingRecordSubjects.tsx';
+export * from './resolveDossierFiles.ts';

package/vona/src/suite/a-training/modules/training-record/src/lib/resolveDossierFiles.ts

@@ -0,0 +1,34 @@
+import type { TableIdentity } from 'table-identity';
+import type { VonaContext } from 'vona';
+
+import type { DtoRecordDossierFileView } from '../dto/recordDossierFileView.ts';
+
+export async function resolveDossierFiles(
+  this: VonaContext,
+  _value: unknown,
+  data: { dossierFileIds?: TableIdentity[] },
+): Promise<DtoRecordDossierFileView[]> {
+  const dossierFileIds = data.dossierFileIds;
+  if (!dossierFileIds?.length) return [];
+  const items: Array<DtoRecordDossierFileView | undefined> = await Promise.all(
+    dossierFileIds.map(async dossierFileId => {
+      const file = await this.bean.file.get(dossierFileId);
+      if (!file || file.fileScene !== 'training-record:dossierFile') return undefined;
+      return {
+        id: file.id,
+        provider: String(file.provider),
+        clientName: file.clientName,
+        fileScene: file.fileScene ? String(file.fileScene) : undefined,
+        filename: file.filename,
+        contentType: file.contentType,
+        size: file.size,
+        public: file.public,
+        uploadedAt: file.uploadedAt,
+        meta: file.meta as Record<string, unknown> | undefined,
+        downloadUrl: await this.bean.file.getDownloadUrl(file.id),
+        signed: !file.public,
+      } satisfies DtoRecordDossierFileView;
+    }),
+  );
+  return items.filter((item): item is DtoRecordDossierFileView => !!item);
+}

package/vona/src/suite/a-training/modules/training-record/test/record.test.ts

@@ -1,14 +1,16 @@
-import type {
-  DtoRecordCreate,
-  DtoRecordSelectRes,
-  DtoRecordUpdate,
-} from 'vona-module-training-record';
+import type { DtoRecordCreate, DtoRecordUpdate } from 'vona-module-training-record';
 import type { DtoStudentCreate } from 'vona-module-training-student';
 
+import fse from 'fs-extra';
 import assert from 'node:assert';
+import os from 'node:os';
+import path from 'node:path';
 import { describe, it } from 'node:test';
 import { app } from 'vona-mock';
 
+const dossierTextAttendance = Buffer.from('attendance dossier file');
+const dossierTextAssessment = Buffer.from('assessment dossier file');
+
 describe('record.test.ts', () => {
   it('action:record', async () => {
     await app.bean.executor.mockCtx(async () => {
@@ -21,142 +23,226 @@ describe('record.test.ts', () => {
       };
       const trainingTime = new Date('2026-01-15T09:30:00.000Z');
       const trainingTimeUpdate = new Date('2026-02-20T14:45:00.000Z');
-      const recordData = {
-        studentId: 0 as any,
-        name: '__Record__',
-        subjectCount: 1,
-        totalScore: 88,
-        averageScore: 88,
-        trainingTime,
-        description: 'This is a record',
-        trainingRecordSubjects: [
+      const dossierFilePathAttendance = path.join(
+        os.tmpdir(),
+        'training-record-dossier-attendance.txt',
+      );
+      const dossierFilePathAssessment = path.join(
+        os.tmpdir(),
+        'training-record-dossier-assessment.txt',
+      );
+      let dossierFileAttendance: any;
+      let dossierFileAssessment: any;
+      await app.bean.passport.signinMock();
+      try {
+        await fse.writeFile(dossierFilePathAttendance, dossierTextAttendance);
+        dossierFileAttendance = await app.bean.file.upload(
+          'file-native:native',
           {
-            name: '__Math__',
-            score: 95,
-            description: 'Math subject',
+            file: dossierFilePathAttendance,
+            filename: 'attendance.txt',
+            contentType: 'text/plain',
+            public: false,
+            meta: {
+              category: 'attendanceSheet',
+              source: 'upload',
+            },
           },
-        ],
-      } as any as DtoRecordCreate;
-      await app.bean.passport.signinMock();
-      const studentId = await app.bean.executor.performAction('post', '/training/student', {
-        body: studentData,
-      });
-      recordData.studentId = studentId;
-      const recordId = await app.bean.executor.performAction('post', '/training/record', {
-        body: recordData,
-      });
-      assert.equal(!!recordId, true);
+          {
+            clientName: 'default',
+            fileScene: 'training-record:dossierFile',
+          },
+        );
+        const recordData = {
+          studentId: 0 as any,
+          name: '__Record__',
+          subjectCount: 1,
+          totalScore: 88,
+          averageScore: 88,
+          trainingTime,
+          dossierFileIds: [dossierFileAttendance.id],
+          description: 'This is a record',
+          trainingRecordSubjects: [
+            {
+              name: '__Math__',
+              score: 95,
+              description: 'Math subject',
+            },
+          ],
+        } as any as DtoRecordCreate;
+        const studentId = await app.bean.executor.performAction('post', '/training/student', {
+          body: studentData,
+        });
+        recordData.studentId = studentId;
+        const recordId = await app.bean.executor.performAction('post', '/training/record', {
+          body: recordData,
+        });
+        assert.equal(!!recordId, true);
 
-      const selectRes: DtoRecordSelectRes = await app.bean.executor.performAction(
-        'get',
-        '/training/record',
-      );
-      const recordItem = selectRes.list.find(item => String(item.id) === String(recordId));
-      assert.equal(!!recordItem, true);
-      assert.equal(recordItem!.name, recordData.name);
-      assert.equal(String(recordItem!.studentId), String(studentId));
+        const selectRes: any = await app.bean.executor.performAction('get', '/training/record');
+        const recordItem = selectRes.list.find((item: any) => String(item.id) === String(recordId));
+        assert.equal(!!recordItem, true);
+        assert.equal(recordItem!.name, recordData.name);
+        assert.equal(String(recordItem!.studentId), String(studentId));
+        assert.equal(recordItem!.dossierFiles?.length, 1);
+        assert.equal(recordItem!.dossierFiles?.[0]?.filename, 'attendance.txt');
 
-      let record: any = await app.bean.executor.performAction('get', '/training/record/:id', {
-        params: { id: recordId },
-      });
-      const recordSubject = record.trainingRecordSubjects?.[0];
-      assert.equal(record.name, recordData.name);
-      assert.equal(String(record.studentId), String(studentId));
-      assert.equal(record.subjectCount, recordData.subjectCount);
-      assert.equal(record.totalScore, recordData.totalScore);
-      assert.equal(record.averageScore, recordData.averageScore);
-      assert.equal(new Date(record.trainingTime).toISOString(), trainingTime.toISOString());
-      assert.equal(record.trainingRecordSubjects?.length, 1);
-      assert.equal(recordSubject?.name, '__Math__');
-      assert.equal(recordSubject?.score, 95);
+        let record: any = await app.bean.executor.performAction('get', '/training/record/:id', {
+          params: { id: recordId },
+        });
+        const recordSubject = record.trainingRecordSubjects?.[0];
+        const recordDossierFile = record.dossierFiles?.[0];
+        assert.equal(record.name, recordData.name);
+        assert.equal(String(record.studentId), String(studentId));
+        assert.equal(record.subjectCount, recordData.subjectCount);
+        assert.equal(record.totalScore, recordData.totalScore);
+        assert.equal(record.averageScore, recordData.averageScore);
+        assert.equal(new Date(record.trainingTime).toISOString(), trainingTime.toISOString());
+        assert.equal(record.dossierFileIds?.length, 1);
+        assert.equal(record.dossierFiles?.length, 1);
+        assert.equal(String(recordDossierFile?.id), String(dossierFileAttendance.id));
+        assert.equal(recordDossierFile?.filename, 'attendance.txt');
+        assert.equal(recordDossierFile?.signed, true);
+        assert.equal(recordDossierFile?.meta?.category, 'attendanceSheet');
+        assert.equal(record.trainingRecordSubjects?.length, 1);
+        assert.equal(recordSubject?.name, '__Math__');
+        assert.equal(recordSubject?.score, 95);
+        const downloadResponse = await fetch(recordDossierFile.downloadUrl);
+        assert.equal(downloadResponse.ok, true);
+        assert.equal(await downloadResponse.text(), dossierTextAttendance.toString());
 
-      let student: any = await app.bean.executor.performAction('get', '/training/student/:id', {
-        params: { id: studentId },
-      });
-      let studentRecord = student.trainingRecords?.find(
-        (item: any) => String(item.id) === String(recordId),
-      );
-      assert.equal(!!studentRecord, true);
-      assert.equal(studentRecord?.trainingRecordSubjects?.length, 1);
+        let student: any = await app.bean.executor.performAction('get', '/training/student/:id', {
+          params: { id: studentId },
+        });
+        let studentRecord = student.trainingRecords?.find(
+          (item: any) => String(item.id) === String(recordId),
+        );
+        assert.equal(!!studentRecord, true);
+        assert.equal(studentRecord?.dossierFiles?.length, 1);
+        assert.equal(studentRecord?.trainingRecordSubjects?.length, 1);
 
-      const dataUpdate = {
-        studentId,
-        name: '__RecordNew__',
-        subjectCount: 2,
-        totalScore: 183,
-        averageScore: 91.5,
-        trainingTime: trainingTimeUpdate,
-        description: 'This is an updated record',
-        trainingRecordSubjects: [
+        await fse.writeFile(dossierFilePathAssessment, dossierTextAssessment);
+        dossierFileAssessment = await app.bean.file.upload(
+          'file-native:native',
           {
-            id: recordSubject.id,
-            name: '__MathNew__',
-            score: 96,
-            description: 'Updated math subject',
+            file: dossierFilePathAssessment,
+            filename: 'assessment.txt',
+            contentType: 'text/plain',
+            public: false,
+            meta: {
+              category: 'assessmentReport',
+              source: 'upload',
+            },
           },
           {
-            name: '__English__',
-            score: 87,
-            description: 'English subject',
+            clientName: 'default',
+            fileScene: 'training-record:dossierFile',
           },
-        ],
-      } as any as DtoRecordUpdate;
-      await app.bean.executor.performAction('patch', '/training/record/:id', {
-        params: { id: recordId },
-        body: dataUpdate,
-      });
+        );
+        const dataUpdate = {
+          studentId,
+          name: '__RecordNew__',
+          subjectCount: 2,
+          totalScore: 183,
+          averageScore: 91.5,
+          trainingTime: trainingTimeUpdate,
+          dossierFileIds: [dossierFileAttendance.id, dossierFileAssessment.id],
+          description: 'This is an updated record',
+          trainingRecordSubjects: [
+            {
+              id: recordSubject.id,
+              name: '__MathNew__',
+              score: 96,
+              description: 'Updated math subject',
+            },
+            {
+              name: '__English__',
+              score: 87,
+              description: 'English subject',
+            },
+          ],
+        } as any as DtoRecordUpdate;
+        await app.bean.executor.performAction('patch', '/training/record/:id', {
+          params: { id: recordId },
+          body: dataUpdate,
+        });
 
-      record = await app.bean.executor.performAction('get', '/training/record/:id', {
-        params: { id: recordId },
-      });
-      const [updatedMathSubject, updatedEnglishSubject] = record.trainingRecordSubjects ?? [];
-      assert.equal(record.name, dataUpdate.name);
-      assert.equal(record.subjectCount, dataUpdate.subjectCount);
-      assert.equal(record.totalScore, dataUpdate.totalScore);
-      assert.equal(record.averageScore, dataUpdate.averageScore);
-      assert.equal(new Date(record.trainingTime).toISOString(), trainingTimeUpdate.toISOString());
-      assert.equal(record.trainingRecordSubjects?.length, 2);
-      assert.equal(updatedMathSubject?.name, '__MathNew__');
-      assert.equal(updatedMathSubject?.score, 96);
-      assert.equal(updatedEnglishSubject?.name, '__English__');
-      assert.equal(updatedEnglishSubject?.score, 87);
+        record = await app.bean.executor.performAction('get', '/training/record/:id', {
+          params: { id: recordId },
+        });
+        const [updatedMathSubject, updatedEnglishSubject] = record.trainingRecordSubjects ?? [];
+        assert.equal(record.name, dataUpdate.name);
+        assert.equal(record.subjectCount, dataUpdate.subjectCount);
+        assert.equal(record.totalScore, dataUpdate.totalScore);
+        assert.equal(record.averageScore, dataUpdate.averageScore);
+        assert.equal(new Date(record.trainingTime).toISOString(), trainingTimeUpdate.toISOString());
+        assert.equal(record.dossierFileIds?.length, 2);
+        assert.equal(record.dossierFiles?.length, 2);
+        assert.equal(
+          record.dossierFiles.some((item: any) => item.filename === 'attendance.txt'),
+          true,
+        );
+        assert.equal(
+          record.dossierFiles.some((item: any) => item.filename === 'assessment.txt'),
+          true,
+        );
+        assert.equal(record.trainingRecordSubjects?.length, 2);
+        assert.equal(updatedMathSubject?.name, '__MathNew__');
+        assert.equal(updatedMathSubject?.score, 96);
+        assert.equal(updatedEnglishSubject?.name, '__English__');
+        assert.equal(updatedEnglishSubject?.score, 87);
 
-      student = await app.bean.executor.performAction('get', '/training/student/:id', {
-        params: { id: studentId },
-      });
-      studentRecord = student.trainingRecords?.find(
-        (item: any) => String(item.id) === String(recordId),
-      );
-      assert.equal(studentRecord?.name, dataUpdate.name);
-      assert.equal(studentRecord?.trainingRecordSubjects?.length, 2);
+        student = await app.bean.executor.performAction('get', '/training/student/:id', {
+          params: { id: studentId },
+        });
+        studentRecord = student.trainingRecords?.find(
+          (item: any) => String(item.id) === String(recordId),
+        );
+        assert.equal(studentRecord?.name, dataUpdate.name);
+        assert.equal(studentRecord?.dossierFiles?.length, 2);
+        assert.equal(studentRecord?.trainingRecordSubjects?.length, 2);
 
-      await app.bean.executor.performAction('delete', '/training/record/:id', {
-        params: { id: recordId },
-      });
+        await app.bean.executor.performAction('delete', '/training/record/:id', {
+          params: { id: recordId },
+        });
 
-      record = await app.bean.executor.performAction('get', '/training/record/:id', {
-        params: { id: recordId },
-      });
-      assert.equal(record, undefined);
+        record = await app.bean.executor.performAction('get', '/training/record/:id', {
+          params: { id: recordId },
+        });
+        assert.equal(record, undefined);
 
-      student = await app.bean.executor.performAction('get', '/training/student/:id', {
-        params: { id: studentId },
-      });
-      studentRecord = student.trainingRecords?.find(
-        (item: any) => String(item.id) === String(recordId),
-      );
-      assert.equal(studentRecord, undefined);
+        student = await app.bean.executor.performAction('get', '/training/student/:id', {
+          params: { id: studentId },
+        });
+        studentRecord = student.trainingRecords?.find(
+          (item: any) => String(item.id) === String(recordId),
+        );
+        assert.equal(studentRecord, undefined);
 
-      await app.bean.executor.performAction('delete', '/training/student/:id', {
-        params: { id: studentId },
-      });
+        const retainedDossierFileAttendance = await app.bean.file.get(dossierFileAttendance.id);
+        const retainedDossierFileAssessment = await app.bean.file.get(dossierFileAssessment.id);
+        assert.equal(!!retainedDossierFileAttendance, true);
+        assert.equal(!!retainedDossierFileAssessment, true);
 
-      student = await app.bean.executor.performAction('get', '/training/student/:id', {
-        params: { id: studentId },
-      });
-      assert.equal(student, undefined);
+        await app.bean.executor.performAction('delete', '/training/student/:id', {
+          params: { id: studentId },
+        });
 
-      await app.bean.passport.signout();
+        student = await app.bean.executor.performAction('get', '/training/student/:id', {
+          params: { id: studentId },
+        });
+        assert.equal(student, undefined);
+      } finally {
+        if (dossierFileAssessment) {
+          await app.bean.file.delete(dossierFileAssessment.id);
+        }
+        if (dossierFileAttendance) {
+          await app.bean.file.delete(dossierFileAttendance.id);
+        }
+        await fse.remove(dossierFilePathAttendance);
+        await fse.remove(dossierFilePathAssessment);
+        await app.bean.passport.signout();
+      }
     });
   });
 });

package/vona/src/suite/a-training/modules/training-student/src/config/locale/en-us.ts

@@ -9,6 +9,7 @@ export default {
   Student: 'Student',
   StudentName: 'Student Name',
   StudentImage: 'Student Image',
+  DossierFiles: 'Dossier Files',
   Summary: 'Summary',
   LevelTitle: 'Level Title',
   DescriptionLength: 'Description Length',

package/vona/src/suite/a-training/modules/training-student/src/config/locale/zh-cn.ts

@@ -9,6 +9,7 @@ export default {
   Student: '学生',
   StudentName: '学生姓名',
   StudentImage: '学生图片',
+  DossierFiles: '培训档案附件',
   Summary: '摘要',
   LevelTitle: '阶段名称',
   DescriptionLength: '描述长度',

package/vona/src/suite/a-training/modules/training-student/src/dto/detailRecordBase.tsx

@@ -5,7 +5,12 @@ import { DtoImageView } from 'vona-module-a-image';
 import { $makeMetadata, Api, v } from 'vona-module-a-openapiutils';
 import { $Dto } from 'vona-module-a-orm';
 import { Dto } from 'vona-module-a-web';
-import { ModelRecord, onEffectForTrainingRecordSubjects } from 'vona-module-training-record';
+import {
+  DtoRecordDossierFileView,
+  ModelRecord,
+  onEffectForTrainingRecordSubjects,
+  resolveDossierFiles,
+} from 'vona-module-training-record';
 import { ZovaRender } from 'zova-rest-cabloy-basic-admin';
 
 import { $locale } from '../.metadata/locales.ts';
@@ -34,6 +39,7 @@ export class DtoDetailRecordBase extends $Dto.get(() => ModelRecord, {
     'averageScore',
     'trainingTime',
     'sceneImageIds',
+    'dossierFileIds',
     'description',
   ],
   include: { trainingRecordSubjects: true },
@@ -48,4 +54,15 @@ export class DtoDetailRecordBase extends $Dto.get(() => ModelRecord, {
     v.array($Class.partial(DtoImageView)),
   )
   sceneImages?: Partial<DtoImageView>[];
+
+  @Api.field(
+    v.title($locale('DossierFiles')),
+    ZovaRender.visible(false),
+    v.optional(),
+    v.serializerTransform('a-serialization:custom', {
+      custom: resolveDossierFiles,
+    }),
+    v.array($Class.partial(DtoRecordDossierFileView)),
+  )
+  dossierFiles?: Partial<DtoRecordDossierFileView>[];
 }

package/vona/src/suite/a-training/modules/training-student/src/entity/student.tsx

@@ -65,8 +65,6 @@ export class EntityStudent extends EntityBase {
     ZovaRender.order(4),
     ZovaRender.field('basic-image:formFieldImage', {
       imageScene: 'training-student:studentImage',
-      accept: ['image/png', 'image/jpeg', 'image/webp'],
-      maxSize: 2 * 1024 * 1024,
       enableCrop: true,
       cropAspectRatio: 1,
       relationName: 'image',

package/vona/src/suite/a-training/modules/training-student/src/model/student.ts

@@ -18,6 +18,7 @@ export interface IModelOptionsStudent extends IDecoratorModelOptions<EntityStude
         'averageScore',
         'trainingTime',
         'sceneImageIds',
+        'dossierFileIds',
         'description',
       ],
     }),

package/vona/src/suite-vendor/a-file/modules/a-file/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-module-a-file",
-  "version": "5.0.3",
+  "version": "5.0.4",
   "description": "",
   "keywords": [
     "Vona Module"
@@ -55,11 +55,13 @@
       "fileProvider": {
         "optionsGlobalInterfaceName": "IDecoratorFileProviderOptions",
         "optionsGlobalInterfaceFrom": "vona-module-a-file",
-        "scopeResource": true
+        "scopeResource": true,
+        "boilerplate": "fileProvider/boilerplate"
       },
       "fileScene": {
         "optionsGlobalInterfaceName": "IDecoratorFileSceneOptions",
-        "optionsGlobalInterfaceFrom": "vona-module-a-file"
+        "optionsGlobalInterfaceFrom": "vona-module-a-file",
+        "boilerplate": "fileScene/boilerplate"
       }
     }
   }

package/vona/src/suite-vendor/a-file/modules/a-file/src/bean/bean.fileUploadPolicy.ts

@@ -125,6 +125,34 @@ export class BeanFileUploadPolicy extends BeanBase {
     };
   }
 
+  async resolveSceneUploadPolicy(data: { fileScene: keyof IFileSceneRecord }) {
+    const fileConfig = this.scope.config.file;
+    const fileScene = data.fileScene;
+    const sceneOptions = this._getSceneOptions(fileScene);
+    const { providerName, clientName } = await this._resolveProvider(sceneOptions);
+    const providerContext = await this.bean.fileProvider.getClientOptions({
+      providerName,
+      clientName,
+    });
+    if (!providerContext.entityFileProvider || providerContext.disabled) {
+      return this.app.throw(403, `File provider unavailable: ${providerName}.${clientName}`);
+    }
+    const uploadOptions = {
+      ...(fileConfig.upload ?? {}),
+      ...(sceneOptions.upload ?? {}),
+    };
+    const mimeTypes = [...(uploadOptions.mimeTypes ?? [])];
+    const extensions = [...(uploadOptions.extensions ?? [])];
+    return {
+      fileScene,
+      maxSize: uploadOptions.maxSize,
+      mimeTypes: mimeTypes.length > 0 ? mimeTypes : undefined,
+      extensions: extensions.length > 0 ? extensions : undefined,
+      multiple: uploadOptions.multiple,
+      public: this._resolvePublic(providerContext.clientOptions, sceneOptions),
+    };
+  }
+
   async resolveUploadPolicy(data: {
     fileScene: keyof IFileSceneRecord;
     size: number;

package/vona/src/suite-vendor/a-file/modules/a-file/src/controller/file.ts

@@ -10,6 +10,8 @@ import { Arg, Controller, Web } from 'vona-module-a-web';
 import { DtoFileDirectUploadRequest } from '../dto/fileDirectUploadRequest.ts';
 import { DtoFileDirectUploadResponse } from '../dto/fileDirectUploadResponse.ts';
 import { DtoFileDownloadRequest } from '../dto/fileDownloadRequest.ts';
+import { DtoFileUploadPolicyRequest } from '../dto/fileUploadPolicyRequest.ts';
+import { DtoFileUploadPolicyResponse } from '../dto/fileUploadPolicyResponse.ts';
 import { DtoFileUploadResponse } from '../dto/fileUploadResponse.ts';
 import { DtoFileUploadTokenRequest } from '../dto/fileUploadTokenRequest.ts';
 import { DtoFileUploadTokenResponse } from '../dto/fileUploadTokenResponse.ts';
@@ -19,6 +21,12 @@ export interface IControllerOptionsFile extends IDecoratorControllerOptions {}
 
 @Controller<IControllerOptionsFile>({ path: 'file' })
 export class ControllerFile extends BeanBase {
+  @Web.post('upload-policy')
+  @Api.body(DtoFileUploadPolicyResponse)
+  async getUploadPolicy(@Arg.body() data: DtoFileUploadPolicyRequest) {
+    return await this.bean.fileUploadPolicy.resolveSceneUploadPolicy(data);
+  }
+
   @Web.post('upload-token')
   @Api.body(DtoFileUploadTokenResponse)
   async createUploadToken(@Arg.body() data: DtoFileUploadTokenRequest) {

package/vona/src/suite-vendor/a-file/modules/a-file/src/dto/fileUploadPolicyRequest.ts

@@ -0,0 +1,15 @@
+import type { IDecoratorDtoOptions } from 'vona-module-a-web';
+
+import { Api } from 'vona-module-a-openapiutils';
+import { Dto } from 'vona-module-a-web';
+import z from 'zod';
+
+import type { IFileSceneRecord } from '../types/fileScene.ts';
+
+export interface IDtoOptionsFileUploadPolicyRequest extends IDecoratorDtoOptions {}
+
+@Dto<IDtoOptionsFileUploadPolicyRequest>()
+export class DtoFileUploadPolicyRequest {
+  @Api.field(z.string())
+  fileScene: keyof IFileSceneRecord;
+}

package/vona/src/suite-vendor/a-file/modules/a-file/src/dto/fileUploadPolicyResponse.ts

@@ -0,0 +1,30 @@
+import type { IDecoratorDtoOptions } from 'vona-module-a-web';
+
+import { Api, v } from 'vona-module-a-openapiutils';
+import { Dto } from 'vona-module-a-web';
+import z from 'zod';
+
+import type { IFileSceneRecord } from '../types/fileScene.ts';
+
+export interface IDtoOptionsFileUploadPolicyResponse extends IDecoratorDtoOptions {}
+
+@Dto<IDtoOptionsFileUploadPolicyResponse>()
+export class DtoFileUploadPolicyResponse {
+  @Api.field(z.string())
+  fileScene: keyof IFileSceneRecord;
+
+  @Api.field(v.optional(), z.number().int().positive())
+  maxSize?: number;
+
+  @Api.field(v.optional(), z.array(z.string()))
+  mimeTypes?: string[];
+
+  @Api.field(v.optional(), z.array(z.string()))
+  extensions?: string[];
+
+  @Api.field(v.optional(), z.boolean())
+  multiple?: boolean;
+
+  @Api.field(v.optional(), z.boolean())
+  public?: boolean;
+}