plazercli 1.0.0

package/README.md

@@ -0,0 +1,227 @@
+<p align="center">
+  <h1 align="center">PlazerCLI</h1>
+  <p align="center">
+    Gerador de projetos fullstack com auto-configuracao completa.<br/>
+    Responda as perguntas e a <strong>Liz</strong> monta tudo pra voce.
+  </p>
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick Start</a> |
+  <a href="#features">Features</a> |
+  <a href="#stack-suportada">Stack</a> |
+  <a href="#liz---ai-agent">Liz AI</a> |
+  <a href="#como-funciona">Como Funciona</a>
+</p>
+
+---
+
+## Quick Start
+
+```bash
+npx plazercli
+```
+
+Ou instale globalmente:
+
+```bash
+npm install -g plazercli
+plazercli
+```
+
+A Liz vai te perguntar sobre o projeto e configurar tudo automaticamente.
+
+## O que a Liz faz por voce
+
+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.)
+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
+
+Resultado: projeto pronto pra rodar com `docker compose up -d && pnpm dev`
+
+## Features
+
+### Frontend
+| Framework | Descricao |
+|-----------|----------|
+| **Next.js** | React SSR/SSG com App Router |
+| **React (Vite)** | SPA com Vite + React |
+| **Vue** | SPA com Vite + Vue 3 |
+| **Angular** | SPA com Angular standalone |
+
+### Backend
+| Framework | Descricao |
+|-----------|----------|
+| **Express** | Minimalista, flexivel |
+| **Fastify** | Alta performance, plugins |
+| **NestJS** | Enterprise, modular, decorators |
+
+### Banco de Dados
+| Banco | ORM/ODM | Auto-config |
+|-------|---------|-------------|
+| **PostgreSQL** | Prisma | Schema com User model, docker service, DATABASE_URL |
+| **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 |
+|------------|----------------|
+| **BullMQ** | Queue config, worker de exemplo, auto-habilita Redis |
+| **RabbitMQ** | Producer/consumer, docker service, connection manager |
+
+### Integracoes (multipla escolha)
+| Integracao | O que configura |
+|------------|----------------|
+| **ViaCEP** | Service para consulta de CEP |
+| **WhatsApp** | Service para API Meta WhatsApp Business |
+| **Stripe** | Checkout, PaymentIntent, webhooks |
+| **Mercado Pago** | Preferences, pagamentos PIX |
+| **AbacatePay** | Pagamentos, PIX |
+
+### Infraestrutura
+| Feature | O que configura |
+|---------|----------------|
+| **Redis** | Service com ioredis, docker service |
+| **SMTP** | Email service com Nodemailer, template HTML |
+| **MinIO** | Storage S3-compatible, upload/download, docker service |
+| **PM2** | ecosystem.config.cjs, cluster mode, zero-downtime |
+| **Multi-tenant** | Middleware de isolamento por header/subdomain |
+
+## Stack Suportada
+
+### Runtimes
+- npm
+- pnpm
+- bun
+
+### Estrutura
+Monorepo com workspaces nativos do runtime escolhido.
+
+```
+meu-projeto/
+├── apps/
+│   ├── api/          # Backend
+│   └── web/          # Frontend
+├── docker-compose.yml
+├── CLAUDE.md         # Liz (Claude Code)
+├── AGENTS.md         # Liz (geral)
+├── .cursor/rules/    # Liz (Cursor)
+└── README.md
+```
+
+## Liz - AI Agent
+
+Todo projeto gerado vem com a **Liz**, uma agente de IA treinada na 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
+
+### Integracao com editores
+
+| Editor | Arquivo | Como funciona |
+|--------|---------|--------------|
+| **Claude Code** | `CLAUDE.md` | Carrega automaticamente |
+| **Cursor** | `.cursor/rules/liz.mdc` | Regras contextuais |
+| **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.
+
+## Como Funciona
+
+### Fluxo interativo (14 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
+```
+
+### Dependencias implicitas
+
+A Liz resolve automaticamente:
+
+| Voce escolhe | Liz habilita |
+|-------------|-------------|
+| BullMQ | Redis |
+| Magic Link | SMTP |
+
+### Auto-wiring
+
+Apos criar os arquivos, a Liz reescreve o arquivo principal do backend para 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.
+
+## CLI Flags
+
+```bash
+plazercli --version        # Mostra versao
+plazercli --name meu-app   # Pre-define nome do projeto
+plazercli --yes            # Usa valores padrao
+```
+
+## Desenvolvimento
+
+```bash
+git clone https://github.com/pablocarss/plazercli.git
+cd plazercli
+npm install
+npm run dev      # Watch mode
+npm run build    # Build para dist/
+
+# Testar localmente
+node dist/index.js
+```
+
+## Licenca
+
+MIT
+
+---
+
+Feito com massa por [@pablocarss](https://github.com/pablocarss)