Bandi AI Assistant
gignus79/Bandi-AI-Assistant
Análise inteligente de editais com chat e exports estruturados
Ver no GitHubAplicação Next.js que analisa bandi (editais) de financiamento extraindo automaticamente requisitos, scadências e critérios de avaliação via LLM. Oferece chat contextual, export em Markdown/PDF e integração com calendário, com autenticação Clerk e planos de uso via Stripe.
Instalação
npx convez-ai gignus79/Bandi-AI-Assistant1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gestores de fundos analisando requisitos de concessões
- Organizações compilando bandi em múltiplos formatos
- Consultores extraindo cronogramas e critérios de documentos complexos
Veredito

Solução técnica sólida para automação de leitura de editais com stack moderno (Next.js 15, TypeScript, Drizzle). Particularmente útil para públicos que lidam com documentação normativa complexa; suporte multi-LLM (OpenAI/Anthropic) e modelo de monetização robusto (Stripe) demonstram maturidade produtiva.
README
A tradução para o português deste README ainda está na fila.
Bandi AI Assistant
Applicazione Next.js per professionisti e organizzazioni che devono leggere bandi complessi: carica documenti o URL, ottieni analisi strutturate (requisiti, scadenze, criteri) e chat contestuale con output leggibile. Include autenticazione, piani di utilizzo e abbonamenti.
MediaMatter · Giorgio Lovecchio
Funzionalità principali
| Area | Contenuto |
|---|---|
| Ingestione | PDF, DOCX, fogli di calcolo, testo, immagini |
| Analisi | Sintesi, requisiti, scadenze, suggerimenti tramite modelli OpenAI / Anthropic |
| Chat | Assistente sul singolo bando, rendering Markdown con formattazione curata |
| Export | Markdown, PDF, calendario (.ics) |
| Business | Clerk (auth), Stripe (checkout abbonamenti), limiti d’uso e piani |
Stack tecnico
| Layer | Tecnologie |
|---|---|
| App | Next.js 15 (App Router), React 19, TypeScript, Tailwind CSS |
| Auth | Clerk (sessioni, OAuth, middleware) |
| Dati | PostgreSQL, Drizzle ORM |
| Pagamenti | Stripe Billing (Checkout, webhook) |
| AI | OpenAI API, Anthropic API (analisi e chat) |
| Test | Vitest (unit), ESLint |
Requisiti
- Node.js 18+
- Account Clerk, database PostgreSQL (es. Neon, Vercel Postgres)
- Chiavi LLM e opzionalmente Stripe per uso completo in locale/produzione
Avvio in locale
-
Clona il repository e installa le dipendenze:
git clone <url-del-repository> cd bandi-ai-assistant npm install -
Variabili d’ambiente: copia
.env.examplein.env.locale imposta i valori reali (solo in.env.local, mai in Git). -
Schema database:
npm run db:pushAlternativa con migrazioni SQL versionate:
npm run db:generateenpm run db:migrate. -
Sviluppo:
npm run dev
npm run build richiede le variabili obbligatorie in fase di build (chiavi Clerk pubbliche, NEXT_PUBLIC_APP_URL dove applicabile).
Script npm
| Comando | Uso |
|---|---|
npm run dev | Server di sviluppo |
npm run build / npm run start | Build e avvio produzione |
npm run lint | ESLint |
npm run test | Vitest (unit) |
npm run db:push | Sincronizza schema Drizzle → DB |
npm run db:generate / db:migrate | Migrazioni SQL (Drizzle) |
Sicurezza e segreti
- Non versionare
.env,.env.localné chiavi API. Template:.env.example. - Clerk: chiavi
pk_test_/sk_test_in sviluppo;pk_live_/sk_live_in produzione. AllineareNEXT_PUBLIC_APP_URLe domini nella dashboard Clerk. - Stripe:
STRIPE_SECRET_KEY,STRIPE_WEBHOOK_SECRETsolo server-side; il webhook verifica la firma delle richieste. - Clerk webhooks: endpoint
POST /api/webhooks/clerk, variabileCLERK_WEBHOOK_SIGNING_SECRET(signing secret della dashboard). L’URL in Clerk deve coincidere con il dominio pubblico dell’app. - LLM:
OPENAI_API_KEY,ANTHROPIC_API_KEYsolo su variabili server. - Database: connessione TLS (
sslmode=requiredove richiesto), accesso ristretto per ambiente. - Multi-app:
NEXT_PUBLIC_APP_SLUGper attribuzione deploy (metadata Clerk/Stripe/DB).
Deploy
Vercel: collegare il repository, impostare le variabili per Production (e Preview se serve). Webhook Stripe: https://<dominio>/api/webhooks/stripe. Webhook Clerk: https://<dominio>/api/webhooks/clerk con lo stesso signing secret di CLERK_WEBHOOK_SIGNING_SECRET. Ridistribuire dopo modifiche alle variabili.
Verifica locale
npm run test
npm run lint
npm run build
I test unitari coprono helper (URL, Markdown, identità app). E2E e integrazione con API esterne sono fuori scope.
Documentazione aggiuntiva
docs/— note interne (conformità, sicurezza).- Privacy e Cookie policy nell’app.
Licenza
Codice proprietario. Vedi LICENSE. Uso del servizio hosted e abbonamenti: termini in-app e Stripe Checkout.