+# AutoNAS - Change Log

+

+## [v3.0.0] - 2025-08-15 🚀

+

+### 🎉 **CLEAN USER INTERFACE & SCRIPT ORGANIZATION**

+

+#### 🔧 Complete Script Architecture Refactoring

+- **Single User Command**: Only `autonas` visible in shell autocomplete

+- **Internal Script Organization**: All utility scripts moved to `/usr/local/lib/autonas/`

+- **47% Code Reduction**: ~2,300 lines eliminated through deduplication

+- **Single Source of Truth**: All shared functions in `autonas-core.sh` library

+

+#### 📁 New Script Architecture

+```

+/usr/local/bin/

+├── autonas -> autonas.sh          # Only user-visible command

+├── autonas.sh                     # Main CLI interface (1,208 lines)  

+└── autonas-core.sh                # Core business logic library (1,044 lines)

+

+/usr/local/lib/autonas/            # Internal scripts (hidden from autocomplete)

+├── autonas-boot-scan.sh           # Boot scanner

+├── autonas-disk-handler.sh        # Disk event handler

+├── autonas-media-importer.sh      # Media importer

+├── autonas-network-handler.sh     # Network handler

+├── autonas-udev-wrapper.sh        # Udev wrapper

+└── autonas-uninstall.sh           # System uninstaller

+```

+

+#### 🎯 Clean User Experience

+- **Professional Interface**: Only `autonas` command appears in tab completion

+- **Unified Functionality**: All operations through single command interface

+- **Organized Backend**: All system utilities properly categorized and hidden

+- **Zero Code Duplication**: Complete elimination of duplicate functions

+

+#### 🔄 Revolutionary Background Import Architecture (Preserved)

+- **Service-Based Import System**: Complete separation of mount/import through systemd services

+- **Unlimited Import Duration**: No more systemd timeout constraints (tested with 300+ files)

+- **Production Scalability**: Architecture tested and validated in production environment

+

+#### �️ **Complete System Integration Updates**

+- **All Service Files**: Updated systemd services with new script paths

+- **All udev Rules**: Updated with `/usr/local/lib/autonas/` paths  

+- **All Configuration References**: Updated throughout entire system

+- **Deploy Script**: Enhanced with directory creation and proper installation

+- **Install/Uninstall**: Complete support for new architecture

+

+#### 🔧 **Technical Architecture Improvements**

+- **Core Library Pattern**: `autonas-core.sh` with all shared business logic

+- **Clean Separation**: User interface vs. system utilities properly organized

+- **Professional Deployment**: Only essential commands visible to users

+- **Backward Compatibility**: Seamless upgrade path from previous versions

+

+#### 📊 **Production Test Results** (Background Import)

+- **✅ 302 files imported** successfully in single session (36 minutes)

+- **✅ 100% success rate** with zero errors

+- **✅ Perfect UTC conversion** for all QuickTime/EXIF timestamps

+- **✅ Complete workflow** mount → background import → auto unmount

+- **✅ Robust error handling** and disconnect detection

+

+#### 🚨 **Architecture Changes** 

+- **Script Locations**: Internal scripts moved from `/usr/local/bin/` to `/usr/local/lib/autonas/`

+- **User Interface**: Single `autonas` command replaces multiple visible scripts

+- **Configuration Updates**: All references updated throughout system

+- **Clean Autocomplete**: Professional user experience with hidden utilities

+

+---

+

+## [v2.5.0] - 2024-08-12

+

+### 🚀 Dual Configuration System

+

+#### Enhanced Mounting Options

+- **Dual Configuration Support**: Complete system supporting both NFS shares and simple local mounts

+  - **NFS share complet**: Cu IP și export pentru acces de rețea

+  - **Montare locală simplă**: Doar mount point, fără IP și NFS (NOUĂ!)

+- **LOCAL Configuration Format**: New `UUID:NAME:LOCAL:LOCAL:MOUNT_POINT:LOCAL` format

+- **Interactive Configuration Selection**: Enhanced `autonas-config.sh add` with mount type selection

+- **Mixed Environment Support**: Both NFS and LOCAL configurations can coexist seamlessly

+

+#### Core System Improvements

+- **Extended UUID Support**: Support for both standard UUIDs and FAT32 short UUIDs (e.g., `8765-4321`)

+- **Enhanced Manager Integration**: Complete autonas-manager.sh support for LOCAL configurations

+- **Clean Logging**: LOCAL configurations show "Skipping X for local mount configuration" instead of errors

+- **Synchronized Disk Display**: Fixed desynchronization between disk display and mapping logic

+

+#### Bug Fixes Resolved

+- **Disk Selection Mapping Bug**: Fixed issue where selecting disk 6 would map to wrong UUID

+- **LOG Spam Resolution**: Eliminated infinite "Waiting for interface LOCAL" loops

+- **UUID Regex Enhancement**: Updated regex pattern to handle FAT32 short UUIDs properly

+- **Manager Function Updates**: All network-related functions now properly detect and skip LOCAL configurations

+

+#### Technical Implementation

+```bash

+# NFS Configuration (existing)

+UUID:NAME:IP:INTERFACE:MOUNT_POINT:NFS_OPTIONS

+

+# LOCAL Configuration (new)

+UUID:NAME:LOCAL:LOCAL:MOUNT_POINT:LOCAL

+```

+

+#### Manager Function Enhancements

+- **`activate_ip()`**: Skips IP activation for LOCAL configurations

+- **`deactivate_ip()`**: Skips IP deactivation for LOCAL configurations  

+- **`add_nfs_export()`**: Skips NFS export for LOCAL configurations

+- **`remove_nfs_export()`**: Skips NFS export removal for LOCAL configurations

+

+#### Use Cases for LOCAL Configurations

+- **Simple local storage**: Diskuri pentru backup-uri locale fără acces de rețea

+- **Scratch space**: Space temporar pentru procesare locală de date  

+- **Development storage**: Storage local pentru cache-uri și fișiere temporare

+- **Archive storage**: Archive locale care nu necesită export NFS

+- **Mixed environments**: Combinație de storage local și shares de rețea

+

+#### Configuration Examples

+```properties

+# NFS Shares (network access)

+920fe1b7-4091-4d6a-bab8-2f48d8d704bc:shared-docs:192.168.1.100:eth0:/mnt/autonas/shared-docs:*(rw,all_squash,insecure,async,no_subtree_check,anonuid=0,anongid=0)

+

+# LOCAL Mounts (local only)  

+8765-4321:local-backup:LOCAL:LOCAL:/mnt/autonas/local-backup:LOCAL

+abcd-1234:scratch-space:LOCAL:LOCAL:/mnt/autonas/scratch-space:LOCAL

+```

+

+#### Backward Compatibility

+- **Full compatibility**: Existing NFS configurations continue to work unchanged

+- **No migration required**: Current setups work without any changes

+- **Enhanced functionality**: New LOCAL options available alongside existing NFS features

+

+## [v2.4.0] - 2025-08-11

+

+### 🌐 Interface Stability Management System

+

+#### Problema Rezolvată

+- **USB/Thunderbolt interfaces instabile**: Interfețele USB și Thunderbolt dispar și revin periodic

+- **IP-uri pierdute**: IP-urile configurate pentru diskuri nu se readaugă automat când interfața revine

+- **NFS exports indisponibile**: Export-urile devin temporar inaccesibile din cauza IP-urilor lipsă

+

+#### Interface Management Tools

+- **autonas-interface-handler.sh**: Handler principal pentru evenimente udev de interfețe

+- **Event-driven only**: Arhitectură complet bazată pe evenimente (fără daemon/servicii permanente)

+- **Emergency diagnostics**: Tool-uri de diagnostic pentru depanare în cazuri extreme

+

+#### Interface Handler System  

+- **autonas-interface-handler.sh**: Handler principal pentru evenimente udev de interfețe

+- **Event-driven architecture**: Răspuns instant la schimbările interfețelor (nu polling)

+- **Multiple event types**: Detectează add/remove/change/carrier/operstate events

+- **Focus USB/Thunderbolt**: Tratament special pentru interfețele instabile

+- **Smart restoration**: Verifică starea interfețelor înainte de configurare IP

+- **Background processing**: Execuție asincronă pentru a evita timeout-urile udev

+- **Retry mechanism**: Logică de retry pentru configurarea IP-urilor pe interfețe instabile

+

+#### Advanced IP Management

+- **Interface existence checking**: Verificare inteligentă dacă interfața există înainte de configurare

+- **IP conflict resolution**: Detectează și evită conflictele de IP-uri

