plazercli 2.0.0 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,7 +1,8 @@
1
1
  <p align="center">
2
- <h1 align="center">PlazerCLI v2.0</h1>
2
+ <h1 align="center">PlazerCLI v3.1</h1>
3
3
  <p align="center">
4
4
  Gerador de projetos fullstack SaaS prontos para producao.<br/>
5
+ <strong>106+ integracoes</strong> · <strong>12 presets</strong> · <strong>Liz AI Agent</strong><br/>
5
6
  Responda as perguntas e a <strong>Liz</strong> monta tudo pra voce.
6
7
  </p>
7
8
  </p>
@@ -22,7 +23,7 @@
22
23
  ## Quick Start
23
24
 
24
25
  ```bash
25
- # Modo interativo (18 perguntas)
26
+ # Modo interativo (8 steps organizados)
26
27
  npx plazercli
27
28
 
28
29
  # Preset rapido
@@ -59,29 +60,99 @@ Resultado: projeto pronto pra rodar com `docker compose up -d && pnpm dev`
59
60
 
60
61
  ## Features
61
62
 
62
- ### SaaS Core (v2.0)
63
+ ### SaaS Core
63
64
  | Feature | O que configura |
64
65
  |---------|----------------|
65
66
  | **RBAC** | Roles (Admin/User/Owner), CASL abilities, guards por framework |
66
67
  | **Organizations** | Workspaces com CRUD, convites por email, gestao de membros |
67
68
  | **Stripe Billing** | Planos Free/Pro/Enterprise, checkout, portal, webhooks |
68
69
 
69
- ### API Quality (v2.0)
70
+ ### Autenticacao (6 providers + 3 services)
71
+ | Metodo | O que configura |
72
+ |--------|----------------|
73
+ | **JWT** | Login/register com bcrypt, guards/middleware, strategy |
74
+ | **Magic Link** | Token por email, verificacao, auto-habilita SMTP |
75
+ | **Google OAuth** | Strategy Passport, rotas de callback, env vars |
76
+ | **GitHub OAuth** | Login com GitHub, essencial pra dev tools |
77
+ | **Apple Sign-In** | Verificacao de identity tokens Apple |
78
+ | **Discord OAuth** | Login com Discord, popular em comunidades |
79
+ | **Clerk** | Auth completo com UI pronto, muito popular com Next.js |
80
+ | **NextAuth/Auth.js** | Auth nativo do Next.js com Prisma adapter |
81
+ | **2FA/TOTP** | Autenticacao de dois fatores com QR code |
82
+
83
+ Todos adaptados automaticamente ao backend escolhido (Express/Fastify/NestJS).
84
+
85
+ ### API Quality
70
86
  | Feature | O que configura |
71
87
  |---------|----------------|
72
88
  | **Zod** | Schemas de validacao prontos, pipes (NestJS) ou middleware |
73
89
  | **Rate Limiting** | Limites globais e por rota, configuraveis por framework |
74
90
  | **Pino Logging** | Logging estruturado com request ID, pretty-print em dev |
75
91
  | **Swagger/OpenAPI** | Documentacao automatica da API em `/api/docs` |
92
+ | **tRPC** | API typesafe end-to-end, integrado com Next.js |
93
+ | **Health Checks** | Endpoint `/api/health` com status de DB, Redis, memoria |
76
94
 
77
- ### Autenticacao (multipla escolha)
78
- | Metodo | O que configura |
79
- |--------|----------------|
80
- | **JWT** | Login/register com bcrypt, guards/middleware, strategy |
81
- | **Magic Link** | Token por email, verificacao, auto-habilita SMTP |
82
- | **Google OAuth** | Strategy Passport, rotas de callback, env vars |
95
+ ### AI/ML (v3.0)
96
+ | Integracao | O que configura |
97
+ |------------|----------------|
98
+ | **OpenAI** | Chat completions, embeddings, assistants |
99
+ | **Vercel AI SDK** | SDK unificado, generateText, streamText |
83
100
 
84
- Todos adaptados automaticamente ao backend escolhido (Express/Fastify/NestJS).
101
+ ### Monitoring & Analytics (v3.0)
102
+ | Feature | O que configura |
103
+ |---------|----------------|
104
+ | **Sentry** | Error tracking + performance monitoring |
105
+ | **Google Analytics 4** | Analytics no frontend com GA4 |
106
+
107
+ ### Pagamentos (5 gateways)
108
+ | Integracao | O que configura |
109
+ |------------|----------------|
110
+ | **Stripe** | Checkout, PaymentIntent, webhooks |
111
+ | **PayPal** | Orders, captures, checkout |
112
+ | **Mercado Pago** | Preferences, pagamentos PIX |
113
+ | **AbacatePay** | Pagamentos, PIX |
114
+
115
+ ### Comunicacao (3 canais)
116
+ | Integracao | O que configura |
117
+ |------------|----------------|
118
+ | **WhatsApp** | Service para API Meta WhatsApp Business |
119
+ | **Twilio SMS** | Envio de SMS e verificacao por telefone |
120
+ | **Telegram Bot** | Bot para notificacoes de sistema |
121
+
122
+ ### Storage (3 opcoes)
123
+ | Opcao | O que configura |
124
+ |-------|----------------|
125
+ | **MinIO** | S3-compatible local, docker service |
126
+ | **AWS S3** | Upload, download, presigned URLs |
127
+ | **Cloudflare R2** | S3-compatible sem egress fees |
128
+
129
+ ### Email (2 opcoes)
130
+ | Opcao | O que configura |
131
+ |-------|----------------|
132
+ | **SMTP** | Nodemailer com templates HTML |
133
+ | **Resend** | API moderna com React Email |
134
+
135
+ ### Search (v3.0)
136
+ | Opcao | O que configura |
137
+ |-------|----------------|
138
+ | **Meilisearch** | Busca full-text, indexacao, docker service |
139
+
140
+ ### Testing (v3.0)
141
+ | Opcao | O que configura |
142
+ |-------|----------------|
143
+ | **Vitest + Supertest** | Unit tests + HTTP tests, config pronta |
144
+
145
+ ### Extras
146
+ | Feature | O que configura |
147
+ |---------|----------------|
148
+ | **WebSockets** | Socket.IO com rooms, broadcast e notificacoes |
149
+ | **Tailwind CSS** | Config + paginas SaaS prontas (landing, login, dashboard) |
150
+ | **CI/CD** | GitHub Actions + Dockerfiles multi-stage |
151
+ | **i18n** | Internacionalizacao pt-BR + en |
152
+ | **Cron Jobs** | Tarefas agendadas com node-cron |
153
+ | **PDFKit** | Gerar PDFs (notas fiscais, relatorios) |
154
+ | **ViaCEP** | Consulta de CEP |
155
+ | **Google Maps** | Maps, Places, Geocoding |
85
156
 
86
157
  ### Frontend
87
158
  | Framework | Descricao |
@@ -105,38 +176,15 @@ Todos adaptados automaticamente ao backend escolhido (Express/Fastify/NestJS).
105
176
  | **MySQL** | Prisma | Schema com User model, docker service, DATABASE_URL |
106
177
  | **MongoDB** | Mongoose | Models, conexao, docker service, MONGODB_URI |
107
178
 
108
- ### Filas e Jobs
109
- | Tecnologia | O que configura |
110
- |------------|----------------|
111
- | **BullMQ** | Queue config, worker de exemplo, auto-habilita Redis |
112
- | **RabbitMQ** | Producer/consumer, docker service, connection manager |
113
-
114
- ### Integracoes (multipla escolha)
115
- | Integracao | O que configura |
116
- |------------|----------------|
117
- | **ViaCEP** | Service para consulta de CEP |
118
- | **WhatsApp** | Service para API Meta WhatsApp Business |
119
- | **Stripe** | Checkout, PaymentIntent, webhooks |
120
- | **Mercado Pago** | Preferences, pagamentos PIX |
121
- | **AbacatePay** | Pagamentos, PIX |
122
-
123
179
  ### Infraestrutura
124
180
  | Feature | O que configura |
125
181
  |---------|----------------|
126
182
  | **Redis** | Service com ioredis, docker service |
127
- | **SMTP** | Email service com Nodemailer, template HTML |
128
- | **MinIO** | Storage S3-compatible, upload/download, docker service |
183
+ | **BullMQ** | Queue config, worker de exemplo, auto-habilita Redis |
184
+ | **RabbitMQ** | Producer/consumer, docker service |
129
185
  | **PM2** | ecosystem.config.cjs, cluster mode, zero-downtime |
130
186
  | **Multi-tenant** | Middleware de isolamento por header/subdomain |
131
187
 
132
- ### Extras (v2.0)
133
- | Feature | O que configura |
134
- |---------|----------------|
135
- | **WebSockets** | Socket.IO com rooms, broadcast e notificacoes |
136
- | **Tailwind CSS** | Config + paginas SaaS prontas (landing, login, dashboard, settings) |
137
- | **CI/CD** | GitHub Actions (lint, build, Docker) + Dockerfiles multi-stage |
138
- | **i18n** | Internacionalizacao pt-BR + en, setup por framework |
139
-
140
188
  ## Presets
141
189
 
142
190
  Use `--preset <nome>` pra criar projetos com configuracoes prontas:
@@ -149,10 +197,16 @@ Use `--preset <nome>` pra criar projetos com configuracoes prontas:
149
197
  | `api-platform` | Fastify + Next.js + PostgreSQL | API robusta com docs e monitoramento |
150
198
  | `realtime-app` | NestJS + Next.js + PostgreSQL | App com comunicacao em tempo real |
151
199
  | `minimal` | Express + Next.js + PostgreSQL | Minimo necessario pra comecar |
200
+ | `ai-saas` | NestJS + Next.js + PostgreSQL | SaaS com IA: OpenAI, Vercel AI SDK, Clerk |
201
+ | `devtool` | NestJS + Next.js + PostgreSQL | Dev tool: GitHub Auth, tRPC, Sentry, testes |
202
+ | `brazil-saas` | NestJS + Next.js + PostgreSQL | SaaS BR: Mercado Pago, ViaCEP, WhatsApp |
203
+ | `marketplace` | NestJS + Next.js + PostgreSQL | Marketplace: busca, storage, pagamentos |
204
+ | `mobile-backend` | Fastify + Next.js + PostgreSQL | Backend mobile: push, SMS, Apple Auth, 2FA |
205
+ | `content-platform` | NestJS + Next.js + PostgreSQL | Plataforma de conteudo com busca e analytics |
152
206
 
153
207
  ```bash
