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 +135 -53
- package/dist/index.js +9656 -85
- package/dist/index.js.map +1 -1
- package/package.json +17 -2
package/README.md
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<h1 align="center">PlazerCLI
|
|
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 (
|
|
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
|
|
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
|
-
###
|
|
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
|
-
###
|
|
78
|
-
|
|
|
79
|
-
|
|
80
|
-
| **
|
|
81
|
-
| **
|
|
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
|
-
|
|
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
|
-
| **
|
|
128
|
-
| **
|
|
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
|
|
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 (
|
|
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
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
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
|