Struttura Path CSV Macchine I40

📁 Architettura Storage

Path Privati (Non Accessibili da Web)


storage/app/connettore_I40/
├── csv_I40_1_5/        ← Macchina ID=1, Profilo ID=5
│   ├── file1.csv
│   ├── file2.csv
│   └── ...
├── csv_I40_1_7/        ← Macchina ID=1, Profilo ID=7
│   └── ...
├── csv_I40_2_5/        ← Macchina ID=2, Profilo ID=5
│   └── ...
└── ...


Scopo: Storage privato per CSV in attesa di elaborazione o archiviazione.
---
Path Pubblici (Accessibili via Web)


storage/app/public/I40/
├── csv_I40_1_5/        → ../../connettore_I40/csv_I40_1_5/ (symlink)
├── csv_I40_1_7/        → ../../connettore_I40/csv_I40_1_7/ (symlink)
├── csv_I40_2_5/        → ../../connettore_I40/csv_I40_2_5/ (symlink)
└── ...


Scopo: Accesso pubblico tramite URL per API, download, ecc.
---
Esposizione Web (Laravel Storage Link)

Laravel espone automaticamente storage/app/public/ come /storage/ tramite un symlink:

`public/storage → ../storage/app/public`

Quindi:

storage/app/public/I40/csv_I40_1_5/

Diventa accessibile come: https://sartup.it/sartup/public/storage/I40/csv_I40_1_5/

---

`🔗 Come Funzionano i Symlink`

`Symlink Relativo`


storage/app/public/I40/csv_I40_1_5
    ↓ (symlink relativo)
../../connettore_I40/csv_I40_1_5
    ↓
storage/app/connettore_I40/csv_I40_1_5/


Vantaggi:
Non dipende dal path assoluto del server
Funziona anche se l'applicazione viene spostata
Compatibile con SFTP/rsync
---
📊 Struttura Dati nel Database

`Campo` profiles_config `(JSON)`

json
[
  {
    "servizio": "Taglio",
    "profilo_id": 5,
    "nomeProfilo": "Profilo Taglio Standard"
  },
  {
    "servizio": "Piega",
    "profilo_id": 7,
    "nomeProfilo": "Profilo Piega CNC"
  }
]


Path Generati Automaticamente
Per ogni configurazione, il sistema genera:

1. Path Name: csv_I40_{machine_id}_{profile_id}- Esempio:csv_I40_1_5

2. Full Path (privato): connettore_I40/{path_name}- Esempio:connettore_I40/csv_I40_1_5

3. Public Path (pubblico): I40/{path_name}- Relativo astorage/app/public/- Esempio:storage/app/public/I40/csv_I40_1_5

---

`🛠️ Creazione e Riparazione Path`

`Creazione Automatica`

I path vengono creati automaticamente quando: 1. Crei una nuova macchina con profili associati 2. Modifichi una macchina e aggiungi nuovi profili

`Riparazione Manuale`

Se i path mancano (database esistente, o errori precedenti):

`Opzione 1: Dashboard Web`


/admin/i40/machines/connected
→ Clicca "🔧 Ripara Tutti i Path"


Opzione 2: Per Singola Macchina


Dashboard → Click su "🔧 Ripara" per ogni macchina


Opzione 3: Script PHP (da VPS)

bash
cd /path/to/sartup
php database/sql/repair_all_machine_paths.php


---
🔍 Verifica Health Status
Il sistema verifica automaticamente:

✅ Storage Exists: La cartella in connettore_I40/ esiste?

✅ Public Accessible: Il symlink in public/I40/ esiste?


✅ Files Count: Quanti CSV sono presenti?
✅ Last Activity: Quando è stato modificato l'ultimo file?
Status Possibili:
🟢 healthy: Storage e symlink OK
🟡 missing_storage: Manca la cartella privata
🟡 missing_public: Manca il symlink pubblico
🔴 error: Errore generico

---

`📝 Esempio Completo`

`Macchina: "CNC Laser 001" (ID=1)`

`Configurazione:`

json
{
  "profiles_config": [
    {
      "servizio": "Taglio",
      "profilo_id": 5,
      "nomeProfilo": "Profilo Taglio Laser"
    }
  ]
}


Path Generati:

Privato (Storage):`storage/app/connettore_I40/csv_I40_1_5/`

Pubblico (Symlink):`storage/app/public/I40/csv_I40_1_5/ → ../../connettore_I40/csv_I40_1_5/`

URL Pubblico:`https://sartup.it/sartup/public/storage/I40/csv_I40_1_5/`

---

`🎯 Best Practices`

`1. Non Modificare Manualmente`


I path vengono gestiti automaticamente dal sistema. Non creare/eliminare cartelle manualmente.
2. Usa Sempre la Funzione di Riparazione
Se qualcosa non funziona, usa il pulsante "Ripara Path" invece di intervenire manualmente.
3. Backup Regolari
La cartella

