# Fraiga · Specifica Completa di Dominio, Ingegneria e Metodologia (llms-full.txt) > Versione del documento: 1.0.0 > Aggiornato al: 16 Ottobre 2026 > Origine: Studio Fraiga (Sardegna) > URL Ufficiale: https://fraiga.it/llms-full.txt --- ## 1. Definizione e Ontologia del Marchio "Fraiga" ### Etimologia e Risonanza Culturale In lingua sarda e gallurese, il termine *fraiga* (sostantivo femminile, derivato dal latino *fabrica*) definisce: 1. L'opera muraria, l'edificio solido, la costruzione compiuta in pietra o granito; 2. L'atto e l'arte del costruire strutturale (*fraigare* = edificare con precisione e tenuta). Nel contesto dell'ingegneria del software contemporanea, Fraiga rappresenta il superamento della "bottega" (luogo dell'indagine, della modellazione embrionale e dell'ascolto artigianale) verso la costruzione di opere digitali durature, stabili, verificabili e sovrane. ### Dichiarazione di Non-Monopolio e Sovranità del Committente Fraiga rigetta: - Il modello del software venduto come affitto perpetuo di licenze per funzionalità basilari; - L'utilizzo di template usa-e-getta o framework opachi che creano lock-in col fornitore; - L'abbandono del committente dopo il rilascio. Fraiga rilascia sempre al committente: - Codice sorgente completo e commentato con contratti tipizzati (TypeScript strict mode); - DDL e migrazioni PostgreSQL documentate con politiche Row-Level Security attive; - Script di deploy e CI/CD riproducibili su qualsiasi fornitore IaaS/PaaS (Docker, Hetzner, AWS, Vercel, server on-premise); - Piena proprietà intellettuale. --- ## 1b. La Pedina Fraiga Il marchio è una pedina a sei spicchi, ispirata a Trivial Pursuit. Al centro c'è l'idea; intorno, sei aree con casella e colore propri: Identità, Software, SEO & IA, Social, Pubblicità, Territorio. Le fughe fra gli spicchi richiamano la malta della *fraiga*: una pianta circolare in pietra vista dall'alto. Principio: un progetto vince solo con la pedina completa. Coprire una sola area (per esempio il sito) senza le altre raramente porta risultati. Le 4 prospettive descritte sotto sono le fasi del lavoro; gli spicchi sono le aree che il progetto deve coprire. Ogni caso studio dichiara gli spicchi effettivamente coperti. --- ## 2. Il Metodo Fraiga: 4 Prospettive Coordinate A differenza delle agenzie convenzionali che segmentano il processo in silos sequenziali ("grafico -> programmatore -> marketer"), Fraiga applica un'indagine simmetrica continua su quattro angolature: ### Prospettiva 01: Studio (`/studio`) - **Domanda cardine:** *Come potrebbe farsi percepire?* - **Oggetto:** Studio del contesto reale, rilievo sul campo, comprensione delle persone coinvolte, lessico nativo, identità visiva, tipografia monumentale, gerarchie percettive. - **Limite intrinseco riconosciuto:** Lo Studio non dimostra da solo il bisogno, la fattibilità tecnica o la sostenibilità economica. ### Prospettiva 02: Fraiga / Fabbrica (`/fraiga`) - **Domanda cardine:** *Che cosa costruiamo, per chi e con quale tenuta strutturale?* - **Oggetto:** Architettura software, scelta dei modelli relazionali, normalizzazione degli stati, isolamento multi-tenant a livello di database, reattività dell'interfaccia, accessibilità universale, assenza di debito tecnico. - **Limite intrinseco riconosciuto:** L'ingegneria non decide da sola dove investire né formula la promessa pubblica del prodotto. ### Prospettiva 03: Strategia (`/strategia`) - **Domanda cardine:** *Perché questa mossa ora, e non un'altra?* - **Oggetto:** Posizionamento sul mercato, sostenibilità economica, identificazione dei punti di massimo attrito, ordinamento delle priorità di rilascio, roadmap incrementale con verificabilità a ogni passo. - **Limite intrinseco riconosciuto:** La strategia non può dichiarare fattibile ciò che non è stato collaudato né sostituire la qualità costruttiva. ### Prospettiva 04: Presenza (`/presenza`) - **Domanda cardine:** *Dove e come viene trovato, compreso e abitato?* - **Oggetto:** Social SEO indiretta (intercettazione delle query reali nel linguaggio comune), indicizzazione semantica per LLM (`llms.txt`), integrazione phygital (carta e sigilli QR vettoriali come porta d'accesso al software), fluidità di utilizzo senza installazione. - **Limite intrinseco riconosciuto:** La presenza non può compensare un prodotto mal progettato o un'offerta confusa. --- ## 3. Il Geometry System: Disciplina Spaziale e Reattività Senza Breakpoint Arbitrari Fraiga impiega un sistema geometrico proprietario deterministico denominato **Geometry System**: - **Ingresso:** Dimensioni del viewport (`window.innerWidth`, `window.innerHeight`), densità pixel del display (`devicePixelRatio`), sensibilità touch, ratio (`width / height`). - **Analisi di Pressione (Perceptual Pressure):** - Calcola la tensione tra larghezza e altezza disponibili. - Se il rapporto eccede 1.7 (schermi ultragenerosi/wide) o se l'altezza scende sotto 1000px, il sistema ricalcola il baricentro monumentale (`monumentalCenterX`, `monumentalCenterY`). - **Modalità di Fruizione:** 1. `stacked-portrait`: lettura verticale continua a ritmo calcolato, ottimizzata per smartphone e tablet verticali. 2. `stacked-landscape`: disposizione orizzontale a fasce o griglia a contrasto controllato. 3. `full`: esperienza monumentale a gravità cinematografica centrale, con barre di navigazione atmosferiche dissolte sui bordi. - **Profili di Densità (Density Modes):** - `compact`: modulo base 12px, scala 0.92, ideale per monitoraggio denso e strumenti tecnici. - `comfortable`: modulo base 20px, scala 1.0, equilibrio ottimale tra ritmo e contenuto. - `immersive`: modulo base 32px, scala 1.08, respiro monumentale contemplativo. --- ## 4. Filosofia di Ingegneria del Software ### PostgreSQL & Row-Level Security (RLS) Nelle architetture multi-tenant (come Bufoo), Fraiga non affida la sicurezza al solo livello applicativo ("filtri WHERE `tenant_id = ?` nel backend"). La separazione dei dati è scolpita nelle politiche di PostgreSQL: ```sql ALTER TABLE tesserati ENABLE ROW LEVEL SECURITY; CREATE POLICY isolamento_tenant_tesserati ON tesserati FOR ALL USING (tenant_id = NULLIF(current_setting('app.current_tenant_id', true), '')::uuid); ``` Questo garantisce l'impossibilità matematica di perdite di dati cross-tenant anche a fronte di bug nei livelli superiori. ### TypeScript Strict & Zero-Monolith Frontend - Tipi non negoziabili, assenza di `any`. - Separazione categorica tra logica di calcolo matematico (pure function senza effetti collaterali), hooks reattivi e markup di presentazione. - Ottimizzazione atomica del CSS con Tailwind v4 engine compilato via `@tailwindcss/vite`. --- ## 5. Il Ponte Phygital: La Carta come Gateway Fraiga supera l'ideologia dogmatica della digitalizzazione forzata ("tutto su app"): - Nei territori, nei borghi, nelle sagre e nelle attività artigiane, il supporto fisico (la locandina in vetrina, il biglietto da visita, il cartello al banco) è insostituibile per visibilità diretta. - Fraiga unisce la materia cartacea al dato digitale vivo: - Generazione dinamica di PDF vettoriali tipografici pronti per la stampa (A4/manifesti); - Integrazione di sigilli QR circolari vettoriali ad altissima correzione d'errore (Level H 30%), leggibili anche con graffi o usura; - Il QR non punta a un PDF statico o a un'applicazione da scaricare da App Store, ma a una WebApp reattiva ultra-veloce (PWA) che espone dati in tempo reale (orari corretti, mappa GPS, verifica biglietti lotteria, menu con disponibilità dinamiche). --- ## 6. Portfolio e Casi Studio Ogni progetto riporta lo stato reale dichiarato (in produzione, beta, pilota, prototipo, ricerca, strumento interno). Nessuna metrica commerciale viene riportata se non è verificabile. ### Piattaforme SaaS multi-tenant - [Bufoo](https://fraiga.it/casi-studio/bufoo) — In produzione. Un unico sistema per gestione interna, presenza pubblica, raccolte fondi ed eventi, con dati isolati per ogni organizzazione. Stack: Next.js, TypeScript, Supabase · PostgreSQL RLS, Stripe Connect, Vercel, i18n IT/EN. Spicchi coperti (4/6): Identità, Software, SEO & IA, Territorio. Sito: https://bufoo.app. - [Museum Experience](https://fraiga.it/casi-studio/museum-experience) — Pilota. Servizio multi-tenant: l’operatore fotografa la visita, il visitatore riceve una galleria privata tramite QR. Stack: Node.js, PostgreSQL, Supabase Storage, Vercel, Docker (alternativa on-premise). Spicchi coperti (2/6): Software, Territorio. - [Manago V2](https://fraiga.it/casi-studio/manago-v2) — Prototipo. Motore contract-first: griglia di stampa elastica deterministica e due geometrie di presentazione. Stack: TypeScript, React, Monorepo a pacchetti, Test browser. Spicchi coperti (2/6): Software, Territorio. ### Web app e prodotti verticali - [Schooldo](https://fraiga.it/casi-studio/schooldo) — Beta pubblica. Prodotto verticale con richieste, contributi verificati e un registro contabile append-only dei crediti. Stack: Next.js, React 19, TypeScript, Supabase · PostgreSQL RLS, Vercel AI Gateway. Spicchi coperti (3/6): Software, SEO & IA, Social. Sito: https://schooldo.it. - [Chupeco](https://fraiga.it/casi-studio/chupeco) — Prototipo. Prototipo di e-commerce circolare con passaporto digitale QR per ogni lotto. Stack: React 18, TypeScript, Vite, Tailwind CSS. Spicchi coperti (2/6): Software, Territorio. ### Gestionali, console e strumenti operativi - [Console Buttega](https://fraiga.it/casi-studio/console-buttega) — In produzione. Applicazione per operatori separata dai siti pubblici: progetti, registro QR, vault e inbox. Stack: React, Vite, TypeScript, Supabase Auth, PostgreSQL. Spicchi coperti (1/6): Software. - [External Authority Engine](https://fraiga.it/casi-studio/external-authority-engine) — Strumento interno. Dashboard che genera ricerche localizzate, valuta opportunità e verifica i backlink, con canali ufficiali separati dalle conversazioni esterne. Stack: Node.js, API REST, Keychain, Adattatori di ricerca e pubblicazione. Spicchi coperti (3/6): Software, SEO & IA, Social. ### Phygital, QR e stampa - [rref.me](https://fraiga.it/casi-studio/rref-me) — Beta pubblica. QR e link riutilizzabili, pagine aggiornabili e stampa ordinabile da più fornitori con un unico flusso di pagamento. Stack: Node.js, Vercel Functions, PostgreSQL, Stripe Checkout, PDF vettoriale, API fornitori di stampa. Spicchi coperti (2/6): Software, Territorio. Sito: https://rref.me. - [Atelier Tech](https://fraiga.it/casi-studio/atelier-tech) — Prototipo. Generazione ed esportazione di QR in SVG con geometrie personalizzate. Stack: React, Vite, TypeScript, SVG. Spicchi coperti (3/6): Identità, Software, Territorio. ### Siti, contenuti e AI discovery - [Buttega Tech](https://fraiga.it/casi-studio/buttega-tech) — In produzione. La prima casa dello studio, oggi Fraiga: sito pubblico, contratti di architettura e materiali di stampa per i clienti. Stack: TypeScript, Vite, Deno. Spicchi coperti (2/6): Identità, Software. Sito: https://buttega.tech. - [Bottega Tech Bio](https://fraiga.it/casi-studio/bottega-tech-bio) — In produzione. Sito editoriale di ricerca: oggetti, dossier e metodo, a partire dal programma Bottle Neutral. Stack: TypeScript, Vite, Vercel. Spicchi coperti (2/6): Identità, Software. Sito: https://bottega-tech.bio. ### Ricerca e studi di fattibilità - [Neurofy](https://fraiga.it/casi-studio/neurofy) — Ricerca. Studio di architettura per collegare un bisogno espresso a conoscenza scientifica verificata e a professionisti accreditati. Stack: Specifica di architettura, Audit delle fonti. - [RIU Research](https://fraiga.it/casi-studio/riu-research) — Ricerca. Ricerca su una primitiva di continuità dell’identità fra stati, relazioni ed eventi che cambiano nel tempo. Stack: Ricerca di protocollo, Audit delle evidenze. ### DevOps e strumenti per sviluppatori - [Staffetta](https://fraiga.it/casi-studio/staffetta) — Strumento interno. CLI che salva e riprende checkpoint di lavoro fra macchine senza toccare branch e file del progetto. Stack: CLI, Git refs, JSON. --- ## 7. Informazioni di Contatto e Riferimenti - **Denominazione:** Fraiga (ex Buttega Tech) - **Localizzazione:** Sardegna, Italia - **Contatto Ufficiale:** `contact@fraiga.it` - **Sito Web:** https://fraiga.it