@gadmin2n/schematics 0.0.70 → 0.0.72

package/dist/lib/application/files/gadmin2-game-angle-demo/server/package.json

@@ -34,8 +34,9 @@
     "prisma:studio": "dotenv -e .env.local -e .env  -- prisma studio"
   },
   "dependencies": {
+    "@agendajs/postgres-backend": "^3.0.5",
     "@azure/identity": "^4.13.0",
-    "@gadmin2n/nest-common": "^0.0.41",
+    "@gadmin2n/nest-common": "^0.0.42",
     "@nestjs/cache-manager": "^3.0.1",
     "@nestjs/common": "^10.4.15",
     "@nestjs/config": "^3.2.0",
@@ -56,6 +57,7 @@
     "@opentelemetry/semantic-conventions": "^1.39.0",
     "@prisma/client": "^6.19.0",
     "@prisma/instrumentation": "6.19.0",
+    "agenda": "^6.2.5",
     "axios": "^1.13.2",
     "cache-manager": "^6.4.3",
     "class-transformer": "^0.5.1",
@@ -85,8 +87,8 @@
   },
   "devDependencies": {
     "@faker-js/faker": "^10.4.0",
-    "@gadmin2n/prisma-nest-generator": "^0.0.35",
-    "@gadmin2n/prisma-react-generator": "^0.0.51",
+    "@gadmin2n/prisma-nest-generator": "^0.0.36",
+    "@gadmin2n/prisma-react-generator": "^0.0.52",
     "@nestjs/testing": "^10.4.15",
     "@types/cookie-parser": "^1.4.3",
     "@types/express": "^4.17.21",

package/dist/lib/application/files/gadmin2-game-angle-demo/server/seed/permissions.ts

@@ -74,6 +74,11 @@ export async function seedPermissions(prisma: PrismaClient) {
       pageCode: 'game',
     },
     { code: 'canvas', description: 'Canvas management', pageCode: 'canvas' },
+    {
+      code: 'agenda',
+      description: 'Agenda job management',
+      pageCode: 'agenda',
+    },
   ];
 
   const resources: { id: number; code: string }[] = [];
@@ -117,7 +122,7 @@ export async function seedPermissions(prisma: PrismaClient) {
     name: 'permission',
     zhName: '权限管理',
     enName: 'Permission Mgnt',
-    sortOrder: 1010,
+    sortOrder: 1030,
     parentId: adminPage.id,
   });
   pages.push({ id: permissionPage.id, code: permissionPage.code });
@@ -175,21 +180,28 @@ export async function seedPermissions(prisma: PrismaClient) {
       name: 'canvas',
       zhName: 'Canvas',
       enName: 'Canvas',
-      sortOrder: 1005,
+      sortOrder: 1010,
+    },
+    {
+      code: 'agenda',
+      name: 'agenda',
+      zhName: 'Cron Jobs',
+      enName: 'Cron Jobs',
+      sortOrder: 1020,
     },
     {
       code: 'game',
       name: 'game',
       zhName: '业务管理',
       enName: 'Business Mgnt',
-      sortOrder: 1050,
+      sortOrder: 1040,
     },
     {
       code: 'audits',
       name: 'audits',
       zhName: '审计日志',
       enName: 'Audit Log',
-      sortOrder: 1060,
+      sortOrder: 1050,
     },
   ];
 

package/dist/lib/application/files/gadmin2-game-angle-demo/server/src/app.module.ts

@@ -18,6 +18,7 @@ import { ScheduleModule } from '@nestjs/schedule';
 import { ServeStaticModule } from '@nestjs/serve-static';
 import { join } from 'path';
 import { LogFormat } from './lib/logger';
+import { AgendaModule } from './modules/agenda/agenda.module';
 import { RoleModule } from './modules/role/role.module';
 import { RoleService } from './modules/role/role.service';
 import { RolesRefresherService } from './modules/role/roles-refresher.service';
@@ -83,6 +84,7 @@ import { RolesRefresherService } from './modules/role/roles-refresher.service';
     }),
 
     ...modules,
+    AgendaModule,
   ],
 
   controllers: [AppController],