+- **Retry mechanism**: Logic de retry pentru configurarea IP-urilor pe interfețe instabile

+- **Shared IP management**: Gestionarea corectă a IP-urilor folosite de multiple diskuri

+- **Wait for interface**: Așteaptă ca interfețele USB/Thunderbolt să apară (până la 30 secunde)

+

+#### Comprehensive Debug Tools

+- **autonas-interface-debug.sh**: Tool complet de diagnostic pentru probleme interfețe

+- **Status analysis**: Analiză detaliată a statusului interfețelor și IP-urilor configurate

+- **Real-time monitoring**: Monitorizare în timp real a schimbărilor de interfețe

+- **Configuration validation**: Verificare configurații AutoNAS vs. starea actuală

+- **Troubleshooting guide**: Sugestii automate pentru rezolvarea problemelor

+- **Color-coded output**: Interface prietenoasă cu coding color pentru status

+

+#### Enhanced udev Rules

+- **98-autonas-interfaces.rules**: Reguli udev comprehensive pentru interfețe de rețea

+- **Event-driven primary mechanism**: Detectare principală prin evenimente, nu polling

+- **Multiple trigger types**: add/remove/change/operstate/carrier events

+- **USB/Thunderbolt specific**: Tratament special pentru interfețele instabile

+- **State change monitoring**: Monitorizează schimbările de stare operațională și carrier

+- **Instant response**: Răspuns în 2-3 secunde la schimbările interfețelor

+

+#### Management Commands

+```bash

+# Debug interfețe și IP-uri

+autonas-interface-debug.sh check

+

+# Monitorizare timp real schimbări

+autonas-interface-debug.sh realtime

+

+# Test stabilitate interfețe USB/Thunderbolt

+autonas-test-interface-stability.sh

+```

+

+#### Installation & Service Integration

+- **Automatic installation**: Toate componentele sunt instalate automat de `install.sh`

+- **Service auto-start**: Serviciul de monitorizare pornește automat la instalare

+- **Initial restore**: Restaurare automată a IP-urilor la finalul instalării

+- **Proper dependencies**: Dependențe corecte cu serviciile de rețea și NFS

+

+### 🔧 Îmbunătățiri Core Manager

+

+#### Smart IP Configuration

+- **Interface existence validation**: Verifică dacă interfața există înainte de configurare

+- **Wait for interface**: Logică de așteptare pentru interfețele care apar cu întârziere

+- **Retry mechanism**: Până la 3 încercări pentru configurarea IP-urilor

+- **Conflict detection**: Evită adăugarea IP-urilor deja configurate

+

+#### Enhanced Error Handling

+- **Detailed error reporting**: Mesaje de eroare mai descriptive

+- **Recovery suggestions**: Sugestii pentru rezolvarea problemelor

+- **Graceful degradation**: Continuă operațiunea chiar dacă unele componente eșuează

+

+### 📚 Documentație Extinsă

+

+#### New Troubleshooting Section

+- **USB/Thunderbolt specific issues**: Secțiune dedicată pentru problemele interfețelor instabile

+- **Debug commands**: Liste complete de comenzi pentru diagnosticare

+- **Step-by-step solutions**: Soluții pas cu pas pentru probleme comune

+- **Power management tips**: Sugestii pentru managementul power al USB

+

+#### Updated Architecture Documentation

+- **Interface monitoring flow**: Documentare completă a fluxului de monitorizare

+- **Service interactions**: Interacțiunile între servicii și dependențele lor

+- **Debug methodology**: Metodologie pentru diagnosticarea problemelor

+

+### 🎯 Use Cases Noi

+

+#### Unstable Interface Environments

+- **USB docking stations**: Stații de andocare USB care se deconectează periodic

+- **Thunderbolt hubs**: Hub-uri Thunderbolt cu conectivitate intermitentă  

+- **USB-C multiport adapters**: Adaptoare multiport cu stabilitate variabilă

+- **Laptop docking scenarios**: Scenarii de laptop care se conectează/deconectează des

+

+#### Enterprise Environment

+- **Multiple identical setups**: Deploy pe multiple servere cu aceleași probleme interfețe

+- **Centralized monitoring**: Monitorizare centralizată a stabilității interfețelor

+- **Automated recovery**: Recuperare automată fără intervenție manuală

+

+## [v2.3.0] - 2025-07-22

+

+### 🚀 Boot Recovery System

+

+#### Boot Scan Service

+- **Automatic boot detection**: New `autonas-boot-scan.service` detects and mounts configured disks at system boot

+- **Pre-connected disk support**: Handles disks that were already attached before system start

+- **Intelligent scanning**: Checks all configured UUIDs from `/etc/pve/autonas/disks.conf`

+- **Mount status detection**: Identifies disks already mounted elsewhere and handles appropriately

+

+#### Boot Scanner Script

+- **autonas-boot-scan.sh**: Comprehensive boot-time disk scanner

+- **UUID existence verification**: Checks if configured disk UUIDs are present as devices

+- **Mount state analysis**: Determines if disks are unmounted, mounted elsewhere, or correctly mounted

+- **Automatic attachment**: Uses `autonas-manager.sh` to properly mount and configure detected disks

+- **Detailed reporting**: Statistics on total, processed, already-mounted, and newly-attached disks

+

+#### System Integration

+- **Service dependencies**: Proper ordering after filesystem, udev-settle, network, and NFS services

+- **Installation automation**: Added to install/uninstall scripts with proper enable/disable

+- **Documentation updates**: Complete documentation of new boot recovery architecture

+- **RemainAfterExit=yes**: Service stays active to indicate successful boot scan completion

+

+#### Main Service Integration

+- **autonas.service**: New main AutoNAS service for centralized system management

+- **Enhanced reload functionality**: Comprehensive reload of udev rules, NFS exports, and systemd daemon

+- **Service orchestration**: Proper dependencies and integration with boot-scan service

+- **Centralized control**: Single point of management for the entire AutoNAS system

+

+#### Orphan File Prevention System

+- **Pre-installation cleanup**: Automatic cleanup of previous installations before reinstalling

+- **Uninstaller integration**: Install script now installs uninstaller for future clean upgrades

+- **Deploy script uninstall**: New `./deploy.sh uninstall` command for remote uninstallation

+- **Force mode uninstaller**: Silent cleanup mode with `--force` flag for automated use

+- **Evolution protection**: Prevents orphan files during project evolution and upgrades

+

+#### Problem Resolution

+- **Solves reboot issue**: Addresses problem where pre-connected disks weren't exported after system restart

+- **udev gap coverage**: Handles scenario where udev doesn't re-trigger events for existing devices

+- **NFS export recovery**: Ensures all configured disks are properly exported after boot

+- **Robust boot process**: System now handles both hot-plug and pre-connected disk scenarios

+

+## [v2.2.0] - 2025-07-22

+

+### 🚀 Remote Deployment System

+

+#### Deploy Script Added

+- **Remote deployment support**: New `deploy.sh` script for automated installation on multiple targets

+- **Multi-target management**: Support for servers 192.168.2.91, 192.168.2.92, 192.168.2.93

+- **SSH-based automation**: Uses SSH keys for seamless remote operations

+- **Intelligent connectivity checks**: Host availability verification before operations

+

+#### Enhanced Reliability

+- **Host status verification**: Ping test before attempting SSH connections

+- **Graceful failure handling**: Skip unavailable hosts with clear warnings

+- **Connection testing**: SSH connectivity validation before deployment

+- **Error reporting**: Clear status messages for each operation step

+

+#### Deployment Features

+- **Complete installation**: Automated install, configure, and start services

+- **Service management**: Start, restart, stop remote AutoNAS services

+- **Status monitoring**: Remote status checking and health validation

+- **Cleanup operations**: Temporary file cleanup on target systems

+

+#### Command Operations

+- **install**: Complete AutoNAS installation and configuration

+- **start/restart/stop**: Service lifecycle management

+- **status**: Health check and configuration validation

+- **cleanup**: Temporary file removal

+- **help**: Comprehensive usage documentation

+

+#### Documentation Consolidation

+- **Merged TECHNICAL.md into README.md**: Complete technical documentation in single file

+- **Enhanced architecture section**: Detailed component descriptions and workflows

+- **Comprehensive troubleshooting**: Technical debugging and extensibility guides

+- **Unified documentation**: Single source of truth for all AutoNAS information

+

+## [v2.1.0] - 2024-12-02

+

+### 🚀 udev Context Improvements

+

+#### Simplified Execution Strategy

+- **Direct systemd execution**: Removed unreliable direct execution in udev context

+- **Guaranteed privilege handling**: All mount operations now run through systemd service