154
208
  # Exemplo
155
- npx plazercli --preset saas-starter --name minha-plataforma
209
+ npx plazercli --preset ai-saas --name minha-plataforma
156
210
  ```
157
211
 
158
212
  ## Stack Suportada
@@ -170,16 +224,19 @@ meu-saas/
170
224
  ├── apps/
171
225
  │ ├── api/ # Backend
172
226
  │ │ ├── src/
173
- │ │ │ ├── auth/ # JWT, Magic Link, OAuth
227
+ │ │ │ ├── auth/ # JWT, Magic Link, OAuth, Clerk, 2FA
174
228
  │ │ │ ├── rbac/ # Roles + CASL
175
229
  │ │ │ ├── organizations/ # Workspaces + convites
176
230
  │ │ │ ├── billing/ # Stripe subscriptions
177
231
  │ │ │ ├── database/ # Prisma/Mongoose
178
- │ │ │ ├── infra/ # Redis, Email, Storage
232
+ │ │ │ ├── infra/ # Redis, Email, Storage, Sentry, PDF
179
233
  │ │ │ ├── queue/ # Workers e jobs
234
+ │ │ │ ├── jobs/ # Cron jobs
235
+ │ │ │ ├── health/ # Health checks
236
+ │ │ │ ├── trpc/ # tRPC router (se habilitado)
180
237
  │ │ │ ├── websockets/ # Socket.IO
181
238
  │ │ │ ├── common/ # Validation, Logging
182
- │ │ │ ├── integrations/ # APIs externas
239
+ │ │ │ ├── integrations/ # APIs externas (OpenAI, Stripe, Twilio, etc.)
183
240
  │ │ │ ├── routes/
184
241
  │ │ │ └── config/
185
242
  │ │ ├── prisma/
@@ -216,7 +273,7 @@ plazercli --config config.json # Carrega config salva
216
273
  | Backend | NestJS |
217
274
  | Auth | JWT |
218
275
  | Queue | BullMQ |
219
- | RBAC / Zod / Rate Limiting / Pino / Swagger | Sim |
276
+ | RBAC / Zod / Rate Limiting / Pino / Swagger / Health Checks | Sim |
220
277
  | Tailwind / CI/CD | Sim |
221
278
  | Redis / SMTP / PM2 | Sim |
222
279
 
@@ -250,9 +307,10 @@ Todo projeto gerado vem com a **Liz**, uma agente de IA configurada pra conhecer
250
307
 
251
308
  ## Como Funciona
252
309
 
253
- ### Fluxo interativo (18 perguntas)
310
+ ### Fluxo interativo (8 steps)
254
311
 
255
312
  ```
