Pratix

Tutto torna.

Gestionale per avvocati freelance: pratiche, clienti, attività fatturabili, fatture (FatturaPA inclusa).

---

Cos'è Pratix

Pratix è il gestionale pensato per avvocati freelance italiani: nessun fronzolo, nessuna logica da grande studio associato. Solo gli strumenti che servono al singolo professionista per tenere in ordine pratiche, clienti, attività fatturabili e fatture, con piena conformità FatturaPA.

Il target esplicito è il professionista singolo: il prodotto evita il linguaggio degli studi associati (vedi glossario e tono di voce).

Avvio rapido

npm run setup   # usa npm 12 per installare le dipendenze
npm run dev     # avvia in locale
npm run build   # build di produzione
npm run lint    # linter

Le variabili d'ambiente (.env) non vanno committate. In produzione vivono su Vercel; il backend è il progetto Supabase di proprietà. Non modificare manualmente src/integrations/supabase/types.ts o src/routeTree.gen.ts.

Mappa della documentazione

File	Cosa contiene
README.md	Questo file: panoramica e indice
AGENTS.md	Regole operative per chi (umani o agenti) modifica il codice
BRAND.md	Guidelines di marca complete
docs/ROADMAP.md	Stato del prodotto per area, con legenda ✅🟡⬜💤
CHANGELOG.md	Storia delle modifiche significative
SECURITY.md	Come segnalare vulnerabilità
CONTRIBUTING.md	Come contribuire al progetto
LICENSE	Licenza d'uso
docs/INDEX.md	Indice canonico della documentazione

Infrastruttura

Pratix usa GitHub come fonte primaria, Codex come ambiente principale, Supabase di proprietà del progetto come backend e Vercel per pubblicazione e preview.

Documentazione approfondita

• 📖 Guide tematiche — architettura, database, fatturazione, tema, tono di voce, deploy, release e smoke test
• 🧰 Toolchain — runtime, comandi, verifiche e provider
• 🧭 Roadmap e backlog — stato, priorità e idee parcheggiate
• 📌 Contesto operativo — handoff rapido e vincoli da ricordare
• 🧠 Memoria di progetto — regole sempre attive (specchio leggibile di mem://)
• 🧭 Decision log (ADR) — perché abbiamo scelto cosa
• 📚 Glossario di dominio — termini legali e fiscali italiani

Stack tecnico

• Frontend: TanStack Start v1 (React 19, Vite 7, file-based routing)
• Backend: Supabase di proprietà del progetto con RLS, Auth passwordless, passkey dietro feature flag e Storage privato
• Deploy: Vercel, produzione su https://pratix.vercel.app
• Styling: Tailwind v4 con token semantici in src/styles.css
• UI: shadcn/ui + Radix + lucide-react
• Lingua UI: italiano (lang="it")

Dettagli in docs/guides/architettura.md.

Stato del progetto

In sviluppo attivo. Per lo stato puntuale di ogni area vedi docs/ROADMAP.md.

Licenza

Vedi LICENSE.