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

apps/server/src/bills/bills.controller.ts

@@ -0,0 +1,108 @@
+import { Controller, Get, Post, Put, Delete, Param, Body, Query, UseGuards, Request, Res, Req } from '@nestjs/common';
+import { BillsService } from './bills.service';
+import { BillsExportService } from './bills-export.service';
+import { GenerateBillsDto, UpdateBillStatusDto } from './dto/bill.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 type { Response } from 'express';
+
+@UseGuards(JwtAuthGuard)
+@Controller('bills')
+export class BillsController {
+  constructor(private service: BillsService, private exportService: BillsExportService, private logService: OperationLogsService) {}
+
+  @Post('generate')
+  @RequirePermission('bill:generate')
+  async generateBills(@Body() dto: GenerateBillsDto, @Request() req: any) {
+    const { ipAddress, userAgent } = extractRequestInfo(req);
+    const result = await this.service.generateBills(dto);
+    await this.logService.log({ userId: req.user?.id, username: req.user?.username, module: '账单', action: '生成账单', detail: `周期 ${dto.periodStart}~${dto.periodEnd}, 生成 ${result.count} 条`, ipAddress, userAgent });
+    return result;
+  }
+
+  @Get()
+  @RequirePermission('bill:view')
+  findAll(
+    @Query('periodStart') periodStart?: string,
+    @Query('periodEnd') periodEnd?: string,
+    @Query('studentId') studentId?: string,
+    @Query('status') status?: string,
+  ) {
+    return this.service.findAll({
+      periodStart, periodEnd,
+      studentId: studentId ? +studentId : undefined,
+      status,
+    });
+  }
+
+  @Get(':id')
+  @RequirePermission('bill:view')
+  findOne(@Param('id') id: string) {
+    return this.service.findOne(+id);
+  }
+
+  @Put(':id/status')
+  @RequirePermission('bill:confirm')
+  async updateStatus(@Param('id') id: string, @Body() dto: UpdateBillStatusDto, @Request() req: any) {
+    const { ipAddress, userAgent } = extractRequestInfo(req);
+    const result = await this.service.updateStatus(+id, dto);
+    await this.logService.log({ userId: req.user?.id, username: req.user?.username, module: '账单', action: `状态变更为${dto.status}`, targetId: +id, targetType: 'bill', ipAddress, userAgent });
+    return result;
+  }
+
+  @Put('batch/status')
+  @RequirePermission('bill:confirm')
+  async batchUpdateStatus(@Body() body: { ids: number[]; status: string }, @Request() req: any) {
+    const { ipAddress, userAgent } = extractRequestInfo(req);
+    const result = await this.service.batchUpdateStatus(body.ids, body.status);
+    await this.logService.log({ userId: req.user?.id, username: req.user?.username, module: '账单', action: `批量状态变更为${body.status}`, detail: `IDs: ${body.ids.join(',')}`, ipAddress, userAgent });
+    return result;
+  }
+
+  @Delete(':id')
+  @RequirePermission('bill: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: 'bill', ipAddress, userAgent });
+    return result;
+  }
+
+  @Post('batch/delete')
+  @RequirePermission('bill: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;
+  }
+
+  @Get('export/excel')
+  @RequirePermission('bill:export-excel')
+  async exportExcel(
+    @Query('periodStart') periodStart?: string,
+    @Query('periodEnd') periodEnd?: string,
+    @Query('studentId') studentId?: string,
+    @Query('status') status?: string,
+    @Res() res?: Response,
+    @Req() req?: any,
+  ) {
+    const { ipAddress, userAgent } = extractRequestInfo(req);
+    await this.logService.log({ userId: req?.user?.id, username: req?.user?.username, module: '账单', action: '导出Excel', detail: `筛选: 周期${periodStart || '全部'}~${periodEnd || '全部'}, 状态${status || '全部'}`, ipAddress, userAgent });
+    return this.exportService.exportExcel({
+      periodStart, periodEnd,
+      studentId: studentId ? +studentId : undefined,
+      status,
+    }, res!);
+  }
+
+  @Get('export/pdf/:id')
+  @RequirePermission('bill:export-pdf')
+  async exportPdf(@Param('id') id: string, @Res() res: Response, @Req() req: any) {
+    const { ipAddress, userAgent } = extractRequestInfo(req);
+    await this.logService.log({ userId: req?.user?.id, username: req?.user?.username, module: '账单', action: '导出PDF', targetId: +id, targetType: 'bill', ipAddress, userAgent });
+    return this.exportService.exportStudentPdf(+id, res);
+  }
+}