# PP Core Platform Architecture v1.0

> **planilhaprofissional.com** · Ecossistema SaaS escalável

---

## Visão Geral

O objetivo deste projeto é criar uma arquitetura SaaS escalável para o ecossistema Planilha Profissional, permitindo a operação de múltiplos aplicativos utilizando uma base tecnológica padronizada, segura e preparada para crescimento.

### Aplicativos atuais

- PetCare Gestão
- Finanças Pro
- GalõesPro
- Supermercado Inteligente

### Aplicativos futuros

- CRM Pro
- RH Pro
- Estoque Pro
- Agenda Pro
- Novos SaaS da Skill App Factory

---

## Objetivos da Arquitetura

### Objetivos Técnicos

- Centralizar padrões de desenvolvimento
- Reduzir retrabalho entre aplicativos
- Padronizar autenticação
- Padronizar permissões
- Padronizar assinaturas
- Facilitar manutenção
- Facilitar implantação
- Permitir escalabilidade para milhares de clientes

### Objetivos Comerciais

- Acelerar lançamento de novos produtos
- Reduzir custo operacional
- Melhorar experiência dos clientes
- Facilitar venda cruzada entre aplicativos

---

## Infraestrutura

| Função | Ferramenta |
|--------|------------|
| Desenvolvimento | Cursor Pro |
| Versionamento | GitHub |
| Banco de Dados | Supabase Pro |
| Publicação | Vercel |
| Site Institucional | Hostinger |

---

## Arquitetura Alvo

```
PlanilhaProfissional Ecosystem
├── Portal Central (app.planilhaprofissional.com)
└── Aplicativos
    ├── PetCare
    ├── Finanças Pro
    ├── GalõesPro
    ├── Supermercado Inteligente
    ├── CRM Pro
    ├── RH Pro
    └── Estoque Pro
```

Detalhes técnicos: [docs/padroes/ARQUITETURA_FABRICA_APPS.md](docs/padroes/ARQUITETURA_FABRICA_APPS.md)

---

## Estratégia de Migração

> **IMPORTANTE:** Nenhum sistema atualmente em produção será alterado até que a nova arquitetura esteja totalmente validada.

Aplicativos atuais permanecem operando normalmente. A migração ocorrerá **apenas após homologação completa**.

### Critério para migração

A migração somente poderá ocorrer após:

- [ ] Testes completos
- [ ] Backup validado
- [ ] Ambiente homologado
- [ ] Plano de rollback definido
- [ ] Aprovação final

**Nenhum cliente poderá sofrer interrupção de serviço durante o processo.**

---

## Fase 1 — Ambiente de Desenvolvimento

### Nova Organização Supabase

| Item | Valor |
|------|-------|
| Nome sugerido | PP Core Dev |
| Objetivo | Ambiente isolado para testes da nova arquitetura |
| Impacto | Sem impacto nos clientes atuais |

### Projeto Principal: `pp-core-dev`

Responsabilidades:

- Autenticação
- Empresas (multi-tenant via `company_id`)
- Usuários
- Planos
- Assinaturas
- Permissões
- Configurações
- Auditoria (ver [AUDITORIA.md](docs/padroes/AUDITORIA.md))

---

## Roadmap Inicial

| Etapa | Entrega |
|-------|---------|
| 1 | Criar organização PP Core Dev |
| 2 | Criar projeto `pp-core-dev` |
| 3 | Modelar banco de dados |
| 4 | Implementar autenticação |
| 5 | Implementar controle de empresas |
| 6 | Implementar permissões |
| 7 | Criar template padrão SaaS |
| 8 | Criar Finanças Pro v2 |
| 9 | Homologação |
| 10 | Planejamento de migração dos sistemas atuais |

---

*Documento de referência fixa — planilhaprofissional.com*