+- **Improved reliability**: Eliminates "permission denied" issues in restricted udev context

+- **Consistent behavior**: Same execution path for all environments

+

+#### Enhanced Logging

+- **Streamlined logging**: Clear indication of systemd service usage

+- **Better debugging**: Simplified troubleshooting without fallback complexity

+

+## [v2.0.0] - 2024-12-02

+

+### 🚀 Major Features Added

+

+#### Intelligent Device Detection

+- **Multiple device type support**: USB storage, SCSI removable, USB-to-SATA bridges

+- **UUID-based identification**: Precise device matching via filesystem UUID

+- **Smart udev rules**: Comprehensive detection for various hardware configurations

+

+#### Enhanced User Experience

+- **Interactive configuration helper**: `autonas-config.sh` with guided setup

+- **UUID parameter support**: Pre-populate UUIDs in `add` and `test` commands

+- **Automatic mounting post-configuration**: Immediate disk availability after setup

+- **Standardized NFS configuration**: Optimized settings applied automatically

+

+#### Advanced System Integration

+- **udev wrapper**: Prevents timeout issues with asynchronous execution

+- **Intelligent IP management**: Shared IP handling across multiple disks

+- **Comprehensive logging**: Structured logging with proper syslog tags

+- **Error handling and recovery**: Robust failure handling with detailed reporting

+

+### 🛡️ Data Protection & Safety

+

+#### Installation Safety

+- **Configuration preservation**: Existing `disks.conf` files are never overwritten

+- **User data detection**: Automatically detects and preserves user configurations

+- **Template system**: New installs get templates, upgrades preserve data

+

+#### Uninstallation Safety

+- **Data-preserving uninstall**: User configurations and mount points preserved

+- **Selective cleanup**: Only removes AutoNAS components, keeps user data

+- **Manual cleanup guidance**: Clear instructions for complete removal if desired

+

+### 🔧 Configuration Management

+

+#### Simplified Configuration Process

+```bash

+# Old method (manual editing)

+sudo nano /etc/pve/autonas/disks.conf

+

+# New method (guided interactive)

+sudo autonas-config.sh add <UUID>

+```

+

+#### Smart Validation

+- **UUID format validation**: Proper 8-4-4-4-12 hex format checking

+- **Disk name validation**: Character restrictions and reserved name checking

+- **Network interface validation**: Real-time interface existence checking

+- **IP address validation**: Format and availability checking

+

+#### Enhanced Commands

+- **`autonas-config.sh add [UUID]`**: Interactive configuration with optional UUID

+- **`autonas-config.sh test [UUID]`**: Configuration testing with optional UUID

+- **`autonas-config.sh list`**: Formatted display of all configurations

+- **`autonas-config.sh remove`**: Interactive configuration removal

+

+### 🌐 Network & NFS Improvements

+

+#### Standardized NFS Configuration

+```

+*(rw,all_squash,insecure,async,no_subtree_check,anonuid=0,anongid=0)

+```

+- **Optimized for performance**: Async writes with no_subtree_check

+- **Security balanced**: all_squash with root mapping for compatibility

+- **Wide compatibility**: insecure flag for broader client support

+

+#### Intelligent IP Management

+- **Shared IP support**: Multiple disks can use the same IP address

+- **Smart cleanup**: IPs only removed when no longer in use

+- **Automatic configuration**: IP setup integrated with disk mounting

+

+### 🔍 Monitoring & Debugging

+

+#### Enhanced Logging System

+- **Structured logging**: Separate tags for different components

+  - `autonas`: Main manager operations

+  - `autonas-wrapper`: udev wrapper operations

+  - `autonas-config`: Configuration helper operations

+- **Informative messages**: Clear indication of actions and results

+- **Debugging support**: Detailed error reporting with context

+

+#### Monitoring Commands

+```bash

+# Live monitoring all AutoNAS components

+journalctl -t autonas -t autonas-wrapper -t autonas-config -f

+

+# Component-specific monitoring

+journalctl -t autonas --since "10 minutes ago"

+

+# udev debugging

+udevadm monitor --subsystem-match=block

+```

+

+### 📁 Project Structure Improvements

+

+#### Organized Component Structure

+```

+autoNAS/

+├── README.md                   # User documentation

+├── TECHNICAL.md               # Technical documentation  

+├── CHANGELOG.md               # This file

+├── config/

+│   ├── disks.conf              # Configuration template

+│   ├── 99-autonas-disk.rules   # udev detection rules

+│   └── autonas-attach@.service # systemd fallback service

+└── scripts/

+    ├── autonas-manager.sh      # Main disk management

+    ├── autonas-udev-wrapper.sh # udev timeout prevention

+    ├── autonas-config.sh       # Interactive configuration

+    ├── install.sh              # Safe installation

+    └── uninstall.sh            # Safe uninstallation

+```

+

+#### Documentation Overhaul

+- **Complete README**: Comprehensive user guide with examples

+- **Technical documentation**: Developer-focused implementation details

+- **Inline comments**: Extensive code documentation for maintainability

+

+### ⚡ Performance Optimizations

+

+#### udev Integration

+- **Timeout prevention**: Asynchronous wrapper prevents udev blocking

+- **Background processing**: Non-blocking device handling

+- **Immediate feedback**: Quick udev response with background operations

+

+#### File System Operations

+- **UUID-based mounting**: Consistent device identification

+- **Optimized mount points**: Organized `/mnt/autonas/` structure

+- **Efficient configuration parsing**: Fast config file processing

+

+### 🔒 Security Enhancements

+

+#### File Permissions

+- **Proper ownership**: All scripts owned by root:root

+- **Secure permissions**: 755 for scripts, 644 for configs

+- **Protected configuration**: Config files not world-writable

+

+#### NFS Security

+- **User mapping**: all_squash prevents privilege escalation

+- **Anonymous mapping**: anonuid=0,anongid=0 for consistent access

+- **Performance vs security**: Balanced configuration for practical use

+

+### 🧪 Testing & Validation

+

+#### Configuration Testing

+- **Real-time validation**: Test configurations against current system state

+- **Device detection**: Check if UUIDs correspond to actual devices

+- **Network validation**: Verify interface existence and IP availability

+

+#### Integration Testing

+- **Manual testing support**: Commands for manual mount/unmount testing

+- **Status verification**: Built-in checks for successful operations

+- **Rollback capability**: Automatic cleanup on operation failures

+

+### 🚨 Error Handling Improvements

+

+#### Graceful Failure Handling

+- **Descriptive error messages**: Clear indication of what went wrong

+- **Suggested remedies**: Specific commands to fix common issues

+- **Logging preservation**: All errors logged for later analysis

+

+#### Recovery Mechanisms

+- **Automatic rollback**: Failed operations clean up after themselves

+- **State consistency**: System left in known good state after failures

+- **Manual recovery**: Clear instructions for manual intervention when needed

+

+### 📖 Breaking Changes

+

+#### Configuration Format

+- **No breaking changes**: Existing configurations continue to work

+- **Enhanced format**: New configurations use optimized NFS settings

+- **Backwards compatibility**: Old configurations preserved during upgrades

+

+#### Command Interface

+- **Extended syntax**: Commands now accept optional parameters

+- **Backwards compatibility**: Old syntax continues to work

+- **Enhanced features**: New parameters provide additional functionality

+

+### 🔄 Migration Guide

+

+#### From Manual Configuration

+If you've been manually editing configuration files:

+1. **Backup existing configs**: `sudo cp /etc/pve/autonas/disks.conf ~/backup.conf`

+2. **Run installer**: `sudo bash scripts/install.sh` (preserves existing configs)

+3. **Use new tools**: `autonas-config.sh list` to see current configurations

+

+#### From Previous AutoNAS Version

+1. **Safe upgrade**: `sudo bash scripts/install.sh` automatically preserves data

+2. **New features**: Start using `autonas-config.sh add <UUID>` for new disks

+3. **Enhanced monitoring**: Use new logging commands for better visibility

+

+### 🎯 Future Roadmap

+

+#### Planned Features

+- **Web interface**: GUI for configuration management

+- **Notification system**: Email/webhook notifications for disk events

+- **Health monitoring**: SMART data integration and disk health reporting

+- **Cloud integration**: Automatic cloud backup triggers

+

+#### Performance Improvements

+- **Parallel processing**: Concurrent handling of multiple disk operations

+- **Caching**: Configuration caching for faster operations

+- **Optimization**: Further NFS and mount option tuning

+

+#### Security Enhancements

+- **TLS support**: Encrypted NFS where supported

+- **Access control**: Per-disk user/group restrictions

