# Un portale B2B per le divise di una rete di negozi, costruito per una gara.

> Una gara chiedeva un portale con cui i punti vendita di una rete ordinassero le divise del personale, con kit gratuiti, riordini a pagamento e due marchi separati. L'abbiamo costruito con un agente di sviluppo AI e la revisione di persone, e l'abbiamo messo online come demo con dati inventati.

- Settore: E-commerce
- Ambito: Sviluppo software
- Stato: In corso
- URL: https://cloudfactory.it/progetti/portale-b2b-ordini-divise/

## In breve

Per una gara abbiamo sviluppato un portale B2B in cui i punti vendita di una rete ordinano divise e accessori: negozi in franchising con il codice negozio, agenzie che gestiscono corner nella grande distribuzione, amministratori della sede con perimetri separati. Il portale gestisce i kit gratuiti per addetto o per punto vendita, i riordini a pagamento al listino del canale, il magazzino, il tracking e i report. È un'applicazione Laravel 13 e Filament 5 per AWS nella regione di Milano, sviluppata con Claude Code a partire da un brief scritto, senza dati reali, e rivista da persone.

- **2** marchi serviti dalla stessa applicazione, con catalogo, listini, carrello e colori separati
- **3** canali con regole diverse: negozi diretti, franchising e grande distribuzione
- **13** requisiti funzionali della gara coperti dalla demo
- **0** dati reali forniti all'AI durante lo sviluppo

## Contesto

Il committente ha una rete nazionale di punti vendita con personale in divisa: negozi diretti, negozi in franchising e corner nella grande distribuzione seguiti da agenzie, su due marchi. La gara chiedeva un portale cloud sviluppato dal fornitore, accessibile dal browser e dallo smartphone, con regole diverse per ogni canale e le condizioni di sicurezza di un grande gruppo.

## Il problema

Le regole non erano quelle di un e-commerce. Il primo kit è gratuito e calcolato sul numero di addetti, i corner hanno un budget per agenzia, gli ordini dei negozi diretti nascono nel sistema acquisti della sede e nel portale vanno solo tracciati. Ogni amministratore deve vedere solo il proprio perimetro e i due marchi devono restare separati, anche nei colori. Le condizioni di sicurezza del committente vietano software fuori supporto e chiedono un penetration test prima della messa online.

## Cosa abbiamo fatto

1. **Le regole nel codice, non nei plugin.** Kit per addetto e per punto vendita, plafond autorizzati dagli ordini della sede, perimetri degli amministratori: sono scritti nell'applicazione e coperti da test automatici, compreso il caso di due ordini simultanei sullo stesso plafond.
2. **Due marchi, un'applicazione.** Ogni marchio ha catalogo, listini, carrello e colori propri; le agenzie scelgono il marchio all'ingresso. Nome, colori e logo si cambiano dal pannello, così un rebranding è una configurazione.
3. **Ordini della sede senza integrazioni fragili.** Gli ordini e le autorizzazioni decisi nel sistema acquisti della sede entrano nel portale da file CSV, con il riepilogo delle righe scartate e del motivo. Il portale traccia spedizioni e scarico di magazzino anche per i negozi che non hanno un accesso.
4. **Sicurezza progettata per un grande gruppo.** Account AWS dedicato a Milano, firewall applicativo, server e database in rete privata, nessuna porta SSH aperta, autenticazione a due fattori, registro delle operazioni, componenti con supporto lungo. Alle condizioni di sicurezza del committente abbiamo risposto punto per punto.
5. **Sviluppato con l'AI, rivisto da persone.** Claude Code ha scritto il codice partendo da un brief tecnico, con soli dati inventati e nessuna funzione AI nel prodotto, come previsto dal codice di condotta sull'AI del committente. Le parti critiche, cioè permessi, calcolo dei kit e pagamenti, le abbiamo riviste noi.

## Com'è andata

La demo è online con dati inventati e copre i 13 requisiti funzionali della gara. L'offerta è stata consegnata e l'esito non è ancora noto: per questo il caso è in corso. Per altre reti di negozi prepariamo una versione distinta della piattaforma, configurabile in poche settimane.

## Strumenti

Laravel 13, Filament 5, Livewire 4, PHP 8.5, MySQL 8.4, Ubuntu 26.04, AWS, Amazon SES, Stripe Checkout, Claude Code

## Domande frequenti

### Si può usare un e-commerce standard per le divise di una rete di negozi?

Per vendere sì, per gestire una rete meno: kit gratuiti per addetto, budget per agenzia, ordini decisi dalla sede e perimetri degli amministratori richiedono regole che un e-commerce standard copre solo con molte estensioni da mantenere.

### Come si collega al sistema acquisti della sede?

Con import ed export di file CSV ed Excel: ordini, autorizzazioni dei kit, anagrafiche, tracking e giacenze. Le integrazioni dirette via API si sviluppano su richiesta.

### Il codice resta al cliente?

Sì. Il cliente riceve il codice sorgente e un diritto d'uso perpetuo; il codice applicativo usa solo librerie open source con licenze permissive.

---

Cloudfactory S.r.l., Roma. Contatti: hello@cloudfactory.it
