🦅 ATR OS

Sistema Operacional para Consultoria Empresarial
O "Cockpit" que transforma dados em clareza para PMEs

---

📋 Índice

• Sobre
• Quick Start
• Estrutura do Projeto
• Design System
• Comandos
• Testes
• Deploy
• Documentação

---

Sobre

O ATR OS é o sistema proprietário da ATR Growth Business, uma consultoria estratégica para pequenas e médias empresas. O sistema oferece:

• 📊 10 Análises Financeiras: DRE Gerencial, Margem por Produto, CAC vs LTV, etc.
• 📈 Pipeline de Vendas: Gestão de leads com Kanban
• 📚 Biblioteca de Documentos: Playbooks e materiais
• 🎯 Dashboard Integrado: KPIs em tempo real

Para quem é

Usuário	Funcionalidade
Admin	Gestão completa do sistema
SDR	Pipeline de leads e prospecção
Cliente	Acesso aos projetos contratados

---

🚀 Quick Start

Pré-requisitos

• Node.js 18+
• npm (ou yarn/pnpm)
• Conta Supabase (para banco de dados)

Instalação

# 1. Clone o repositório
git clone [url-do-repo]
cd atr-os

# 2. Instale as dependências
npm install

# 3. Configure as variáveis de ambiente
cp env.example.txt .env.local
# Edite .env.local com suas credenciais Supabase

# 4. Inicie o servidor de desenvolvimento
npm run dev

Acesse http://localhost:3000 para ver o sistema.

Variáveis de Ambiente

# Supabase
NEXT_PUBLIC_SUPABASE_URL=sua-url-supabase
NEXT_PUBLIC_SUPABASE_ANON_KEY=sua-anon-key
SUPABASE_SERVICE_ROLE_KEY=sua-service-role-key

# Opcional: APIs externas
ASSERTIVA_API_KEY=sua-chave-assertiva

---

📁 Estrutura do Projeto

atr-os/
├── src/
│   ├── app/                  # Rotas e páginas (App Router)
│   │   ├── dashboard/        # Dashboard principal
│   │   ├── clientes/         # CRUD clientes
│   │   ├── leads/            # Pipeline de vendas
│   │   ├── projetos/         # Módulos financeiros
│   │   └── ...
│   │
│   ├── components/           # Componentes React
│   │   ├── ui/               # Base (Button, Card, Input...)
│   │   └── [feature]/        # Por funcionalidade
│   │
│   ├── lib/                  # Serviços e lógica de negócio
│   │   ├── supabase/         # Configuração Supabase
│   │   └── *-service.ts      # Serviços por domínio
│   │
│   ├── actions/              # Server Actions
│   ├── contexts/             # React Contexts
│   ├── hooks/                # Custom Hooks
│   └── types/                # TypeScript types
│
├── supabase/
│   └── migrations/           # Migrations do banco
│
├── docs/                     # Documentação
├── .agent/workflows/         # Workflows para IA
├── CLAUDE.md                 # Contexto para IA (obrigatório ler!)
└── DESIGN_SYSTEM.md          # Guia do Design System

📖 Para detalhes completos, veja docs/ARCHITECTURE.md

---

🎨 Design System

O ATR OS usa um Design System Premium com tema escuro e acentos dourados.

Regra de Ouro

NUNCA use cores hardcoded. Sempre use tokens semânticos:

// ❌ ERRADO
<div className="bg-gray-800 text-blue-400">

// ✅ CORRETO
<div className="bg-elevated text-gold-primary">

Tokens Principais

Uso	Classe
Fundo base	bg-deep
Card	bg-card ou cockpit-card
Texto principal	text-text-main
Destaque	text-gold-primary
Sucesso	text-status-success
Erro	text-status-error

📖 Guia completo: DESIGN_SYSTEM.md

---

⌨️ Comandos

Desenvolvimento

npm run dev       # Servidor local (localhost:3000)
npm run build     # Build de produção
npm run start     # Inicia build de produção
npm run lint      # Verificação ESLint

Testes

npm test              # Executar testes
npm run test:watch    # Modo watch
npm run test:coverage # Com cobertura
npm run storybook     # Storybook (localhost:6006)

Supabase

supabase db push           # Deploy migrations
supabase db push --dry-run # Simular (sem executar)
supabase gen types typescript --linked > src/types/database.types.ts

📖 Workflow completo: .agent/workflows/supabase.md

---

🧪 Testes

O projeto usa Vitest para unit tests e Storybook para visual testing.

# Rodar todos os testes
npm test

# Storybook para visualizar componentes
npm run storybook

📖 Guia completo: docs/TESTING.md

---

🚀 Deploy

Vercel (Recomendado)

1. Conecte o repositório na Vercel
2. Configure variáveis de ambiente
3. Deploy automático em cada push

Manual

npm run build
npm run start

---

📚 Documentação

Documento	Descrição
CLAUDE.md	Contexto completo para IA - Leia primeiro!
DESIGN_SYSTEM.md	Guia visual e tokens
docs/ARCHITECTURE.md	Arquitetura do sistema
docs/DESIGN_STANDARDS.md	Padrões de design
docs/TESTING.md	Guia de testes
docs/GIT_WORKFLOW.md	Convenções de Git

Workflows para IA

Workflow	Descrição
/supabase	Comandos Supabase CLI
/development	Fluxo de desenvolvimento
/componente	Criar componentes
/pagina	Criar páginas

---

🤝 Contribuição

1. Leia o CLAUDE.md para entender o projeto
2. Siga o DESIGN_SYSTEM.md para visual
3. Use branches: feature/nome, fix/nome, refactor/nome
4. Faça commits descritivos: feat: adiciona modal de lead
5. Abra PR para review

---

📄 Licença

Proprietário - ATR Growth Business © 2026

---

ATR Growth Business - Explorando o Próximo Nível.