Strategia Profili Import Immutabili
Strategia Profili Import Immutabili
🎯 Decisione Architetturale
I profili import CSV sono IMMUTABILI - Una volta creati, non possono essere modificati, solo duplicati.
---
❓ Perché questa scelta?
Problema: Data Integrity
``
Scenario problematico con profili modificabili:
1. Profilo "Juki Standard" → Import 10.000 lavorazioni (Gen 2025) Mapping: Data, Operazione, Pezzi
2. Admin modifica mapping Mapping: Data, Operazione, Pezzi, Operatore, Durata
3. Profilo "Juki Standard" → Import 5.000 lavorazioni (Feb 2025)
❌ PROBLEMA:
- Lavorazioni Gen: senza Operatore/Durata
- Lavorazioni Feb: con Operatore/Durata
- Stessa struttura → Dati inconsistenti!
`
Soluzione: Immutabilità
`
✅ Profilo "Juki Standard v1" → Import Gen (frozen) ✅ Duplica → "Juki Standard v1 (copia)" → Modifica mapping ✅ Rinomina → "Juki Standard v2" ✅ Import Feb → Usa v2</p><p>Risultato: ✅ Ogni import ha il suo profilo specifico ✅ Integrità dati garantita ✅ Tracciabilità completa
---
🔧 Implementazione
1. Route Duplica
File:
</p><p></code>`<code>php
Route::post('/{importProfile}/duplicate', [ImportProfilesController::class, 'duplicate'])
->name('duplicate');
</code>`<code></p><p><h3><strong>2. Metodo Controller</strong></h3></p><p><strong>File</strong>: </code>app/Http/Controllers/Admin/I40/ImportProfilesController.php<code></p><p></code>`<code>php
public function duplicate(ImportProfile $importProfile)
{
// Replica profilo
$new = $importProfile->replicate();
// Nome univoco
$baseName = $importProfile->name;
$counter = 2;
$newName = "{$baseName} (copia)";
while (ImportProfile::where('name', $newName)->exists()) {
$newName = "{$baseName} (copia {$counter})";
$counter++;
}
$new->name = $newName;
$new->created_by = auth()->id();
$new->save();
// Duplica file CSV
if ($importProfile->sample_file_path) {
$newPath = 'I40/import-profiles/' . uniqid('profile_') . '.csv';
Storage::disk('public')->copy($importProfile->sample_file_path, $newPath);
$new->sample_file_path = $newPath;
$new->save();
}
return redirect()->with('success', "Profilo duplicato: '{$new->name}'");
}
</code>`<code></p><p><h3><strong>3. UI - Pulsante Duplica</strong></h3></p><p><strong>Nella tabella</strong>:
</code>`<code>html
<button onclick="duplicateProfile(id, name)">
<i class="bi bi-files"></i> Duplica
</button>
</code>`<code></p><p><strong>Nel modal dettaglio</strong>:
</code>`<code>html
<div class="modal-footer">
<button onclick="duplicateFromModal()">Duplica Profilo</button>
</div>
</code>`<code></p><p>---</p><p><h2>🚫 Cosa NON È Implementato</h2></p><p><ul><li>❌ <strong>Update/Modifica</strong>: Rimosso completamente</li>
<li>❌ <strong>Versioning</strong>: Non necessario con immutabilità</li>
<li>❌ <strong>Soft Delete</strong>: Eliminazione fisica (per ora)</li></p><p>---</p><p><h2>📋 Workflow Utente</h2></p><p><h3><strong>Creare Nuovo Profilo</strong></h3>
1. Click "Nuovo Profilo"
2. Upload CSV
3. Sistema analizza e propone mapping
4. Salva profilo
5. ✅ Profilo frozen (immutabile)</p><p><h3><strong>Correggere/Aggiornare Profilo</strong></h3>
1. Visualizza profilo esistente
2. Click "Duplica" (tabella o modal)
3. Modifica nome duplicato (es. "Juki Standard v2")
4. ✅ Nuovo profilo modificabile</p><p><h3><strong>Eliminare Profilo</strong></h3>
1. Click cestino
2. Conferma eliminazione
3. ✅ Profilo e file CSV eliminati</p><p>---</p><p><h2>✅ Vantaggi</h2></p><p>1. <strong>Integrità Dati</strong>: Garantita al 100%
2. <strong>Semplicità</strong>: Zero complessità architetturale
3. <strong>Tracciabilità</strong>: Ogni import ha profilo specifico
4. <strong>Sicurezza</strong>: Nessun rischio corruzione storico
5. <strong>UX Chiara</strong>: "Frozen → Duplica → Modifica"</p><p>---</p><p><h2>🎨 UX Flow Completo</h2></p><p>┌─────────────────────────────────────────┐ │ Lista Profili │ ├─────────────────────────────────────────┤ │ • Juki Standard v1 │ │ [👁️ Visualizza] [📋 Duplica] [🗑️] │ │ │ │ • Juki Standard v2 │ │ [👁️ Visualizza] [📋 Duplica] [🗑️] │ └─────────────────────────────────────────┘</p><p>Click "Visualizza" → Modal con: ┌─────────────────────────────────────────┐ │ Juki Standard v1 ✕ │ ├─────────────────────────────────────────┤ │ Info | Mapping | File CSV │ │ │ │ [Chiudi] [📋 Duplica Profilo] │ └─────────────────────────────────────────┘
---
🔮 Evoluzioni Future (opzionali)
Se in futuro serve più flessibilità:
Opzione A: Aggiungi flag
`sql
ALTER TABLE import_profiles ADD COLUMN is_locked BOOLEAN DEFAULT 0;-- Blocca profilo dopo primo import
UPDATE import_profiles SET is_locked = 1 WHERE id = X;
`Opzione B: Conta import associati
php
public function canBeDeleted(): bool {
return $this->imports()->count() === 0;
}
`Opzione C: Soft Delete con restore
php
use SoftDeletes;// Elimina logicamente, ripristinabile
``---
📚 Pattern Riutilizzabile
Questo pattern "Immutabile + Duplica" funziona per:
Quando serve integrità storica, usa immutabilità!
---
Documento creato: 17 Ottobre 2025 Strategia: Immutabilità senza versioning
Analisi Codice
Blocco 1
Scenario problematico con profili modificabili:
1. Profilo "Juki Standard" → Import 10.000 lavorazioni (Gen 2025)
Mapping: Data, Operazione, Pezzi
2. Admin modifica mapping
Mapping: Data, Operazione, Pezzi, Operatore, Durata
3. Profilo "Juki Standard" → Import 5.000 lavorazioni (Feb 2025)
❌ PROBLEMA:
- Lavorazioni Gen: senza Operatore/Durata
- Lavorazioni Feb: con Operatore/Durata
- Stessa struttura → Dati inconsistenti!
Blocco 2
✅ Profilo "Juki Standard v1" → Import Gen (frozen)
✅ Duplica → "Juki Standard v1 (copia)" → Modifica mapping
✅ Rinomina → "Juki Standard v2"
✅ Import Feb → Usa v2
Risultato:
✅ Ogni import ha il suo profilo specifico
✅ Integrità dati garantita
✅ Tracciabilità completa
Blocco 3 php
Route::post('/{importProfile}/duplicate', [ImportProfilesController::class, 'duplicate'])
->name('duplicate');
Blocco 4 php
public function duplicate(ImportProfile $importProfile)
{
// Replica profilo
$new = $importProfile->replicate();
// Nome univoco
$baseName = $importProfile->name;
$counter = 2;
$newName = "{$baseName} (copia)";
while (ImportProfile::where('name', $newName)->exists()) {
$newName = "{$baseName} (copia {$counter})";
$counter++;
}
$new->name = $newName;
$new->created_by = auth()->id();
$new->save();
// Duplica file CSV
if ($importProfile->sample_file_path) {
$newPath = 'I40/import-profiles/' . uniqid('profile_') . '.csv';
Storage::disk('public')->copy($importProfile->sample_file_path, $newPath);
$new->sample_file_path = $newPath;
$new->save();
}
return redirect()->with('success', "Profilo duplicato: '{$new->name}'");
}
Blocco 5 html
<button onclick="duplicateProfile(id, name)">
<i class="bi bi-files"></i> Duplica
</button>
Blocco 6 html
<div class="modal-footer">
<button onclick="duplicateFromModal()">Duplica Profilo</button>
</div>
Blocco 7
┌─────────────────────────────────────────┐
│ Lista Profili │
├─────────────────────────────────────────┤
│ • Juki Standard v1 │
│ [👁️ Visualizza] [📋 Duplica] [🗑️] │
│ │
│ • Juki Standard v2 │
│ [👁️ Visualizza] [📋 Duplica] [🗑️] │
└─────────────────────────────────────────┘
Click "Visualizza" → Modal con:
┌─────────────────────────────────────────┐
│ Juki Standard v1 ✕ │
├─────────────────────────────────────────┤
│ Info | Mapping | File CSV │
│ │
│ [Chiudi] [📋 Duplica Profilo] │
└─────────────────────────────────────────┘
Blocco 8 sql
ALTER TABLE import_profiles ADD COLUMN is_locked BOOLEAN DEFAULT 0;
-- Blocca profilo dopo primo import
UPDATE import_profiles SET is_locked = 1 WHERE id = X;
Blocco 9 php
public function canBeDeleted(): bool {
return $this->imports()->count() === 0;
}
Blocco 10 php
use SoftDeletes;
// Elimina logicamente, ripristinabile