feat(task1): restructure directories for turborepo monorepo

- Move backend/ to apps/server/ via git mv - Move frontend/ to apps/admin/ via git mv - Create packages/typescript-config/ with base, nestjs, and react-vite presets
2026-07-02 15:05:12 +08:00
parent 4704adcba1
commit 46a817503e
137 changed files with 52 additions and 0 deletions
--- a/apps/server/src/students/dto/student.dto.ts
+++ b/apps/server/src/students/dto/student.dto.ts
@@ -0,0 +1,80 @@
+import { IsString, IsOptional, IsEnum } from 'class-validator';
+
+export class CreateStudentDto {
+  @IsString()
+  name: string;
+
+  @IsOptional()
+  @IsString()
+  phone?: string;
+
+  @IsOptional()
+  @IsString()
+  idNumber?: string;
+
+  @IsOptional()
+  @IsString()
+  gender?: string;
+
+  @IsOptional()
+  @IsString()
+  ethnicity?: string;
+
+  @IsOptional()
+  @IsString()
+  emergencyContact?: string;
+
+  @IsOptional()
+  @IsString()
+  emergencyPhone?: string;
+
+  @IsOptional()
+  @IsString()
+  organization?: string;
+
+  @IsOptional()
+  @IsString()
+  supervisor?: string;
+}
+
+export class UpdateStudentDto {
+  @IsOptional()
+  @IsString()
+  name?: string;
+
+  @IsOptional()
+  @IsString()
+  phone?: string;
+
+  @IsOptional()
+  @IsString()
+  idNumber?: string;
+
+  @IsOptional()
+  @IsString()
+  gender?: string;
+
+  @IsOptional()
+  @IsString()
+  ethnicity?: string;
+
+  @IsOptional()
+  @IsString()
+  emergencyContact?: string;
+
+  @IsOptional()
+  @IsString()
+  emergencyPhone?: string;
+
+  @IsOptional()
+  @IsString()
+  organization?: string;
+
+  @IsOptional()
+  @IsString()
+  supervisor?: string;
+
+  @IsOptional()
+  @IsEnum(['active', 'graduated', 'withdrawn'])
+  status?: string;
+}
--- a/apps/server/src/students/students.controller.ts
+++ b/apps/server/src/students/students.controller.ts
@@ -0,0 +1,156 @@
+import { Controller, Get, Post, Put, Delete, Body, Param, Query, UseGuards, Request, Res, UseInterceptors, UploadedFile } from '@nestjs/common';
+import { FileInterceptor } from '@nestjs/platform-express';
+import type { Response } from 'express';
+import { StudentsService } from './students.service';
+import { CreateStudentDto, UpdateStudentDto } from './dto/student.dto';
+import { JwtAuthGuard } from '../auth/guards/jwt-auth.guard';
+import { OperationLogsService } from '../operation-logs/operation-logs.service';
+import { extractRequestInfo } from '../common/request-utils';
+import { RequirePermission } from '../auth/decorators/permission.decorator';
+import * as ExcelJS from 'exceljs';
+
+@UseGuards(JwtAuthGuard)
+@Controller('students')
+export class StudentsController {
+  constructor(private service: StudentsService, private logService: OperationLogsService) {}
+
+  @Get()
+  @RequirePermission('student:view')
+  findAll(@Query('name') name?: string, @Query('status') status?: string, @Query('includeArchived') includeArchived?: string) {
+    return this.service.findAll({ name, status, includeArchived: includeArchived === 'true' });
+  }
+
+  @Get('export')
+  @RequirePermission('student:export')
+  async exportExcel(@Query('includeArchived') includeArchived?: string, @Res() res?: Response) {
+    const students = await this.service.findAll({ includeArchived: includeArchived === 'true' });
+    const workbook = new ExcelJS.Workbook();
+    const ws = workbook.addWorksheet('学生名单');
+    ws.columns = [
+      { header: '姓名', key: 'name', width: 12 },
+      { header: '性别', key: 'gender', width: 8 },
+      { header: '电话', key: 'phone', width: 18 },
+      { header: '学号/身份证', key: 'idNumber', width: 22 },
+      { header: '民族', key: 'ethnicity', width: 10 },
+      { header: '紧急联系人', key: 'emergencyContact', width: 15 },
+      { header: '紧急联系人电话', key: 'emergencyPhone', width: 18 },
+      { header: '所属机构', key: 'organization', width: 18 },
+      { header: '负责人/班主任', key: 'supervisor', width: 15 },
+      { header: '状态', key: 'status', width: 10 },
+    ];
+    ws.getRow(1).font = { bold: true };
+    ws.getRow(1).fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FFE0E0E0' } };
+    const statusMap: Record<string, string> = { active: '在读', graduated: '已毕业', withdrawn: '已退训', archived: '已归档' };
+    for (const s of students) {
+      ws.addRow({ name: s.name, gender: s.gender || '', phone: s.phone || '', idNumber: s.idNumber || '', ethnicity: s.ethnicity || '', emergencyContact: s.emergencyContact || '', emergencyPhone: s.emergencyPhone || '', organization: s.organization || '', supervisor: s.supervisor || '', status: statusMap[s.status] || s.status });
+    }
+    res!.setHeader('Content-Type', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
+    res!.setHeader('Content-Disposition', 'attachment; filename=students.xlsx');
+    await workbook.xlsx.write(res!);
+    res!.end();
+  }
+
+  @Get('template')
+  @RequirePermission('student:view')
+  async downloadTemplate(@Res() res: Response) {
+    const workbook = new ExcelJS.Workbook();
+    const ws = workbook.addWorksheet('学生导入模板');
+    ws.columns = [
+      { header: '姓名', key: 'name', width: 15 },
+      { header: '电话', key: 'phone', width: 18 },
+      { header: '学号/身份证', key: 'idNumber', width: 22 },
+      { header: '性别', key: 'gender', width: 8 },
+      { header: '民族', key: 'ethnicity', width: 10 },
+      { header: '紧急联系人', key: 'emergencyContact', width: 15 },
+      { header: '紧急联系人电话', key: 'emergencyPhone', width: 18 },
+      { header: '所属机构', key: 'organization', width: 18 },
+      { header: '负责人/班主任', key: 'supervisor', width: 15 },
+    ];
+    ws.getRow(1).font = { bold: true };
+    ws.getRow(1).fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FFE0E0E0' } };
+    ws.addRow({ name: '张三', phone: '13800138000', idNumber: '2024001', gender: '男', ethnicity: '汉族', emergencyContact: '张父', emergencyPhone: '13900000000', organization: '', supervisor: '' });
+    res.setHeader('Content-Type', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
+    res.setHeader('Content-Disposition', 'attachment; filename=student_template.xlsx');
+    await workbook.xlsx.write(res);
+    res.end();
+  }
+
+  @Get(':id')
+  @RequirePermission('student:view')
+  findOne(@Param('id') id: string) {
+    return this.service.findOne(+id);
+  }
+
+  @Post()
+  @RequirePermission('student:create')
+  async create(@Body() dto: CreateStudentDto, @Request() req: any) {
+    const { ipAddress, userAgent } = extractRequestInfo(req);
+    const result = await this.service.create(dto);
+    await this.logService.log({ userId: req.user?.id, username: req.user?.username, module: '学生', action: '添加学生', targetId: result.id, targetType: 'student', detail: `姓名: ${dto.name}, 电话: ${dto.phone || '无'}, 学号: ${dto.idNumber || '无'}`, ipAddress, userAgent });
+    return result;
+  }
+
+  @Put(':id')
+  @RequirePermission('student:edit')
+  async update(@Param('id') id: string, @Body() dto: UpdateStudentDto, @Request() req: any) {
+    const { ipAddress, userAgent } = extractRequestInfo(req);
+    const result = await this.service.update(+id, dto);
+    await this.logService.log({ userId: req.user?.id, username: req.user?.username, module: '学生', action: '编辑学生', targetId: +id, targetType: 'student', detail: JSON.stringify(dto), ipAddress, userAgent });
+    return result;
+  }
+
+  @Delete(':id')
+  @RequirePermission('student:delete')
+  async remove(@Param('id') id: string, @Request() req: any) {
+    const { ipAddress, userAgent } = extractRequestInfo(req);
+    const result = await this.service.remove(+id);
+    await this.logService.log({ userId: req.user?.id, username: req.user?.username, module: '学生', action: '归档学生', targetId: +id, targetType: 'student', ipAddress, userAgent });
+    return result;
+  }
+
+  @Post('batch-delete')
+  @RequirePermission('student:delete')
+  async batchRemove(@Body() body: { ids: number[] }, @Request() req: any) {
+    const { ipAddress, userAgent } = extractRequestInfo(req);
+    const result = await this.service.batchRemove(body.ids || []);
+    await this.logService.log({ userId: req.user?.id, username: req.user?.username, module: '学生', action: '批量归档学生', detail: `IDs: ${(body.ids || []).join(',')}`, ipAddress, userAgent });
+    return result;
+  }
+
+  @Put(':id/restore')
+  @RequirePermission('student:edit')
+  async restore(@Param('id') id: string, @Request() req: any) {
+    const { ipAddress, userAgent } = extractRequestInfo(req);
+    const result = await this.service.restore(+id);
+    await this.logService.log({ userId: req.user?.id, username: req.user?.username, module: '学生', action: '恢复学生', targetId: +id, targetType: 'student', ipAddress, userAgent });
+    return result;
+  }
+
+  @Post('import')
+  @RequirePermission('student:import')
+  @UseInterceptors(FileInterceptor('file'))
+  async importExcel(@UploadedFile() file: Express.Multer.File, @Request() req: any) {
+    const { ipAddress, userAgent } = extractRequestInfo(req);
+    const workbook = new ExcelJS.Workbook();
+    await workbook.xlsx.load(file.buffer as any);
+    const ws = workbook.worksheets[0];
+    const rows: { name: string; phone?: string; idNumber?: string; gender?: string; ethnicity?: string; emergencyContact?: string; emergencyPhone?: string; organization?: string; supervisor?: string }[] = [];
+    ws.eachRow((row, idx) => {
+      if (idx === 1) return;
+      rows.push({
+        name: String(row.getCell(1).value || ''),
+        phone: String(row.getCell(2).value || ''),
+        idNumber: String(row.getCell(3).value || ''),
+        gender: String(row.getCell(4).value || '').trim() || undefined,
+        ethnicity: String(row.getCell(5).value || '').trim() || undefined,
+        emergencyContact: String(row.getCell(6).value || '').trim() || undefined,
+        emergencyPhone: String(row.getCell(7).value || '').trim() || undefined,
+        organization: String(row.getCell(8).value || '').trim() || undefined,
+        supervisor: String(row.getCell(9).value || '').trim() || undefined,
+      });
+    });
+    const result = await this.service.batchImport(rows);
+    await this.logService.log({ userId: req.user?.id, username: req.user?.username, module: '学生', action: '批量导入', detail: result.message, ipAddress, userAgent });
+    return result;
+  }
+}
--- a/apps/server/src/students/students.module.ts
+++ b/apps/server/src/students/students.module.ts
@@ -0,0 +1,13 @@
+import { Module } from '@nestjs/common';
+import { TypeOrmModule } from '@nestjs/typeorm';
+import { Student } from '../entities/student.entity';
+import { StudentsService } from './students.service';
+import { StudentsController } from './students.controller';
+
+@Module({
+  imports: [TypeOrmModule.forFeature([Student])],
+  controllers: [StudentsController],
+  providers: [StudentsService],
+  exports: [StudentsService],
+})
+export class StudentsModule {}
--- a/apps/server/src/students/students.service.ts
+++ b/apps/server/src/students/students.service.ts
@@ -0,0 +1,103 @@
+import { Injectable, NotFoundException, BadRequestException } from '@nestjs/common';
+import { InjectRepository } from '@nestjs/typeorm';
+import { Repository, Like, Not, In } from 'typeorm';
+import { Student } from '../entities/student.entity';
+import { CreateStudentDto, UpdateStudentDto } from './dto/student.dto';
+
+@Injectable()
+export class StudentsService {
+  constructor(@InjectRepository(Student) private repo: Repository<Student>) {}
+
+  async findAll(query?: { name?: string; status?: string; includeArchived?: boolean }) {
+    const where: any = {};
+    if (query?.name) where.name = Like(`%${query.name}%`);
+    if (query?.status) {
+      where.status = query.status;
+    } else if (!query?.includeArchived) {
+      where.status = Not('archived');
+    }
+    return this.repo.find({ where, order: { createdAt: 'DESC' } });
+  }
+
+  async findOne(id: number) {
+    const student = await this.repo.findOne({ where: { id }, relations: ['occupancies', 'occupancies.room'] });
+    if (!student) throw new NotFoundException('学生不存在');
+    return student;
+  }
+
+  async create(dto: CreateStudentDto) {
+    return this.repo.save(this.repo.create(dto));
+  }
+
+  async update(id: number, dto: UpdateStudentDto) {
+    await this.findOne(id);
+    await this.repo.update(id, dto);
+    return this.repo.findOne({ where: { id } });
+  }
+
+  async remove(id: number) {
+    const student = await this.findOne(id);
+    if (student.status === 'archived') {
+      throw new BadRequestException('该学生已归档');
+    }
+    // 软删除：归档而非物理删除，保留历史数据
+    await this.repo.update(id, { status: 'archived' });
+    return { message: '已归档（数据已保留，可随时恢复）' };
+  }
+
+  async batchRemove(ids: number[]) {
+    if (!ids || ids.length === 0) throw new BadRequestException('请选择要归档的学生');
+    const students = await this.repo.find({ where: { id: In(ids) } });
+    const skipped: string[] = [];
+    const targetIds: number[] = [];
+    for (const s of students) {
+      if (s.status === 'archived') skipped.push(s.name);
+      else targetIds.push(s.id);
+    }
+    let affected = 0;
+    if (targetIds.length > 0) {
+      const result = await this.repo.createQueryBuilder()
+        .update()
+        .set({ status: 'archived' })
+        .where('id IN (:...ids)', { ids: targetIds })
+        .execute();
+      affected = result.affected || 0;
+    }
+    const message = skipped.length > 0
+      ? `成功归档 ${affected} 人；${skipped.length} 人已是归档状态被跳过（${skipped.slice(0, 5).join('、')}${skipped.length > 5 ? '…' : ''}）`
+      : `已批量归档 ${affected} 人（数据已保留，可随时恢复）`;
+    return { message, archived: affected, skipped: skipped.length };
+  }
+
+  async restore(id: number) {
+    const student = await this.findOne(id);
+    if (student.status !== 'archived') {
+      throw new BadRequestException('该学生未被归档');
+    }
+    await this.repo.update(id, { status: 'active' });
+    return { message: '已恢复' };
+  }
+
+  async batchImport(rows: { name: string; phone?: string; idNumber?: string; gender?: string; ethnicity?: string; emergencyContact?: string; emergencyPhone?: string; organization?: string; supervisor?: string }[]) {
+    let imported = 0;
+    let skipped = 0;
+    for (const row of rows) {
+      if (!row.name || !row.name.trim()) { skipped++; continue; }
+      const exists = await this.repo.findOne({ where: { name: row.name.trim() } });
+      if (exists) { skipped++; continue; }
+      await this.repo.save(this.repo.create({
+        name: row.name.trim(),
+        phone: row.phone?.trim() || undefined,
+        idNumber: row.idNumber?.trim() || undefined,
+        gender: row.gender || undefined,
+        ethnicity: row.ethnicity || undefined,
+        emergencyContact: row.emergencyContact || undefined,
+        emergencyPhone: row.emergencyPhone || undefined,
+        organization: row.organization || undefined,
+        supervisor: row.supervisor || undefined,
+      }));
+      imported++;
+    }
+    return { message: `成功导入 ${imported} 名学生，跳过 ${skipped} 条（重复或空行）`, imported, skipped };
+  }
+}