refactor: 完成项目整体目录重构与路径别名配置

1.  重构项目文件结构，统一文件存放位置与命名规则
2.  配置tsconfig路径别名，替换原有相对路径导入
3.  迁移drama-status枚举到dramas.types统一管理
4.  新增全局配置文件与工具类，补充完整注释与文档
5.  修复所有导入路径与依赖引用问题

decorators/api-message.decorator.ts

@@ -1,6 +1,12 @@
-import { SetMetadata } from '@nestjs/common';
+/**
+ * ApiMessage decorator.
+ * @file 接口响应文案装饰器
+ * @module decorators/api-message.decorator
+ * @author zhxiao1124
+ */
 
-export const API_MESSAGE_METADATA = 'api:message';
+import { SetMetadata } from "@nestjs/common";
 
-export const ApiMessage = (message: string) =>
-  SetMetadata(API_MESSAGE_METADATA, message);
+export const API_MESSAGE_METADATA = "api:message";
+
+export const ApiMessage = (message: string) => SetMetadata(API_MESSAGE_METADATA, message);

decorators/current-admin.decorator.ts

@@ -1,12 +1,15 @@
-import { createParamDecorator, ExecutionContext } from '@nestjs/common';
-import { Request } from 'express';
-import { AdminUserRecord } from '../interfaces/admin-records.interface';
+/**
+ * CurrentAdmin decorator.
+ * @file 当前登录管理员装饰器
+ * @module decorators/current-admin.decorator
+ * @author zhxiao1124
+ */
 
-export const CurrentAdmin = createParamDecorator(
-  (_data: unknown, ctx: ExecutionContext): AdminUserRecord | undefined => {
-    const request = ctx
-      .switchToHttp()
-      .getRequest<Request & { adminUser?: AdminUserRecord }>();
+import { createParamDecorator, ExecutionContext } from "@nestjs/common";
+import { Request } from "express";
+import { AdminUserRecord } from "@src/admin/admin.types";
+
+export const CurrentAdmin = createParamDecorator((_data: unknown, ctx: ExecutionContext): AdminUserRecord | undefined => {
+    const request = ctx.switchToHttp().getRequest<Request & { adminUser?: AdminUserRecord }>();
     return request.adminUser;
-  },
-);
+});

decorators/current-user.decorator.ts

@@ -1,10 +1,15 @@
-import { createParamDecorator, ExecutionContext } from '@nestjs/common';
-import { Request } from 'express';
-import { UserRecord } from '../../users/interfaces/user-record.interface';
+/**
+ * CurrentUser decorator.
+ * @file 当前登录用户装饰器
+ * @module decorators/current-user.decorator
+ * @author zhxiao1124
+ */
 
-export const CurrentUser = createParamDecorator(
-  (_data: unknown, ctx: ExecutionContext): UserRecord | undefined => {
+import { createParamDecorator, ExecutionContext } from "@nestjs/common";
+import { Request } from "express";
+import { UserRecord } from "@src/users/users.types";
+
+export const CurrentUser = createParamDecorator((_data: unknown, ctx: ExecutionContext): UserRecord | undefined => {
     const request = ctx.switchToHttp().getRequest<Request & { user?: UserRecord }>();
     return request.user;
-  },
-);
+});

decorators/require-permissions.decorator.ts

@@ -1,6 +1,12 @@
-import { SetMetadata } from '@nestjs/common';
+/**
+ * RequirePermissions decorator.
+ * @file 接口权限声明装饰器
+ * @module decorators/require-permissions.decorator
+ * @author zhxiao1124
+ */
 
-export const REQUIRED_PERMISSIONS_METADATA = 'admin:required-permissions';
+import { SetMetadata } from "@nestjs/common";
 
-export const RequirePermissions = (...permissions: string[]) =>
-  SetMetadata(REQUIRED_PERMISSIONS_METADATA, permissions);
+export const REQUIRED_PERMISSIONS_METADATA = "admin:required-permissions";
+
+export const RequirePermissions = (...permissions: string[]) => SetMetadata(REQUIRED_PERMISSIONS_METADATA, permissions);