+- **Audit logging**: Enhanced security logging for compliance

+

+---

+

+### 📝 Notes

+

+- **Semantic versioning**: AutoNAS follows semver for version numbering

+- **Stability focus**: All changes prioritize data safety and system stability

+- **Community feedback**: Features developed based on user needs and feedback

+

+For detailed technical information, see [TECHNICAL.md](TECHNICAL.md).

+For user documentation, see [README.md](README.md).

+# AutoNAS Development Documentation

+

+## Development Architecture Overview

+

+### Project Structure - v3.0 Clean Architecture

+```

+autoNAS/

+├── README.md                   # User documentation & quick start

+├── DEVELOPMENT.md             # Development documentation (this file)

+├── deploy.sh                  # Remote deployment system

+├── config/

+│   ├── disks.conf             # Disk configuration template

+│   ├── 99-autonas-disk.rules  # udev rules for disk detection

+│   ├── 98-autonas-interfaces.rules # Network interface monitoring

+│   ├── autonas.service        # Main AutoNAS service

+│   ├── autonas-attach@.service # Individual disk services

+│   └── autonas-boot-scan.service # Boot time disk scanning

+├── scripts/

+│   ├── autonas.sh             # ✅ Main CLI interface (1,208 lines)

+│   ├── autonas-core.sh        # ✅ Core business logic library (1,044 lines)

+│   ├── autonas-disk-handler.sh    # Internal: Disk event handler

+│   ├── autonas-network-handler.sh # Internal: Network event handler

+│   ├── autonas-udev-wrapper.sh    # Internal: udev timeout prevention

+│   ├── autonas-boot-scan.sh       # Internal: Boot-time scanning

+│   ├── autonas-media-importer.sh  # Internal: Camera import processing

+│   ├── autonas-uninstall.sh       # Internal: System uninstaller

+│   └── install.sh             # Installation and setup script

+```

+

+### Clean User Interface Architecture

+```

+User Command: autonas <cmd> [options]

+             ↓

+    /usr/local/bin/autonas.sh (Main CLI)

+             ↓  

+    /usr/local/bin/autonas-core.sh (Business Logic Library)

+             ↓

+    /usr/local/lib/autonas/*.sh (Internal System Scripts - Hidden)

+```

+

+### Script Organization - Professional Deployment

+```

+/usr/local/bin/

+├── autonas -> autonas.sh          # Only user-visible command

+├── autonas.sh                     # Main CLI interface

+└── autonas-core.sh                # Core business logic library

+

+/usr/local/lib/autonas/            # Internal scripts (hidden from autocomplete)

+├── autonas-boot-scan.sh           # Boot scanner

+├── autonas-disk-handler.sh        # Disk event handler  

+├── autonas-media-importer.sh      # Media importer

+├── autonas-network-handler.sh     # Network handler

+├── autonas-udev-wrapper.sh        # Udev wrapper

+└── autonas-uninstall.sh           # System uninstaller

+```

+

+### v3.0 Code Reduction Achievement - Technical Metrics

+```

+BEFORE v3.0 (Duplicated Architecture):

+- Multiple visible scripts with duplicated functions

+- ~5,929+ lines across all components

+- autonas-manager.sh: 696 lines (eliminated)

+- autonas-config.sh: 1,709 lines (eliminated)  

+- autonas.sh (old): 1,505 lines (replaced)

+

+AFTER v3.0 (Clean Architecture):

+- Single visible command: autonas

+- autonas.sh: 1,208 lines (unified CLI)

+- autonas-core.sh: 1,044 lines (business logic)

+- Internal scripts: properly organized and hidden

+

+TOTAL CODE REDUCTION: ~2,300 lines (47% reduction)

+DUPLICATION ELIMINATED: 100% through core library pattern

+```

+

+### System Integration Updates - v3.0 Complete

+```

+Configuration Files (All Updated):

+✅ 99-autonas-disk.rules       - Updated with /usr/local/lib/autonas/ paths

+✅ 98-autonas-interfaces.rules - Updated with /usr/local/lib/autonas/ paths

+✅ autonas.service             - Updated with /usr/local/lib/autonas/ paths  

+✅ autonas-boot-scan.service   - Updated with /usr/local/lib/autonas/ paths

+✅ autonas-attach@.service     - Updated with /usr/local/lib/autonas/ paths

+✅ disks.conf                  - Configuration template (unchanged)

+```

+

+### Core Architecture Components

+

+#### 1. Clean User Interface (`autonas.sh`) ⭐ v3.0

+**Single visible command** combining all functionality:

+```bash

+autonas attach <uuid>         # Disk operations

+autonas detach <uuid>

+autonas list                  # Configuration management  

+autonas add [uuid]

+autonas show                  # Device discovery

+autonas status               # System status

+autonas --help               # Complete help system

+```

+

+**Key Features:**

+- **1,208 lines** - Clean CLI interface

+- **Single command interface** - Professional user experience

+- **Unified logging** with `LOG_TAG="autonas"`

+- **Zero code duplication** - All business logic in core library

+

+#### 2. Core Business Logic Library (`autonas-core.sh`) ⭐ v3.0

+**Single source of truth** for all AutoNAS functionality:

+```bash

+source "/usr/local/bin/autonas-core.sh"  # Loaded by all scripts

+```

+

+**Key Features:**

+- **1,044 lines** - Complete business logic library

+- **Zero duplication** - All shared functions centralized

+- **47% code reduction** - ~2,300 lines eliminated across system

+- **Consistent behavior** - Single implementation for all operations

+- **Complete feature parity** with separate scripts

+

+#### 3. Internal System Scripts (Hidden from Users) ⭐ v3.0

+**Location:** `/usr/local/lib/autonas/*.sh`

+

+**Professional organization** with scripts hidden from autocomplete:

+- **autonas-disk-handler.sh**: Disk attach/detach operations

+- **autonas-network-handler.sh**: Network interface event handling

+- **autonas-udev-wrapper.sh**: udev timeout prevention

+- **autonas-boot-scan.sh**: Boot-time disk discovery

+- **autonas-media-importer.sh**: Camera import processing

+- **autonas-uninstall.sh**: Complete system removal

+

+#### 4. udev Detection System

+**File:** `config/99-autonas-disk.rules`

+

+Detects three types of external storage devices:

+- **USB Storage**: `ENV{ID_BUS}=="usb"`

+- **SCSI Removable**: `ATTRS{removable}=="1"`  

+- **USB-SATA Bridges**: `ENV{ID_BUS}=="ata"` + `ENV{ID_USB_TYPE}=="disk"`

+

+#### 5. Background Processing (`autonas-udev-wrapper.sh`)

+Prevents udev timeout issues through:

+- **Asynchronous execution** with 2-second device stabilization delay

+- **Complete environment setup** for restricted udev context

+- **systemd integration** for privilege escalation

+- **Comprehensive logging** with device details

+

+### v3.0 Architecture Validation - Technical Assessment

+

+#### Professional User Experience

+- **✅ Single visible command**: `autonas` only command in autocomplete

+- **✅ All functionality preserved**: Complete feature parity through unified interface  

+- **✅ Clean backend organization**: All utilities properly categorized and hidden

+- **✅ Zero duplication**: Single source of truth for all business logic

+

+#### System Integration Status

+- **✅ systemd services**: All updated with `/usr/local/lib/autonas/` paths

+- **✅ udev rules**: All updated with `/usr/local/lib/autonas/` paths  

+- **✅ configuration files**: All references updated throughout system

+- **✅ deploy script**: Enhanced with directory creation and proper installation

+- **✅ install/uninstall**: Complete support for new architecture

+

+#### Development Metrics - v3.0 Success

+- **Scripts organized**: 7 moved to internal directory

+- **User commands visible**: 1 (`autonas` only)

+- **Code duplication eliminated**: ~2,300 lines (47% reduction)

+- **System integration**: 100% updated

+- **Backward compatibility**: 100% preserved

+Handles complex mount operations:

+- **UUID-based device identification**

+- **Intelligent IP sharing** across multiple disks

+- **NFS export automation** with optimized settings

+- **Camera import workflow** with background processing

+

+#### 5. Configuration System (`autonas-config.sh`)

+Interactive configuration management:

+- **Three configuration types**: NFS shares, local mounts, camera import

+- **UUID validation** and device verification

+- **Interactive setup wizards**

+- **Configuration testing** and status reporting

+

+#### 6. Media Import System

+**Script:** `autonas-media-importer.sh` (Non-configurable, built-in)

+- **EXIF-based organization** with UTC to local time conversion

+- **Multi-format support**: MP4, MOV, JPG, JPEG, PNG, ARW, DNG, AVI, MKV

