README.pt-BR.md

Jim Consultoria - Plataforma CRM para Editais Culturais

Uma plataforma moderna de consultoria para gerenciar programas de incentivo cultural brasileiros, rastrear leads e avaliar elegibilidade para editais.

English

Funcionalidades   |    Arquitetura   |    Tecnologias   |    Instalacao   |    Uso   |    Licenca

✨ Funcionalidades

Gestao de Leads (CRM)

• Visualizacao em Pipeline - Quadro Kanban para acompanhar leads por etapas
• Pontuacao de Leads - Algoritmo automatico de elegibilidade para programas de fomento
• Gestao de Contatos - Armazene informacoes da organizacao, areas culturais e interesses em editais
• Registro de Atividades - Registre notas, ligacoes, e-mails e mudancas de status

Suporte a Programas de Fomento

• ProAC ICMS - Programa de incentivo fiscal do estado de Sao Paulo
• Lei Rouanet - Lei federal de incentivo a cultura
• PNAB - Politica Nacional Aldir Blanc
• Integracao com APIs Governamentais - Dados em tempo real do FomentoCultSP e SALIC

Gestao de Tarefas e Atividades

• Atribuicao de Tarefas - Vincule tarefas a leads e editais com niveis de prioridade
• Historico de Atividades - Trilha de auditoria completa de todas as interacoes
• Acompanhamento de Prazos - Nunca perca datas importantes de submissao

Seguranca e Performance

• Row Level Security - Politicas RLS do PostgreSQL para isolamento de dados
• Server-Side Rendering - Carregamentos rapidos com SSR do SvelteKit
• Atualizacoes em Tempo Real - Alimentado por subscriptions do Supabase

🎨 Arquitetura

Visao Geral do Sistema

graph TD
    User[Usuario / Admin]

    subgraph "Plataforma Jim Consultoria"
        LB[Servidor SvelteKit]
        UI[Interface Svelte 5]
        API[Server Actions]
        Services[Logica de Negocios]
    end

    subgraph "Camada de Dados"
        DB[(Supabase PostgreSQL)]
        Auth[Supabase Auth]
    end

    subgraph "APIs Externas"
        Fomento[API FomentoCultSP]
        SALIC[API SALIC]
    end

    User -->|HTTPS| LB
    LB --> UI
    LB --> API
    API --> Services

    Services --> DB
    Services --> Auth
    Services --> Fomento
    Services --> SALIC

Loading

Fluxo de Dados

sequenceDiagram
    participant C as Cliente
    participant S as Servidor SvelteKit
    participant D as Supabase DB
    participant A as Auth

    C->>S: Requisita Pagina
    S->>A: Valida Sessao
    A-->>S: Dados do Usuario
    S->>D: Busca Dados (RLS Aplicado)
    D-->>S: Resultados Filtrados
    S-->>C: HTML Renderizado + Hidratacao

Loading

💻 Tecnologias

Framework Principal

• SvelteKit 2.x - Framework web full-stack
• Svelte 5 - UI reativa com Runes ($state, $derived, $effect)
• TypeScript 5.x - Desenvolvimento com tipagem segura

Backend e Banco de Dados

• Supabase - Banco PostgreSQL com RLS
• Supabase Auth - Autenticacao e autorizacao
• Zod v4 - Validacao de schemas
• Superforms - Manipulacao de formularios para SvelteKit

Frontend e Design

• Tailwind CSS 4.0 - Estilizacao utility-first
• svelte-dnd-action - Drag and drop para Kanban

Qualidade e Ferramentas

• Biome - Linting e formatacao rapidos
• pnpm - Gerenciador de pacotes eficiente

📦 Instalacao

Pre-requisitos

• Node.js 20+
• pnpm 8+
• Conta Supabase (plano gratuito funciona)

Inicio Rapido

1. Clone o repositorio

git clone https://github.com/gabrielmaialva33/jim-consultoria.git
cd jim-consultoria

2. Instale as dependencias

pnpm install

3. Configure o ambiente

cp .env.example .env

Preencha suas credenciais do Supabase:

PUBLIC_SUPABASE_URL=url-do-seu-projeto
PUBLIC_SUPABASE_ANON_KEY=sua-anon-key

4. Execute as migrations do banco

# Usando Supabase CLI
supabase db push

5. Inicie o servidor de desenvolvimento

pnpm dev

6. Abra no navegador

Acesse http://localhost:5173

🚀 Uso

Gestao de Leads

1. Navegue ate Admin > Leads no painel
2. Clique em Novo Lead para adicionar um contato
3. Preencha os dados da organizacao, areas culturais e interesses em editais
4. O sistema calcula automaticamente a pontuacao de elegibilidade
5. Arraste leads entre as etapas do pipeline no quadro Kanban

Exploracao de Editais

1. Acesse a pagina Editais para explorar projetos aprovados
2. Filtre por programa: ProAC ICMS, ProAC Editais, PNAB
3. Pesquise por nome do projeto ou proponente
4. Visualize detalhes do projeto e informacoes de financiamento

Gestao de Tarefas

1. Crie tarefas vinculadas a leads especificos
2. Defina niveis de prioridade e datas de vencimento
3. Acompanhe o progresso e marque como concluido

🛠️ Comandos

pnpm dev          # Inicia servidor de desenvolvimento
pnpm build        # Build de producao
pnpm preview      # Preview do build de producao
pnpm check        # Verificacao de tipos TypeScript
pnpm lint         # Verifica com Biome
pnpm lint:fix     # Corrige problemas de lint automaticamente

📝 Licenca

Este projeto esta sob a licenca MIT. Veja LICENSE para detalhes.

🤝 Contribuindo

Contribuicoes sao bem-vindas! Sinta-se a vontade para enviar um Pull Request.

1. Faca um fork do projeto
2. Crie sua branch de feature (git checkout -b feature/RecursoIncrivel)
3. Commit suas alteracoes (git commit -m 'Adiciona recurso incrivel')
4. Push para a branch (git push origin feature/RecursoIncrivel)
5. Abra um Pull Request

👥 Autor

Feito com ❤️ por Maia

gabrielmaialva33@gmail.com  |  @gabrielmaialva33

Jim Consultoria - Fortalecendo Projetos Culturais no Brasil

© 2017-presente Maia