๐ ๏ธ Stack ยท Tech + AI + Payments + Security + Skills
Stack lean e moderno. Tutto cloud-native. Free tier o piani entry per i primi mesi, scaling solo quando serve. Il principio: ogni tool deve avere una via di uscita (no vendor lock-in nemmeno per noi).
Stack Core ยท Prodotto
| Layer | Tool | Costo | Note |
|---|---|---|---|
| Frontend + Backend | Next.js 16.2.6 + React 19 | โฌ0 | PWA installabile da browser (iOS Safari + Android Chrome) ยท Vision 2027 React Native (70-80% code reuse) |
| 3D Dashboard | React Three Fiber v9 stable | โฌ0 | NucleoSphere centrale + 6 pianeti orbitanti. NO v10 alpha pre-10-Giu |
| DB + Auth + Storage + Realtime | Supabase eu-central-1 | Free โ $25/mo Pro | 47+9 tabelle MVP ยท pgvector ยท pg_cron ยท pgmq ยท RLS multi-tenant ยท project yqhixdqipojvgzfadufo (Frankfurt). Free tier: 500MB DB, 1GB storage, 50K MAU (sufficiente fino ~50 clienti) |
| Deploy + CDN | Vercel | $0 dev โ $20/mo Pro | multiverbe.com (landing) + multiverbe.app (dashboard) LIVE HTTPS. Hobby tier richiede upgrade a Pro appena hai clienti paganti (ToS) |
| Email transazionale Multiverbe | Brevo | Free 9K/mo โ $20/mo Pro 50K | Sender noreply@multiverbe.com via send.multiverbe.com (DNS verificato 2026-05-10). Decisione 2026-05-10: Brevo per Multiverbe (Resend resta solo per Metaverbe agenzia per evitare brand mix + reputation cross-contamination) |
| Email transazionale Metaverbe agenzia | Resend | Free 3.000/mo | Sender send.metaverbe.com (legacy setup) |
| AI Cervello Multimodale | Google Gemini API | ~$0.20/cliente/mo a regime | Powering Content Studio: img/video/audio + adattamento piattaforma + analisi performance. Tier free 1500 req/giorno per gemini-1.5-pro |
| AI-Assisted Development | Claude Code Max | โฌ110/mo (Gregorio) | Strumento principale BUILD phase Mag-Giu. Da rivalutare a luglio quando app in produzione |
| Workflow engine ยท Background agentico | Inngest cloud + Supabase Edge Functions (cron) | Free 50K runs/mo โ $25/mo | ๐ข Nuovo 2026-05-20 ยท sostituisce n8n + Python legacy. Workflow durable event-driven (auto-retry ยท idempotente ยท state checkpoint). Endpoint app.multiverbe.app/api/inngest (adapter inngest/express ยท SDK v4). Integrazione ufficiale VercelโInngest (org Inngest "Multiverbe", scope solo progetto multiverbe-app) auto-provisiona INNGEST_SIGNING_KEY + INNGEST_EVENT_KEY + sync on-deploy. App sincronizzata 2026-05-21 ยท 1ยช funzione live booking-reminder-smart (trigger booking/created). Loop AI agenti = Anthropic Tool Use native (NO LangGraph). Registrazione app via URL canonico pubblico multiverbe.app/api/inngest (path durabile ยท Inngest ri-sincronizza quello). Vercel "Protection Bypass for Automation" giร attivo (VERCEL_AUTOMATION_BYPASS_SECRET, dal 13 Mag); gli "unattached sync" dell'auto-sync integrazione (che colpisce l'URL deployment protetto) sono rumore cosmetico, non rompono la registrazione canonica ยท re-sync manuale solo se cambiano le funzioni |
| Backend Python (legacy MAIND) | Render.com | $7/mo โ $0 post-disable | ๐ด DEPRECATO 2026-05-10: 14 file Python + render.yaml archiviati in legacy/maind-python/. Sostituito da backend nuovo Next.js + Vercel functions + Inngest. Render service da disabilitare post-test (TODO founder) |
Stack AI ยท Routing 3-Tier
| Tier | Modello | % uso | Use case |
|---|---|---|---|
| 60% | Sonnet 4.6 | majority | User-facing real-time (chat, suggerimenti) |
| 30% | Haiku 4.5 | batch | Task interni (classificazione, dedup, embeddings) |
| 10% | Opus 4.7 | strategic | Decisioni complex (planning, reasoning) |
Specializzazioni:
- Mistral Medium 3 ยท email outreach (GDPR EU, host Francia)
- Kimi K2.6 ยท site builder (10-30 min generazione)
- Gemini 2.5 Flash ยท content multimodale (img/video/audio)
Cost discipline ยท architettura compounding:
- Anthropic prompt cache: -50/-80% input
- Semantic cache via embeddings Vercel KV/Upstash: hit 30-40%, -73% cost
- Embedding cache deterministico: -90% cost embedding
- Compounding: ~95% riduzione cost input vs baseline
- Stima a regime: ~CHF 4.80/cliente/mo a uso medio (margine 95%)
VIETATI: DeepSeek (Garante IT block) ยท OpenRouter (uso diretto API).
Stack Pagamenti ยท CH-Compliant
| Tool | Costo | Note |
|---|---|---|
| Stripe ยท carte credito/debito clienti CH + EU | 1.5% + โฌ0.25 transazione ยท nessun costo fisso | Setup: 3-4 ore + 1-2 giorni verifica |
| Datatrans o Payrexx ยท Twint per Svizzera | CHF 29-49/mese fisso + commissioni | Twint dominante in CH: 60%+ degli svizzeri lo usa. Stripe non supporta Twint diretto: serve partner certificato. Attivo solo dopo apertura conto CH (Q4 con GmbH) |
Stack Marketing & Outreach
| Tool | Costo | Note |
|---|---|---|
| Google Workspace ยท email domini Multiverbe | ~$6/utente/mo (~CHF 18/mo per 3 caselle) | Migrazione da Register.it webmail vecchia a info@/loris@/contact@multiverbe.com. Necessario per outreach professionale |
| Instantly o Lemwarm ยท email warmup + sequencer | ~$30/mese | Warmup automatico caselle multiverbe.com per evitare spam. Mentre Loris fa cold outreach da loris@metaverbe.com (dominio caldo), warmup parallelo multiverbe.com |
| Google Ads + Meta Ads ยท da Giugno | CHF 700-1.100/mo (Google 300-500 + LinkedIn 400-600) | Attivati in fase SELL Giugno. Budget iniziale modesto. Gregorio gestisce con supporto Claude Chrome |
| Apollo.io ยท prospect sourcing | Free 50 leads/mo | Sourcing primo mese Loris |
| Composio MCP ยท auto-publish | da definire | Meta Ads MCP ufficiale (mcp.meta.com/ads) per FB/IG + Composio Facebook MCP per posting Pages |
๐ 2026-05-10: anche Gregorio fa cold outreach in prima persona (founder-led ABM premium, parallelo a Loris).
Stack Domini & Infrastruttura
- Domini Register.it:
metaverbe.com+multiverbe.coma โฌ5,99/anno ciascuno (โฌ12/anno totale). Eventualemultiverbe.chpending decisione founder. Email migrate a Google Workspace. - GitHub: repository privati Gregorio. Free tier sufficiente fino a team grande.
- Cloudflare: DNS, SSL, DDoS protection. Free tier basta. Eventualmente Cloudflare Workers per edge functions.
- Sentry: error tracking app. Free tier 5K errors/mese, sufficiente fino a ~50 clienti.
- Plausible o Posthog: analytics interno (privacy-first, no Google Analytics sull'app stessa). $9-19/mese.
๐๏ธ Architettura Hosting Multi-tenant ยท come funziona
Aggiunto 2026-05-17 audit-batch ยท founder request "grafico hosting + multitenant". Mostra il flusso completo end-to-end: cliente PMI fa signup โ onboarding genera workspace isolato โ Site Builder pubblica โ sito live su sub-dominio o custom dominio. La chiave del multi-tenant รจ
workspace_id+ RLS su Supabase: ogni cliente vede SOLO i propri dati, anche se condividiamo lo stesso database fisico.
๐ฏ Spiegazione layer-by-layer
| Layer | Cosa fa | Tech | Multi-tenant safety |
|---|---|---|---|
| 1 ยท Cliente PMI | Signup founder via mobile/desktop | multiverbe.app PWA |
Auth Supabase + JWT con workspace_id claim |
| 2 ยท Dashboard SaaS | Onboarding 4-step + Site Builder Kimi + 6 Pianeti 3D | Vite 5 + React 19 + R3F v9 | Client-side query con auth.uid() ยท zero leak cross-workspace |
| 3 ยท Data + AI | Storage centrale tutti i tenant + Multiverbe AI orchestratrice | Supabase eu-central-1 ยท pgvector ยท pg_cron | RLS policy WHERE workspace_id = auth.uid() su tutte le tabelle ยท cliente A NON puรฒ mai leggere dati cliente B |
| 4 ยท Sites Runtime | Server-side render del sito pubblico per slug | Next.js 16 ยท ISR 60s ยท Edge Zurich | service_role bypassa RLS server-side (necessario per public read) ยท slugโworkspace_id resolve sicuro |
| 5 ยท DNS pubblico | Routing wildcard + custom domain | Vercel Pro wildcard + Cloudflare | Vercel Domains API auto-aggiunge subdomain idempotent (409 OK) |
| 6 ยท Visitatori finali | Browser visitatore โ sito cliente HTTPS | HTTP/2 ยท auto-SSL Let's Encrypt | Edge cache per slug ยท revalidate on publish โค5s |
๐ Garanzie di sicurezza multi-tenant
- RLS sempre attiva su tabelle cliente-facing (
sites,bookings,contacts,contents, ecc.) ยท skillmultiverbe-supabase-rls-patternsper audit pattern. service_rolekey MAI esposta client-side ยท solo server-side in Vercel env vars per Sites Runtime + webhook handlers.- Slug reserved blacklist (35 reserved:
admin,api,www,app,bos,sites,mail,ftp,dev,staging, ecc.) impedisce spoofing endpoint Multiverbe. - Rate limit per workspace su publish API (10/min) ยท check-slug API (30/min per IP).
- Backup PITR Supabase Pro ยท DR test quarterly (skill
dr-test).
Costi Mensili Totali ยท Stima Realistica
Mag ยท Build Phase ยท ~โฌ250/mese
| Voce | Costo |
|---|---|
| Claude Code Max ร2 (Opus + Sonnet) | โฌ220 |
| Domini | โฌ2 |
| Email warmup | $30 |
| API extra (Claude/Gemini/Kimi) | ~CHF 50 |
| Tutto il resto (free) | โฌ0 |
| Totale | ~โฌ250 + CHF 1.500 API spalmati 28gg |
Giu ยท Sell Phase ยท ~CHF 1.000/mese
| Voce | Costo |
|---|---|
| Stack base (sopra) | ~โฌ140 |
| Vercel Pro (1ยฐ cliente) | $20 |
| Brevo (volume) | $20 |
| Google Workspace | $18 |
| Google + Meta Ads | CHF 700 |
| Totale | ~CHF 1.000 |
Lug+ ยท Scale Phase ยท ~CHF 1.500-2.000/mese
| Voce | Costo |
|---|---|
| Stack a regime | ~CHF 250 |
| Twint via Datatrans | CHF 49 |
| Supabase Pro | $25 |
| Gemini API a volume | ~$50-100 |
| Ads scaling | CHF 1.000-1.500 |
| Totale | ~CHF 1.500-2.000 |
Hard rules tecniche
- Workspace isolation โ OGNI query DB filtra per
workspace_id. Skillmultiverbe-supabase-rls-patterns. - R3F v9 stable โ NO v10 alpha. Hard gate 10 Giu.
- DeepSeek MAI โ bloccato in Italia.
- SMTP โ credenziali in DB (
smtp_configs), NON in env var. - Direct DB Supabase รจ IPv6 only โ usare SQL Editor o MCP per DDL.
- RLS attivo su TUTTE le tabelle.
- Pseudonimizzazione obbligatoria prima di Anthropic (US, fuori EU Data Boundary). Helper:
frontend/.../src/lib/pii-pseudonymize.ts+ server-side equivalente. - OpenRouter MAI uso diretto API.
Sub-processor list (revFADP / GDPR)
Anthropic (US) ยท Mistral (FR) ยท Google Gemini (US) ยท OpenAI (post-Series-A only) ยท Stripe (US/IRL) ยท Datatrans/Payrexx (CH) ยท Brevo (FR โ transactional Multiverbe) ยท Resend (US โ Metaverbe agenzia only) ยท Vercel (US/EU) ยท Supabase (US/EU project Frankfurt) ยท Sentry (US/EU) ยท Cloudflare (US/global) ยท Register.it (IT โ DNS + mailbox SMTP).
๐๏ธ Principi Architetturali ยท Soliditร + Agentic by Design
L'architettura tecnica deve supportare un prodotto che cresce nel tempo senza riscritture continue. Principi non negoziabili. (Sezione duplicata in [[operations]] per cross-reference roadmap esecuzione.)
๐ค Agentic by Design
- Ogni pianeta รจ un agente: ha goal, puรฒ chiamare altri agenti via Centro, puรฒ pianificare task multi-step.
- Brand memory persistente: ogni decisione AI passa dalla brand memory del cliente (no allucinazioni off-brand).
- Tool-calling standardizzato: ogni satellite espone interfaccia AI-callable (function-calling Claude/Kimi/Gemini).
- Self-learning loop: il sistema osserva quali contenuti/strategie convertono e adatta brand memory automaticamente.
๐ก๏ธ Soliditร Tecnica
- Multi-tenancy via RLS Supabase: row-level security su ogni tabella. Zero data leak tra tenant.
- Type safety end-to-end: TypeScript strict, Zod validation su API, types Supabase generati.
- Test coverage minima 60%: unit + integration sui satelliti core (Web, Booking, CRM).
- Observability: Sentry errori, logging strutturato AI calls (cost + latency + outcome).
- Backup automatici: Supabase daily, retention 30gg.
๐ Scalabilitร Modulare
- Pianeti pluggable: nuovo pianeta = nuova folder + nuova entry nel router. Zero impatto sugli altri.
- API-first: ogni feature interna รจ prima un endpoint API, poi una UI. Permette integrazioni future enterprise.
- Multi-AI router: il Centro decide a runtime quale modello usare (Claude per reasoning, Kimi per code/UI, Gemini per multimodale, Haiku per task veloci).
- Cost-aware: ogni AI call loggata con cost. Budget alert per cliente se uso eccessivo.
Skills Claude Inventory
Cosa Loris/team trova installato il giorno 1. Source di veritร : CLAUDE.md root.
Skills custom Multiverbe (10) ยท ~/.claude/skills/
multiverbe-designโ Nebula Glass design system (PRIMA per UI)multiverbe-ch-complianceโ nDSG + GDPR + DPA + DSARmultiverbe-cold-outreach-chโ Loris playbook (cold email/call/DM W1-W4)multiverbe-r3f-patternsโ NucleoSphere + i Pianeti R3F (7 canonici ยท oggi 6 in scena, Finanza da aggiungere)multiverbe-sector-onboardingโ 5 macro ร 21 settori + AI fallbackmultiverbe-security-chโ Cybersecurity Swiss + periodic checksmultiverbe-stripe-checkout-edgesโ Revenue edge cases Stripemultiverbe-supabase-rls-patternsโ RLS deep + audit scriptmultiverbe-incident-responseโ 5-step playbook breach (4h target)metaverbe-agency-projectsโ Workflow agenzia (dual-business)
Slash commands custom (~/.claude/commands/)
/launch-checklistยท/security-weeklyยท/security-monthlyยท/dr-testยท/incident-startยท/loris-cadenceยท/giorno
Plugins ufficiali abilitati (15)
vercel ยท frontend-design ยท superpowers ยท plugin-dev ยท claude-md-management ยท supabase ยท coderabbit ยท stripe ยท code-review ยท security-guidance ยท feature-dev ยท playwright ยท skill-creator ยท github ยท context7
๐ Subscription tools security (iubenda, Klaro, Bitwarden, Aegis, Apollo, Yubikey, LinkedIn Sales Nav) โ vedi [[operations]] sub-section "Reminders Calendar + Subscription Tools". ๐ Skills extra dettaglio (BE sec-16 verbatim): cloned GitHub OSS (5), baseline n8n+ads+seo (32), Security Toolkit GitHub top 5 install pre-launch (gitleaks, trufflehog, OWASP skill, semgrep, supabase-mcp, trivy), context7 + Figma + Chrome DevTools MCP roadmap โ file dedicato
ops/be-sections-extra-2026-05-10.mdsezioni 6-9.
Ultimo update: 2026-05-11 ยท migrazione verbatim sec-06 Stack BE 4475-4630 + scenari costi Mag/Giu/Lug + Architettura Principi (cross-ref con [[operations]]) + Skills Inventory (sync con CLAUDE.md root). Brevo + Vercel multi-project + 21 settori + 10 custom skills + 6 slash commands + 15 plugins. Owner: Gregorio (decisioni stack) Skill chain: multiverbe-security-ch + multiverbe-supabase-rls-patterns + multiverbe-stripe-checkout-edges + multiverbe-ch-compliance