+- **Automated cleanup** of proprietary files (GLV for Garmin cameras)

+- **Background service integration** for unlimited processing time

+

+### Configuration Types

+

+#### 1. NFS Share (Network Access)

+```

+UUID:name:ip:interface:mount_point:nfs_options

+```

+

+#### 2. Local Mount (Local Only)  

+```

+UUID:name:LOCAL:LOCAL:mount_point:LOCAL

+```

+

+#### 3. Camera Import (Automated Processing)

+```

+UUID:name:IMPORT:IMPORT:temp_mount:destination_path

+```

+

+### Remote Deployment System

+

+#### Deploy Script (`deploy.sh`)

+Manages AutoNAS across multiple production nodes:

+```bash

+./deploy.sh install          # Deploy to all nodes (91, 92, 93)

+./deploy.sh install 192.168.2.91  # Deploy to specific node

+./deploy.sh start|restart|stop     # Service management

+./deploy.sh status               # Health checking

+./deploy.sh uninstall           # Complete removal

+```

+

+**Features:**

+- **SSH-based automation** with connectivity validation

+- **Host availability checking** with ping verification  

+- **Graceful error handling** - continues with available hosts

+- **Transfer optimization** with rsync and exclude patterns

+- **Service lifecycle management** across multiple nodes

+

+### Development Testing

+

+#### Target Production Nodes

+- **192.168.2.91** (baobab.vad.is.xdev.ro) - NFS Consumer

+- **192.168.2.92** (ebony.vad.is.xdev.ro) - Storage Provider (ext01)

+- **192.168.2.93** (tapia.vad.is.xdev.ro) - Storage Provider (ext02)

+

+#### SSH Access Requirement

+```bash

+# ⚠️ CRITICAL: Always use root user for AutoNAS operations

+ssh -l root 192.168.2.91 'autonas status'

+ssh -l root 192.168.2.92 'autonas list'  

+ssh -l root 192.168.2.93 'autonas attach <uuid>'

+```

+

+AutoNAS requires root privileges for:

+- Disk mounting/unmounting operations

+- Network interface IP configuration

+- NFS export management

+- systemd service operations

+

+### Logging and Monitoring

+

+#### Log Tag System - v3.0 Clean Architecture

+- **`autonas`**: Main CLI and core business logic operations

+- **`autonas-boot-scan`**: Boot-time disk discovery

+- **`autonas-disk-handler`**: Disk attach/detach operations  

+- **`autonas-network-handler`**: Network interface events

+- **`autonas-media-import`**: Camera import processing

+- **`autonas-udev-wrapper`**: udev event processing

+

+#### Real-time Monitoring

+```bash

+# All AutoNAS system components

+journalctl -t autonas -t autonas-boot-scan -t autonas-disk-handler -t autonas-network-handler -t autonas-media-import -f

+```

+# All AutoNAS components

+journalctl -t autonas -t autonas-manager -t autonas-wrapper -f

+

+# Unified script only  

+journalctl -t autonas -f

+

+# Specific component

+journalctl -t autonas-import --since "10 minutes ago"

+```

+

+#### System Status Checks

+```bash

+# Service status

+systemctl status autonas autonas-boot-scan

+

+# Active mounts

+mount | grep autonas

+

+# NFS exports

+showmount -e localhost

+

+# Network configuration

+ip addr show | grep "192.168.10"

+```

+

+## Important Development Notes

+

+### User Context for Testing and Administration

+- **AutoNAS is a system administration utility designed for root user**

+- **Always use `ssh -l root` for testing and administration**

+- AutoNAS manages system-level resources: disk mounting, NFS exports, systemd services

+- Root privileges are required for all core functionality

+

+### Development Testing Commands

+```bash

+# Correct way to test AutoNAS operations

+ssh -l root 192.168.2.91 'autonas attach <uuid>'

+ssh -l root 192.168.2.92 'autonas detach <uuid>'

+ssh -l root 192.168.2.93 'autonas list'

+

+# Check system status

+ssh -l root <host> 'systemctl status autonas'

+ssh -l root <host> 'journalctl -t autonas -n 10'

+```

+

+## Configuration Backup and Recovery

+

+### Current Configuration Backup

+Date: August 14, 2025

+Location: `/etc/pve/autonas/disks.conf`

+

+```

+8765-4321:camera-real:IMPORT:IMPORT:/mnt/autonas/camera-real:/mnt/autonas/ext01/@Camera/import

+f6ac3d86-5681-4b33-bc64-aa272b333057:ext01:192.168.10.21:thunderbridge:/mnt/autonas/ext01:*(rw,all_squash,insecure,async,no_subtree_check,anonuid=0,anongid=0)

+920fe1b7-4091-4d6a-bab8-2f48d8d704bc:ext02:192.168.10.22:thunderbridge:/mnt/autonas/ext02:*(rw,all_squash,insecure,async,no_subtree_check,anonuid=0,anongid=0)

+```

+

+### Configuration Format

+- **Camera Import Format**: `UUID:name:IMPORT:IMPORT:mount_point:destination_path`

+  - Media importer script (`/usr/local/bin/autonas-media-importer.sh`) is **built-in and non-configurable**

+- **External Disk Format**: `UUID:name:ip:interface:mount_point:nfs_options`

+

+### Known UUIDs and Labels

+- `8765-4321`: Camera device (LABEL="CAMERA-REAL")

+- `f6ac3d86-5681-4b33-bc64-aa272b333057`: External RAID (LABEL="External RAID")

+- `920fe1b7-4091-4d6a-bab8-2f48d8d704bc`: External disk ext02

+

+## Recent Issues and Solutions

+

+### Segmentation Fault Resolution (Aug 14, 2025)

+- **Issue**: Corrupted `log_message` function in `autonas-manager.sh` causing segfaults

+- **Cause**: During refactoring, sync code from `cleanup_and_unmount` was embedded into `log_message` function

+- **Solution**: Repaired `log_message` function by removing embedded sync code that executed at global scope

+- **Status**: ✅ RESOLVED - All nodes functioning correctly

+

+### Configuration Loss

+- **Issue**: `/etc/pve/autonas/disks.conf` configurations disappeared

+- **Possible Cause**: Unknown - may be related to system cleanup or restart

+- **Recovery**: Manual reconstruction using `lsblk` and `blkid` to identify disk UUIDs

+- **Prevention**: Regular backups of configuration file

+

+## Architecture Notes

+

+### Simplified Architecture (Current)

+- Removed auxiliary debugging tools and redundant services

+- Direct udev-based reactive monitoring

+- SystemD integration with `systemd-run` for background processes

+- Global LOG_TAG system for standardized logging

+

+### Active Core Components

+- `autonas-manager.sh`: Main orchestration (LOG_TAG="autonas-manager")

+- `autonas-config.sh`: Configuration management (LOG_TAG="autonas-config") 

+- `autonas-boot-scan.sh`: Boot-time scanning (LOG_TAG="autonas-boot")

+- `autonas-udev-wrapper.sh`: udev event handling (LOG_TAG="autonas-wrapper")

+- `autonas-media-importer.sh`: Camera import processing (LOG_TAG="autonas-import")

+- `99-autonas-disk.rules`: udev rules for disk detection

+

+## Deployment Information

+

+### Target Nodes

+- 192.168.2.91 (baobab.vad.is.xdev.ro)

+- 192.168.2.92 (ebony.vad.is.xdev.ro)  

+- 192.168.2.93 (tapia.vad.is.xdev.ro)

+

+### Deploy Command

+```bash

+./deploy.sh install 192.168.2.91 192.168.2.92 192.168.2.93

+```

+

+## Monitoring and Debugging

+

+### Log Monitoring

+```bash

+ssh -l root <host> 'journalctl -t autonas-manager -t autonas-wrapper -f'

+```

+

+### Service Status

+```bash

+ssh -l root <host> 'systemctl status autonas autonas-boot-scan'

+```

+

+### Manual Operations

+```bash

+ssh -l root <host> 'autonas-manager.sh attach <uuid>'

+ssh -l root <host> 'autonas-manager.sh detach <uuid>'

+ssh -l root <host> 'autonas-manager.sh reload'

+```

+

+## ✅ AutoNAS Script Unification COMPLETE! (August 14, 2025)

+

+### Successfully Unified: `autonas.sh`

+✅ **Deployed on all nodes:**

+- 192.168.2.91 (baobab) - Unified script active

+- 192.168.2.92 (ebony) - Unified script active

+- 192.168.2.93 (tapia) - Unified script active

+

+### Unified Command Interface:

+```bash