storage/app/connettore_I40/

 contiene i CSV delle macchine. Include questa cartella nei backup.
4. Monitoraggio Continuo
Usa la dashboard "Macchine Collegate" per monitorare lo stato di salute dei path.
---
🚨 Troubleshooting
Problema: Path non esistono
Soluzione: Usa "Ripara Tutti i Path" dalla dashboard
Problema: URL pubblico restituisce 404
Verifica:
1. Symlink Laravel principale esiste?

ls -la public/storage


2. Se manca:

php artisan storage:link

 (da VPS)
3. Symlink specifico esiste?

ls -la storage/app/public/I40/


Problema: File non visibili
Verifica:
1. Permessi corretti?

chmod 755 storage/app/connettore_I40/


2. Owner corretto?

chown -R www-data:www-data storage/`

---

Ultimo aggiornamento: 17 Ottobre 2025

Analisi Codice

Blocco 1

storage/app/connettore_I40/
├── csv_I40_1_5/        ← Macchina ID=1, Profilo ID=5
│   ├── file1.csv
│   ├── file2.csv
│   └── ...
├── csv_I40_1_7/        ← Macchina ID=1, Profilo ID=7
│   └── ...
├── csv_I40_2_5/        ← Macchina ID=2, Profilo ID=5
│   └── ...
└── ...

Blocco 2

storage/app/public/I40/
├── csv_I40_1_5/        → ../../connettore_I40/csv_I40_1_5/ (symlink)
├── csv_I40_1_7/        → ../../connettore_I40/csv_I40_1_7/ (symlink)
├── csv_I40_2_5/        → ../../connettore_I40/csv_I40_2_5/ (symlink)
└── ...

Blocco 3

public/storage → ../storage/app/public

Blocco 4

storage/app/public/I40/csv_I40_1_5
    ↓ (symlink relativo)
../../connettore_I40/csv_I40_1_5
    ↓
storage/app/connettore_I40/csv_I40_1_5/

Blocco 5 json

[
  {
    "servizio": "Taglio",
    "profilo_id": 5,
    "nomeProfilo": "Profilo Taglio Standard"
  },
  {
    "servizio": "Piega",
    "profilo_id": 7,
    "nomeProfilo": "Profilo Piega CNC"
  }
]

Blocco 6

/admin/i40/machines/connected
→ Clicca "🔧 Ripara Tutti i Path"

Blocco 7

Dashboard → Click su "🔧 Ripara" per ogni macchina

Blocco 8 bash

cd /path/to/sartup
php database/sql/repair_all_machine_paths.php

Blocco 9 json

{
  "profiles_config": [
    {
      "servizio": "Taglio",
      "profilo_id": 5,
      "nomeProfilo": "Profilo Taglio Laser"
    }
  ]
}

Blocco 10

storage/app/connettore_I40/csv_I40_1_5/

Blocco 11

storage/app/public/I40/csv_I40_1_5/ → ../../connettore_I40/csv_I40_1_5/

Blocco 12

https://sartup.it/sartup/public/storage/I40/csv_I40_1_5/

Indice

Info Documento

Struttura Path CSV Macchine I40

Struttura Path CSV Macchine I40

📁 Architettura Storage

Path Privati (Non Accessibili da Web)

Path Pubblici (Accessibili via Web)

Esposizione Web (Laravel Storage Link)

🔗 Come Funzionano i Symlink

Symlink Relativo

📊 Struttura Dati nel Database

Campo profiles_config (JSON)

Path Generati Automaticamente

🛠️ Creazione e Riparazione Path

Creazione Automatica

Riparazione Manuale

Opzione 1: Dashboard Web

Opzione 2: Per Singola Macchina

Opzione 3: Script PHP (da VPS)

🔍 Verifica Health Status

Status Possibili:

📝 Esempio Completo

Macchina: "CNC Laser 001" (ID=1)

Configurazione:

Path Generati:

🎯 Best Practices

1. Non Modificare Manualmente

2. Usa Sempre la Funzione di Riparazione

3. Backup Regolari

4. Monitoraggio Continuo

🚨 Troubleshooting

Problema: Path non esistono

Problema: URL pubblico restituisce 404

Problema: File non visibili

Analisi Codice

Blocco 1

Blocco 2

Blocco 3

Blocco 4

Blocco 5 json

Blocco 6

Blocco 7

Blocco 8 bash

Blocco 9 json

Blocco 10

Blocco 11

Blocco 12

Documenti Correlati

Indice

Info Rapide

Documenti Correlati

Screenshot

`🔗 Come Funzionano i Symlink`

`Symlink Relativo`

`Campo` profiles_config `(JSON)`

`🛠️ Creazione e Riparazione Path`

`Creazione Automatica`

`Riparazione Manuale`

`Opzione 1: Dashboard Web`

`📝 Esempio Completo`

`Macchina: "CNC Laser 001" (ID=1)`

`Configurazione:`

`🎯 Best Practices`

`1. Non Modificare Manualmente`