用途:这是旧应用现代化重写项目中的脚手架技能,目标是为后续改造建立基础目录结构与依赖。适用于开始搭建新仓库、尚未写业务代码的阶段。
主要能力:按清单分步执行初始化、UI 初始化、核心依赖安装、清理样板代码与构建验证。
必要用法:创建 Next.js 应用时执行 npx -y create-next-app@latest . --typescript --tailwind --eslint --app --src-dir --import-alias "@/*",注意要在新的输出目录(如 modern-app/)中运行,而非旧应用目录。随后运行 npx shadcn@latest init 配置 Tailwind 与组件目录。依赖依据旧系统审计产物 docs/legacy-audit/ 中的 Business_Logic_Rules.md 决定:连旧 MongoDB 时安装 mongodb@latest;主机运行需用 localhost(如 mongodb://localhost:27017/db_name),不能解析 mongo 这类 Docker 内部主机名;若用 mongodb@7+ 就不要装 @auth/mongodb-adapter(存在 peer 冲突),改用 JWT 策略(next-auth@latest);若可接受 mongodb@^6 则安装 mongodb@^6 与 @auth/mongodb-adapter@latest。示例命令:npm install next-auth@latest mongodb@latest zod@latest bcrypt@latest && npm install -D @types/bcrypt@latest。还需规划 .env.local,安装 zod@latest 校验,安装 bcrypt@latest 与 -D @types/bcrypt@latest。最后清理 src/app/page.tsx 与 src/app/globals.css 的默认样板,并确保 npm run build 在空基础上成功。
限制:具体项目规则以审计文档为准;未提供 Node 版本、实际数据库字段等细节。