SuperAPI AI 工具集

create-nextjs-ddd-auth-db

编程与开发

查看项目

更新于 10-16 00:30

技能介绍

用途:当用户要求创建新的 Next.js 项目或应用时,用该技能生成满足指定架构与功能要求的全新全栈 Next.js 应用。技能本身不写应用代码,只在用户选定的目标文件夹内生成代码。

必要流程:先向用户提问并确认——应用名称、创建文件夹、数据库、数据库管理库(不确定时建议:MongoDB 用 mongoose,DynamoDB 用 dynamoose,SQL 用 prisma)、测试库选 Jest 还是 Vitest、代码检查选 ESLint 还是 Oxlint。确认后再给出实施计划并等待用户明确批准。实施前须依据官方文档核对最新稳定版本,不凭记忆假定版本,参考 Next.js 文档与安装指南、better-auth 文档及所选数据库、测试、检查库文档。

脚手架:在指定文件夹以最新 Next.js 方案创建应用,采用 App Router 与 src/ 结构,安装配置 better-auth(Google 认证)、所选测试库、检查库、数据库库及驱动。

DDD 结构:创建 src/tests、src/app、src/app/api、src/application、src/domain、src/infrastructure、src/shared、src/shared/logger、docs 目录。

必备功能:infrastructure 下的数据库连接;shared/logger 下的简单日志工具;含 addDomainEvent 与 releaseDomainEvents 方法、以 DomainEventInterface 为基础的抽象类 BaseEntity;domain 层继承 BaseEntity 的示例 User 实体;至少一个具体领域事件实现;用户仓储抽象与实现;用户查询应用服务;App Router 下带 limit 与 offset 分页参数的 GET /users 接口;含 better-auth Google 登录按钮的首页;src/tests 下覆盖 domain/application/infrastructure/API 的测试。

环境与文档:创建 .env.example 列出全部所需变量;docs/endpoints.yaml 以 OpenAPI 格式列出端点、方法、路径、用途与认证要求;docs/asyncapi.yaml 作为事件目录唯一来源,默认与传输方式无关,包含 asyncapi 与 info 元数据、每个事件一个通道、每事件一条带 payload 模式的消息,共享结构放 components,payload 需记录聚合、事件名与事件数据;更新 README 说明安装、环境、运行、测试、检查、端点用法及 asyncapi.yaml 的用法。

验证:运行检查与测试,修复至通过;确认应用可启动、首页渲染且含认证按钮、/users 可用、所需结构与文档齐备、asyncapi.yaml 覆盖已实现事件,未达标则继续迭代。

限制:所有包保持运行时最新稳定版;脚手架完成后不得停止,须继续至全部要求满足并验证。