Benvenuto

FireFeed è una piattaforma commerce SaaS multi-tenant composta da due moduli coordinati:

• il Feed Manager, per importare, normalizzare e distribuire cataloghi prodotto;
• l'OMS, per gestire canali di vendita, ordini, clienti, disponibilità, fulfillment, spedizioni e resi.

Questa documentazione copre due livelli:

Vista prodotto

Per stakeholder, project manager e team non-tecnici. Spiega cosa fa FireFeed e come funziona la pipeline, senza scendere nell'implementazione.

• Panoramica — il prodotto in 2 minuti
• Pipeline — i 5 step FETCH → PARSE → MERGE → RULES → EXPORT
• Concetti chiave — progetti, sources, regole, esportazioni
• Multi-tenant — isolamento dati per company
• Stato & roadmap — dove siamo, dove andiamo

Guide operative

• Primi passi — accesso, organizzazione e navigazione
• Canali marketplace — connessioni, credenziali e attivazione
• Ordini — acquisizione e lavorazione degli ordini
• Magazzino — giacenze, movimenti, trasferimenti e inventari fisici
• Spedizioni — fulfillment, etichette e tracking
• Resi — RMA, ricezione, rimborsi e portale pubblico
• Automazioni e Operations — regole e gestione delle anomalie

Architettura & API

Per chi sviluppa o opera il sistema.

• Stack tecnico — Next.js, Fastify, Postgres, Redis e Keycloak
• Auth & SSO — NextAuth v5 + Keycloak 26
• Deploy — Docker Compose, reverse proxy
• Setup locale — come avviare FireFeed in dev
• Architettura OMS — dominio, ledger, outbox e integrazioni
• API reference — spec web/worker generate da Zod e catalogo OMS
• API OMS — catalogo e convenzioni delle API del modulo OMS
• Setup super-admin — provisioning iniziale