@ai-partner-x/aiko-boot-cli 0.1.4

package/templates/scaffold-default/packages/api/src/controller/upload.controller.ts

@@ -0,0 +1,83 @@
+import 'reflect-metadata';
+import { RestController, PostMapping, DeleteMapping, GetMapping, RequestParam, RequestPart, MultipartFile } from '@ai-partner-x/aiko-boot-starter-web';
+import { Autowired } from '@ai-partner-x/aiko-boot';
+import { StorageService, type UploadResult } from '@ai-partner-x/aiko-boot-starter-storage';
+
+/**
+ * 文件上传控制器
+ *
+ * 提供文件上传、删除、获取 URL 等接口
+ */
+@RestController({ path: '/upload' })
+export class UploadController {
+  @Autowired(StorageService)
+  private storageService!: StorageService;
+
+  /**
+   * 上传单个文件
+   *
+   * @example
+   * curl -X POST http://localhost:3001/api/upload \
+   *   -F "file=@/path/to/image.png" \
+   *   -F "folder=images"
+   */
+  @PostMapping('/')
+  async upload(
+    @RequestPart('file') file: MultipartFile | undefined,
+    @RequestPart('folder') folder?: string,
+  ): Promise<UploadResult> {
+    if (!file || file.isEmpty()) {
+      throw new Error('上传的文件为空或未提供');
+    }
+    return this.storageService.upload(file.getBytes(), file.getOriginalFilename(), {
+      folder: folder || 'uploads',
+      maxSize: 10 * 1024 * 1024, // 10MB
+      allowedTypes: ['image/jpeg', 'image/png', 'image/gif', 'image/webp'],
+    });
+  }
+
+  /**
+   * 删除文件
+   *
+   * @example
+   * curl -X DELETE "http://localhost:3001/api/upload?key=images/xxx.png"
+   */
+  @DeleteMapping('/')
+  async delete(@RequestParam('key') key: string): Promise<{ success: boolean }> {
+    await this.storageService.delete(key);
+    return { success: true };
+  }
+
+  /**
+   * 获取文件 URL
+   *
+   * @example
+   * curl "http://localhost:3001/api/upload/url?key=images/xxx.png"
+   */
+  @GetMapping('/url')
+  async getUrl(@RequestParam('key') key: string): Promise<{ url: string }> {
+    const url = await this.storageService.getUrl(key);
+    return { url };
+  }
+
+  /**
+   * 获取图片预览 URL（支持 OSS/COS 的图片处理参数）
+   *
+   * @example
+   * curl "http://localhost:3001/api/upload/preview?key=images/xxx.png&width=200&height=200"
+   */
+  @GetMapping('/preview')
+  async getPreviewUrl(
+    @RequestParam('key') key: string,
+    @RequestParam('width') width?: string,
+    @RequestParam('height') height?: string,
+    @RequestParam('quality') quality?: string,
+  ): Promise<{ url: string }> {
+    const url = await this.storageService.getPreviewUrl(key, {
+      width: width ? parseInt(width, 10) : undefined,
+      height: height ? parseInt(height, 10) : undefined,
+      quality: quality ? parseInt(quality, 10) : undefined,
+    });
+    return { url };
+  }
+}

package/templates/scaffold-default/packages/api/src/controller/user.controller.ts