package/dist/lib/application/files/gadmin2-game-angle-demo/server/src/modules/agenda/agenda.controller.ts

@@ -0,0 +1,106 @@
+import { ACGuard } from '@gadmin2n/nest-common';
+import {
+  Body,
+  Controller,
+  Get,
+  NotFoundException,
+  Param,
+  Post,
+  Query,
+  UseGuards,
+} from '@nestjs/common';
+import { ApiOkResponse, ApiTags } from '@nestjs/swagger';
+import { AgendaService } from './agenda.service';
+
+class JobIdsDto {
+  jobIds: string[];
+}
+
+class JobsQueryDto {
+  job?: string;
+  state?: string;
+  toggle?: string;
+  module?: string;
+  q?: string;
+  skip?: number;
+  limit?: number;
+}
+
+class JobLogsQueryDto {
+  jobName: string;
+  status?: string;
+  before?: string;
+  skip?: number;
+  limit?: number;
+}
+
+@UseGuards(ACGuard)
+@Controller('agenda')
+@ApiTags('agenda')
+export class AgendaController {
+  constructor(private readonly agendaService: AgendaService) {}
+
+  @Get('jobs')
+  @ApiOkResponse({ description: 'List jobs with overview stats' })
+  async getJobs(@Query() query: JobsQueryDto) {
+    return this.agendaService.getJobs({
+      job: query.job,
+      state: query.state,
+      toggle: query.toggle,
+      module: query.module,
+      q: query.q,
+      skip: query.skip ? Number(query.skip) : 0,
+      limit: query.limit ? Number(query.limit) : 20,
+    });
+  }
+
+  @Post('requeue')
+  @ApiOkResponse({ description: 'Requeue jobs by IDs' })
+  async requeue(@Body() body: JobIdsDto) {
+    return this.agendaService.requeueByIds(body.jobIds);
+  }
+
+  @Post('retry')
+  @ApiOkResponse({ description: 'Retry failed jobs by IDs' })
+  async retry(@Body() body: JobIdsDto) {
+    return this.agendaService.retryByIds(body.jobIds);
+  }
+
+  @Post('delete')
+  @ApiOkResponse({ description: 'Delete jobs by IDs' })
+  async delete(@Body() body: JobIdsDto) {
+    return this.agendaService.deleteByIds(body.jobIds);
+  }
+
+  @Post('disable')
+  @ApiOkResponse({ description: 'Disable (pause) jobs by IDs' })
+  async disable(@Body() body: JobIdsDto) {
+    return this.agendaService.disableByIds(body.jobIds);
+  }
+
+  @Post('enable')
+  @ApiOkResponse({ description: 'Enable (resume) jobs by IDs' })
+  async enable(@Body() body: JobIdsDto) {
+    return this.agendaService.enableByIds(body.jobIds);
+  }
+
+  @Get('job/:jobName')
+  @ApiOkResponse({ description: 'Get single job detail with run statistics' })
+  async getJobDetail(@Param('jobName') jobName: string) {
+    const detail = await this.agendaService.getJobDetail(jobName);
+    if (!detail) throw new NotFoundException(`Job "${jobName}" not found`);
+    return detail;
+  }
+
+  @Get('logs')
+  @ApiOkResponse({ description: 'Get execution history logs for a job' })
+  async getLogs(@Query() query: JobLogsQueryDto) {
+    return this.agendaService.getJobLogs({
+      jobName: query.jobName,
+      status: query.status,
+      before: query.before,
+      skip: query.skip ? Number(query.skip) : 0,
+      limit: query.limit ? Number(query.limit) : 20,
+    });
+  }
+}

package/dist/lib/application/files/gadmin2-game-angle-demo/server/src/modules/agenda/agenda.module.ts

@@ -0,0 +1,10 @@
+import { Module } from '@nestjs/common';
+import { AgendaController } from './agenda.controller';
+import { AgendaService } from './agenda.service';
+
+@Module({
+  controllers: [AgendaController],
+  providers: [AgendaService],
+  exports: [AgendaService],
+})
+export class AgendaModule {}