openstamanager/README.md

9.5 KiB
Executable File

OpenSTAManager

Il software gestionale open-source per l'assistenza tecnica e la fatturazione.

Sito web · Documentazione · Forum


GitHub release Downloads SourceForge license huntr

Il gestionale OpenSTAManager è un software open-source e web based, sviluppato dall'azienda informatica DevCode di Este per gestire ed archiviare il servizio di assistenza tecnica e la relativa fatturazione. Il nome del progetto deriva dalla parziale traduzione in inglese degli elementi principali che lo compongono: la natura open-source e il suo obiettivo quale Gestore del Servizio Tecnico di Assistenza.

Un software gestionale, identificato nell'insieme degli applicativi che automatizzano i processi di gestione all'interno delle aziende, appartiene solitamente a una specifica categoria del settore, specializzata negli ambiti di:

  • Gestione della contabilità;
  • Gestione del magazzino;
  • Gestione e ausilio della produzione;
  • Gestione e previsione dei budget aziendali;
  • Gestione ed analisi finanziaria.

Secondo questa definizione, OpenSTAManager riesce a generalizzare al proprio interno le funzionalità caratteristiche della contabilità e della gestione del magazzino, presentando inoltre moduli piuttosto avanzati e destinati a complementare l'attività aziendale in relazione agli interventi di assistenza della realtà lavorativa in oggetto.

La documentazione ufficiale è disponibile all'indirizzo https://docs.openstamanager.com/.

Requisiti

L'installazione del gestionale richiede un server web con le seguenti tecnologie disponibili:

  • PHP 8.0+
  • Un database a scelta tra:
  • Accesso SSH (facoltativo)
  • Composer installato e disponibile da linea di comando (facoltativo)

e un dispositivo (client) con le seguenti tecnologie disponibili:

Alcune note:

  • Non è supportato nessun browser diverso dai precedenti, nemmeno in versioni più datate. Pertanto, anche se il gestionale potrebbe funzionare, non è garantita assistenza su tali browser. Si citano come esempi: Internet Explorer, Samsung Internet, Opera Mini, Opera Mobile, UC Browser, Safari per iOS.
  • È fortemente consigliato aggiornare sempre il proprio browser alla versione più recente e non interrompere la ricezione degli aggiornamenti raggiunta la versione minima indicata
  • Il gestionale viene testato sui 3 principali browser (Edge, Chrome, Firefox) nella loro versione più recente

Per ulteriori informazioni sui pacchetti che forniscono questi elementi di default, visitare la sezione Installazione della documentazione.

Dipendenze

Per installare le dipendenze del gestionale sono necessari i seguenti strumenti (installati sul server web o su un PC da utilizzare per la preparazione del progetto):

Installazione

Per procedere all'installazione è necessario seguire i seguenti punti:

  1. Scaricare una release ufficiale del progetto.

  2. Creare una cartella (ad esempio openstamanager) nella root del server web installato ed estrarvi il contenuto della release scaricata. Il percorso della cartella root del server varia in base al software in utilizzo:

    • LAMP (/var/www/html)
    • XAMPP (C:/xampp/htdocs per Windows, /opt/lampp/htdocs/ per Linux, /Applications/XAMPP/htdocs/ per MAC)
    • WAMP (C:\wamp\www)
    • MAMP (C:\MAMP\htdocs per Windows, /Applications/MAMP/htdocs per MAC)
  3. Creare un database vuoto (tramite PHPMyAdmin o riga di comando).

  4. Accedere a http://localhost/openstamanager dal vostro browser.

  5. Inserire i dati di configurazione per collegarsi al database.

  6. Procedere all'installazione del software, cliccando sul pulsante Installa.

Attenzione: è possibile che l'installazione richieda del tempo. Si consiglia pertanto di attendere almeno qualche minuto senza alcun cambiamento nella pagina di installazione (in particolare, della progress bar presente) prima di cercare una possibile soluzione nelle discussioni del forum o nella sezione dedicata.

Versioni

Per mantenere un elevato grado di trasparenza riguardo al ciclo delle release, seguiamo le linee guida Semantic Versioning (SemVer) per definire le versioni del progetto. Per vedere tutte le versioni disponibili al download, visitare la pagina relativa su GitHub (per versioni precedenti alla 2.3, visitare SourceForge).

Nel caso utilizziate il programma per uso commerciale, si consiglia di scaricare le release disponibili nel sito ufficiale del progetto (https://www.openstamanager.com), evitando di utilizzare direttamente il codice della repository. Se siete inoltre interessati a supporto e assistenza professionali, li potete richiedere nella sezione dedicata.

GitHub

Nel caso si stia utilizzando la versione direttamente ottenuta dalla repository di GitHub, è necessario eseguire i seguenti comandi da linea di comando per completare le dipendenze PHP (tramite Composer) e gli assets (tramite PNPM) del progetto.

composer install --no-dev
pnpm install --prod
pnpm build

php artisan key:generate
php artisan migrate
php artisan vendor:publish

Per ulteriori informazioni, visitare le sezioni Assets e Framework della documentazione.

Perché software open-source

Il progetto è un software open-source perché permette agli utilizzatori di studiarne il funzionamento ed adattarlo alle proprie esigenze; inoltre, in ambito commerciale, non obbliga l'utilizzatore ad essere legato allo stesso fornitore di assistenza.

In questo modo è possibile ottenere un'ulteriore garanzia sul funzionamento del software, poiché chiunque ne abbia le capacità può verificarlo, escludendo mancanze in relazione alla sicurezza e alla privacy dei dati (caratteristica che il software proprietario non può offrire).

Community

La community è una componente importante in un progetto open-source, perché mette in contatto utenti e programmatori tra di loro e permette pertanto l'individuazione di soluzioni innovative e migliori.

Siamo presenti su Facebook, e il nostro forum ufficiale è disponibile all'indirizzo https://forum.openstamanager.com, dove potete segnalare i vostri problemi e soddisfare le vostre curiosità nelle sezioni più adeguate:

Attenzione: vi ricordiamo che non vi è nessuna garanzia che qualcuno risponda in tempo alle vostre richieste o problemi.

Contribuire

Per poter contribuire ed eseguire i test automatici, si consiglia di seguire le indicazioni descritte all'interno della documentazione ufficiale.

Licenza

Questo progetto è tutelato dalla licenza GPL 3.