@@ -0,0 +1,102 @@
+import 'reflect-metadata';
+import {
+  RestController, GetMapping, PostMapping, PutMapping, DeleteMapping,
+  PathVariable, RequestBody, RequestParam,
+} from '@ai-partner-x/aiko-boot-starter-web';
+import { Autowired } from '@ai-partner-x/aiko-boot/di/server';
+import { ApiPermission, ButtonPermission } from '@ai-partner-x/aiko-boot-starter-security';
+import { UserService } from '../service/user.service.js';
+import type { CreateUserDto, UpdateUserDto, UserPageDto } from '../dto/user.dto.js';
+
+@RestController({ path: '/sys/user' })
+export class UserController {
+  @Autowired(UserService)
+  private userService!: UserService;
+
+  @GetMapping('/page')
+  @ApiPermission('user', 'page', {
+    description: '查看用户分页列表',
+    group: '用户管理',
+  })
+  async page(
+    @RequestParam('pageNo') pageNo: string,
+    @RequestParam('pageSize') pageSize: string,
+    @RequestParam('username') username: string,
+    @RequestParam('status') status: string,
+  ) {
+    const params: UserPageDto = {
+      pageNo: pageNo ? parseInt(pageNo) : 1,
+      pageSize: pageSize ? parseInt(pageSize) : 10,
+      username: username || undefined,
+      status: status !== undefined && status !== '' ? parseInt(status) : undefined,
+    };
+    return this.userService.pageUsers(params);
+  }
+
+  @GetMapping('/:id')
+  @ApiPermission('user', 'read', {
+    description: '查看用户详情',
+    group: '用户管理',
+  })
+  async getById(@PathVariable('id') id: string) {
+    return this.userService.getById(Number(id));
+  }
+
+  @PostMapping()
+  @ApiPermission('user', 'create', {
+    description: '创建用户',
+    group: '用户管理',
+  })
+  @ButtonPermission('user', 'create', {
+    description: '创建用户按钮',
+    group: '用户管理',
+    buttonId: 'btn-create-user',
+  })
+  async create(@RequestBody() dto: CreateUserDto) {
+    return this.userService.createUser(dto);
+  }
+
+  @PutMapping('/:id')
+  @ApiPermission('user', 'update', {
+    description: '更新用户信息',
+    group: '用户管理',
+  })
+  @ButtonPermission('user', 'update', {
+    description: '更新用户按钮',
+    group: '用户管理',
+    buttonId: 'btn-update-user',
+  })
+  async update(@PathVariable('id') id: string, @RequestBody() dto: UpdateUserDto) {
+    return this.userService.updateUser(Number(id), dto);
+  }
+
+  @DeleteMapping('/:id')
+  @ApiPermission('user', 'delete', {
+    description: '删除用户',
+    group: '用户管理',
+  })
+  @ButtonPermission('user', 'delete', {
+    description: '删除用户按钮',
+    group: '用户管理',
+    buttonId: 'btn-delete-user',
+  })
+  async delete(@PathVariable('id') id: string) {
+    await this.userService.deleteUser(Number(id));
+    return { message: '删除成功' };
+  }
+
+  @PutMapping('/:id/password')
+  @ApiPermission('user', 'reset-password', {
+    description: '重置用户密码',
+    group: '用户管理',
+  })
+  @ButtonPermission('user', 'reset-password', {
+    description: '重置密码按钮',
+    group: '用户管理',
+    buttonId: 'btn-reset-password',
+  })
+  async resetPassword(@PathVariable('id') id: string, @RequestBody() body: { newPassword: string }) {
+    await this.userService.resetPassword(Number(id), body.newPassword);
+    return { message: '密码重置成功' };
+  }
+}

package/templates/scaffold-default/packages/api/src/dto/auth.dto.ts

@@ -0,0 +1,30 @@
+import { IsNotEmpty, Length, MinLength } from '@ai-partner-x/aiko-boot-starter-validation';
+
+export class LoginDto {
+  @IsNotEmpty({ message: '用户名不能为空' })
+  @Length(1, 50, { message: '用户名长度必须在 1-50 之间' })
+  username!: string;
+
+  @IsNotEmpty({ message: '密码不能为空' })
+  @MinLength(6, { message: '密码至少 6 位' })
+  password!: string;
+}
+
+export class RefreshTokenDto {
+  @IsNotEmpty({ message: 'refreshToken不能为空' })
+  refreshToken!: string;
+}
+
+/** 登录成功返回的用户信息（不含密码） */
+export class LoginResultDto {
+  accessToken!: string;
+  refreshToken!: string;
+  userInfo!: {
+    id: number;
+    username: string;
+    realName?: string;
+    email?: string;
+    roles: string[];
+    permissions: string[];
+  };
+}

package/templates/scaffold-default/packages/api/src/dto/cache.dto.ts

@@ -0,0 +1,24 @@
+/**
+ * Cache 操作 DTO
+ */
+export interface CacheGetDto {
+  name: string;
+  key: string;
+}
+
+export interface CachePutDto {
+  name: string;
+  key: string;
+  value: unknown;
+  ttlSeconds?: number;
+}
+
+export interface CacheEvictDto {
+  name: string;
+  key?: string;
+  allEntries?: boolean;
+}
+
+export interface CacheClearDto {
+  name: string;
+}

