Le Piramidi Company

Benvenuti in Le Piramidi

Siamo lieti di accogliervi. Questa è la gateway API ufficiale di Le Piramidi — una piattaforma sicura e multilingue pensata per alimentare i nostri servizi digitali con affidabilità e cura.

Ambiente production Porta 3000 Stato Sano Lingue EN · AR · IT

MongoDB

Online

Database documenti con riconnessione automatica e profili utente

Redis

Online

Client cache con retry a backoff esponenziale

WebSocket

Online

Connessioni attive: 0

Socket.io con handshake protetto da JWT

Caricamento file

Online

Dimensione max: 5 MB (images), 20 MB (drawings)

Consentiti: image/jpeg, image/png, image/gif, image/webp, image/bmp, image/tiff, image/heic, image/heif, image/avif

Cosa alimenta Le Piramidi

Capacità principali già implementate e pronte per i nostri prodotti e team.

Livello di sicurezza

  • Header di sicurezza Helmet
  • CORS con allowlist delle origini
  • Rate limiting su rotte globali e auth
  • Guardia JWT Bearer

Internazionalizzazione

  • Locali inglese, arabo e italiano
  • Messaggi di errore API localizzati
  • Supporto layout RTL per l'arabo
  • Rilevamento header Accept-Language

Autenticazione

  • Registrazione utenti con ruoli
  • Login sicuro e emissione JWT
  • Hash password bcrypt
  • Autenticazione handshake WebSocket

Moduli field service

  • Utenti, progetti, veicoli e attività
  • Accesso basato su ruoli per admin e worker
  • Fogli presenze con geofence e timbrature
  • Webhook trigger geofence nativo

Esperienza sviluppatore

  • Validazione Zod per env e richieste
  • Gestione centralizzata degli errori
  • Logging strutturato in produzione
  • Shutdown graceful su SIGTERM / SIGINT

Endpoint API

Rotte e canali esposti da questo server.

Metodo Percorso Descrizione Stato
GET / Pagina di benvenuto Le Piramidi Attivo
GET /health Dashboard salute e dipendenze Attivo
POST /api/v1/auth/register Crea un nuovo account utente Attivo
POST /api/v1/auth/login Autenticati e ricevi un token JWT Attivo
GET /api/v1/auth/me Restituisce il profilo utente autenticato Attivo
POST /api/v1/auth/users Creazione utenti solo admin con assegnazione ruolo Attivo
GET /api/v1/users Elenco utenti (solo admin) Attivo
GET /api/v1/users/:id Recupera profilo utente (proprio o admin) Attivo
PATCH /api/v1/users/:id Aggiorna utente con policy per ruolo Attivo
DELETE /api/v1/users/:id Soft delete utente (solo admin) Attivo
GET /api/v1/projects Elenco progetti (tutti o assegnati) Attivo
POST /api/v1/projects Creazione progetto con geofence (solo admin) Attivo
GET /api/v1/projects/:id Recupera progetto per id Attivo
PATCH /api/v1/projects/:id Aggiorna progetto (solo admin) Attivo
DELETE /api/v1/projects/:id Elimina progetto (solo admin) Attivo
GET /api/v1/vehicles Elenco veicoli della flotta Attivo
POST /api/v1/vehicles Registrazione veicolo (solo admin) Attivo
PATCH /api/v1/vehicles/:id Aggiorna veicolo (solo admin) Attivo
DELETE /api/v1/vehicles/:id Elimina veicolo (solo admin) Attivo
GET /api/v1/worker/shifts Elenco turni giornalieri di cantiere per il lavoratore attivo Attivo
GET /api/v1/worker/shifts/reports Archivio rapporti di turno completati per il lavoratore attivo Attivo
POST /api/v1/files/profiles Caricamento avatar autenticato con compressione WebP Attivo
GET /api/v1/files/:category/:filename Streaming sicuro dei file per categoria con autenticazione Attivo
WS /socket.io Canale real-time — passa Bearer JWT nel handshake Attivo

Monitora la salute del servizio su GET /health o richiedi JSON con ?format=json. GET /health · ?format=json