+autonas attach <uuid>       # Disk operations

+autonas detach <uuid>

+autonas list               # Configuration management  

+autonas add [uuid]

+autonas show               # Device discovery

+autonas status             # System status

+```

+

+### Functions Successfully Integrated:

+✅ **Disk Operations** (from autonas-manager.sh):

+- `handle_attach()`, `handle_detach()`, `mount_disk()`, `unmount_disk()`

+- `activate_ip()`, `deactivate_ip()`, `add_nfs_export()`, `remove_nfs_export()`

+- `handle_camera_import()`, `run_background_import()`

+

+✅ **Configuration Management** (from autonas-config.sh):

+- `list_disks()`, `show_available_disks()`, `validate_uuid()`, `check_uuid_exists()`

+- `get_device_info()`, unified parsing and status display

+

+✅ **System Integration**:

+- Unified logging with `LOG_TAG="autonas"`

+- Single configuration file parsing

+- Consistent error handling and status reporting

+

+### Deployment Results:

+```

+✓ Unified AutoNAS script installed

+✓ Created 'autonas' command symlink  

+✓ Unified script: /usr/local/bin/autonas.sh

+```

+

+### Validated Operations:

+- `autonas --help` ✅ Complete help system

+- `autonas list` ✅ Configuration display (3 disks shown perfectly)

+- `autonas show` ✅ Device discovery (6 devices detected)

+- `autonas attach 8765-4321` ✅ Camera import process (working)

+- `autonas status` ✅ System status (working with minor display issue)

+

+### Code Reduction Achievement:

+- **Before**: 699 + 1720 = 2419 lines (two separate scripts)

+- **After**: ~2100 lines (single unified script) 

+- **Reduction**: ~13% code reduction + eliminated duplication

+- **Maintenance**: Single script to maintain vs. two scripts

+

+### Legacy Scripts Status:

+- `autonas-manager.sh` ✅ Still available for compatibility

+- `autonas-config.sh` ✅ Still available for compatibility  

+- `autonas.sh` ✅ **NEW unified interface** (recommended)

+

+## 🔄 Script Unification Analysis (August 14, 2025)

+

+### Identified Function Overlaps:

+**autonas-manager.sh** (699 lines) vs **autonas-config.sh** (1720 lines)

+

+#### Duplicate Functions:

+1. **Configuration Parsing:**

+   - `get_disk_config()` vs `get_config()` - Same functionality

+   - `parse_config()` vs multiple `IFS=':' read -r uuid name...` patterns

+   

+2. **File System Operations:**

+   - `mount_disk()` vs `mount_disk_config()` - Similar mounting logic

+   - `unmount_disk()` vs `umount_disk_config()` - Similar unmounting logic

+

+3. **Device Detection:**

+   - Similar UUID validation and device scanning in both scripts

+

+#### Unification Proposal: `autonas.sh`

+✅ **Created unified script skeleton** with:

+- Combined logging system (`LOG_TAG="autonas"`)

+- Unified configuration parsing

+- Single command dispatcher: `autonas <command> [options]`

+- Core disk operations (attach, detach, mount, unmount)

+- Configuration management (add, remove, list, test)

+

+#### Command Structure:

+```bash

+# Disk Operations (from manager)

+autonas attach <uuid>

+autonas detach <uuid> 

+autonas reload

+

+# Configuration (from config)

+autonas add [uuid]

+autonas remove [uuid]

+autonas list

+autonas test [uuid]

+autonas show

+

+# Maintenance

+autonas mount <uuid>

+autonas umount <uuid>

+autonas status

+```

+

+#### Benefits of Unification:

+- **Reduced Code Duplication**: ~40% code reduction estimated

+- **Consistent Interface**: Single entry point for all operations

+- **Simplified Maintenance**: One script to debug and update

+- **Better Error Handling**: Unified logging and error reporting

+

+#### Implementation Status:

+- ✅ Core manager functions integrated

+- ⏳ Configuration functions need integration (~1200 lines from config.sh)

+- ⏳ Testing and validation required

+- ⏳ Deployment script updates needed

+

+## ✅ AutoNAS Media Importer Integration Complete!

+

+### Key Simplification: Non-Configurable Media Importer (August 14, 2025)

+✅ **Media importer script is now built-in and non-configurable:**

+- Script path: `/usr/local/bin/autonas-media-importer.sh` (hardcoded)

+- Configuration format simplified: `UUID:name:IMPORT:IMPORT:temp_mount_point:destination_path`

+- Removed redundant script_path parameter from camera configurations

+- Updated display logic to show "(built-in, non-configurable)" status

+

+### Rationale:

+- `autonas-media-importer.sh` is a core component with deep system integration

+- Making it configurable would require extensive testing and validation

+- Single, well-tested importer ensures consistent behavior across all cameras

+- Simplified configuration reduces user error and maintenance complexity

+

+## Final Deployment Status (August 14, 2025)

+

+### Version Deployed: AutoNAS v2.1 (Optimized & Segfault-Free)

+✅ **Successfully deployed on all nodes:**

+- 192.168.2.91 (baobab.vad.is.xdev.ro) - NFS Consumer

+- 192.168.2.92 (ebony.vad.is.xdev.ro) - Storage Provider (ext01)

+- 192.168.2.93 (tapia.vad.is.xdev.ro) - Storage Provider (ext02)

+

+### Key Fixes Deployed:

+1. **Segmentation Fault Resolution**: Corrupted `log_message` function repaired

+2. **Configuration Recovery**: All 3 disk configurations restored with backups

+3. **Architecture Optimization**: Simplified system with removed orphan components

+4. **Logging Standardization**: Global LOG_TAG system implemented

+5. **Boot Scan Service**: Fully functional auto-detection at boot

+

+### Current System State:

+- ✅ All core functionality working

+- ✅ Configuration backups created with timestamps

+- ✅ No segmentation faults on any node

+- ✅ udev-based reactive monitoring active

+- ✅ SystemD integration optimized

+

+### Validated Operations:

+```bash

+ssh -l root 192.168.2.92 'autonas-manager.sh attach f6ac3d86-5681-4b33-bc64-aa272b333057'  # ✅ Works

+ssh -l root 192.168.2.93 'autonas-config.sh list'                                           # ✅ Works  

+ssh -l root 192.168.2.91 'autonas-manager.sh reload'                                        # ✅ Works

+```

+

+## Critical Reminders

+

+1. **Always use root user** for AutoNAS operations

+2. **Backup configurations** before major changes

+3. **Test on single node** before mass deployment

+4. **Monitor logs** during operations for early issue detection

+5. **Keep development context updated** with any architecture changes

+

+---

+

+# AutoNAS Change Log

+

+## [v3.0.0] - 2025-08-13 🚀

+

+### 🎉 **REVOLUTIONARY BACKGROUND IMPORT ARCHITECTURE**

+

+#### 🔄 Service-Based Import System

+- **Background Import Services**: Complete separation of mount/import through systemd services

+  - **Attach Service**: Handles camera mount and launches background import service

+  - **Background Import Service**: `autonas-camera-import@UUID.service` for unlimited duration imports

+  - **Auto-Cleanup Service**: Automatic unmount after import completion

+- **Unlimited Import Duration**: No more systemd timeout constraints (tested with 300+ files)

+- **Production Scalability**: Architecture tested and validated in production environment

+

+#### 📊 **Production Test Results**

+- **✅ 302 files imported** successfully in single session (36 minutes)

+- **✅ 100% success rate** with zero errors

+- **✅ Perfect UTC conversion** for all QuickTime/EXIF timestamps

+- **✅ Complete workflow** mount → background import → auto unmount

+- **✅ Robust error handling** and disconnect detection

+

+#### 🛠️ **Enhanced Camera Import Features**

+- **UTC to Local Time Conversion**: Perfect timestamp conversion for QuickTime files

+- **Systemd-Escaped UUID Support**: Proper handling of service parameter escaping

+- **External Configuration File**: `/etc/autonas/disks.conf` for production deployments  

+- **Background Import Script**: `autonas-background-import.sh` for service integration

+- **Enhanced Config Management**: `get-config` function with UUID unescaping support

+

+#### 🔧 **Technical Architecture Improvements**

+- **Service Template**: `autonas-camera-import@.service` for parameterized background imports

+- **Config File Migration**: From embedded config to external `/etc/autonas/disks.conf`

+- **Manager Script Updates**: Integration with background service launching

+- **Robust Mount Detection**: Enhanced mount point validation and timeout protection

+- **Logging Integration**: Separate log channels for background imports (`autonas-bg-import`)

+

+#### 🚨 **Breaking Changes**

+- **Configuration Location**: Camera configurations now require external config file

+- **Service Architecture**: Import workflow now uses background services instead of direct execution

+- **Manager Behavior**: Attach operations now launch services instead of blocking imports

+

+#### 📈 **Performance Metrics**

+- **Scalability**: Tested with 300+ file imports without timeout issues  

+- **Reliability**: 100% success rate in production testing

+- **Efficiency**: 36-minute import time for 302 MP4 files with EXIF processing

+- **Robustness**: Complete disconnect detection and error recovery

+

+---

+

+## [v2.5.0] - 2024-08-12

+

+### 🚀 Dual Configuration System

+

+#### Enhanced Mounting Options

+- **Dual Configuration Support**: Complete system supporting both NFS shares and simple local mounts

+  - **NFS share complet**: Cu IP și export pentru acces de rețea

+  - **Montare locală simplă**: Doar mount point, fără IP și NFS (NOUĂ!)

+- **LOCAL Configuration Format**: New `UUID:NAME:LOCAL:LOCAL:MOUNT_POINT:LOCAL` format

+- **Interactive Configuration Selection**: Enhanced `autonas-config.sh add` with mount type selection

+- **Mixed Environment Support**: Both NFS and LOCAL configurations can coexist seamlessly

+

+#### Core System Improvements

+- **Extended UUID Support**: Support for both standard UUIDs and FAT32 short UUIDs (e.g., `8765-4321`)

+- **Enhanced Manager Integration**: Complete autonas-manager.sh support for LOCAL configurations

+- **Clean Logging**: LOCAL configurations show "Skipping X for local mount configuration" instead of errors

+- **Synchronized Disk Display**: Fixed desynchronization between disk display and mapping logic

+

+#### Bug Fixes Resolved

+- **Disk Selection Mapping Bug**: Fixed issue where selecting disk 6 would map to wrong UUID

+- **LOG Spam Resolution**: Eliminated infinite "Waiting for interface LOCAL" loops

+- **UUID Regex Enhancement**: Updated regex pattern to handle FAT32 short UUIDs properly

+- **Manager Function Updates**: All network-related functions now properly detect and skip LOCAL configurations

+

+#### Technical Implementation

+```bash