package/templates/scaffold-default/packages/api/src/dto/menu.dto.ts

@@ -0,0 +1,37 @@
+export class CreateMenuDto {
+  parentId: number = 0;
+  menuName!: string;
+  menuType!: number; // 1目录 2菜单 3按钮
+  path?: string;
+  component?: string;
+  permission?: string;
+  icon?: string;
+  sortOrder: number = 0;
+  status: number = 1;
+}
+
+export class UpdateMenuDto {
+  parentId?: number;
+  menuName?: string;
+  menuType?: number;
+  path?: string;
+  component?: string;
+  permission?: string;
+  icon?: string;
+  sortOrder?: number;
+  status?: number;
+}
+
+export interface MenuTreeVo {
+  id: number;
+  parentId: number;
+  menuName: string;
+  menuType: number;
+  path?: string;
+  component?: string;
+  permission?: string;
+  icon?: string;
+  sortOrder: number;
+  status: number;
+  children?: MenuTreeVo[];
+}

package/templates/scaffold-default/packages/api/src/dto/mq.dto.ts

@@ -0,0 +1,16 @@
+/**
+ * MQ 消息 DTO（复用 User 实体字段，不包含敏感信息）
+ */
+export interface UserEventDto {
+  id: number;
+  username: string;
+  email: string;
+  createdAt?: string;
+  updatedAt?: string;
+}
+
+export interface SendUserEventDto {
+  topic: string;
+  tag?: string;
+  body: UserEventDto;
+}

package/templates/scaffold-default/packages/api/src/dto/role.dto.ts

@@ -0,0 +1,16 @@
+import { IsNotEmpty, IsEmail, IsOptional, Length, Min, Max, IsInt } from '@ai-partner-x/aiko-boot-starter-validation';
+export class CreateRoleDto {
+  @IsNotEmpty({ message: '用户名不能为空' })
+  roleCode!: string;
+  roleName!: string;
+  description?: string;
+  status: number = 1;
+  menuIds?: number[];
+}
+
+export class UpdateRoleDto {
+  roleName?: string;
+  description?: string;
+  status?: number;
+  menuIds?: number[];
+}

package/templates/scaffold-default/packages/api/src/dto/user.dto.ts

@@ -0,0 +1,35 @@
+export class CreateUserDto {
+  username!: string;
+  password!: string;
+  realName?: string;
+  email?: string;
+  phone?: string;
+  status: number = 1;
+  roleIds?: number[];
+}
+
+export class UpdateUserDto {
+  realName?: string;
+  email?: string;
+  phone?: string;
+  status?: number;
+  roleIds?: number[];
+}
+
+export class UserPageDto {
+  pageNo: number = 1;
+  pageSize: number = 10;
+  username?: string;
+  status?: number;
+}
+
+export interface UserVo {
+  id: number;
+  username: string;
+  realName?: string;
+  email?: string;
+  phone?: string;
+  status: number;
+  roles: string[];
+  createdAt?: Date;
+}

package/templates/scaffold-default/packages/api/src/entity/menu.entity.ts

@@ -0,0 +1,34 @@
+import { Entity, TableId, TableField } from '@ai-partner-x/aiko-boot-starter-orm';
+
+@Entity({ tableName: 'sys_menu' })
+export class Menu {
+  @TableId({ type: 'AUTO' })
+  id!: number;
+
+  @TableField({ column: 'parent_id' })
+  parentId!: number; // 0 为顶级
+
+  @TableField({ column: 'menu_name' })
+  menuName!: string;
+
+  @TableField({ column: 'menu_type' })
+  menuType!: number; // 1目录 2菜单 3按钮
+
+  @TableField({ column: 'path' })
+  path?: string;
+
+  @TableField({ column: 'component' })
+  component?: string;
+
+  @TableField({ column: 'permission' })
+  permission?: string; // 权限标识，如 sys:user:list
+
+  @TableField({ column: 'icon' })
+  icon?: string;
+
+  @TableField({ column: 'sort_order' })
+  sortOrder!: number;
+
+  @TableField({ column: 'status' })
+  status!: number;
+}

package/templates/scaffold-default/packages/api/src/entity/role-menu.entity.ts