313
+ Step 1/8 — Stack Principal
256
314
  1. Modo (Custom ou Preset)
257
315
  2. Nome do projeto (validado como pacote npm)
258
316
  3. Descricao (texto)
@@ -260,17 +318,41 @@ Todo projeto gerado vem com a **Liz**, uma agente de IA configurada pra conhecer
260
318
  5. Banco de dados PostgreSQL | MySQL | MongoDB | None
261
319
  6. Frontend Next.js | React | Vue | Angular
262
320
  7. Backend NestJS | Express | Fastify
263
- 8. Autenticacao JWT | Magic Link | Google (multipla)
264
- 9. SaaS Features RBAC | Organizations | Stripe (multipla)
265
- 10. API Quality Zod | Rate Limiting | Pino | Swagger (multipla)
266
- 11. Multi-tenant? sim | nao
267
- 12. SMTP (emails)? sim | nao
268
- 13. Redis? sim | nao
269
- 14. Filas/Jobs BullMQ | RabbitMQ | None
270
- 15. Integracoes ViaCEP | WhatsApp | Stripe | MP | Abacate (multipla)
271
- 16. MinIO (storage)? sim | nao
272
- 17. Extras Tailwind | CI/CD | WebSockets | i18n (multipla)
273
- 18. PM2 (zero-downtime)? sim | nao
321
+
322
+ Step 2/8 Autenticacao
323
+ 8. Auth methods JWT | Magic Link | Google | GitHub | Apple | Discord
324
+ 9. Auth services Clerk | NextAuth | 2FA/TOTP
325
+
326
+ Step 3/8 SaaS Features
327
+ 10. SaaS RBAC | Organizations | Stripe Billing
328
+
329
+ Step 4/8 API Quality & Patterns
330
+ 11. API Zod | Rate Limiting | Pino | Swagger | tRPC | Health
331
+
332
+ Step 5/8 — Infraestrutura
333
+ 12. Multi-tenant sim | nao
334
+ 13. Email SMTP | Resend | None
335
+ 14. Redis sim | nao
336
+ 15. Filas/Jobs BullMQ | RabbitMQ | None
337
+ 16. Storage MinIO | AWS S3 | Cloudflare R2 | None
338
+ 17. Meilisearch sim | nao
339
+ 18. Cron Jobs sim | nao
340
+
341
+ Step 6/8 — Integracoes
342
+ 19. Pagamentos Stripe | PayPal | Mercado Pago | AbacatePay
343
+ 20. Comunicacao WhatsApp | Twilio SMS | Telegram Bot
344
+ 21. AI OpenAI | Vercel AI SDK
345
+ 22. Outras ViaCEP | Google Maps
346
+
347
+ Step 7/8 — Monitoring & Analytics
348
+ 23. Sentry sim | nao
349
+ 24. Google Analytics sim | nao
350
+
351
+ Step 8/8 — Extras
352
+ 25. Testes sim | nao (Vitest + Supertest)
353
+ 26. PDFKit sim | nao
354
+ 27. Extras Tailwind | CI/CD | WebSockets | i18n
355
+ 28. PM2 sim | nao
274
356
  ```
275
357
 
276
358
  ### Dependencias implicitas