+# NFS Configuration (existing)

+UUID:NAME:IP:INTERFACE:MOUNT_POINT:NFS_OPTIONS

+

+# LOCAL Configuration (new)

+UUID:NAME:LOCAL:LOCAL:MOUNT_POINT:LOCAL

+```

+

+#### Manager Function Enhancements

+- **`activate_ip()`**: Skips IP activation for LOCAL configurations

+- **`deactivate_ip()`**: Skips IP deactivation for LOCAL configurations  

+- **`add_nfs_export()`**: Skips NFS export for LOCAL configurations

+- **`remove_nfs_export()`**: Skips NFS export removal for LOCAL configurations

+

+#### Use Cases for LOCAL Configurations

+- **Simple local storage**: Diskuri pentru backup-uri locale fără acces de rețea

+- **Scratch space**: Space temporar pentru procesare locală de date  

+- **Development storage**: Storage local pentru cache-uri și fișiere temporare

+- **Archive storage**: Archive locale care nu necesită export NFS

+- **Mixed environments**: Combinație de storage local și shares de rețea

+

+#### Configuration Examples

+```properties

+# NFS Shares (network access)

+920fe1b7-4091-4d6a-bab8-2f48d8d704bc:shared-docs:192.168.1.100:eth0:/mnt/autonas/shared-docs:*(rw,all_squash,insecure,async,no_subtree_check,anonuid=0,anongid=0)

+

+# LOCAL Mounts (local only)  

+8765-4321:local-backup:LOCAL:LOCAL:/mnt/autonas/local-backup:LOCAL

+abcd-1234:scratch-space:LOCAL:LOCAL:/mnt/autonas/scratch-space:LOCAL

+```

+

+#### Backward Compatibility

+- **Full compatibility**: Existing NFS configurations continue to work unchanged

+- **No migration required**: Current setups work without any changes

+- **Enhanced functionality**: New LOCAL options available alongside existing NFS features

+

+## [v2.4.0] - 2025-08-11

+

+### 🌐 Interface Stability Management System

+

+#### Problema Rezolvată

+- **USB/Thunderbolt interfaces instabile**: Interfețele USB și Thunderbolt dispar și revin periodic

+- **IP-uri pierdute**: IP-urile configurate pentru diskuri nu se readaugă automat când interfața revine

+- **NFS exports indisponibile**: Export-urile devin temporar inaccesibile din cauza IP-urilor lipsă

+

+#### Interface Management Tools

+- **autonas-interface-handler.sh**: Handler principal pentru evenimente udev de interfețe

+- **Event-driven only**: Arhitectură complet bazată pe evenimente (fără daemon/servicii permanente)

+- **Emergency diagnostics**: Tool-uri de diagnostic pentru depanare în cazuri extreme

+

+#### Interface Handler System  

+- **autonas-interface-handler.sh**: Handler principal pentru evenimente udev de interfețe

+- **Event-driven architecture**: Răspuns instant la schimbările interfețelor (nu polling)

+- **Multiple event types**: Detectează add/remove/change/carrier/operstate events

+- **Focus USB/Thunderbolt**: Tratament special pentru interfețele instabile

+- **Smart restoration**: Verifică starea interfețelor înainte de configurare IP

+- **Background processing**: Execuție asincronă pentru a evita timeout-urile udev

+- **Retry mechanism**: Logică de retry pentru configurarea IP-urilor pe interfețe instabile

+

+#### Advanced IP Management

+- **Interface existence checking**: Verificare inteligentă dacă interfața există înainte de configurare

+- **IP conflict resolution**: Detectează și evită conflictele de IP-uri

+- **Retry mechanism**: Logic de retry pentru configurarea IP-urilor pe interfețe instabile

+- **Shared IP management**: Gestionarea corectă a IP-urilor folosite de multiple diskuri

+- **Wait for interface**: Așteaptă ca interfețele USB/Thunderbolt să apară (până la 30 secunde)

+

+#### Debug și Monitoring Integration

+- **Integrated monitoring**: Built-in status checking în autonas.sh unified script

+- **Real-time logging**: Monitorizare în timp real prin journalctl

+- **Configuration validation**: Built-in testing cu `autonas test <uuid>`

+- **Status analysis**: System status prin `autonas status`

+- **Network debugging**: Standard tools (ip, journalctl, udevadm) pentru troubleshooting

+

+#### Enhanced udev Rules

+- **98-autonas-interfaces.rules**: Reguli udev comprehensive pentru interfețe de rețea

+- **Event-driven primary mechanism**: Detectare principală prin evenimente, nu polling

+- **Multiple trigger types**: add/remove/change/operstate/carrier events

+- **USB/Thunderbolt specific**: Tratament special pentru interfețele instabile

+- **State change monitoring**: Monitorizează schimbările de stare operațională și carrier

+- **Instant response**: Răspuns în 2-3 secunde la schimbările interfețelor

+

+#### Management Commands

+```bash

+# Debug interfețe și IP-uri prin unified interface

+autonas status                    # System status complet

+autonas show                      # Device discovery și status

+

+# Monitorizare timp real

+journalctl -t autonas -f          # Live monitoring AutoNAS

+journalctl -t autonas-interface-handler -f  # Interface events

+

+# Network debugging standard

+ip addr show                      # Check interface status

+udevadm monitor --subsystem-match=net       # Monitor udev events