@@ -0,0 +1,13 @@
+import { Entity, TableId, TableField } from '@ai-partner-x/aiko-boot-starter-orm';
+
+@Entity({ tableName: 'sys_role_menu' })
+export class RoleMenu {
+  @TableId({ type: 'AUTO' })
+  id!: number;
+
+  @TableField({ column: 'role_id' })
+  roleId!: number;
+
+  @TableField({ column: 'menu_id' })
+  menuId!: number;
+}

package/templates/scaffold-default/packages/api/src/entity/role.entity.ts

@@ -0,0 +1,22 @@
+import { Entity, TableId, TableField } from '@ai-partner-x/aiko-boot-starter-orm';
+
+@Entity({ tableName: 'sys_role' })
+export class Role {
+  @TableId({ type: 'AUTO' })
+  id!: number;
+
+  @TableField({ column: 'role_code' })
+  roleCode!: string;
+
+  @TableField({ column: 'role_name' })
+  roleName!: string;
+
+  @TableField({ column: 'description' })
+  description?: string;
+
+  @TableField({ column: 'status' })
+  status!: number;
+
+  @TableField({ column: 'created_at' })
+  createdAt?: Date;
+}

package/templates/scaffold-default/packages/api/src/entity/user-role.entity.ts

@@ -0,0 +1,13 @@
+import { Entity, TableId, TableField } from '@ai-partner-x/aiko-boot-starter-orm';
+
+@Entity({ tableName: 'sys_user_role' })
+export class UserRole {
+  @TableId({ type: 'AUTO' })
+  id!: number;
+
+  @TableField({ column: 'user_id' })
+  userId!: number;
+
+  @TableField({ column: 'role_id' })
+  roleId!: number;
+}

package/templates/scaffold-default/packages/api/src/entity/user.entity.ts

@@ -0,0 +1,31 @@
+import { Entity, TableId, TableField } from '@ai-partner-x/aiko-boot-starter-orm';
+
+@Entity({ tableName: 'sys_user' })
+export class User {
+  @TableId({ type: 'AUTO' })
+  id!: number;
+
+  @TableField({ column: 'user_name' })
+  username!: string;
+
+  @TableField({ column: 'password_hash' })
+  passwordHash!: string;
+
+  @TableField({ column: 'real_name' })
+  realName?: string;
+
+  @TableField({ column: 'email' })
+  email!: string;
+
+  @TableField({ column: 'phone' })
+  phone?: string;
+
+  @TableField({ column: 'status' })
+  status!: number; // 1启用 0禁用
+
+  @TableField({ column: 'created_at' })
+  createdAt?: Date;
+
+  @TableField({ column: 'updated_at' })
+  updatedAt?: Date;
+}

package/templates/scaffold-default/packages/api/src/mapper/menu.mapper.ts

@@ -0,0 +1,6 @@
+import 'reflect-metadata';
+import { Mapper, BaseMapper } from '@ai-partner-x/aiko-boot-starter-orm';
+import { Menu } from '../entity/menu.entity.js';
+
+@Mapper(Menu)
+export class MenuMapper extends BaseMapper<Menu> {}

package/templates/scaffold-default/packages/api/src/mapper/role-menu.mapper.ts

@@ -0,0 +1,6 @@
+import 'reflect-metadata';
+import { Mapper, BaseMapper } from '@ai-partner-x/aiko-boot-starter-orm';
+import { RoleMenu } from '../entity/role-menu.entity.js';
+
+@Mapper(RoleMenu)
+export class RoleMenuMapper extends BaseMapper<RoleMenu> {}

package/templates/scaffold-default/packages/api/src/mapper/role.mapper.ts

@@ -0,0 +1,6 @@
+import 'reflect-metadata';
+import { Mapper, BaseMapper } from '@ai-partner-x/aiko-boot-starter-orm';
+import { Role } from '../entity/role.entity.js';
+
+@Mapper(Role)
+export class RoleMapper extends BaseMapper<Role> {}

package/templates/scaffold-default/packages/api/src/mapper/user-role.mapper.ts

@@ -0,0 +1,6 @@
+import 'reflect-metadata';
+import { Mapper, BaseMapper } from '@ai-partner-x/aiko-boot-starter-orm';
+import { UserRole } from '../entity/user-role.entity.js';
+
+@Mapper(UserRole)
+export class UserRoleMapper extends BaseMapper<UserRole> {}

package/templates/scaffold-default/packages/api/src/mapper/user.mapper.ts

