Requisiti & Installazione Locale

AgriReg è un'applicazione cloud-agnostic progettata per essere auto-ospitata (self-hosted). Questa sezione spiega i requisiti hardware e i passaggi per avviare l'applicazione utilizzando Docker in locale o su un server VPS dedicato.

Se invece desideri ospitare l'applicazione sul cloud in modo semplice e gestito, consulta la guida al Deploy Cloud su Render.com.

---

Prerequisiti

Prima di iniziare, assicurati che il tuo server o computer locale soddisfi i seguenti requisiti:

Requisiti Hardware Minimi

• CPU: 1 vCPU (consigliato 2 vCPU per l'elaborazione dei dati GIS)
• RAM: 1 GB di RAM libera (consigliato 2 GB)
• Spazio su Disco: 2 GB per l'applicazione e un database iniziale. Se importi l'intero database dei fitofarmaci e i dati catastali, potrebbero servire fino a 10 GB.

Requisiti Software

• Docker (versione 20.10 o superiore)
• Docker Compose (versione 2.0 o superiore)

---

Installazione Rapida con Docker Compose

Il modo più semplice per avviare AgriReg è utilizzare Docker Compose. Questo avvierà automaticamente il server API (backend Go), il frontend (Vue 3) e il database relazionale (PostgreSQL + PostGIS).

1. Crea una cartella per il progetto e crea un file chiamato docker-compose.yml copiando il seguente contenuto:

version: '3.8'

services:
  db:
    image: postgis/postgis:15-3.3
    container_name: agrireg_db
    environment:
      POSTGRES_DB: agrireg
      POSTGRES_USER: agriuser
      POSTGRES_PASSWORD: agripassword
    ports:
      - "5432:5432"
    volumes:
      - pgdata:/var/lib/postgresql/data
    restart: always

  backend:
    image: agrireg/backend:latest
    container_name: agrireg_backend
    ports:
      - "8080:8080"
    environment:
      - DB_HOST=db
      - DB_PORT=5432
      - DB_USER=agriuser
      - DB_PASSWORD=agripassword
      - DB_NAME=agrireg
    depends_on:
      - db
    restart: always

  frontend:
    image: agrireg/frontend:latest
    container_name: agrireg_frontend
    ports:
      - "80:80"
    depends_on:
      - backend
    restart: always

volumes:
  pgdata:

2. Avvia i servizi in background con il comando:

docker compose up -d

3. Apri il tuo browser all'indirizzo http://localhost (o l'IP del tuo server) per accedere all'interfaccia utente di AgriReg.

---

Configurazione Iniziale

Al primo avvio, l'applicazione ti chiederà di configurare un account amministratore e di importare il database dei fitofarmaci autorizzati per la tua nazione.

Importazione del Database Fitofarmaci

AgriReg include un parser integrato che si collega alle fonti open data ministeriali per scaricare l'elenco aggiornato dei prodotti fitosanitari ammessi. Per avviare l'importazione:

1. Accedi come amministratore.
2. Vai su Impostazioni > Sincronizzazione Dati.
3. Seleziona la tua nazione (es. Italia - Ministero della Salute) e clicca su Avvia Sincronizzazione.

L'importazione richiederà circa 2-3 minuti e popolerà il database con tutti i prodotti commerciali, i principi attivi, le dosi registrate e i tempi di carenza ufficiali.

---

Configurazione dello Storage S3 (Opzionale)

Per impostazione predefinita, AgriReg salva gli allegati (es. foto dei registri cartacei, ricevute di smaltimento o mappe esportate) sul file system locale. Se desideri una configurazione ad alta disponibilità o collegare uno storage persistente esterno, puoi associare un servizio di object storage compatibile con le API AWS S3 (es. AWS S3, Cloudflare R2, Backblaze B2 o MinIO).

Aggiungi le seguenti variabili d'ambiente al servizio backend nel tuo file docker-compose.yml:

      - STORAGE_S3_ENDPOINT=https://your-s3-endpoint.com
      - STORAGE_S3_REGION=eu-south-1
      - STORAGE_S3_BUCKET=your-bucket-name
      - STORAGE_S3_ACCESS_KEY_ID=your-access-key-id
      - STORAGE_S3_SECRET_ACCESS_KEY=your-secret-access-key
      - STORAGE_S3_PUBLIC_URL=https://cdn.yourdomain.com
      - STORAGE_S3_FORCE_PATH_STYLE=true

Dettagli delle Variabili:

• STORAGE_S3_PUBLIC_URL: L'URL pubblico da cui servire gli allegati (opzionale, utile se utilizzi una CDN).
• STORAGE_S3_FORCE_PATH_STYLE: Impostare a true per provider come MinIO o Cloudflare R2 che richiedono l'accesso tramite path e non tramite sottodominio.