nestforge-generator 0.2.0 → 0.4.0

package/templates/drizzle/src/users/users.service.ts

@@ -44,7 +44,7 @@ export class UsersService {
 
     if (existing) {
       throw new ConflictException(
-        'E-mail já cadastrado',
+        'Email already registered',
       );
     }
 
@@ -144,7 +144,7 @@ export class UsersService {
 
     if (!user) {
       throw new NotFoundException(
-        'Usuário não encontrado',
+        'User not found',
       );
     }
 
@@ -190,7 +190,7 @@ export class UsersService {
       .where(eq(users.id, id));
 
     return {
-      message: 'Usuário removido com sucesso',
+      message: 'User deleted successfully',
     };
   }
 
@@ -210,4 +210,4 @@ export class UsersService {
 
     return this.findOne(id);
   }
-}
+}

package/templates/drizzle/test/auth.e2e-spec.ts

@@ -25,7 +25,7 @@ describe('Auth (e2e)', () => {
         await app.close();
     });
 
-    it('deve registrar, logar, renovar e revogar o token', async () => {
+    it('registers, logs in, refreshes, and revokes the token', async () => {
         const server = app.getHttpServer();
 
         const registerResponse = await request(server)
@@ -33,7 +33,7 @@ describe('Auth (e2e)', () => {
             .send({
                 name: 'Jeiel',
                 email: 'jeiel.e2e@example.com',
-                password: 'senhaForte123',
+                password: 'strongPassword123',
             })
             .expect(201);
 
@@ -49,7 +49,7 @@ describe('Auth (e2e)', () => {
             .post('/auth/login')
             .send({
                 email: 'jeiel.e2e@example.com',
-                password: 'senhaForte123',
+                password: 'strongPassword123',
             })
             .expect(200);
 
@@ -82,13 +82,13 @@ describe('Auth (e2e)', () => {
             .expect(401);
     });
 
-    it('não deve permitir cadastro com e-mail duplicado', async () => {
+    it('rejects registration with a duplicate email', async () => {
         const server = app.getHttpServer();
 
         const payload = {
             name: 'Jeiel',
-            email: 'duplicado.e2e@example.com',
-            password: 'senhaForte123',
+            email: 'duplicate.e2e@example.com',
+            password: 'strongPassword123',
         };
 
         await request(server)
@@ -102,7 +102,7 @@ describe('Auth (e2e)', () => {
             .expect(409);
     });
 
-    it('deve rejeitar login com credenciais inválidas', async () => {
+    it('rejects login with invalid credentials', async () => {
         await request(app.getHttpServer())
             .post('/auth/login')
             .send({
@@ -111,4 +111,4 @@ describe('Auth (e2e)', () => {
             })
             .expect(401);
     });
-});
+});

package/templates/drizzle/test/session-auth.e2e-spec.ts

@@ -28,7 +28,7 @@ describe('Session auth (e2e)', () => {
         }
     });
 
-    it('registra, autentica e encerra uma sessão protegida por CSRF', async () => {
+    it('registers, authenticates, and closes a CSRF-protected session', async () => {
         const agent = request.agent(app.getHttpServer());
 
         await agent
@@ -43,13 +43,13 @@ describe('Session auth (e2e)', () => {
 
         expect(csrfToken).toMatch(/^[a-f0-9]{64}$/);
 
-        // Requisições que alteram estado devem ser rejeitadas sem o token.
+        // State-changing requests must be rejected without the token.
         await agent
             .post('/auth/register')
             .send({
                 name: 'Jeiel',
                 email: 'jeiel.session@example.com',
-                password: 'senhaForte123',
+                password: 'strongPassword123',
             })
             .expect(403);
 
@@ -59,7 +59,7 @@ describe('Session auth (e2e)', () => {
             .send({
                 name: 'Jeiel',
                 email: 'jeiel.session@example.com',
-                password: 'senhaForte123',
+                password: 'strongPassword123',
             })
             .expect(201);
 
@@ -97,7 +97,7 @@ describe('Session auth (e2e)', () => {
             .expect(401);
     });
 
-    it('realiza login e renova o token CSRF da sessão', async () => {
+    it('logs in and refreshes the session CSRF token', async () => {
         const registrationAgent = request.agent(
             app.getHttpServer(),
         );
@@ -113,9 +113,9 @@ describe('Session auth (e2e)', () => {
             .post('/auth/register')
             .set('x-csrf-token', registrationCsrfToken)
             .send({
-                name: 'Usuário de sessão',
+                name: 'Session User',
                 email: 'login.session@example.com',
-                password: 'senhaForte123',
+                password: 'strongPassword123',
             })
             .expect(201);
 
@@ -141,7 +141,7 @@ describe('Session auth (e2e)', () => {
             .set('x-csrf-token', loginCsrfToken)
             .send({
                 email: 'login.session@example.com',
-                password: 'senhaForte123',
+                password: 'strongPassword123',
             })
             .expect(200);
 
@@ -160,4 +160,4 @@ describe('Session auth (e2e)', () => {
             .get('/users/me')
             .expect(200);
     });
-});
+});

package/templates/drizzle/test/users.e2e-spec.ts

@@ -28,7 +28,7 @@ describe('Users (e2e)', () => {
 
         await database.insert(users).values({
             id: randomUUID(),
-            name: 'Usuário de teste',
+            name: 'Test User',
             email,
             passwordHash,
             role,
@@ -70,22 +70,22 @@ describe('Users (e2e)', () => {
         await app.close();
     });
 
-    it('rejeita acesso sem token', async () => {
+    it('rejects access without a token', async () => {
         await request(app.getHttpServer())
             .get('/users')
             .expect(401);
     });
 
-    it('ADMIN consegue criar, listar, atualizar e remover um usuário', async () => {
+    it('allows ADMIN to create, list, update, and delete a user', async () => {
         await createUserWithRole(
             'admin.e2e@example.com',
-            'senhaForte123',
+            'strongPassword123',
             Role.ADMIN,
         );
 
         const token = await loginAndGetToken(
             'admin.e2e@example.com',
-            'senhaForte123',
+            'strongPassword123',
         );
 
         const server = app.getHttpServer();
@@ -99,9 +99,9 @@ describe('Users (e2e)', () => {
                 `Bearer ${token}`,
             )
             .send({
-                name: 'Novo Usuário',
-                email: 'novo.e2e@example.com',
-                password: 'senhaForte123',
+                name: 'New User',
+                email: 'new.e2e@example.com',
+                password: 'strongPassword123',
             })
             .expect(201);
 
@@ -146,16 +146,16 @@ describe('Users (e2e)', () => {
     });
 
     // nestforge:feature:rbac
-    it('USER consegue ler mas não consegue criar usuário', async () => {
+    it('allows USER to read but not create users', async () => {
         await createUserWithRole(
             'user.e2e@example.com',
-            'senhaForte123',
+            'strongPassword123',
             Role.USER,
         );
 
         const token = await loginAndGetToken(
             'user.e2e@example.com',
-            'senhaForte123',
+            'strongPassword123',
         );
 
         const server = app.getHttpServer();
@@ -175,24 +175,24 @@ describe('Users (e2e)', () => {
                 `Bearer ${token}`,
             )
             .send({
-                name: 'Não deveria criar',
-                email: 'bloqueado.e2e@example.com',
-                password: 'senhaForte123',
+                name: 'Should Not Be Created',
+                email: 'blocked.e2e@example.com',
+                password: 'strongPassword123',
             })
             .expect(403);
     });
     // nestforge:feature:rbac:end
 
-    it('GET /users/me retorna o usuário autenticado', async () => {
+    it('returns the authenticated user from GET /users/me', async () => {
         await createUserWithRole(
             'me.e2e@example.com',
-            'senhaForte123',
+            'strongPassword123',
             Role.USER,
         );
 
         const token = await loginAndGetToken(
             'me.e2e@example.com',
-            'senhaForte123',
+            'strongPassword123',
         );
 
         const response = await request(
@@ -209,4 +209,4 @@ describe('Users (e2e)', () => {
             'me.e2e@example.com',
         );
     });
-});
+});

package/templates/prisma/.github/workflows/ci.yml

@@ -64,6 +64,9 @@ jobs:
       # nestforge:feature:database:sqlite
       DATABASE_URL: file:./ci-dev.db
       # nestforge:feature:database:sqlite:end
+      # nestforge:feature:database:mongodb
+      DATABASE_URL: mongodb://localhost:27017/nestforge?replicaSet=rs0
+      # nestforge:feature:database:mongodb:end
       JWT_ACCESS_SECRET: ci-access-secret-0123456789
       JWT_REFRESH_SECRET: ci-refresh-secret-0123456789
 
@@ -77,14 +80,34 @@ jobs:
           node-version: 20
           cache: npm
 
+      # nestforge:feature:database:mongodb
+      - name: Start MongoDB replica set
+        run: |
+          docker run --detach --name nestforge-mongodb --publish 27017:27017 mongo:8 mongod --replSet rs0 --bind_ip_all
+          for attempt in {1..30}; do
+            if docker exec nestforge-mongodb mongosh --quiet --eval "try { rs.status().ok } catch (error) { rs.initiate({_id: 'rs0', members: [{_id: 0, host: 'localhost:27017'}]}).ok }" | grep -q 1; then
+              exit 0
+            fi
+            sleep 2
+          done
+          exit 1
+      # nestforge:feature:database:mongodb:end
+
       - name: Instalar dependências
         run: npm ci
 
       - name: Gerar Prisma Client
         run: npx prisma generate
 
+      # nestforge:feature:database:relational
       - name: Rodar migrations
         run: npx prisma migrate deploy
+      # nestforge:feature:database:relational:end
+
+      # nestforge:feature:database:mongodb
+      - name: Sincronizar schema do MongoDB
+        run: npx prisma db push
+      # nestforge:feature:database:mongodb:end
 
       - name: Lint
         run: npm run lint
@@ -106,4 +129,4 @@ jobs:
       # nestforge:feature:database:mysql:end
 
       - name: Testes e2e
-        run: npm run test:e2e
+        run: npm run test:e2e

package/templates/prisma/ARCHITECTURE.md

@@ -11,7 +11,7 @@ Request → main.ts (global pipes/filters/interceptors)
         → Guards (JwtAuthGuard → RolesGuard → PermissionsGuard)
         → Controller (validates through a Zod DTO, delegates to the service)
         → Service (business rules, calls Prisma)
-        → Prisma → PostgreSQL
+        → Prisma → selected database
         → Response (passes through ClassSerializerInterceptor before becoming JSON)
 ```
 
@@ -38,6 +38,12 @@ Controllers never communicate with Prisma directly — they always go through th
 
 Prisma Client is effectively already a type-safe repository. Adding an abstraction layer on top merely to “follow the pattern” would add indirection without a real benefit in this project (there is no plan to replace the ORM). Services call `this.prisma.<model>` directly.
 
+### How does MongoDB differ from the relational databases?
+
+MongoDB documents use `_id`. The generated Prisma schema maps model IDs to `_id`, uses native `ObjectId` values where IDs are generated by MongoDB, and marks relation scalar fields with `@db.ObjectId`. The session store keeps its externally supplied string ID mapped directly to `_id`.
+
+MongoDB uses `prisma db push` instead of Prisma Migrate. A replica set is required for transactional and nested-write behavior, so the generated Docker Compose starts a single-node replica set. The database health indicator uses MongoDB's `ping` command instead of executing `SELECT 1`.
+
 ### Why are permissions a fixed map in code (`ROLE_PERMISSIONS`) instead of a database table?
 
 A fully dynamic permission system (`roles`, `permissions`, and `role_permissions` tables) is overkill for a starter — most projects created from it will have 3–5 fixed roles. Keeping the mapping in `src/common/constants/role-permissions.ts` makes it explicitly auditable: the entire permission array for every role is visible in one file. If the project grows enough to require permissions configurable at runtime (for example, an administrator creating custom roles through the UI), then migrating to database tables becomes worthwhile.

package/templates/prisma/ARCHITECTURE.pt-BR.md

@@ -11,7 +11,7 @@ Request → main.ts (pipes/filters/interceptors globais)
         → Guards (JwtAuthGuard → RolesGuard → PermissionsGuard)
         → Controller (valida via DTO Zod, delega pro service)
         → Service (regra de negócio, chama o Prisma)
-        → Prisma → PostgreSQL
+        → Prisma → banco selecionado
         → Response (passa pelo ClassSerializerInterceptor antes de virar JSON)
 ```
 
@@ -36,6 +36,12 @@ Controllers nunca falam com o Prisma diretamente — sempre passam pelo service.
 ### Por que Prisma sem uma camada de "repository" por cima?
 Prisma Client já é, na prática, um repository type-safe — adicionar uma camada de abstração em cima dele só pra "seguir o padrão" adicionaria indireção sem trazer benefício real neste projeto (não há plano de trocar de ORM). Os services chamam `this.prisma.<model>` diretamente.
 
+### Como o MongoDB difere dos bancos relacionais?
+
+Documentos MongoDB usam `_id`. O schema Prisma gerado mapeia os IDs dos models para `_id`, usa valores nativos `ObjectId` quando os IDs são gerados pelo MongoDB e marca os campos escalares de relação com `@db.ObjectId`. O armazenamento de sessão mantém seu ID textual fornecido externamente mapeado diretamente para `_id`.
+
+MongoDB usa `prisma db push` no lugar do Prisma Migrate. Um replica set é necessário para transações e escritas aninhadas, então o Docker Compose gerado inicia um replica set de nó único. O indicador de saúde usa o comando `ping` do MongoDB em vez de executar `SELECT 1`.
+
 ### Por que permissions são um mapa fixo em código (`ROLE_PERMISSIONS`) e não uma tabela no banco?
 Um sistema de permissions 100% dinâmico (tabelas `roles`, `permissions`, `role_permissions`) é overkill pra um boilerplate — a maioria dos projetos que nascem daqui vai ter 3-5 roles fixas. Manter o mapeamento em `src/common/constants/role-permissions.ts` deixa auditável de forma explícita: dá pra ver o array inteiro de permissões de cada role em um arquivo só. Se o seu projeto crescer a ponto de precisar de permissions configuráveis em runtime (ex.: um admin criando roles customizadas pela UI), aí sim vale migrar pra tabela.
 

package/templates/prisma/README.md

@@ -17,7 +17,7 @@ NestForge is a NestJS starter designed to accelerate the beginning of serious ba
 - 🌐 **OAuth** — Google and GitHub, integrated with the selected token or session strategy
 - 👥 **RBAC** — Roles (Admin, Manager, User) and granular Permissions
 - 🛡️ **Security** — Helmet, CORS, Rate Limiting, validation, and serialization with Zod
-- 🗄️ **Database** — Prisma with PostgreSQL, MySQL, or SQLite
+- 🗄️ **Database** — Prisma with PostgreSQL, MySQL, SQLite, or MongoDB
 - 📨 **Email** — queues with BullMQ + Redis, locally tested with Mailpit
 - 📄 **Automatic documentation** — Swagger
 - 🪵 **Structured logs** — Pino
@@ -31,7 +31,7 @@ NestForge is a NestJS starter designed to accelerate the beginning of serious ba
 |---|---|
 | Framework | NestJS + TypeScript |
 | ORM | Prisma |
-| Database | PostgreSQL, MySQL, or SQLite |
+| Database | PostgreSQL, MySQL, SQLite, or MongoDB |
 | Cache / Queues | Redis + BullMQ |
 | Authentication | JWT, Session/Cookies, or OAuth with Passport |
 | Validation | Zod + nestjs-zod (schemas automatically become DTOs + Swagger) |
@@ -73,14 +73,19 @@ cp .env.example .env
 docker compose up
 ```
 
-This starts the API, PostgreSQL, Redis, and Mailpit (email interface at `http://localhost:8025`).
+This starts the API, the selected database, Redis, and Mailpit (email interface at `http://localhost:8025`). MongoDB runs as a single-node replica set for transaction support.
 
 ### Running locally
 
 ```bash
 npm install
 cp .env.example .env
+# nestforge:feature:database:relational
 npx prisma migrate dev
+# nestforge:feature:database:relational:end
+# nestforge:feature:database:mongodb
+npm run prisma:push
+# nestforge:feature:database:mongodb:end
 npx prisma db seed
 npm run start:dev
 ```
@@ -234,15 +239,14 @@ npm run test:e2e      # integration tests (E2E)
 npm run test:cov      # coverage
 ```
 
-E2E tests (`test/*.e2e-spec.ts`) start the real application (Nest + Prisma + Redis) and call its endpoints with `supertest`, using an isolated database (`.env.test`, the `nestforge_test` database — never the development database). Before running them for the first time:
+E2E tests (`test/*.e2e-spec.ts`) start the real application (Nest + Prisma + Redis) and call its endpoints with `supertest`, using an isolated database (`.env.test`, the `nestforge_test` database — never the development database). Before running them for the first time, start the selected database and Redis:
 
 ```bash
-createdb nestforge_test   # or: psql -U nestforge -c "CREATE DATABASE nestforge_test;"
-docker compose up -d postgres redis
+docker compose up -d
 npm run test:e2e
 ```
 
-The `pretest:e2e` script automatically applies migrations to this database before every run. Each test cleans the tables before running (`test/utils/clean-database.ts`), so nothing needs to be reset manually between runs. Current coverage includes the complete authentication flow (registration, login, refresh, logout, duplicate email, invalid credentials) and user CRUD with RBAC (ADMIN can do everything, USER can read but cannot create, `/users/me`, and access without a token).
+The `pretest:e2e` script automatically applies migrations for relational databases or pushes the Prisma schema for MongoDB before every run. Each test cleans the database before running (`test/utils/clean-database.ts`), so nothing needs to be reset manually between runs. Current coverage includes the complete authentication flow (registration, login, refresh, logout, duplicate email, invalid credentials) and user CRUD with RBAC (ADMIN can do everything, USER can read but cannot create, `/users/me`, and access without a token).
 
 Unit tests (`src/**/*.spec.ts`) run in isolation with Prisma and `ioredis` mocked (`vi.fn()` / `vi.mock()`), so they do not require a real database or Redis. Current coverage includes `AuthService` (registration/login), `UsersService` (complete CRUD + pagination + confirmation through `instanceToPlain` that `passwordHash` is not leaked during serialization), `RolesGuard` and `PermissionsGuard` (allowing/blocking, including multiple permissions required at the same time), and health indicators (`PrismaHealthIndicator`, `RedisHealthIndicator`).
 

package/templates/prisma/README.pt-BR.md

@@ -17,7 +17,7 @@ NestForge é um boilerplate de NestJS pensado para acelerar o início de projeto
 - 🌐 **OAuth** — Google e GitHub, integrado à estratégia de token ou sessão escolhida
 - 👥 **RBAC** — Roles (Admin, Manager, User) e Permissions granulares
 - 🛡️ **Segurança** — Helmet, CORS, Rate Limiting, validação e serialização com Zod
-- 🗄️ **Banco de dados** — Prisma com PostgreSQL, MySQL ou SQLite
+- 🗄️ **Banco de dados** — Prisma com PostgreSQL, MySQL, SQLite ou MongoDB
 - 📨 **E-mails** — filas com BullMQ + Redis, testado localmente com Mailpit
 - 📄 **Documentação automática** — Swagger
 - 🪵 **Logs estruturados** — Pino
@@ -31,7 +31,7 @@ NestForge é um boilerplate de NestJS pensado para acelerar o início de projeto
 |---|---|
 | Framework | NestJS + TypeScript |
 | ORM | Prisma |
-| Banco | PostgreSQL, MySQL ou SQLite |
+| Banco | PostgreSQL, MySQL, SQLite ou MongoDB |
 | Cache / Filas | Redis + BullMQ |
 | Autenticação | JWT, Session/Cookies ou OAuth com Passport |
 | Validação | Zod + nestjs-zod (schemas viram DTO + Swagger automaticamente) |
@@ -73,14 +73,19 @@ cp .env.example .env
 docker compose up
 ```
 
-Isso sobe: API, PostgreSQL, Redis e Mailpit (interface de e-mail em `http://localhost:8025`).
+Isso sobe a API, o banco selecionado, Redis e Mailpit (interface de e-mail em `http://localhost:8025`). O MongoDB funciona como replica set de nó único para permitir transações.
 
 ### Rodando localmente
 
 ```bash
 npm install
 cp .env.example .env
+# nestforge:feature:database:relational
 npx prisma migrate dev
+# nestforge:feature:database:relational:end
+# nestforge:feature:database:mongodb
+npm run prisma:push
+# nestforge:feature:database:mongodb:end
 npx prisma db seed
 npm run start:dev
 ```
@@ -234,15 +239,14 @@ npm run test:e2e      # integração (e2e)
 npm run test:cov      # cobertura
 ```
 
-Os testes e2e (`test/*.e2e-spec.ts`) sobem a aplicação real (Nest + Prisma + Redis) e batem nos endpoints com `supertest`, usando um banco isolado (`.env.test`, banco `nestforge_test` — nunca o de desenvolvimento). Antes de rodar pela primeira vez:
+Os testes e2e (`test/*.e2e-spec.ts`) sobem a aplicação real (Nest + Prisma + Redis) e batem nos endpoints com `supertest`, usando um banco isolado (`.env.test`, banco `nestforge_test` — nunca o de desenvolvimento). Antes de rodar pela primeira vez, inicie o banco selecionado e o Redis:
 
 ```bash
-createdb nestforge_test   # ou: psql -U nestforge -c "CREATE DATABASE nestforge_test;"
-docker compose up -d postgres redis
+docker compose up -d
 npm run test:e2e
 ```
 
-O script `pretest:e2e` já aplica as migrations nesse banco automaticamente antes de cada rodada. Cada teste limpa as tabelas antes de rodar (`test/utils/clean-database.ts`), então não precisa zerar nada manualmente entre execuções. Hoje cobrem o fluxo de autenticação completo (registro, login, refresh, logout, e-mail duplicado, credenciais inválidas) e o CRUD de usuários com RBAC (ADMIN consegue tudo, USER lê mas não cria, `/users/me`, acesso sem token).
+O script `pretest:e2e` aplica as migrations nos bancos relacionais ou envia o schema Prisma ao MongoDB antes de cada rodada. Cada teste limpa o banco antes de rodar (`test/utils/clean-database.ts`), então não precisa zerar nada manualmente entre execuções. Hoje cobrem o fluxo de autenticação completo (registro, login, refresh, logout, e-mail duplicado, credenciais inválidas) e o CRUD de usuários com RBAC (ADMIN consegue tudo, USER lê mas não cria, `/users/me`, acesso sem token).
 
 Os testes unitários (`src/**/*.spec.ts`) rodam isolados, com Prisma e `ioredis` mockados (`vi.fn()` / `vi.mock()`) — não precisam de banco nem Redis de verdade. Hoje cobrem: `AuthService` (registro/login), `UsersService` (CRUD completo + paginação + confirma que o `passwordHash` não vaza na serialização via `instanceToPlain`), `RolesGuard` e `PermissionsGuard` (liberação/bloqueio, inclusive com múltiplas permissões exigidas ao mesmo tempo) e os indicadores de saúde (`PrismaHealthIndicator`, `RedisHealthIndicator`).
 

package/templates/prisma/ROADMAP.md

@@ -41,7 +41,11 @@ This roadmap makes it clear what is ready and where contributions are possible.
 
 - [x] Prisma
 - [x] PostgreSQL
-- [x] Migrations
+- [x] MySQL
+- [x] SQLite
+- [x] MongoDB
+- [x] Migrations for relational databases
+- [x] Schema synchronization with `prisma db push` for MongoDB
 - [x] Complete seed (roles, permissions, administrator user)
 
 ## Infrastructure

package/templates/prisma/ROADMAP.pt-BR.md

@@ -36,7 +36,11 @@ Este roadmap existe para deixar claro o que já está pronto e onde dá pra cont
 ## Banco de dados
 - [x] Prisma
 - [x] PostgreSQL
-- [x] Migrations
+- [x] MySQL
+- [x] SQLite
+- [x] MongoDB
+- [x] Migrations para bancos relacionais
+- [x] Sincronização do schema com `prisma db push` para MongoDB
 - [x] Seed completo (roles, permissions, usuário admin)
 
 ## Infra

package/templates/prisma/TESTING.md

@@ -8,7 +8,7 @@ This guide validates a project generated from the NestForge Prisma template.
 
 * Node.js 20 or later
 * npm 10 or later
-* Docker when testing PostgreSQL, MySQL, Redis, or Mailpit
+* Docker when testing PostgreSQL, MySQL, MongoDB, Redis, or Mailpit
 
 SQLite can be tested without Docker.
 
@@ -30,10 +30,18 @@ npm run prisma:generate
 
 ## Apply the development schema
 
+For PostgreSQL, MySQL, or SQLite:
+
 ```bash
 npm run prisma:migrate -- --name init
 ```
 
+For MongoDB:
+
+```bash
+npm run prisma:push
+```
+
 Run the seed when the generated project includes password authentication:
 
 ```bash
@@ -67,7 +75,7 @@ Unit tests mock Prisma and Redis, so they do not require real services.
 npm run test:e2e
 ```
 
-The `pretest:e2e` script runs `prisma migrate deploy` with `.env.test` before the suite starts.
+The `pretest:e2e` script runs `prisma migrate deploy` for relational databases or `prisma db push` for MongoDB with `.env.test` before the suite starts.
 
 Depending on the generated authentication strategy, the suite may cover:
 
@@ -110,11 +118,25 @@ npm test
 npm run test:e2e
 ```
 
+### MongoDB
+
+MongoDB must run as a replica set because Prisma uses transactions for nested writes. The generated Docker Compose configures a single-node replica set:
+
+```bash
+docker compose up -d mongodb
+npm run prisma:push
+npm run build
+npm test
+npm run test:e2e
+```
+
+Use different database names in `.env` and `.env.test`, such as `nestforge` and `nestforge_test`.
+
 ## Final checklist
 
 * [ ] Dependencies install successfully
 * [ ] Prisma Client is generated
-* [ ] Migrations are applied
+* [ ] Migrations are applied, or the MongoDB schema is pushed
 * [ ] Seed runs when applicable
 * [ ] Build passes
 * [ ] Lint passes

package/templates/prisma/TESTING.pt-BR.md

@@ -8,7 +8,7 @@ Este guia valida um projeto gerado a partir do template Prisma do NestForge.
 
 * Node.js 20 ou superior
 * npm 10 ou superior
-* Docker para testar PostgreSQL, MySQL, Redis ou Mailpit
+* Docker para testar PostgreSQL, MySQL, MongoDB, Redis ou Mailpit
 
 SQLite pode ser testado sem Docker.
 
@@ -30,10 +30,18 @@ npm run prisma:generate
 
 ## Aplicar o schema de desenvolvimento
 
+Para PostgreSQL, MySQL ou SQLite:
+
 ```bash
 npm run prisma:migrate -- --name init
 ```
 
+Para MongoDB:
+
+```bash
+npm run prisma:push
+```
+
 Execute o seed quando o projeto gerado incluir autenticação por senha:
 
 ```bash
@@ -67,7 +75,7 @@ Os testes unitários simulam Prisma e Redis, portanto não exigem serviços reai
 npm run test:e2e
 ```
 
-O script `pretest:e2e` executa `prisma migrate deploy` com `.env.test` antes do início da suíte.
+O script `pretest:e2e` executa `prisma migrate deploy` nos bancos relacionais ou `prisma db push` no MongoDB com `.env.test` antes do início da suíte.
 
 Dependendo da estratégia de autenticação gerada, a suíte pode cobrir:
 
@@ -110,11 +118,25 @@ npm test
 npm run test:e2e
 ```
 
+### MongoDB
+
+O MongoDB deve funcionar como replica set porque o Prisma usa transações em escritas aninhadas. O Docker Compose gerado configura um replica set de nó único:
+
+```bash
+docker compose up -d mongodb
+npm run prisma:push
+npm run build
+npm test
+npm run test:e2e
+```
+
+Use nomes de banco diferentes em `.env` e `.env.test`, como `nestforge` e `nestforge_test`.
+
 ## Checklist final
 
 * [ ] As dependências são instaladas corretamente
 * [ ] O Prisma Client é gerado
-* [ ] As migrations são aplicadas
+* [ ] As migrations são aplicadas ou o schema MongoDB é enviado
 * [ ] O seed executa quando aplicável
 * [ ] O build passa
 * [ ] O lint passa