Torna alla home

Documentazione

Ultimo aggiornamento:

Ti diamo il benvenuto nella documentazione di SM Supports. Questa guida completa ti aiuta a conoscere il nostro processo di sviluppo, le tecnologie che usiamo, le integrazioni API e le buone pratiche per lavorare con i nostri servizi.

Primi passi

Segui questi passaggi per iniziare con i servizi e i progetti di SM Supports.

  1. Consulenza iniziale

    Prenota una chiamata di consulenza gratuita per parlare di requisiti, obiettivi e tempistiche del tuo progetto.

    Prenota una chiamata

  2. Pianificazione del progetto

    Creiamo un piano di progetto dettagliato con ambito, fasi, consegne e tempistiche. Riceverai una proposta completa che descrive ogni aspetto del progetto.

  3. Sviluppo e collaborazione

    Il nostro team avvia lo sviluppo con confronti e aggiornamenti regolari. Avrai accesso agli ambienti di test (staging) per verificare i progressi e dare il tuo parere in ogni fase.

  4. Lancio e assistenza

    Dopo test approfonditi e la tua approvazione, mettiamo online il progetto. Offriamo assistenza continua, manutenzione e documentazione per garantirne il successo nel tempo.

Tecnologie che usiamo

Usiamo tecnologie moderne e leader del settore per creare applicazioni scalabili e performanti.

Sviluppo frontend

  • Next.js 15 - framework React con App Router
  • React 18 - libreria UI basata su componenti
  • TypeScript - JavaScript con tipizzazione statica
  • Tailwind CSS - framework CSS utility-first
  • Framer Motion - libreria per le animazioni

Backend e API

  • Node.js - ambiente di esecuzione JavaScript
  • Next.js API Routes - funzioni serverless
  • API REST - architettura RESTful
  • Cloudflare Workers - edge computing
  • Resend - servizio di invio email

Database e archiviazione

  • Cloudflare D1 - SQLite serverless
  • PostgreSQL - database relazionale
  • MongoDB - database NoSQL
  • Redis - cache in memoria

Piattaforme e strumenti

  • Wix - piattaforma per creare siti web
  • Velo (Wix Code) - funzionalità personalizzate
  • Git & GitHub - controllo di versione
  • Vercel - piattaforma di rilascio

Riferimento API

Documentazione dei nostri endpoint API e dei servizi di integrazione.

POST /api/contact

Invia una richiesta tramite il modulo di contatto

POST

Corpo della richiesta:

{
  "name": "string",
  "email": "string",
  "subject": "string",
  "message": "string"
}

Risposta (200):

{
  "success": true,
  "message": "Message sent successfully"
}

POST /api/schedule

Prenota un incontro di consulenza

POST

Corpo della richiesta:

{
  "name": "string",
  "email": "string",
  "company": "string",
  "date": "string",
  "time": "string",
  "timezone": "string",
  "projectType": "string",
  "description": "string"
}

GET /api/timeslots

Recupera le fasce orarie disponibili per la prenotazione

GET

Parametri della query:

?date=2025-10-02&timezone=America/New_York

Risposta (200):

{
  "availableSlots": ["09:00", "10:00", "14:00"],
  "bookedSlots": ["11:00", "15:00"]
}

Rilascio e hosting

Pubblichiamo le applicazioni su piattaforme leader del settore per garantire prestazioni e affidabilità ottimali.

Vercel (piattaforma principale)

La nostra piattaforma principale per il rilascio di applicazioni Next.js, con CI/CD automatica, edge function e CDN globale.

  • Rilasci automatici da Git
  • Rilasci di anteprima per le pull request
  • Rete edge con oltre 100 località
  • Analisi e monitoraggio integrati

Cloudflare Pages e Workers

Piattaforma di edge computing per funzioni serverless, database D1 e hosting di siti statici.

  • Database SQLite D1 serverless
  • Workers per l'edge computing
  • Archiviazione a oggetti R2
  • Protezione DDoS e sicurezza

Soluzioni di hosting personalizzate

Lavoriamo anche con diversi fornitori di hosting, in base alle esigenze del progetto.

  • AWS (EC2, S3, CloudFront, Lambda)
  • DigitalOcean (Droplets, App Platform)
  • Netlify (siti statici, edge function)
  • Heroku (rilasci tramite container)

Buone pratiche

Linee guida e consigli per lavorare ai progetti di SM Supports.

Qualità del codice

  • Usa TypeScript per la sicurezza dei tipi e una migliore esperienza di sviluppo
  • Segui le configurazioni di ESLint e Prettier per uno stile di codice coerente
  • Scrivi messaggi di commit chiari secondo lo standard Conventional Commits
  • Mantieni i componenti piccoli, mirati e riutilizzabili
  • Documenta la logica complessa e le interfacce API

Ottimizzazione delle prestazioni

  • Ottimizza le immagini con il componente Image di Next.js
  • Usa il caricamento differito (lazy loading) per i contenuti sotto la piega
  • Usa i React Server Components dove possibile
  • Riduci le dimensioni del bundle con code splitting e tree shaking
  • Memorizza nella cache in modo adeguato le risposte API e le risorse statiche

Sicurezza

  • Non inserire mai dati sensibili o chiavi API nel controllo di versione
  • Usa le variabili d'ambiente per la configurazione
  • Implementa una corretta validazione e sanificazione degli input
  • Usa HTTPS per tutti i rilasci in produzione
  • Mantieni aggiornate le dipendenze per correggere le vulnerabilità di sicurezza

Accessibilità (A11y)

  • Usa elementi HTML semantici (nav, main, article, ecc.)
  • Aggiungi un testo alternativo a tutte le immagini
  • Garantisci un contrasto cromatico adeguato
  • Rendi gli elementi interattivi accessibili da tastiera
  • Esegui test con screen reader e strumenti per l'accessibilità

Risoluzione dei problemi

Problemi comuni e relative soluzioni.

Errori di compilazione

Problema: la compilazione non va a buon fine per errori TypeScript o ESLint

Soluzione:

  • Esegui npm run lint per individuare i problemi
  • Verifica che in package.json non manchino dipendenze
  • Assicurati che tutti gli import siano tipizzati correttamente
  • Svuota la cartella .next e ricompila il progetto

Problemi di connessione alle API

Problema: gli endpoint API restituiscono errori o vanno in timeout

Soluzione:

  • Verifica che le variabili d'ambiente siano impostate correttamente
  • Controlla i limiti di frequenza e le quote delle API
  • Controlla le impostazioni CORS per le richieste cross-origin
  • Tieni d'occhio la scheda Rete negli strumenti per sviluppatori del browser

Problemi di prestazioni

Problema: pagine lente a caricarsi o punteggi Lighthouse bassi

Soluzione:

  • Ottimizza le immagini (usa il formato WebP e dimensioni adeguate)
  • Attiva il lazy loading per immagini e componenti
  • Riduci le dimensioni del bundle JavaScript
  • Usa la cache edge per le risposte API
  • Implementa stati di caricamento adeguati

Ti serve altro aiuto?

Non trovi quello che cerchi? Il nostro team è qui per aiutarti con qualsiasi domanda o richiesta di assistenza tecnica.

Email:
[email protected]
Telefono:
(+880) 13013-60818
Orari:
lun–ven, 9:00–18:00 (ora del Bangladesh, BST)
Contatta l'assistenzaPrenota una chiamata