chore: commit oxfmt formatting changes and verify artifacts

This commit is contained in:
2026-07-02 15:55:09 +08:00
parent 34726cc46d
commit 4f4cee157a
77 changed files with 5576 additions and 1400 deletions

View File

@@ -0,0 +1,31 @@
## Why
当前项目采用平面目录结构(`backend/` + `frontend/`),根 `package.json` 仅用 `cd` 脚本串联两个子项目。规划中将新增学生端(`student`)等应用,现有结构无法支持统一构建编排、共享配置和依赖管理,项目工程化能力成为扩张瓶颈。需要建立标准 monorepo 体系,为多应用并行开发奠定基础。
## What Changes
- **BREAKING**:目录重组 — `backend/``apps/server/`API 服务),`frontend/``apps/admin/`(管理后台),预留 `apps/student/`(学生端)
- 引入 Turborepo 构建编排,定义 `turbo.json` 流水线
-`package.json` 改造为 npm workspaces 声明
- 抽取共享 TypeScript 配置到 `packages/typescript-config/`
- 代码格式化从 Prettier 迁移到 oxfmt
- 前端 Linting 从 ESLint 迁移到 oxlint后端保留 ESLint保障 NestJS 规则覆盖)
- Docker Compose 构建上下文路径调整
- 新增统一的根级脚本:`dev``build``lint``format`
## Capabilities
### New Capabilities
- `monorepo-structure`: npm workspaces 驱动的 monorepo 目录结构apps/ + packages/
- `turborepo-pipeline`: Turborepo 构建流水线与缓存
- `oxlint-oxfmt-toolchain`: 基于 oxlint + oxfmt 的代码质量工具链(前端 oxlint后端保留 ESLint
### Modified Capabilities
<!-- 本次无现有 spec 需要修改 -->
## Impact
- **目录结构**:所有顶层 `backend/``frontend/` 路径引用需更新
- **配置文件**:根 `package.json``tsconfig`(新增共享包)、`.gitignore`、Dockerfiles、`docker-compose.yml`
- **开发流程**开发、构建、lint、format 命令从子目录变更到根目录执行
- **无业务代码变更**`src/` 下所有业务逻辑保持不变