@@ -0,0 +1,11 @@
+import 'reflect-metadata';
+import { Mapper, BaseMapper } from '@ai-partner-x/aiko-boot-starter-orm';
+import { User } from '../entity/user.entity.js';
+
+@Mapper(User)
+export class UserMapper extends BaseMapper<User> {
+  async selectByUsername(username: string): Promise<User | null> {
+    const user = await this.selectOne({ username });
+    return user;
+  }
+}

package/templates/scaffold-default/packages/api/src/scripts/assign-role.ts

@@ -0,0 +1,41 @@
+import 'reflect-metadata';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { createKyselyDatabase, getKyselyDatabase } from '@ai-partner-x/aiko-boot-starter-orm';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const dbPath = join(__dirname, '../../data/app.db');
+
+await createKyselyDatabase({
+    type: 'sqlite',
+    filename: dbPath,
+});
+
+const db = getKyselyDatabase();
+
+const users = await db.selectFrom('sys_user').selectAll().execute();
+const roles = await db.selectFrom('sys_role').selectAll().execute();
+
+if (users.length > 0 && roles.length > 0) {
+    const adminUser = users.find(u => u.user_name === 'admin');
+    const adminRole = roles.find(r => r.role_code === 'SUPER_ADMIN');
+    
+    if (adminUser && adminRole) {
+        const existing = await db.selectFrom('sys_user_role')
+            .where('user_id', '=', adminUser.id as number)
+            .where('role_id', '=', adminRole.id as number)
+            .selectAll()
+            .execute();
+        
+        if (existing.length === 0) {
+            await db.insertInto('sys_user_role')
+                .values({ user_id: adminUser.id as number, role_id: adminRole.id as number })
+                .execute();
+            console.log('✅ 已为 admin 用户分配 SUPER_ADMIN 角色');
+        } else {
+            console.log('ℹ️  admin 用户已有 SUPER_ADMIN 角色');
+        }
+    }
+}
+
+process.exit(0);

package/templates/scaffold-default/packages/api/src/scripts/check-user-role.ts

@@ -0,0 +1,28 @@
+import 'reflect-metadata';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { createKyselyDatabase, getKyselyDatabase } from '@ai-partner-x/aiko-boot-starter-orm';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const dbPath = join(__dirname, '../../data/app.db');
+
+await createKyselyDatabase({
+    type: 'sqlite',
+    filename: dbPath,
+});
+
+const db = getKyselyDatabase();
+
+const users = await db.selectFrom('sys_user').selectAll().execute();
+console.log('用户:');
+console.log(JSON.stringify(users, null, 2));
+
+const roles = await db.selectFrom('sys_role').selectAll().execute();
+console.log('\n角色:');
+console.log(JSON.stringify(roles, null, 2));
+
+const userRoles = await db.selectFrom('sys_user_role').selectAll().execute();
+console.log('\n用户角色关联:');
+console.log(JSON.stringify(userRoles, null, 2));
+
+process.exit(0);

package/templates/scaffold-default/packages/api/src/scripts/check-users.mjs

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+/**
+ * 检查数据库中的用户信息
+ */
+
+import { SqliteDialect } from 'kysely';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const dbPath = join(__dirname, '../../data/app.db');
+
+// 创建Kysely实例
+const { createPool } = await import('kysely');
+const db = createPool({
+  dialect: new SqliteDialect(),
+  database: dbPath,
+});
+
+try {
+  // 查询admin用户
+  const adminUsers = await db.selectFrom('sys_user').where('user_name', '=', 'admin').selectAll();
+  console.log('Admin users found:', JSON.stringify(adminUsers, null, 2));
+
+  // 查询所有用户
+  const allUsers = await db.selectFrom('sys_user').selectAll();
+  console.log('Total users in database:', JSON.stringify(allUsers, null, 2));
+
+  // 查询admin用户密码哈希
+  if (adminUsers.length > 0) {
+    const adminUser = adminUsers[0];
+    console.log('Admin password hash:', adminUser.password_hash);
+    console.log('Admin status:', adminUser.status);
+  }
+
+  await db.destroy();
+  console.log('\n✅ Database query completed successfully');
+  process.exit(0);
+} catch (error) {
+  console.error('Database query error:', error);
+  await db.destroy();
+  process.exit(1);
+}