IzaCenter — Izabela Tarot

Plataforma web completa para serviços de Tarot Cigano com e-commerce, área do cliente e painel administrativo.

Stack

Frontend: Angular 20, PrimeNG, Tailwind CSS, ngx-translate (i18n)
Backend: Express 5, TypeScript, Prisma 7, PostgreSQL (Supabase)
Pagamentos: Stripe (checkout sessions + webhooks)
Storage: Supabase Storage (imagens e mídia)
E-mail: Nodemailer (SMTP)
Cache: Redis (opcional em dev, obrigatório em produção)

Funcionalidades

Site público — Home, Sobre, Serviços, Loja, Contato, FAQ, Depoimentos, Termos, Privacidade
Loja/E-commerce — Catálogo de produtos, carrinho com cupons, checkout com Stripe
Área do Cliente — Dashboard, leituras, agendamentos, pedidos com download de PDF, perfil
Painel Admin — Dashboard, leituras, agendamentos, pedidos, produtos, categorias, cartas, usuários, depoimentos, disponibilidade, relatórios, configurações
Backend API — REST API com autenticação JWT, integração Stripe, Supabase Storage, e-mail SMTP
PWA — Service worker com cache de assets e APIs
i18n — 4 idiomas: PT-BR, EN, ES, FR

Status do Projeto (Auditoria 26/02/2026)

Verificação completa dos arquivos reais. Análise detalhada em REVIEW.md.

✅ Implementado e Verificado

| Módulo | Status | |--------|--------| | Backend API — 13 módulos | ✅ Completo | | Banco de Dados — 16 modelos Prisma | ✅ Completo | | Admin — Dashboard, Leituras, Agendamentos, Pedidos | ✅ Completo | | Admin — Produtos, Categorias, Cartas, Usuários | ✅ Completo | | Admin — Depoimentos, Disponibilidade, Relatórios, Configurações | ✅ Completo | | Cliente — Dashboard, Leituras, Agendamentos, Pedidos, Perfil | ✅ Completo | | Loja — Catálogo, Produto, Carrinho (com cupons), Checkout Stripe | ✅ Completo | | Páginas Públicas — Home, Sobre, Serviços, FAQ, Termos, Privacidade | ✅ Completo | | Autenticação — Login, Cadastro, Esqueci/Redefinir Senha | ✅ Completo | | i18n — PT-BR, EN, ES, FR (1.400+ chaves, cobertura 100%) | ✅ Completo | | Email Templates — 7 templates com layout reutilizável | ✅ Completo | | Stripe Webhooks — 6 handlers com idempotência Redis | ✅ Completo | | PWA — Service worker + ngsw-config.json | ✅ Completo | | CI/CD — 3 GitHub Actions workflows | ✅ Completo | | Testes — 303+ unitários backend + 28 E2E Playwright | ✅ Completo | | Monitoramento — Sentry backend + frontend | ✅ Integrado (requer SENTRY_DSN) |

❌ Pendente — Gaps Encontrados na Auditoria

| Item | Módulo | Prioridade | |------|--------|-----------| | Páginas pós-pagamento (/checkout/sucesso e /checkout/cancelado) | Loja | 🔴 Crítico | | Formulário de agendamento pelo cliente (/cliente/agendar) | Cliente | 🔴 Crítico | | Formulário de contato com backend real (atualmente é mock) | Público | 🟡 Alta | | Depoimentos dinâmicos na página pública (atualmente hardcoded) | Público | 🟡 Alta | | Geração de PDF server-side para pedidos e leituras | Backend | 🟡 Alta | | Configuração de produção (secrets, Redis, SMTP, domínio) | Infra | 🔴 Crítico |

Setup

Pré-requisitos

Node.js 20+
PostgreSQL (ou conta Supabase)
Conta Stripe (test mode para desenvolvimento)
Conta de e-mail SMTP (Gmail com App Password, ou similar)
Redis (opcional — necessário para produção)

Backend

cd backend
cp .env.example .env
# Edite .env com suas credenciais (veja seção Variáveis de Ambiente abaixo)
npm install
npx prisma migrate dev
npm run seed  # Popular banco com dados de teste
npm run dev

A API estará disponível em http://localhost:3000.

Frontend

cd frontend
npm install
npm start

A aplicação estará disponível em http://localhost:4200.

Variáveis de Ambiente (Backend)

Copie backend/.env.example para backend/.env e configure:

