Skip to content

App .NET MAUI per meccanici. Calcolo raccordi, conversioni e tabelle tecniche.

License

Notifications You must be signed in to change notification settings

Mugen85/MechTools

Repository files navigation

🔧 Mechtools - Assistente digitale per officina

Questa applicazione multipiattaforma è stata progettata per supportare montatori meccanici e manutentori nelle attività quotidiane di officina e cantiere. Il progetto nasce dalla volontà di unire l'esperienza pratica nel settore metalmeccanico con le competenze di sviluppo software, creando uno strumento che risolve problemi concreti in modo rapido e senza necessità di connessione internet. 📱⚙️

⚙️ Funzionalità lato meccanico

L'applicazione è sviluppata seguendo le reali necessità operative di chi lavora sul campo.

🔩 Convertitore vite-chiave intelligente

Permette di individuare immediatamente la chiave fissa o la brugola necessaria partendo dalla misura della vite e viceversa. Supporta lo standard ISO e gestisce le eccezioni per le misure pesanti fino a M52.

💧 Database raccordi idraulici

In sviluppo - Tabella di consultazione rapida per distinguere raccordi GAS (BSP) e NPT, con visualizzazione dei filetti per pollice (TPI) e diametri nominali.

🔍 Riconoscimento filettature

Strumento di calcolo per identificare la conicità dei raccordi tramite misurazione col calibro, utile quando non si dispone di un contafiletti.

🏗️ Architettura Software

Dal punto di vista tecnico, il progetto è realizzato per dimostrare una gestione pulita del codice e l'utilizzo dei più recenti standard di sviluppo Microsoft.

🎯 Framework

Sviluppato in C# su piattaforma .NET MAUI 9 per garantire la compatibilità nativa su Android e iOS con un'unica base di codice.

🎨 Pattern MVVM

L'architettura segue rigorosamente il pattern model-view-viewmodel per separare la logica di business dall'interfaccia utente. Questo rende il codice testabile, manutenibile e modulare.

🛠️ Community toolkit MVVM

Utilizzo del toolkit ufficiale per la gestione ottimizzata di ObservableProperty e RelayCommand, riducendo il codice boilerplate e migliorando le performance.

✨ Clean code

I dati tecnici (tabelle ISO, misure raccordi) sono isolati in servizi dedicati, rendendo semplice l'aggiornamento delle normative senza intaccare la logica dell'applicazione.

🎯 Obiettivi del Progetto

Questo repository serve come dimostrazione di competenza nello sviluppo full-stack mobile, evidenziando la capacità di trasformare un dominio di conoscenza specifico (la meccanica industriale) in una soluzione software strutturata e professionale.

📋 Requisiti

  • Visual Studio 2022 o successivi
  • Workload .NET multi-platform app UI installato
  • Android SDK (per l'emulazione)

🚀 Installazione

# Clona il repository
git clone https://github.com/tuousername/mechtools.git

# Apri la solution in Visual Studio
cd mechtools
start Mechtools.sln

💻 Utilizzo

  1. Seleziona l'emulatore Android o il dispositivo fisico
  2. Premi F5 per avviare l'applicazione in modalità debug
  3. Naviga tra le diverse funzionalità tramite il menu principale

📁 Struttura del Progetto

Mechtools/
├── Models/                  # Definizioni degli oggetti (Dati)
│   ├── BoltKey.cs           # Modello Chiavi/Bulloni
│   ├── Fitting.cs           # Modello Raccordi (Gas/NPT)
│   ├── ConversionItem.cs    # Modello dati per il Convertitore
│   └── ThreadItem.cs        # Modello Prefori Maschiatura
│
├── ViewModels/              # Logica di presentazione (MVVM)
│   ├── MainViewModel.cs       # Logica pagina Chiavi
│   ├── FittingsViewModel.cs   # Logica pagina Raccordi e Detector
│   ├── ConvertersViewModel.cs # Logica Conversione pollici/mm
│   └── DrillingViewModel.cs   # Logica filtri Prefori
│
├── Views/                   # Interfaccia Utente (XAML)
│   ├── MainPage.xaml        # Page Chiavi
│   ├── FittingsPage.xaml    # Page Raccordi
│   ├── ConvertersPage.xaml  # Page Convertitore
│   └── DrillingPage.xaml    # Page Prefori
│
├── Services/                # Logica di Business e Database statici
│   ├── BoltKeyService.cs    # Dati Chiavi ISO
│   ├── FittingService.cs    # Dati Raccordi e Algoritmo Detector
│   └── DrillingService.cs   # Dati Maschiatura (Passo Fine/Grosso)
│
└── Resources/               # Asset Grafici
    ├── AppIcon/             # Icone adattive Android/iOS
    └── Splash/              # Splash Screen brandizzata

🗺️ Roadmap e Funzionalità

Il progetto è in continuo sviluppo. Ecco lo stato attuale dei lavori:

  • Core & UI

    • Setup architettura MVVM con .NET MAUI.
    • Design System "Industrial" (Dark Mode, Contrasti elevati).
    • Icone adattive e Splash Screen professionali.
    • Navigazione tramite AppShell (Tabs).
  • Modulo Raccordi (Fittings)

    • Database Standard GAS (BSP) e NPT (fino a 2").
    • Smart Detector: Algoritmo per identificare il raccordo dal diametro misurato.
    • Distinzione visiva tra filetti Conici e Cilindrici.
  • Modulo Convertitore (Converter)

    • Motore di conversione Pollici/Millimetri.
    • Supporto input frazionario (es. "1/2", "3/8") e decimale.
    • Tabella di riferimento rapido integrata.
  • Modulo Prefori (Drilling)

    • Database Maschiatura Metrica (M3 - M24).
    • Supporto doppio standard: Passo Grosso (ISO) e Passo Fine.
    • Visualizzazione immediata diametro punta.
  • Modulo Velocità di Taglio (RPM)

    • Calcolatore Giri/min ($n = \frac{V_c \cdot 1000}{\pi \cdot D}$).
    • Database materiali (Acciaio, Inox, Alluminio, ecc.) con $V_c$ preimpostate.
  • Modulo Serraggio (Torque)

    • Tabella coppie di serraggio viti metriche (Classi 8.8, 10.9, 12.9).
    • Filtro per diametro vite.

🤝 Contributi

I contributi sono benvenuti! Sentiti libero di aprire issue o pull request per miglioramenti e nuove funzionalità.

📄 Licenza

Questo progetto è distribuito sotto licenza MIT. Vedi il file LICENSE per maggiori dettagli.


👤 Autore e Contatti

Questo progetto è sviluppato e mantenuto da Marco Morello, sviluppatore .NET e appassionato di meccanica. Il software nasce dall'esigenza reale di ottimizzare i tempi in officina e dalla volontà di applicare architetture software moderne (MVVM) in contesti industriali.

Se hai suggerimenti, vuoi segnalare un bug o discutere di opportunità lavorative, sentiti libero di contattarmi:


Progetto Open Source distribuito con licenza MIT.

⚠️ Nota: Questo è un progetto in continua evoluzione. Le funzionalità contrassegnate come "in sviluppo" potrebbero non essere completamente disponibili nella versione corrente.

About

App .NET MAUI per meccanici. Calcolo raccordi, conversioni e tabelle tecniche.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages