plazercli 1.0.0 → 2.0.0

package/README.md

@@ -1,7 +1,7 @@
 <p align="center">
-  <h1 align="center">PlazerCLI</h1>
+  <h1 align="center">PlazerCLI v2.0</h1>
   <p align="center">
-    Gerador de projetos fullstack com auto-configuracao completa.<br/>
+    Gerador de projetos fullstack SaaS prontos para producao.<br/>
     Responda as perguntas e a <strong>Liz</strong> monta tudo pra voce.
   </p>
 </p>
@@ -9,9 +9,12 @@
 <p align="center">
   <a href="#quick-start">Quick Start</a> |
   <a href="#features">Features</a> |
+  <a href="#presets">Presets</a> |
   <a href="#stack-suportada">Stack</a> |
+  <a href="#cli-flags">CLI Flags</a> |
   <a href="#liz---ai-agent">Liz AI</a> |
-  <a href="#como-funciona">Como Funciona</a>
+  <a href="#como-funciona">Como Funciona</a> |
+  <a href="https://pablocarss.github.io/plazercli/">Docs</a>
 </p>
 
 ---
@@ -19,7 +22,14 @@
 ## Quick Start
 
 ```bash
+# Modo interativo (18 perguntas)
 npx plazercli
+
+# Preset rapido
+npx plazercli --preset saas-starter
+
+# Zero perguntas com defaults inteligentes
+npx plazercli --yes --name meu-saas
 ```
 
 Ou instale globalmente:
@@ -36,20 +46,43 @@ A Liz vai te perguntar sobre o projeto e configurar tudo automaticamente.
 Ao rodar o `plazercli`, a Liz:
 
 1. **Pergunta** o nome do projeto e o que ele faz
-2. **Pergunta** qual stack voce quer (frontend, backend, banco, etc.)
+2. **Pergunta** qual stack voce quer (frontend, backend, banco, auth, billing, etc.)
 3. **Cria** o monorepo completo com `apps/web` + `apps/api`
-4. **Configura** o banco de dados com o nome do projeto
-5. **Conecta** todos os modulos automaticamente (auth, filas, integracoes)
-6. **Gera** `docker-compose.yml` com todos os servicos
-7. **Gera** `.env` com todas as variaveis organizadas
-8. **Instala** as dependencias
-9. **Inicializa** o git com commit inicial
-10. **Configura** a si mesma (Liz) como AI agent no projeto
+4. **Configura** banco de dados, autenticacao, RBAC, billing
+5. **Conecta** todos os modulos automaticamente (auto-wiring)
+6. **Gera** docker-compose.yml, .env, README, CI/CD, Dockerfiles
+7. **Instala** as dependencias
+8. **Inicializa** o git com commit inicial
+9. **Configura** a si mesma (Liz) como AI agent no projeto
 
 Resultado: projeto pronto pra rodar com `docker compose up -d && pnpm dev`
 
 ## Features
 
+### SaaS Core (v2.0)
+| Feature | O que configura |
+|---------|----------------|
+| **RBAC** | Roles (Admin/User/Owner), CASL abilities, guards por framework |
+| **Organizations** | Workspaces com CRUD, convites por email, gestao de membros |
+| **Stripe Billing** | Planos Free/Pro/Enterprise, checkout, portal, webhooks |
+
+### API Quality (v2.0)
+| Feature | O que configura |
+|---------|----------------|
+| **Zod** | Schemas de validacao prontos, pipes (NestJS) ou middleware |
+| **Rate Limiting** | Limites globais e por rota, configuraveis por framework |
+| **Pino Logging** | Logging estruturado com request ID, pretty-print em dev |
+| **Swagger/OpenAPI** | Documentacao automatica da API em `/api/docs` |
+
+### Autenticacao (multipla escolha)
+| Metodo | O que configura |
+|--------|----------------|
+| **JWT** | Login/register com bcrypt, guards/middleware, strategy |
+| **Magic Link** | Token por email, verificacao, auto-habilita SMTP |
+| **Google OAuth** | Strategy Passport, rotas de callback, env vars |
+
+Todos adaptados automaticamente ao backend escolhido (Express/Fastify/NestJS).
+
 ### Frontend
 | Framework | Descricao |
 |-----------|----------|
@@ -61,9 +94,9 @@ Resultado: projeto pronto pra rodar com `docker compose up -d && pnpm dev`
 ### Backend
 | Framework | Descricao |
 |-----------|----------|
+| **NestJS** | Enterprise, modular, decorators |
 | **Express** | Minimalista, flexivel |
 | **Fastify** | Alta performance, plugins |
-| **NestJS** | Enterprise, modular, decorators |
 
 ### Banco de Dados
 | Banco | ORM/ODM | Auto-config |
@@ -72,15 +105,6 @@ Resultado: projeto pronto pra rodar com `docker compose up -d && pnpm dev`
 | **MySQL** | Prisma | Schema com User model, docker service, DATABASE_URL |
 | **MongoDB** | Mongoose | Models, conexao, docker service, MONGODB_URI |
 
-### Autenticacao (multipla escolha)
-| Metodo | O que configura |
-|--------|----------------|
-| **JWT** | Login/register com bcrypt, middleware de auth, guards |
-| **Magic Link** | Token por email, verificacao, auto-habilita SMTP |
-| **Google OAuth** | Strategy Passport, rotas de callback, env vars |
-
-Todos adaptados automaticamente ao backend escolhido (Express/Fastify/NestJS).
-
 ### Filas e Jobs
 | Tecnologia | O que configura |
 |------------|----------------|
@@ -105,39 +129,107 @@ Todos adaptados automaticamente ao backend escolhido (Express/Fastify/NestJS).
 | **PM2** | ecosystem.config.cjs, cluster mode, zero-downtime |
 | **Multi-tenant** | Middleware de isolamento por header/subdomain |
 
+### Extras (v2.0)
+| Feature | O que configura |
+|---------|----------------|
+| **WebSockets** | Socket.IO com rooms, broadcast e notificacoes |
+| **Tailwind CSS** | Config + paginas SaaS prontas (landing, login, dashboard, settings) |
+| **CI/CD** | GitHub Actions (lint, build, Docker) + Dockerfiles multi-stage |
+| **i18n** | Internacionalizacao pt-BR + en, setup por framework |
+
+## Presets
+
+Use `--preset <nome>` pra criar projetos com configuracoes prontas:
+
+| Preset | Stack | Descricao |
+|--------|-------|-----------|
+| `saas-starter` | NestJS + Next.js + PostgreSQL | Stack completa: auth, billing, RBAC, dashboard |
+| `saas-multi-tenant` | NestJS + Next.js + PostgreSQL | SaaS B2B com isolamento por tenant |
+| `ecommerce` | NestJS + Next.js + PostgreSQL | Loja online com pagamentos e storage |
+| `api-platform` | Fastify + Next.js + PostgreSQL | API robusta com docs e monitoramento |
+| `realtime-app` | NestJS + Next.js + PostgreSQL | App com comunicacao em tempo real |
+| `minimal` | Express + Next.js + PostgreSQL | Minimo necessario pra comecar |
+
+```bash
+# Exemplo
+npx plazercli --preset saas-starter --name minha-plataforma
+```
+
 ## Stack Suportada
 
 ### Runtimes
-- npm
-- pnpm
+- pnpm (recomendado)
 - bun