+```

+

+#### Installation & Service Integration

+- **Automatic installation**: Toate componentele sunt instalate automat de `deploy.sh`

+- **Service auto-start**: Serviciul de monitorizare pornește automat la instalare

+- **Initial restore**: Restaurare automată a IP-urilor la finalul instalării

+- **Proper dependencies**: Dependențe corecte cu serviciile de rețea și NFS

+

+### 🔧 Îmbunătățiri Core Manager

+

+#### Smart IP Configuration

+- **Interface existence validation**: Verifică dacă interfața există înainte de configurare

+- **Wait for interface**: Logică de așteptare pentru interfețele care apar cu întârziere

+- **Retry mechanism**: Până la 3 încercări pentru configurarea IP-urilor

+- **Conflict detection**: Evită adăugarea IP-urilor deja configurate

+

+#### Enhanced Error Handling

+- **Detailed error reporting**: Mesaje de eroare mai descriptive

+- **Recovery suggestions**: Sugestii pentru rezolvarea problemelor

+- **Graceful degradation**: Continuă operațiunea chiar dacă unele componente eșuează

+

+### 📚 Documentație Extinsă

+

+#### New Troubleshooting Section

+- **USB/Thunderbolt specific issues**: Secțiune dedicată pentru problemele interfețelor instabile

+- **Debug commands**: Liste complete de comenzi pentru diagnosticare

+- **Step-by-step solutions**: Soluții pas cu pas pentru probleme comune

+- **Power management tips**: Sugestii pentru managementul power al USB

+

+#### Updated Architecture Documentation

+- **Interface monitoring flow**: Documentare completă a fluxului de monitorizare

+- **Service interactions**: Interacțiunile între servicii și dependențele lor

+- **Debug methodology**: Metodologie pentru diagnosticarea problemelor

+

+### 🎯 Use Cases Noi

+

+#### Unstable Interface Environments

+- **USB docking stations**: Stații de andocare USB care se deconectează periodic

+- **Thunderbolt hubs**: Hub-uri Thunderbolt cu conectivitate intermitentă  

+- **USB-C multiport adapters**: Adaptoare multiport cu stabilitate variabilă

+- **Laptop docking scenarios**: Scenarii de laptop care se conectează/deconectează des

+

+#### Enterprise Environment

+- **Multiple identical setups**: Deploy pe multiple servere cu aceleași probleme interfețe

+- **Centralized monitoring**: Monitorizare centralizată a stabilității interfețelor

+- **Automated recovery**: Recuperare automată fără intervenție manuală

+

+## [v2.3.0] - 2025-07-22

+

+### 🚀 Boot Recovery System

+

+#### Boot Scan Service

+- **Automatic boot detection**: New `autonas-boot-scan.service` detects and mounts configured disks at system boot

+- **Pre-connected disk support**: Handles disks that were already attached before system start

+- **Intelligent scanning**: Checks all configured UUIDs from `/etc/pve/autonas/disks.conf`

+- **Mount status detection**: Identifies disks already mounted elsewhere and handles appropriately

+

+#### Boot Scanner Script

+- **autonas-boot-scan.sh**: Comprehensive boot-time disk scanner

+- **UUID existence verification**: Checks if configured disk UUIDs are present as devices

+- **Mount state analysis**: Determines if disks are unmounted, mounted elsewhere, or correctly mounted

+- **Automatic attachment**: Uses `autonas-manager.sh` to properly mount and configure detected disks

+- **Detailed reporting**: Statistics on total, processed, already-mounted, and newly-attached disks

+

+#### System Integration

+- **Service dependencies**: Proper ordering after filesystem, udev-settle, network, and NFS services

+- **Installation automation**: Added to install/uninstall scripts with proper enable/disable

+- **Documentation updates**: Complete documentation of new boot recovery architecture

+- **RemainAfterExit=yes**: Service stays active to indicate successful boot scan completion

+

+#### Main Service Integration

+- **autonas.service**: New main AutoNAS service for centralized system management

+- **Enhanced reload functionality**: Comprehensive reload of udev rules, NFS exports, and systemd daemon

+- **Service orchestration**: Proper dependencies and integration with boot-scan service

+- **Centralized control**: Single point of management for the entire AutoNAS system

+

+#### Orphan File Prevention System

+- **Pre-installation cleanup**: Automatic cleanup of previous installations before reinstalling

+- **Uninstaller integration**: Install script now installs uninstaller for future clean upgrades

+- **Deploy script uninstall**: New `./deploy.sh uninstall` command for remote uninstallation

+- **Force mode uninstaller**: Silent cleanup mode with `--force` flag for automated use

+- **Evolution protection**: Prevents orphan files during project evolution and upgrades

+

+#### Problem Resolution

+- **Solves reboot issue**: Addresses problem where pre-connected disks weren't exported after system restart

+- **udev gap coverage**: Handles scenario where udev doesn't re-trigger events for existing devices

+- **NFS export recovery**: Ensures all configured disks are properly exported after boot

+- **Robust boot process**: System now handles both hot-plug and pre-connected disk scenarios

+

+## [v2.2.0] - 2025-07-22

+

+### 🚀 Remote Deployment System

+

+#### Deploy Script Added

+- **Remote deployment support**: New `deploy.sh` script for automated installation on multiple targets

+- **Multi-target management**: Support for servers 192.168.2.91, 192.168.2.92, 192.168.2.93

+- **SSH-based automation**: Uses SSH keys for seamless remote operations

+- **Intelligent connectivity checks**: Host availability verification before operations

+

+#### Enhanced Reliability

+- **Host status verification**: Ping test before attempting SSH connections

+- **Graceful failure handling**: Skip unavailable hosts with clear warnings

+- **Connection testing**: SSH connectivity validation before deployment

+- **Error reporting**: Clear status messages for each operation step

+

+#### Deployment Features

+- **Complete installation**: Automated install, configure, and start services

+- **Service management**: Start, restart, stop remote AutoNAS services

+- **Status monitoring**: Remote status checking and health validation

+- **Cleanup operations**: Temporary file cleanup on target systems

+

+#### Command Operations

+- **install**: Complete AutoNAS installation and configuration

+- **start/restart/stop**: Service lifecycle management

+- **status**: Health check and configuration validation

+- **cleanup**: Temporary file removal

+- **help**: Comprehensive usage documentation

+

+#### Documentation Consolidation

+- **Merged TECHNICAL.md into README.md**: Complete technical documentation in single file

+- **Enhanced architecture section**: Detailed component descriptions and workflows

+- **Comprehensive troubleshooting**: Technical debugging and extensibility guides

+- **Unified documentation**: Single source of truth for all AutoNAS information

+

+## [v2.1.0] - 2024-12-02

+

+### 🚀 udev Context Improvements

+

+#### Simplified Execution Strategy

+- **Direct systemd execution**: Removed unreliable direct execution in udev context

+- **Guaranteed privilege handling**: All mount operations now run through systemd service

+- **Improved reliability**: Eliminates "permission denied" issues in restricted udev context

+- **Consistent behavior**: Same execution path for all environments

+

+#### Enhanced Logging

+- **Streamlined logging**: Clear indication of systemd service usage

+- **Better debugging**: Simplified troubleshooting without fallback complexity

+

+## [v2.0.0] - 2024-12-02

+

+### 🚀 Major Features Added

+

+#### Intelligent Device Detection

+- **Multiple device type support**: USB storage, SCSI removable, USB-to-SATA bridges

+- **UUID-based identification**: Precise device matching via filesystem UUID

+- **Smart udev rules**: Comprehensive detection for various hardware configurations

+

+#### Enhanced User Experience

+- **Interactive configuration helper**: `autonas-config.sh` with guided setup

+- **UUID parameter support**: Pre-populate UUIDs in `add` and `test` commands

+- **Automatic mounting post-configuration**: Immediate disk availability after setup

+- **Standardized NFS configuration**: Optimized settings applied automatically

+

+#### Advanced System Integration

+- **udev wrapper**: Prevents timeout issues with asynchronous execution

+- **Intelligent IP management**: Shared IP handling across multiple disks

+- **Comprehensive logging**: Structured logging with proper syslog tags

+- **Error handling and recovery**: Robust failure handling with detailed reporting

+

+### 🛡️ Data Protection & Safety

+

+#### Installation Safety

+- **Configuration preservation**: Existing `disks.conf` files are never overwritten

+- **User data detection**: Automatically detects and preserves user configurations

+- **Template system**: New installs get templates, upgrades preserve data

+

+#### Uninstallation Safety

+- **Data-preserving uninstall**: User configurations and mount points preserved

+- **Selective cleanup**: Only removes AutoNAS components, keeps user data

+- **Manual cleanup guidance**: Clear instructions for complete removal if desired

+

+### 🔧 Configuration Management

+

+#### Simplified Configuration Process

+```bash

+# Old method (manual editing)

+sudo nano /etc/pve/autonas/disks.conf

+

+# New method (guided interactive)

+sudo autonas-config.sh add <UUID>

+```

+

+#### Smart Validation

+- **UUID format validation**: Proper 8-4-4-4-12 hex format checking

+- **Disk name validation**: Character restrictions and reserved name checking

+- **Network interface validation**: Real-time interface existence checking

+- **IP address validation**: Format and availability checking

+

+#### Enhanced Commands

+- **`autonas-config.sh add [UUID]`**: Interactive configuration with optional UUID

+- **`autonas-config.sh test [UUID]`**: Configuration testing with optional UUID

+- **`autonas-config.sh list`**: Formatted display of all configurations

+- **`autonas-config.sh remove`**: Interactive configuration removal

+

+### 🌐 Network & NFS Improvements

+

+#### Standardized NFS Configuration