Elerama Frontend

Appearance

Configurazione URL per Ambienti ​

Gli URL utilizzati dall'applicazione per comunicare con i servizi backend sono configurabili tramite variabili d'ambiente.

Variabili d'Ambiente ​

VITE_API_BASE_URL ​

URL base per tutte le chiamate API REST.

  • Default: https://api.local.daisy/erp
  • Uso: Utilizzato da app/lib/api.ts per tutte le chiamate API
  • Esempio produzione: https://api.example.com/erp

VITE_ERP_IFRAME_BASE_URL ​

URL base per il caricamento degli iframe che mostrano i moduli ERP legacy.

  • Default: https://erp.local.daisy
  • Uso: Utilizzato in app/routes/r.$path.tsx e app/components/auth/AuthenticatedLayout.tsx
  • Esempio produzione: https://erp.example.com

File di Configurazione ​

.env (Ambiente locale) ​

File con le configurazioni per lo sviluppo locale. Non committare questo file se contiene dati sensibili.

bash
VITE_API_BASE_URL=https://api.local.daisy/erp
VITE_ERP_IFRAME_BASE_URL=https://erp.local.daisy

.env.example (Template) ​

File di esempio da copiare per creare il proprio .env. Committabile nel repository.

Configurazione per Ambienti ​

Sviluppo Locale ​

bash
# .env
VITE_API_BASE_URL=https://api.local.daisy/erp
VITE_ERP_IFRAME_BASE_URL=https://erp.local.daisy

Staging ​

bash
# .env.staging
VITE_API_BASE_URL=https://api.staging.example.com/erp
VITE_ERP_IFRAME_BASE_URL=https://erp.staging.example.com

Produzione ​

bash
# .env.production
VITE_API_BASE_URL=https://api.example.com/erp
VITE_ERP_IFRAME_BASE_URL=https://erp.example.com

Build per Ambienti Specifici ​

Usando file .env specifici ​

Vite carica automaticamente i file .env.{mode} in base al mode:

bash
# Development (usa .env e .env.development)
npm run dev

# Production (usa .env e .env.production)
npm run build

# Staging (usa .env e .env.staging)
npm run build -- --mode staging

Sovrascrivere variabili a runtime ​

Le variabili possono essere sovrascritte direttamente nel comando:

bash
VITE_API_BASE_URL=https://api.prod.example.com npm run build

Verifica Configurazione ​

Puoi verificare quale URL è configurato aprendo la console del browser e controllando:

javascript
// Per l'API base URL
console.log(import.meta.env.VITE_API_BASE_URL);

// Per l'iframe base URL
console.log(import.meta.env.VITE_ERP_IFRAME_BASE_URL);

Note Importanti ​

  1. Prefisso VITE_: Le variabili d'ambiente devono iniziare con VITE_ per essere esposte al client
  2. Build time: Le variabili sono sostituite durante il build, non a runtime
  3. Sicurezza: Non inserire segreti o token nelle variabili VITE_* perché saranno visibili nel client
  4. CORS: Assicurati che i domini configurati siano abilitati nella configurazione CORS del backend

File Modificati ​

I seguenti file utilizzano le variabili d'ambiente:

  1. app/lib/api.ts: Usa VITE_API_BASE_URL per tutte le chiamate API
  2. app/routes/r.$path.tsx: Usa VITE_ERP_IFRAME_BASE_URL per costruire l'URL dell'iframe
  3. app/components/auth/AuthenticatedLayout.tsx: Usa VITE_ERP_IFRAME_BASE_URL per i link esterni

Riferimenti ​

Documentazione Elerama Frontend

Copyright © 2024-present Elerama