DressAI.info

1. Architettura del Sistema

DressAI utilizza un'architettura serverless composta da un frontend statico (HTML/CSS/JS) ospitato su Cloudflare Pages e un backend Python su Google Cloud Run. Il backend orchestra una pipeline di analisi video che combina Google Gemini per l'analisi visiva primaria e Claude (Anthropic) per la cross-validazione.

Flusso Completo

2. Pipeline di Analisi Video

La pipeline si attiva automaticamente al ricevimento del webhook checkout.session.completed da Stripe. Ogni step ha gestione degli errori con notifica email al cliente in caso di fallimento.

Resilienza e Retry

Step della Pipeline

3. Piani e Tier

4. Specifiche Video e Compressione

Requisiti Video in Ingresso

Compressione ffmpeg per Tier

Estrazione Frame (Pro/Premium)

Invece di caricare il video compresso, per Pro e Premium estraiamo frame JPEG a 4 fps con risoluzione massima 1080p. Questo bypassa il limite interno di Gemini e fornisce 4x più frame.

Per Premium: anche 10 keyframe ai cambi di scena (soglia > 0.3).

Upload parallelizzato: ThreadPoolExecutor(max_workers=10) → ~20s per 740 frame (5x speedup).

5. Modelli AI Utilizzati

6. Costi in Token

Gemini calcola ~258 token per immagine. Per un video tipico di dressage (3–4 minuti), il conteggio varia significativamente tra i tier.

7. Costi in Euro per Analisi

Prezzi basati su listino API febbraio 2026. Video di riferimento: ripresa dressage ~3:40 minuti.

* Resend: 3.000 email/mese gratuite. Stripe: commissione EU standard carta.

Prezzi API di Riferimento (Feb 2026)

8. Sistema Gift (Regalo)

Il sistema Gift permette di acquistare un'analisi DressAI come regalo per un altro utente. Il flusso gestisce la separazione tra acquirente e destinatario, con possibilità di schedulare la consegna.

Flusso Gift

Metadata Gift (Stripe)

Email Generate nel Flusso Gift

9. Architettura Email

Tutte le email vengono inviate tramite Resend API con dominio verificato dressai.info.

Tipi di Email

Tempi di Consegna Stimati

10. Integrazioni e Servizi

11. Codici Sconto (Promotion Codes)

Il sistema utilizza Stripe Promotion Codes nativi, attivati tramite allow_promotion_codes=True nella Checkout Session. I codici sono gestiti interamente lato Stripe.

Architettura

Codici Attivi

Implementazione Backend

L'unica modifica al codice è nel servizio dressai-checkout (main.py):

session = stripe.checkout.Session.create(
    payment_method_types=["card"],
    line_items=[{"price": price_id, "quantity": 1}],
    mode="payment",
    allow_promotion_codes=True,   # abilita codici sconto
    success_url=f"{SITE_URL}/grazie.html?...",
    cancel_url=f"{SITE_URL}/servizio.html?cancelled=1",
    customer_email=email,
    metadata=checkout_metadata,
)

12. Report di Esempio

La cartella samples/ contiene report HTML di esempio (dati simulati) per ciascun tier e variante.

Usano lo stesso template Jinja2 (templates/report.html) del backend, renderizzati con dati fittizi. Sono self-contained (CSS inline).

13. Infrastruttura Cloud

Google Cloud Run — Servizi

Variabili d'Ambiente (Cloud Run)

Docker (Dockerfile)

FROM python:3.12-slim

# ffmpeg + weasyprint dependencies
RUN apt-get update && apt-get install -y --no-install-recommends \
    ffmpeg \
    libpango-1.0-0 libpangocairo-1.0-0 libpangoft2-1.0-0 \
    libgdk-pixbuf-2.0-0 libffi-dev libcairo2 \
    fonts-liberation \
    && apt-get clean && rm -rf /var/lib/apt/lists/*

WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .

ENV PORT=8080
CMD ["functions-framework", "--target=handle_webhook", "--port=8080"]

Dipendenze Python

functions-framework==3.*    # HTTP framework per Cloud Run
stripe==8.*                # Stripe SDK
google-genai==1.*          # Google Gemini SDK (nuova API)
anthropic==0.40.*          # Claude SDK
jinja2==3.*                # Template engine per report
requests==2.*              # HTTP client (download GDrive)
google-cloud-storage==2.*  # GCS per upload report
resend==2.*                # Email transazionali
weasyprint==68.*           # Generazione PDF certificato

14. Sicurezza e Privacy

15. Struttura del Progetto

Frontend (Cloudflare Pages)

Backend (Google Cloud Run)

16. Proprietà Intellettuale e Protezione del Marchio

Stato attuale

Il nome DressAI, il logo (cavallo vitruviano) e il dominio dressai.info sono attualmente protetti solo dal diritto d'autore automatico (Legge 633/1941 e Direttiva UE 2019/790). Il copyright tutela il codice sorgente, i contenuti editoriali e il design grafico, ma non protegge il nome commerciale dall'uso da parte di terzi.

Opzioni di registrazione del marchio

Classi di Nizza rilevanti

Cosa registrare

Procedura consigliata — UIBM (Italia)

Riepilogo costi UIBM

Eventuale estensione EUIPO successiva: €900 per 2 classi (protezione 27 stati UE).

Protezioni già in essere