+- npm
 
 ### Estrutura
 Monorepo com workspaces nativos do runtime escolhido.
 
 ```
-meu-projeto/
+meu-saas/
 ├── apps/
-│   ├── api/          # Backend
-│   └── web/          # Frontend
+│   ├── api/                    # Backend
+│   │   ├── src/
+│   │   │   ├── auth/           # JWT, Magic Link, OAuth
+│   │   │   ├── rbac/           # Roles + CASL
+│   │   │   ├── organizations/  # Workspaces + convites
+│   │   │   ├── billing/        # Stripe subscriptions
+│   │   │   ├── database/       # Prisma/Mongoose
+│   │   │   ├── infra/          # Redis, Email, Storage
+│   │   │   ├── queue/          # Workers e jobs
+│   │   │   ├── websockets/     # Socket.IO
+│   │   │   ├── common/         # Validation, Logging
+│   │   │   ├── integrations/   # APIs externas
+│   │   │   ├── routes/
+│   │   │   └── config/
+│   │   ├── prisma/
+│   │   └── .env
+│   └── web/                    # Frontend
+│       └── src/
 ├── docker-compose.yml
-├── CLAUDE.md         # Liz (Claude Code)
-├── AGENTS.md         # Liz (geral)
-├── .cursor/rules/    # Liz (Cursor)
+├── .github/workflows/          # CI/CD
+├── CLAUDE.md                   # Liz (Claude Code)
+├── AGENTS.md                   # Liz (geral)
+├── .cursor/rules/              # Liz (Cursor)
 └── README.md
 ```
 
+## CLI Flags
+
+```bash
+plazercli --version                    # Mostra versao
+plazercli --name meu-app               # Pre-define nome
+plazercli --yes                        # Defaults inteligentes, sem perguntas
+plazercli --preset saas-starter        # Usa preset pronto
+plazercli --dry-run                    # Mostra o que seria gerado
+plazercli --save-config config.json    # Salva config pra reutilizar
+plazercli --config config.json         # Carrega config salva
+```
+
+### Valores padrao (--yes)
+
+| Opcao | Default |
+|-------|---------|
+| Runtime | pnpm |
+| Database | PostgreSQL (Prisma) |
+| Frontend | Next.js |
+| Backend | NestJS |
+| Auth | JWT |
+| Queue | BullMQ |
+| RBAC / Zod / Rate Limiting / Pino / Swagger | Sim |
+| Tailwind / CI/CD | Sim |
+| Redis / SMTP / PM2 | Sim |
+
 ## Liz - AI Agent
 
-Todo projeto gerado vem com a **Liz**, uma agente de IA treinada na arquitetura do projeto.
+Todo projeto gerado vem com a **Liz**, uma agente de IA configurada pra conhecer a arquitetura do projeto.
 
 ### O que a Liz sabe
 - Toda a stack escolhida
 - Estrutura de diretorios
 - Convencoes de codigo
-- Como criar novas features
-- Como adicionar endpoints
-- Como usar cada integracao
+- Como criar novas features seguindo os patterns
+- Como adicionar endpoints, models, workers e integracoes
 
 ### Integracao com editores
 
@@ -148,63 +240,84 @@ Todo projeto gerado vem com a **Liz**, uma agente de IA treinada na arquitetura
 | **Copilot / Outros** | `AGENTS.md` | Referencia completa |
 
 ### Exemplo de uso
-Ao abrir o projeto no editor com IA, voce pode pedir:
-
-- "Liz, cria um endpoint de listagem de produtos"
-- "Liz, adiciona um model de Order no Prisma"
-- "Liz, cria um job para enviar email de boas-vindas"
-- "Liz, integra o webhook do Stripe"
 
-A Liz vai seguir as convencoes do projeto e usar os servicos ja configurados.
+```
+"Liz, cria um endpoint de listagem de produtos"
+"Liz, adiciona um model de Order no Prisma"
+"Liz, cria um job para enviar email de boas-vindas"
+"Liz, integra o webhook do Stripe"
+```
 
 ## Como Funciona
 