| Variável | Descrição | Obrigatório | |----------|-----------|-------------| | DATABASE_URL | URL de conexão PostgreSQL (Supabase) | ✅ | | JWT_SECRET | Segredo para tokens JWT | ✅ | | JWT_REFRESH_SECRET | Segredo para refresh tokens | ✅ | | SUPABASE_URL | URL do projeto Supabase | ✅ | | SUPABASE_ANON_KEY | Chave anônima do Supabase | ✅ | | SUPABASE_SERVICE_ROLE_KEY | Chave de serviço do Supabase | ✅ | | STRIPE_SECRET_KEY | Chave secreta do Stripe (sk_test_...) | ✅ | | STRIPE_WEBHOOK_SECRET | Segredo de webhook do Stripe (whsec_...) | ✅ | | SMTP_HOST | Host do servidor SMTP | ✅ | | SMTP_USER | Usuário SMTP | ✅ | | SMTP_PASS | Senha SMTP | ✅ | | FRONTEND_URL | URL do frontend (para CORS e e-mails) | ✅ | | REDIS_URL | URL do Redis (token blacklist) | ⚠️ Prod | | SENTRY_DSN | DSN do Sentry (monitoramento de erros) | ⚠️ Prod |

Configuração do Stripe (Webhooks)

Para receber eventos do Stripe localmente:

# Instale o Stripe CLI
stripe listen --forward-to localhost:3000/api/webhooks/stripe

Copie o segredo exibido para STRIPE_WEBHOOK_SECRET no .env.

Banco de Dados

cd backend

# Criar e aplicar migrações
npx prisma migrate dev

# Visualizar banco de dados
npx prisma studio

# Popular com dados de exemplo
npm run seed

Testes

# Backend — testes unitários
cd backend
npm run test:unit

# Backend — testes de integração
npm run test:integration

# Backend — cobertura
npm run test:coverage

# Frontend — testes unitários
cd frontend
npm test

# E2E (Playwright)
cd e2e
npm test

Build para Produção

# Backend
cd backend
npm run build
npm start

# Frontend
cd frontend
npm run build

Deploy

Render (recomendado)

O projeto inclui configurações para deploy no Render:

Backend: backend/render.yaml — Web service com PostgreSQL e Redis
Frontend: Configuração via render.yaml na raiz

Configure as variáveis de ambiente no painel do Render antes do primeiro deploy.

Secrets do GitHub Actions

Para CI/CD automático, configure os seguintes secrets no GitHub:

| Secret | Descrição | |--------|-----------| | RENDER_BACKEND_DEPLOY_HOOK | Webhook de deploy do backend no Render | | RENDER_FRONTEND_DEPLOY_HOOK | Webhook de deploy do frontend no Render | | E2E_BASE_URL | URL base para testes E2E (ex: https://seu-frontend.onrender.com) |

Docker

# Backend
cd backend
docker build -t izacenter-backend .
docker run -p 3000:3000 --env-file .env izacenter-backend

Estrutura do Projeto

IzaCenter/
├── backend/                # API Express 5 + TypeScript
│   ├── src/
│   │   ├── modules/        # auth, users, products, orders, readings,
│   │   │                   # appointments, cards, categories, testimonials,
│   │   │                   # settings, dashboard, notifications, webhooks
│   │   ├── middlewares/    # auth, error, rate-limit, audit, upload
│   │   ├── config/         # database, redis, email, stripe, supabase, sentry
│   │   └── utils/          # helpers, email templates (7), jwt, password
│   ├── prisma/
│   │   ├── schema.prisma   # 16 modelos
│   │   └── seed.ts         # dados de exemplo
│   └── Dockerfile
├── frontend/               # Angular 20 + PrimeNG + Tailwind
│   └── src/app/
│       ├── features/
│       │   ├── public/     # home, about, services, contact, faq,
│       │   │               # testimonials, terms, privacy, not-found
│       │   ├── auth/       # login, register, forgot-password, reset-password
│       │   ├── shop/       # product-list, product-detail, cart, checkout
│       │   ├── client/     # dashboard, readings, appointments, orders, profile
│       │   └── admin/      # dashboard, readings, appointments, orders, products,
│       │                   # categories, cards, users, testimonials,
│       │                   # availability, reports, settings
│       ├── layouts/        # public-layout, client-layout, admin-layout
│       ├── core/           # services, guards, interceptors, models
│       └── shared/         # components, pipes, animations
├── e2e/                    # Testes E2E Playwright (4 suites, 28+ testes)
└── docs/                   # Documentação adicional

API

A documentação Swagger/OpenAPI está disponível em http://localhost:3000/api/docs após iniciar o backend.

Usuários de Teste (seed)

Após executar npm run seed no backend:

| Papel | E-mail | Senha | |-------|--------|-------| | Admin | admin@izabelatarot.com.br | Admin@123 | | Cliente | cliente@example.com | Cliente@123 |

IzaCenter

Install / Use

README