) {}
+ get>(path: P): PathValue {
+ return this.configService.get(path, { infer: true });
+ }
+}
diff --git a/template/nest-next/libs/configure/src/configure/configure.ts b/template/nest-next/libs/configure/src/configure/configure.ts
new file mode 100644
index 00000000..1b2d1b09
--- /dev/null
+++ b/template/nest-next/libs/configure/src/configure/configure.ts
@@ -0,0 +1,5 @@
+import { DatabaseConfig } from './database';
+
+export type Configure = {
+ database: DatabaseConfig;
+};
diff --git a/template/nest-next/libs/configure/src/configure/database.ts b/template/nest-next/libs/configure/src/configure/database.ts
new file mode 100644
index 00000000..d47c75a6
--- /dev/null
+++ b/template/nest-next/libs/configure/src/configure/database.ts
@@ -0,0 +1,7 @@
+export type DatabaseConfig = {
+ host: string;
+ port: number;
+ user: string;
+ password: string;
+ dbName: string;
+};
diff --git a/template/nest-next/libs/configure/src/configure/index.ts b/template/nest-next/libs/configure/src/configure/index.ts
new file mode 100644
index 00000000..c46a1977
--- /dev/null
+++ b/template/nest-next/libs/configure/src/configure/index.ts
@@ -0,0 +1 @@
+export * from './configure';
diff --git a/template/nest-next/libs/configure/src/index.ts b/template/nest-next/libs/configure/src/index.ts
new file mode 100644
index 00000000..7aaac7e6
--- /dev/null
+++ b/template/nest-next/libs/configure/src/index.ts
@@ -0,0 +1,3 @@
+export * from './configure.module';
+export * from './configure';
+export * from './configure.service';
diff --git a/template/nest-next/libs/configure/src/loader.ts b/template/nest-next/libs/configure/src/loader.ts
new file mode 100644
index 00000000..96d254e2
--- /dev/null
+++ b/template/nest-next/libs/configure/src/loader.ts
@@ -0,0 +1,6 @@
+import { readFileSync } from 'fs';
+import { join } from 'path';
+
+export const loader = () =>
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+ JSON.parse(readFileSync(join(__dirname, './config/config.json')).toString());
diff --git a/template/nest-next/libs/configure/tsconfig.lib.json b/template/nest-next/libs/configure/tsconfig.lib.json
new file mode 100644
index 00000000..ebba8506
--- /dev/null
+++ b/template/nest-next/libs/configure/tsconfig.lib.json
@@ -0,0 +1,9 @@
+{
+ "extends": "../../tsconfig.json",
+ "compilerOptions": {
+ "declaration": true,
+ "outDir": "../../dist/libs/configure"
+ },
+ "include": ["src/**/*"],
+ "exclude": ["node_modules", "dist", "test", "**/*spec.ts"]
+}
diff --git a/template/nest-next/libs/shared/src/.generate/i18n.generated.ts b/template/nest-next/libs/shared/src/.generate/i18n.generated.ts
new file mode 100644
index 00000000..2c69b00d
--- /dev/null
+++ b/template/nest-next/libs/shared/src/.generate/i18n.generated.ts
@@ -0,0 +1,24 @@
+/* DO NOT EDIT, file generated by nestjs-i18n */
+
+/* eslint-disable */
+/* prettier-ignore */
+import { Path } from "nestjs-i18n";
+/* prettier-ignore */
+export type I18nTranslations = {
+ "exception": {
+ "common": {
+ "INTERNAL_ERROR": string;
+ };
+ "permission": {
+ "NOT_FOUND": string;
+ };
+ };
+ "validation": {
+ "NOT_EMPTY": string;
+ "IS_ARRAY": string;
+ "NOT_EMPTY_HUMAN": string;
+ "TYPE_ERROR": string;
+ };
+};
+/* prettier-ignore */
+export type I18nPath = Path;
diff --git a/template/nest-next/libs/shared/src/error.base.ts b/template/nest-next/libs/shared/src/error.base.ts
new file mode 100644
index 00000000..d0196ee2
--- /dev/null
+++ b/template/nest-next/libs/shared/src/error.base.ts
@@ -0,0 +1,41 @@
+import { HttpStatus } from '@nestjs/common';
+import { I18nPath } from './.generate/i18n.generated';
+
+export type DomainErrorProps = {
+ message: I18nPath;
+ code: HttpStatus;
+ details?: unknown;
+ params?: Record;
+ cause?: Error;
+};
+
+export class DomainError extends Error {
+ /**
+ * HTTP 状态码
+ * @type {HttpStatus}
+ */
+ public readonly code: HttpStatus;
+ /**
+ * 错误信息
+ * @type {I18nPath}
+ */
+ public readonly message: I18nPath;
+ /**
+ * 附加详情
+ * @type {unknown}
+ */
+ public readonly details?: unknown;
+ /**
+ * 模板参数，用于格式化错误信息
+ * @type {Record}
+ */
+ public readonly args?: Record;
+
+ constructor(props: DomainErrorProps) {
+ super(props.message, { cause: props.cause });
+ this.code = props.code;
+ this.message = props.message;
+ this.details = props.details;
+ this.args = props.params;
+ }
+}
diff --git a/template/nest-next/libs/shared/src/global-exception.filter.ts b/template/nest-next/libs/shared/src/global-exception.filter.ts
new file mode 100644
index 00000000..52b5e6c1
--- /dev/null
+++ b/template/nest-next/libs/shared/src/global-exception.filter.ts
@@ -0,0 +1,38 @@
+import {
+ ArgumentsHost,
+ Catch,
+ ExceptionFilter,
+ Injectable,
+ Logger,
+} from '@nestjs/common';
+import { DomainError } from './error.base';
+import { I18nService } from 'nestjs-i18n';
+import { Request, Response } from 'express';
+import { I18nTranslations } from './.generate/i18n.generated';
+
+@Catch(Error)
+@Injectable()
+export class GlobalExceptionFilter implements ExceptionFilter {
+ private readonly logger: Logger = new Logger(GlobalExceptionFilter.name);
+ constructor(private readonly i18n: I18nService) {}
+ catch(exception: any, host: ArgumentsHost) {
+ this.logger.error(exception);
+ const ctx = host.switchToHttp();
+ const response: Response = ctx.getResponse();
+ const request: Request = ctx.getRequest();
+ const lang = request.headers['accept-language']?.split(',')[0] || 'enUS';
+ if (exception instanceof DomainError) {
+ const { code, message, details, args } = exception;
+ const translatedMessage = this.i18n.translate(message, { args, lang });
+ return response.status(code).json({
+ statusCode: code,
+ message: translatedMessage,
+ details,
+ });
+ }
+ return response.status(500).json({
+ statusCode: 500,
+ message: this.i18n.translate('exception.common.INTERNAL_ERROR', { lang }),
+ });
+ }
+}
diff --git a/template/nest-next/libs/shared/src/index.ts b/template/nest-next/libs/shared/src/index.ts
new file mode 100644
index 00000000..ba149205
--- /dev/null
+++ b/template/nest-next/libs/shared/src/index.ts
@@ -0,0 +1,5 @@
+export { DomainError } from './error.base';
+export type { DomainErrorProps } from './error.base';
+export { GlobalExceptionFilter } from './global-exception.filter';
+export * from './.generate/i18n.generated';
+export * from './pagination';
diff --git a/template/nest-next/libs/shared/src/pagination.ts b/template/nest-next/libs/shared/src/pagination.ts
new file mode 100644
index 00000000..db70dede
--- /dev/null
+++ b/template/nest-next/libs/shared/src/pagination.ts
@@ -0,0 +1,31 @@
+import { ApiProperty } from '@nestjs/swagger';
+
+export class PaginationMeta {
+ @ApiProperty({
+ description: '本页大小',
+ })
+ itemCount: number;
+ @ApiProperty({
+ description: '元素大小',
+ })
+ totalItems: number;
+ @ApiProperty({
+ description: '每页大小',
+ })
+ itemsPerPage: number;
+ @ApiProperty({
+ description: '当前页数',
+ })
+ currentPage: number;
+ constructor(
+ itemCount: number,
+ totalItems: number,
+ itemsPerPage: number,
+ currentPage: number,
+ ) {
+ this.itemCount = itemCount;
+ this.totalItems = totalItems;
+ this.itemsPerPage = itemsPerPage;
+ this.currentPage = currentPage;
+ }
+}
diff --git a/template/nest-next/libs/shared/tsconfig.lib.json b/template/nest-next/libs/shared/tsconfig.lib.json
new file mode 100644
index 00000000..06a72cef
--- /dev/null
+++ b/template/nest-next/libs/shared/tsconfig.lib.json
@@ -0,0 +1,9 @@
+{
+ "extends": "../../tsconfig.json",
+ "compilerOptions": {
+ "declaration": true,
+ "outDir": "../../dist/libs/shared"
+ },
+ "include": ["src/**/*"],
+ "exclude": ["node_modules", "dist", "test", "**/*spec.ts"]
+}
diff --git a/template/nest-next/mikro-orm.config.ts b/template/nest-next/mikro-orm.config.ts
new file mode 100644
index 00000000..a3516dd5
--- /dev/null
+++ b/template/nest-next/mikro-orm.config.ts
@@ -0,0 +1,14 @@
+import { defineConfig } from '@mikro-orm/core';
+import { MySqlDriver } from '@mikro-orm/mysql';
+import { Permission } from './src/permission';
+import config from './configs/config.json';
+
+export default defineConfig({
+ entities: [Permission],
+ host: config.database.host,
+ port: config.database.port,
+ driver: MySqlDriver,
+ user: config.database.user,
+ password: config.database.password,
+ dbName: config.database.dbName,
+});
diff --git a/template/nest-next/nest-cli.json b/template/nest-next/nest-cli.json
new file mode 100644
index 00000000..627d06b1
--- /dev/null
+++ b/template/nest-next/nest-cli.json
@@ -0,0 +1,37 @@
+{
+ "$schema": "https://json.schemastore.org/nest-cli",
+ "collection": "@nestjs/schematics",
+ "sourceRoot": "src",
+ "compilerOptions": {
+ "webpack": true,
+ "assets": [
+ "./i18n",
+ {
+ "include": "../configs/*",
+ "outDir": "./dist/config"
+ }
+ ],
+ "watchAssets": true,
+ "deleteOutDir": false
+ },
+ "projects": {
+ "configure": {
+ "type": "library",
+ "root": "libs/configure",
+ "entryFile": "index",
+ "sourceRoot": "libs/configure/src",
+ "compilerOptions": {
+ "tsConfigPath": "libs/configure/tsconfig.lib.json"
+ }
+ },
+ "shared": {
+ "type": "library",
+ "root": "libs/shared",
+ "entryFile": "index",
+ "sourceRoot": "libs/shared/src",
+ "compilerOptions": {
+ "tsConfigPath": "libs/shared/tsconfig.lib.json"
+ }
+ }
+ }
+}
diff --git a/template/nest-next/package.json b/template/nest-next/package.json
new file mode 100644
index 00000000..35d51179
--- /dev/null
+++ b/template/nest-next/package.json
@@ -0,0 +1,96 @@
+{
+ "name": "nest-next",
+ "version": "0.0.1",
+ "description": "",
+ "author": "",
+ "private": true,
+ "license": "UNLICENSED",
+ "scripts": {
+ "build": "nest build",
+ "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\" \"libs/**/*.ts\"",
+ "start": "nest start",
+ "start:dev": "nest start --watch",
+ "start:debug": "nest start --debug --watch",
+ "start:prod": "node dist/main",
+ "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
+ "test": "jest",
+ "test:watch": "jest --watch",
+ "test:cov": "jest --coverage",
+ "test:debug": "node --inspect-brk -r tsconfig-paths/register -r ts-node/register node_modules/.bin/jest --runInBand",
+ "test:e2e": "jest --config ./test/jest-e2e.json",
+ "schema:update": "mikro-orm schema:update --run"
+ },
+ "dependencies": {
+ "@gaonengwww/jose": "^6.1.0",
+ "@mikro-orm/core": "^7.1.5",
+ "@mikro-orm/decorators": "^7.1.5",
+ "@mikro-orm/mysql": "^7.1.5",
+ "@mikro-orm/nestjs": "^7.0.2",
+ "@nestjs/common": "^11.0.1",
+ "@nestjs/config": "^3.3.0",
+ "@nestjs/core": "^11.0.1",
+ "@nestjs/cqrs": "^11.0.3",
+ "@nestjs/platform-express": "^11.0.1",
+ "@nestjs/swagger": "8.1.1",
+ "class-transformer": "^0.5.1",
+ "class-validator": "^0.14.1",
+ "nestjs-i18n": "^10.5.1",
+ "reflect-metadata": "^0.2.2",
+ "rimraf": "5.0.1",
+ "rxjs": "^7.8.1",
+ "uuid": "^9.0.1",
+ "winston": "^3.17.0",
+ "winston-daily-rotate-file": "^5.0.0"
+ },
+ "devDependencies": {
+ "@eslint/eslintrc": "^3.2.0",
+ "@eslint/js": "^9.18.0",
+ "@mikro-orm/cli": "^7.1.5",
+ "@nestjs/cli": "^11.0.0",
+ "@nestjs/schematics": "^11.0.0",
+ "@nestjs/testing": "^11.0.1",
+ "@types/express": "^5.0.6",
+ "@types/jest": "^30.0.0",
+ "@types/node": "^24.0.0",
+ "@types/supertest": "^7.0.0",
+ "eslint": "^9.18.0",
+ "eslint-config-prettier": "^10.0.1",
+ "eslint-plugin-prettier": "^5.2.2",
+ "globals": "^17.0.0",
+ "jest": "^30.0.0",
+ "prettier": "^3.4.2",
+ "source-map-support": "^0.5.21",
+ "supertest": "^7.0.0",
+ "ts-jest": "^29.2.5",
+ "ts-loader": "^9.5.2",
+ "ts-node": "^10.9.2",
+ "tsconfig-paths": "^4.2.0",
+ "typescript": "^5.7.3",
+ "typescript-eslint": "^8.20.0"
+ },
+ "jest": {
+ "moduleFileExtensions": [
+ "js",
+ "json",
+ "ts"
+ ],
+ "rootDir": ".",
+ "testRegex": ".*\\.spec\\.ts$",
+ "transform": {
+ "^.+\\.(t|j)s$": "ts-jest"
+ },
+ "collectCoverageFrom": [
+ "**/*.(t|j)s"
+ ],
+ "coverageDirectory": "./coverage",
+ "testEnvironment": "node",
+ "roots": [
+ "/src/",
+ "/libs/"
+ ],
+ "moduleNameMapper": {
+ "^@app/configure(|/.*)$": "/libs/configure/src/$1",
+ "^@app/shared(|/.*)$": "/libs/shared/src/$1"
+ }
+ }
+}
diff --git a/template/nest-next/src/.generate/i18n.generated.ts b/template/nest-next/src/.generate/i18n.generated.ts
new file mode 100644
index 00000000..54a3a258
--- /dev/null
+++ b/template/nest-next/src/.generate/i18n.generated.ts
@@ -0,0 +1,21 @@
+/* DO NOT EDIT, file generated by nestjs-i18n */
+
+/* eslint-disable */
+/* prettier-ignore */
+import { Path } from "nestjs-i18n";
+/* prettier-ignore */
+export type I18nTranslations = {
+ "exception": {
+ "common": {
+ "INTERNAL_ERROR": string;
+ };
+ };
+ "validation": {
+ "NOT_EMPTY": string;
+ "IS_ARRAY": string;
+ "NOT_EMPTY_HUMAN": string;
+ "TYPE_ERROR": string;
+ };
+};
+/* prettier-ignore */
+export type I18nPath = Path;
diff --git a/template/nest-next/src/app.module.ts b/template/nest-next/src/app.module.ts
new file mode 100644
index 00000000..1e0fdd84
--- /dev/null
+++ b/template/nest-next/src/app.module.ts
@@ -0,0 +1,54 @@
+import { Module } from '@nestjs/common';
+import { ConfigureModule, ConfigureService } from '@app/configure';
+import { APP_FILTER } from '@nestjs/core';
+import { GlobalExceptionFilter } from '@app/shared';
+import { HeaderResolver, I18nModule } from 'nestjs-i18n';
+import { join } from 'path';
+import { PermissionModule } from './permission/permission.module';
+import { MikroOrmModule } from '@mikro-orm/nestjs';
+import { MySqlDriver } from '@mikro-orm/mysql';
+import { Permission } from './permission';
+import { CqrsModule } from '@nestjs/cqrs';
+
+@Module({
+ imports: [
+ ConfigureModule,
+ CqrsModule.forRoot({
+ rethrowUnhandled: true,
+ }),
+ I18nModule.forRoot({
+ fallbackLanguage: 'enUS',
+ loaderOptions: {
+ path: join(__dirname, '/i18n/'),
+ watch: true,
+ },
+ resolvers: [new HeaderResolver(['x-lang'])],
+ typesOutputPath: join(
+ __dirname,
+ '../libs/shared/src/.generate/i18n.generated.ts',
+ ),
+ }),
+ PermissionModule,
+ MikroOrmModule.forRootAsync({
+ imports: [ConfigureModule],
+ inject: [ConfigureService],
+ useFactory: (configService: ConfigureService) => ({
+ entities: [Permission],
+ host: configService.get('database.host'),
+ port: configService.get('database.port'),
+ driver: MySqlDriver,
+ user: configService.get('database.user'),
+ password: configService.get('database.password'),
+ dbName: configService.get('database.dbName'),
+ }),
+ }),
+ ],
+ providers: [
+ {
+ provide: APP_FILTER,
+
+ useClass: GlobalExceptionFilter,
+ },
+ ],
+})
+export class AppModule {}
diff --git a/template/nest-next/src/i18n/enUS/exception.json b/template/nest-next/src/i18n/enUS/exception.json
new file mode 100644
index 00000000..442261f5
--- /dev/null
+++ b/template/nest-next/src/i18n/enUS/exception.json
@@ -0,0 +1,8 @@
+{
+ "common":{
+ "INTERNAL_ERROR": "Internal Error"
+ },
+ "permission":{
+ "NOT_FOUND": "Permission not found"
+ }
+}
diff --git a/template/nest-next/src/i18n/enUS/validation.json b/template/nest-next/src/i18n/enUS/validation.json
new file mode 100644
index 00000000..b21cb291
--- /dev/null
+++ b/template/nest-next/src/i18n/enUS/validation.json
@@ -0,0 +1,6 @@
+{
+ "NOT_EMPTY": "{property} should not to be empty",
+ "IS_ARRAY": "{property} should to be array",
+ "NOT_EMPTY_HUMAN": "{name} should not to be empty",
+ "TYPE_ERROR": "{property} should to be {type}"
+}
diff --git a/template/nest-next/src/i18n/zhCN/exception.json b/template/nest-next/src/i18n/zhCN/exception.json
new file mode 100644
index 00000000..8a94e744
--- /dev/null
+++ b/template/nest-next/src/i18n/zhCN/exception.json
@@ -0,0 +1,5 @@
+{
+ "common":{
+ "INTERNAL_ERROR": "内部错误"
+ }
+}
diff --git a/template/nest-next/src/i18n/zhCN/validation.json b/template/nest-next/src/i18n/zhCN/validation.json
new file mode 100644
index 00000000..b9486ecd
--- /dev/null
+++ b/template/nest-next/src/i18n/zhCN/validation.json
@@ -0,0 +1,6 @@
+{
+ "NOT_EMPTY": "{property} 不能为空",
+ "IS_ARRAY": "{property} 应该为数组",
+ "NOT_EMPTY_HUMAN": "{name} 不能为空",
+ "TYPE_ERROR": "{property} 应该为 {type}"
+}
diff --git a/template/nest-next/src/main.ts b/template/nest-next/src/main.ts
new file mode 100644
index 00000000..f291f198
--- /dev/null
+++ b/template/nest-next/src/main.ts
@@ -0,0 +1,13 @@
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+import { VersioningType } from '@nestjs/common';
+
+async function bootstrap() {
+ const app = await NestFactory.create(AppModule);
+ app.enableVersioning({
+ type: VersioningType.MEDIA_TYPE,
+ key: 'v=',
+ });
+ await app.listen(process.env.PORT ?? 3000);
+}
+bootstrap();
diff --git a/template/nest-next/src/permission/commands/create-permission.command.ts b/template/nest-next/src/permission/commands/create-permission.command.ts
new file mode 100644
index 00000000..43ebf2cc
--- /dev/null
+++ b/template/nest-next/src/permission/commands/create-permission.command.ts
@@ -0,0 +1,34 @@
+import { InjectRepository } from '@mikro-orm/nestjs';
+import { Command, CommandHandler, ICommandHandler } from '@nestjs/cqrs';
+import {
+ CreatePermissionDto,
+ CreatePermissionResponse,
+} from '../dto/create-permission.dto';
+import { Permission } from '../permission.entry';
+import { EntityRepository } from '@mikro-orm/core';
+
+export class CreatePermission extends Command {
+ constructor(public readonly dto: CreatePermissionDto) {
+ super();
+ }
+}
+
+@CommandHandler(CreatePermission)
+export class CreatePermissionHandler implements ICommandHandler {
+ constructor(
+ @InjectRepository(Permission)
+ private readonly permissionRepository: EntityRepository,
+ ) {}
+ async execute(command: CreatePermission): Promise {
+ const permission = this.permissionRepository.create({
+ name: command.dto.name,
+ desc: command.dto.desc,
+ });
+ await this.permissionRepository.upsert(permission);
+ return new CreatePermissionResponse(
+ permission.id,
+ permission.desc,
+ permission.name,
+ );
+ }
+}
diff --git a/template/nest-next/src/permission/commands/index.ts b/template/nest-next/src/permission/commands/index.ts
new file mode 100644
index 00000000..23d447fa
--- /dev/null
+++ b/template/nest-next/src/permission/commands/index.ts
@@ -0,0 +1,3 @@
+export * from './create-permission.command';
+export * from './update-permission.command';
+export * from './remove-permission.command';
diff --git a/template/nest-next/src/permission/commands/remove-permission.command.ts b/template/nest-next/src/permission/commands/remove-permission.command.ts
new file mode 100644
index 00000000..0baa8739
--- /dev/null
+++ b/template/nest-next/src/permission/commands/remove-permission.command.ts
@@ -0,0 +1,36 @@
+import { Command, CommandHandler, ICommandHandler } from '@nestjs/cqrs';
+import { RemovePermissionResponse } from '../dto/remove-permission.dto';
+import { EntityRepository } from '@mikro-orm/mysql';
+import { InjectRepository } from '@mikro-orm/nestjs';
+import { Permission } from '../permission.entry';
+import { PermissionNotFound } from '../errors';
+
+export class RemovePermissionCommand extends Command {
+ constructor(public readonly id: number) {
+ super();
+ }
+}
+
+@CommandHandler(RemovePermissionCommand)
+export class RemovePermissionCommandHandler implements ICommandHandler {
+ constructor(
+ @InjectRepository(Permission)
+ private readonly permissionRepository: EntityRepository,
+ ) {}
+ async execute(
+ command: RemovePermissionCommand,
+ ): Promise {
+ const permission = await this.permissionRepository.findOne({
+ id: command.id,
+ });
+ if (!permission) {
+ throw new PermissionNotFound();
+ }
+ await this.permissionRepository.nativeDelete(permission);
+ return new RemovePermissionResponse(
+ permission.id,
+ permission.desc,
+ permission.name,
+ );
+ }
+}
diff --git a/template/nest-next/src/permission/commands/update-permission.command.ts b/template/nest-next/src/permission/commands/update-permission.command.ts
new file mode 100644
index 00000000..9f716aa4
--- /dev/null
+++ b/template/nest-next/src/permission/commands/update-permission.command.ts
@@ -0,0 +1,39 @@
+import { Command, CommandHandler, ICommandHandler } from '@nestjs/cqrs';
+import {
+ UpdatePermissionDto,
+ UpdatePermissionResponse,
+} from '../dto/update-permission.dto';
+import { InjectRepository } from '@mikro-orm/nestjs';
+import { Permission } from '../permission.entry';
+import { EntityRepository } from '@mikro-orm/core';
+import { PermissionNotFound } from '../errors';
+
+export class UpdatePermission extends Command {
+ constructor(public readonly dto: UpdatePermissionDto) {
+ super();
+ }
+}
+
+@CommandHandler(UpdatePermission)
+export class UpdatePermissionHandler implements ICommandHandler {
+ constructor(
+ @InjectRepository(Permission)
+ private readonly permissionRepository: EntityRepository,
+ ) {}
+ async execute(command: UpdatePermission): Promise {
+ const permission = await this.permissionRepository.findOne({
+ id: command.dto.id,
+ });
+ if (!permission) {
+ throw new PermissionNotFound();
+ }
+ if (command.dto.name) {
+ permission.name = command.dto.name;
+ }
+ if (command.dto.desc) {
+ permission.desc = command.dto.desc;
+ }
+ await this.permissionRepository.upsert(permission);
+ return new UpdatePermissionResponse(permission.id);
+ }
+}
diff --git a/template/nest-next/src/permission/dto/create-permission.dto.ts b/template/nest-next/src/permission/dto/create-permission.dto.ts
new file mode 100644
index 00000000..a6dafde3
--- /dev/null
+++ b/template/nest-next/src/permission/dto/create-permission.dto.ts
@@ -0,0 +1,37 @@
+import { IsNotEmpty } from 'class-validator';
+import { i18nValidationMessage } from 'nestjs-i18n';
+import { I18nTranslations } from '../../.generate/i18n.generated';
+import { ApiProperty } from '@nestjs/swagger';
+
+export class CreatePermissionDto {
+ @ApiProperty({
+ description: '权限在使用时候的键值对.',
+ })
+ @IsNotEmpty({
+ message: i18nValidationMessage('validation.NOT_EMPTY'),
+ })
+ name: string;
+
+ @ApiProperty({
+ description: '权限在后台, 人类可读的短简介',
+ })
+ @IsNotEmpty({
+ message: i18nValidationMessage('validation.NOT_EMPTY'),
+ })
+ desc: string;
+}
+
+export class CreatePermissionResponse {
+ @ApiProperty()
+ id: number;
+ @ApiProperty()
+ desc: string;
+ @ApiProperty()
+ name: string;
+
+ constructor(id: number, desc: string, name: string) {
+ this.id = id;
+ this.desc = desc;
+ this.name = name;
+ }
+}
diff --git a/template/nest-next/src/permission/dto/get-permissions.dto.ts b/template/nest-next/src/permission/dto/get-permissions.dto.ts
new file mode 100644
index 00000000..b31049af
--- /dev/null
+++ b/template/nest-next/src/permission/dto/get-permissions.dto.ts
@@ -0,0 +1,27 @@
+import { PaginationMeta } from '@app/shared';
+import { ApiProperty } from '@nestjs/swagger';
+
+export class GetPermissionInfo {
+ @ApiProperty()
+ id: number;
+ @ApiProperty()
+ desc: string;
+ @ApiProperty()
+ name: string;
+ constructor(id: number, desc: string, name: string) {
+ this.id = id;
+ this.desc = desc;
+ this.name = name;
+ }
+}
+
+export class GetPermissionResponse {
+ @ApiProperty()
+ items: GetPermissionInfo[];
+ @ApiProperty({ type: PaginationMeta })
+ meta: PaginationMeta;
+ constructor(items: GetPermissionInfo[], meta: PaginationMeta) {
+ this.items = items;
+ this.meta = meta;
+ }
+}
diff --git a/template/nest-next/src/permission/dto/remove-permission.dto.ts b/template/nest-next/src/permission/dto/remove-permission.dto.ts
new file mode 100644
index 00000000..0a4ad9fa
--- /dev/null
+++ b/template/nest-next/src/permission/dto/remove-permission.dto.ts
@@ -0,0 +1,39 @@
+import { I18nTranslations } from '@app/shared';
+import { ApiProperty } from '@nestjs/swagger';
+import { IsNotEmpty, IsNumber } from 'class-validator';
+import { i18nValidationMessage } from 'nestjs-i18n';
+
+export class RemovePermissionRequest {
+ @ApiProperty()
+ @IsNotEmpty({
+ message: i18nValidationMessage('validation.NOT_EMPTY'),
+ })
+ @IsNumber(
+ {},
+ {
+ message: i18nValidationMessage(
+ 'validation.TYPE_ERROR',
+ {
+ type: 'number',
+ property: 'id',
+ },
+ ),
+ },
+ )
+ id: number;
+}
+
+export class RemovePermissionResponse {
+ @ApiProperty()
+ id: number;
+ @ApiProperty()
+ desc: string;
+ @ApiProperty()
+ name: string;
+
+ constructor(id: number, desc: string, name: string) {
+ this.id = id;
+ this.desc = desc;
+ this.name = name;
+ }
+}
diff --git a/template/nest-next/src/permission/dto/update-permission.dto.ts b/template/nest-next/src/permission/dto/update-permission.dto.ts
new file mode 100644
index 00000000..a6138337
--- /dev/null
+++ b/template/nest-next/src/permission/dto/update-permission.dto.ts
@@ -0,0 +1,24 @@
+import { CreatePermissionDto } from './create-permission.dto';
+import { IsNotEmpty } from 'class-validator';
+import { i18nValidationMessage } from 'nestjs-i18n';
+import { I18nTranslations } from '../../.generate/i18n.generated';
+import { ApiProperty, PartialType } from '@nestjs/swagger';
+
+export class UpdatePermissionDto extends PartialType(CreatePermissionDto) {
+ @ApiProperty({
+ description: '你想要修改的权限字段的数据库主键',
+ })
+ @IsNotEmpty({
+ message: i18nValidationMessage('validation.NOT_EMPTY'),
+ })
+ id: number;
+}
+
+export class UpdatePermissionResponse {
+ @ApiProperty()
+ id: number;
+
+ constructor(id: number) {
+ this.id = id;
+ }
+}
diff --git a/template/nest-next/src/permission/errors/index.ts b/template/nest-next/src/permission/errors/index.ts
new file mode 100644
index 00000000..991933ba
--- /dev/null
+++ b/template/nest-next/src/permission/errors/index.ts
@@ -0,0 +1 @@
+export { PermissionNotFound } from './permission-not-found.error';
diff --git a/template/nest-next/src/permission/errors/permission-not-found.error.ts b/template/nest-next/src/permission/errors/permission-not-found.error.ts
new file mode 100644
index 00000000..3a462130
--- /dev/null
+++ b/template/nest-next/src/permission/errors/permission-not-found.error.ts
@@ -0,0 +1,11 @@
+import { DomainError } from '@app/shared';
+import { HttpStatus } from '@nestjs/common';
+
+export class PermissionNotFound extends DomainError {
+ constructor() {
+ super({
+ code: HttpStatus.NOT_FOUND,
+ message: 'exception.permission.NOT_FOUND',
+ });
+ }
+}
diff --git a/template/nest-next/src/permission/index.ts b/template/nest-next/src/permission/index.ts
new file mode 100644
index 00000000..ab652679
--- /dev/null
+++ b/template/nest-next/src/permission/index.ts
@@ -0,0 +1,6 @@
+export * from './permission.module';
+export * from './queries';
+export * from './errors';
+export * from './commands';
+export * from './permission.entry';
+
diff --git a/template/nest-next/src/permission/permission.controller.ts b/template/nest-next/src/permission/permission.controller.ts
new file mode 100644
index 00000000..5413990a
--- /dev/null
+++ b/template/nest-next/src/permission/permission.controller.ts
@@ -0,0 +1,68 @@
+import {
+ Body,
+ Controller,
+ DefaultValuePipe,
+ Delete,
+ Get,
+ Param,
+ ParseIntPipe,
+ Patch,
+ Post,
+ Query,
+} from '@nestjs/common';
+import { PermissionService } from './permission.service';
+import { UpdatePermissionDto } from './dto/update-permission.dto';
+import {
+ CreatePermissionDto,
+ CreatePermissionResponse,
+} from './dto/create-permission.dto';
+import {
+ ApiCreatedResponse,
+ ApiOkResponse,
+ ApiOperation,
+ ApiParam,
+ ApiQuery,
+} from '@nestjs/swagger';
+import { RemovePermissionResponse } from './dto/remove-permission.dto';
+
+@Controller('permission')
+export class PermissionController {
+ constructor(private readonly permissionService: PermissionService) {}
+
+ @ApiOperation({ summary: '创建一个权限字段' })
+ @ApiCreatedResponse({
+ description: '创建的权限',
+ type: CreatePermissionResponse,
+ })
+ @Post('')
+ create(@Body() dto: CreatePermissionDto) {
+ return this.permissionService.create(dto);
+ }
+
+ @ApiOperation({ summary: '修改一个权限字段' })
+ @Patch()
+ update(@Body() dto: UpdatePermissionDto) {
+ return this.permissionService.updatePermission(dto);
+ }
+
+ @ApiOperation({ summary: '分页查询权限' })
+ @ApiQuery({ name: 'page', description: '页码, 必须是一个正整数' })
+ @ApiQuery({ name: 'limit', description: '页大小, 必须是一个正整数' })
+ @ApiQuery({ name: 'name', description: '模糊查找条件' })
+ @Get()
+ findAllPermission(
+ @Query('page', new DefaultValuePipe('1'), ParseIntPipe) page: number,
+ @Query('limit', new DefaultValuePipe('0'), ParseIntPipe) limit: number,
+ @Query('name') name?: string,
+ ) {
+ return this.permissionService.findAllPermission(page, limit, name);
+ }
+
+ @ApiOperation({ summary: '删除权限字段' })
+ @ApiParam({ name: 'id', description: '你想删除的权限字段的数据库主键' })
+ @ApiOkResponse({ type: RemovePermissionResponse })
+ @Delete(':id')
+ remove(@Param('id', ParseIntPipe) id: number) {
+ return this.permissionService.remove(id);
+ }
+}
diff --git a/template/nest-next/src/permission/permission.entry.ts b/template/nest-next/src/permission/permission.entry.ts
new file mode 100644
index 00000000..55dcc215
--- /dev/null
+++ b/template/nest-next/src/permission/permission.entry.ts
@@ -0,0 +1,17 @@
+import { Entity, PrimaryKey, Property } from '@mikro-orm/decorators/legacy';
+
+@Entity({ tableName: 'permission' })
+export class Permission {
+ @PrimaryKey({ type: 'int', autoincrement: true })
+ id: number;
+ @Property({ type: 'text' })
+ desc: string;
+ @Property({ type: 'text' })
+ name: string;
+
+ constructor(id: number, desc: string, name: string) {
+ this.id = id;
+ this.desc = desc;
+ this.name = name;
+ }
+}
diff --git a/template/nest-next/src/permission/permission.module.ts b/template/nest-next/src/permission/permission.module.ts
new file mode 100644
index 00000000..5b13b050
--- /dev/null
+++ b/template/nest-next/src/permission/permission.module.ts
@@ -0,0 +1,24 @@
+import { Module } from '@nestjs/common';
+import { PermissionService } from './permission.service';
+import { PermissionController } from './permission.controller';
+import {
+ CreatePermissionHandler,
+ RemovePermissionCommandHandler,
+ UpdatePermissionHandler,
+} from './commands';
+import { MikroOrmModule } from '@mikro-orm/nestjs';
+import { Permission } from './permission.entry';
+import { GetAllPermissionQueryHandler } from './queries';
+
+@Module({
+ imports: [MikroOrmModule.forFeature([Permission])],
+ controllers: [PermissionController],
+ providers: [
+ PermissionService,
+ RemovePermissionCommandHandler,
+ CreatePermissionHandler,
+ UpdatePermissionHandler,
+ GetAllPermissionQueryHandler,
+ ],
+})
+export class PermissionModule {}
diff --git a/template/nest-next/src/permission/permission.service.ts b/template/nest-next/src/permission/permission.service.ts
new file mode 100644
index 00000000..77c9744f
--- /dev/null
+++ b/template/nest-next/src/permission/permission.service.ts
@@ -0,0 +1,34 @@
+import { Injectable } from '@nestjs/common';
+import { CommandBus, QueryBus } from '@nestjs/cqrs';
+import { GetAllPermissionQuery } from './queries';
+import { UpdatePermissionDto } from './dto/update-permission.dto';
+import {
+ CreatePermission,
+ RemovePermissionCommand,
+ UpdatePermission,
+} from './commands';
+import { CreatePermissionDto } from './dto/create-permission.dto';
+
+@Injectable()
+export class PermissionService {
+ constructor(
+ private readonly qb: QueryBus,
+ private readonly cb: CommandBus,
+ ) {}
+
+ create(dto: CreatePermissionDto) {
+ return this.cb.execute(new CreatePermission(dto));
+ }
+
+ updatePermission(dto: UpdatePermissionDto) {
+ return this.cb.execute(new UpdatePermission(dto));
+ }
+
+ findAllPermission(page: number, size: number, name?: string) {
+ return this.qb.execute(new GetAllPermissionQuery(page, size, name));
+ }
+
+ remove(id: number) {
+ return this.cb.execute(new RemovePermissionCommand(id));
+ }
+}
diff --git a/template/nest-next/src/permission/queries/get-all-permissions.query.ts b/template/nest-next/src/permission/queries/get-all-permissions.query.ts
new file mode 100644
index 00000000..d238aca0
--- /dev/null
+++ b/template/nest-next/src/permission/queries/get-all-permissions.query.ts
@@ -0,0 +1,48 @@
+import { IQueryHandler, Query, QueryHandler } from '@nestjs/cqrs';
+import {
+ GetPermissionInfo,
+ GetPermissionResponse,
+} from '../dto/get-permissions.dto';
+import { EntityRepository } from '@mikro-orm/mysql';
+import { Permission } from '../permission.entry';
+import { PaginationMeta } from '@app/shared';
+import { InjectRepository } from '@mikro-orm/nestjs';
+
+export class GetAllPermissionQuery extends Query {
+ constructor(
+ public readonly page: number,
+ public readonly size: number,
+ public readonly name?: string,
+ ) {
+ super();
+ }
+}
+
+@QueryHandler(GetAllPermissionQuery)
+export class GetAllPermissionQueryHandler implements IQueryHandler {
+ constructor(
+ @InjectRepository(Permission)
+ private readonly permissionRepo: EntityRepository
+ ) {}
+ async execute(query: GetAllPermissionQuery): Promise {
+ const [items, total] = await this.permissionRepo.findAndCount(
+ {
+ name: { $like: `%${query.name}%` },
+ },
+ {
+ offset: (query.page - 1) * query.size,
+ limit: query.size,
+ },
+ );
+ const meta = new PaginationMeta(
+ items.length,
+ total,
+ query.size,
+ query.page,
+ );
+ const infos = items.map(
+ (item) => new GetPermissionInfo(item.id, item.desc, item.name),
+ );
+ return new GetPermissionResponse(infos, meta);
+ }
+}
diff --git a/template/nest-next/src/permission/queries/index.ts b/template/nest-next/src/permission/queries/index.ts
new file mode 100644
index 00000000..64742d97
--- /dev/null
+++ b/template/nest-next/src/permission/queries/index.ts
@@ -0,0 +1,2 @@
+export { GetAllPermissionQuery } from './get-all-permissions.query';
+export { GetAllPermissionQueryHandler } from './get-all-permissions.query';
diff --git a/template/nest-next/test/jest-e2e.json b/template/nest-next/test/jest-e2e.json
new file mode 100644
index 00000000..5d2701a6
--- /dev/null
+++ b/template/nest-next/test/jest-e2e.json
@@ -0,0 +1,17 @@
+{
+ "moduleFileExtensions": [
+ "js",
+ "json",
+ "ts"
+ ],
+ "rootDir": ".",
+ "testEnvironment": "node",
+ "testRegex": ".e2e-spec.ts$",
+ "transform": {
+ "^.+\\.(t|j)s$": "ts-jest"
+ },
+ "moduleNameMapper": {
+ "^@app/configure(|/.*)$": "/../libs/configure/src/$1",
+ "^@app/shared(|/.*)$": "/../libs/shared/src/$1"
+ }
+}
diff --git a/template/nest-next/test/permission.e2e-spec.ts b/template/nest-next/test/permission.e2e-spec.ts
new file mode 100644
index 00000000..2707eb15
--- /dev/null
+++ b/template/nest-next/test/permission.e2e-spec.ts
@@ -0,0 +1,23 @@
+import request from 'supertest';
+import { E2EApp } from './utils/e2e-app';
+
+describe('PermissionController (e2e)', () => {
+ let e2e: E2EApp;
+ beforeAll(async () => {
+ e2e = new E2EApp();
+ await e2e.init();
+ });
+ afterAll(async () => {
+ await e2e.close();
+ });
+ beforeEach(async () => {
+ await e2e.clearData();
+ });
+ it('/permission (GET) - 初始状态应为空', async () => {
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-argument
+ return request(e2e.app.getHttpServer())
+ .get('/permission')
+ .expect(200)
+ .expect([]);
+ });
+});
diff --git a/template/nest-next/test/utils/e2e-app.ts b/template/nest-next/test/utils/e2e-app.ts
new file mode 100644
index 00000000..bcfbcbea
--- /dev/null
+++ b/template/nest-next/test/utils/e2e-app.ts
@@ -0,0 +1,28 @@
+import { INestApplication } from '@nestjs/common';
+import { Test, TestingModule } from '@nestjs/testing';
+import { MikroORM } from '@mikro-orm/core';
+import { AppModule } from '../../src/app.module';
+
+export class E2EApp {
+ public app: INestApplication;
+ public orm: MikroORM;
+
+ async init() {
+ const moduleFixture: TestingModule = await Test.createTestingModule({
+ imports: [AppModule],
+ }).compile();
+
+ this.app = moduleFixture.createNestApplication();
+ await this.app.init();
+ this.orm = this.app.get(MikroORM);
+ await this.orm.schema.clear({ truncate: true });
+ }
+
+ async clearData() {
+ await this.orm.schema.clear({ truncate: true });
+ }
+
+ async close() {
+ await this.app.close();
+ }
+}
diff --git a/template/nest-next/tsconfig.build.json b/template/nest-next/tsconfig.build.json
new file mode 100644
index 00000000..64f86c6b
--- /dev/null
+++ b/template/nest-next/tsconfig.build.json
@@ -0,0 +1,4 @@
+{
+ "extends": "./tsconfig.json",
+ "exclude": ["node_modules", "test", "dist", "**/*spec.ts"]
+}
diff --git a/template/nest-next/tsconfig.json b/template/nest-next/tsconfig.json
new file mode 100644
index 00000000..63add7cf
--- /dev/null
+++ b/template/nest-next/tsconfig.json
@@ -0,0 +1,41 @@
+{
+ "compilerOptions": {
+ "module": "nodenext",
+ "moduleResolution": "nodenext",
+ "resolvePackageJsonExports": true,
+ "esModuleInterop": true,
+ "isolatedModules": true,
+ "declaration": true,
+ "removeComments": true,
+ "emitDecoratorMetadata": true,
+ "experimentalDecorators": true,
+ "allowSyntheticDefaultImports": true,
+ "target": "ES2023",
+ "sourceMap": true,
+ "outDir": "./dist",
+ "baseUrl": "./",
+ "incremental": true,
+ "skipLibCheck": true,
+ "strictNullChecks": true,
+ "forceConsistentCasingInFileNames": true,
+ "noImplicitAny": false,
+ "strictBindCallApply": false,
+ "noFallthroughCasesInSwitch": false,
+ "types": ["@types/node", "@types/express", "@types/jest"],
+ "strictPropertyInitialization": false,
+ "paths": {
+ "@app/configure": [
+ "libs/configure/src"
+ ],
+ "@app/configure/*": [
+ "libs/configure/src/*"
+ ],
+ "@app/shared": [
+ "libs/shared/src"
+ ],
+ "@app/shared/*": [
+ "libs/shared/src/*"
+ ]
+ }
+ }
+}
+
+
+
+
+
+
+ 
+ 
+ 
+