-### Fluxo interativo (14 perguntas)
+### Fluxo interativo (18 perguntas)
 
 ```
- 1. Nome do projeto           (texto)
- 2. Descricao                 (texto)
- 3. Runtime                   npm | pnpm | bun
- 4. Banco de dados            PostgreSQL | MySQL | MongoDB | Nenhum
- 5. Multi-tenant?             sim | nao
- 6. SMTP (emails)?            sim | nao
- 7. Autenticacao              JWT | Magic Link | Google (multipla)
- 8. Redis?                    sim | nao
- 9. Filas/Jobs                BullMQ | RabbitMQ | Nenhum
-10. Frontend                  Next.js | React | Vue | Angular
-11. Backend                   Express | Fastify | NestJS
-12. Integracoes               ViaCEP | WhatsApp | Stripe | MP | Abacate (multipla)
-13. MinIO (storage)?          sim | nao
-14. PM2 (zero-downtime)?      sim | nao
+ 1. Modo (Custom ou Preset)
+ 2. Nome do projeto              (validado como pacote npm)
+ 3. Descricao                    (texto)
+ 4. Runtime                      pnpm | bun | npm
+ 5. Banco de dados               PostgreSQL | MySQL | MongoDB | None
+ 6. Frontend                     Next.js | React | Vue | Angular
+ 7. Backend                      NestJS | Express | Fastify
+ 8. Autenticacao                 JWT | Magic Link | Google (multipla)
+ 9. SaaS Features                RBAC | Organizations | Stripe (multipla)
+10. API Quality                  Zod | Rate Limiting | Pino | Swagger (multipla)
+11. Multi-tenant?                sim | nao
+12. SMTP (emails)?               sim | nao
+13. Redis?                       sim | nao
+14. Filas/Jobs                   BullMQ | RabbitMQ | None
+15. Integracoes                  ViaCEP | WhatsApp | Stripe | MP | Abacate (multipla)
+16. MinIO (storage)?             sim | nao
+17. Extras                       Tailwind | CI/CD | WebSockets | i18n (multipla)
+18. PM2 (zero-downtime)?         sim | nao
 ```
 
 ### Dependencias implicitas
 
-A Liz resolve automaticamente:
-
 | Voce escolhe | Liz habilita |
 |-------------|-------------|
 | BullMQ | Redis |
 | Magic Link | SMTP |
+| Stripe Billing | Integracao Stripe |
 
 ### Auto-wiring
 
-Apos criar os arquivos, a Liz reescreve o arquivo principal do backend para importar e conectar todos os modulos:
+A Liz reescreve o arquivo principal do backend pra importar e conectar todos os modulos:
 
 - **NestJS:** Todos os modules importados no `app.module.ts`
 - **Express:** Todas as rotas registradas no `app.ts`, conexoes no `index.ts`
 - **Fastify:** Todos os plugins registrados no `app.ts`, conexoes no `index.ts`
 
-Nada de configuracao manual - tudo ja esta conectado.
+## Documentacao
 
-## CLI Flags
+O PlazerCLI tem um site de documentacao completo com 39 paginas cobrindo todas as features:
+
+- **[Documentacao Online](https://pablocarss.github.io/plazercli/)** — Site completo com Next.js
+
+### Rodar localmente
 
 ```bash
-plazercli --version        # Mostra versao
-plazercli --name meu-app   # Pre-define nome do projeto
-plazercli --yes            # Usa valores padrao
+cd docs
+npm install
+npm run dev
 ```
 
+### O que tem na documentacao
+
+| Categoria | Paginas |
+|-----------|---------|
+| Comecando | Introducao, Instalacao, Quick Start, CLI Flags, Presets, Arquitetura |
+| Stack | Frontend, Backend, Banco de Dados |
+| Autenticacao | Visao Geral, JWT, Magic Link, Google OAuth |
+| SaaS Features | RBAC, Organizations, Stripe Billing |
+| API Quality | Zod, Rate Limiting, Pino Logging, Swagger |
+| Infraestrutura | Redis, SMTP, MinIO, WebSockets, Filas, Multi-tenant, PM2 |
+| Extras | Tailwind CSS, CI/CD, i18n |
+| Integracoes | Visao Geral, ViaCEP, WhatsApp, Stripe, Mercado Pago, AbacatePay |
+| IA | Liz AI Agent |
+| Avancado | Docker, Variaveis de Ambiente |
+
 ## Desenvolvimento
 
 ```bash
@@ -213,8 +326,6 @@ cd plazercli
 npm install
 npm run dev      # Watch mode
 npm run build    # Build para dist/
-
-# Testar localmente
 node dist/index.js
 ```
 
@@ -224,4 +335,4 @@ MIT
 
 ---
 
-Feito com massa por [@pablocarss](https://github.com/pablocarss)
+Feito por [@pablocarss](https://github.com/pablocarss)