OuroAutomation/ai-dashboard-starter

O que ai-dashboard-starter faz?

Starter genérico SvelteKit + Supabase extraído do Marketing OS: autenticação, RBAC v2, monitoramento de erros, framework de agente de IA, Vercel Workflow e shell de interface.

Visão Geral

Este projeto fornece uma base robusta e pronta para produção para construir aplicações de dashboard modernas. Ele aproveita o poder do SvelteKit para renderização eficiente e roteamento flexível, combinado com Supabase para backend serverless (autenticação, banco de dados, armazenamento).

Funcionalidades Principais

• Autenticação: Sistema completo de login/registro com Supabase Auth, incluindo provedores OAuth.
• RBAC v2: Controle de acesso baseado em funções refinado, permitindo gerenciar permissões de forma granular.
• Monitoramento de Erros: Integração com serviços como Sentry ou similar para rastreamento de exceções em tempo real.
• Framework de Agente de IA: Estrutura pronta para integrar e gerenciar agentes de inteligência artificial dentro da aplicação.
• Vercel Workflow: Suporte a automações serverless usando Vercel Workflow (anteriormente conhecido como Vercel Functions + Cron).
• Shell de Interface (UI): Conjunto de componentes de interface reutilizáveis e estilizados, incluindo navegação, painéis e formulários.

Pré-requisitos

• Node.js 18+ e npm/pnpm/yarn
• Conta no Supabase (gratuita) e Vercel (opcional para deploy)
• Conhecimento básico de SvelteKit e Supabase

Como Usar

1. Clone este repositório:

   git clone https://github.com/OuroAutomation/ai-dashboard-starter
   cd ai-dashboard-starter
   

2. Instale as dependências:

   npm install
   

3. Configure as variáveis de ambiente: copie .env.example para .env e preencha com suas credenciais do Supabase.
4. Inicie o servidor de desenvolvimento:

   npm run dev
   

5. Acesse http://localhost:5173.

Estrutura de Pastas

src/
  lib/
    components/   # Componentes de UI reutilizáveis
    server/       # Lógica de backend (endpoints, helpers)
    stores/       # Stores do Svelte para estado global
  routes/         # Rotas do SvelteKit
  app.html        # Template HTML principal
  app.css         # Estilos globais
supabase/
  migrations/     # Migrações do banco de dados Supabase

Personalização

• Temas: Altere as variáveis CSS em src/app.css ou substitua a UI shell por seus próprios componentes.
• Agentes de IA: Edite os arquivos em src/lib/server/ai/ para adicionar ou modificar comportamentos dos agentes.
• Workflows: Os arquivos de workflow do Vercel ficam em workflows/ (ou conforme configurado no vercel.json).

Deploy

Para fazer deploy na Vercel:

npx vercel deploy

Licença

MIT - Veja o arquivo LICENSE para mais detalhes.

Contribuição

Contribuições são bem-vindas! Abra uma issue ou envie um pull request.

---

Este starter foi extraído do Marketing OS pela OuroAutomation.