Il software gestionale open source per l'assistenza tecnica e la fatturazione
Go to file
pek5892 0b5c5183d0 Fix minore 2024-06-04 17:05:21 +02:00
.github Aggiornamento pagina per contributori 2022-07-19 22:15:43 +02:00
api Ottimizzazioni per php8.3 2024-05-23 11:36:25 +02:00
assets/src Fix style 2024-06-04 10:48:42 +02:00
backup Uniformazione righe interventi (#659) 2020-02-14 17:02:16 +01:00
config Aggiornamento del copyright notice 2021-01-20 15:08:51 +01:00
files Rimozione file deprecato 2023-06-08 16:31:06 +02:00
include Fix minori 2024-05-29 09:25:33 +02:00
lib Formattazione stile codice 2024-05-24 09:17:38 +02:00
locale Fix traduzione 2024-03-28 00:55:13 +01:00
logs Uniformazione righe interventi (#659) 2020-02-14 17:02:16 +01:00
modules Fix minore 2024-06-04 16:41:20 +02:00
plugins Fix per export scadenze con più banche 2024-06-03 17:14:09 +02:00
src Formattazione stile codice 2024-05-24 09:17:38 +02:00
templates Fix minore 2024-05-29 12:50:27 +02:00
update Fix minori 2024-05-29 09:25:33 +02:00
.editorconfig Uniformazione righe interventi (#659) 2020-02-14 17:02:16 +01:00
.gitattributes Uniformazione righe interventi (#659) 2020-02-14 17:02:16 +01:00
.gitignore Aggiunta verifica integrità db per MariaDB 10.x 2024-03-02 02:52:30 +01:00
.htaccess Fix per mimetype su file con estensione mjs 2023-11-29 16:45:46 +01:00
.php-cs-fixer.php Formattazione stile codice 2023-08-04 14:54:28 +02:00
.sami Uniformazione righe interventi (#659) 2020-02-14 17:02:16 +01:00
CHANGELOG.md Aggiornamento CHANGELOG 2024-05-31 16:19:57 +02:00
KNOWN-ISSUES.md Miglioria gestione traduzioni 2024-04-18 17:44:05 +02:00
LICENSE Aggiornamento della Licenza GPLv3 da GNU 2020-08-07 08:06:15 +02:00
README.md Fix minori 2024-05-14 11:56:24 +02:00
SECURITY.md Create SECURITY.md (#968) 2021-07-02 16:35:23 +02:00
actions.php Fix minori 2024-05-21 16:26:19 +02:00
add.php Migrazione parziale ad AdminLTE 3 2024-05-16 18:02:50 +02:00
ajax.php Aggiunta gestione calcolo media su colonne 2024-05-09 16:51:13 +02:00
ajax_complete.php Aggiornamento del copyright notice 2021-01-20 15:08:51 +01:00
ajax_dataload.php Migrazione parziale ad AdminLTE 3 2024-05-16 18:02:50 +02:00
ajax_search.php Aggiornamento del copyright notice 2021-01-20 15:08:51 +01:00
ajax_select.php Aggiornamento del copyright notice 2021-01-20 15:08:51 +01:00
composer.json Fix minori 2024-05-14 11:56:24 +02:00
composer_74.json Fix compatibilità 2024-05-13 17:26:12 +02:00
config.example.php Formattazione codice 2024-01-15 15:30:45 +01:00
controller.php Fix minore 2024-06-04 17:05:21 +02:00
core.php Fix minore 2024-04-10 17:43:54 +02:00
cron.php Miglioria gestione traduzioni 2024-04-18 17:44:05 +02:00
editor.php Fix sidebar 2024-05-23 18:39:25 +02:00
gulpfile.js Fix menu dropdown 2024-05-22 17:16:50 +02:00
index.php Fix login 2024-05-22 08:49:14 +02:00
info.php Migrazione parziale ad AdminLTE 3 2024-05-16 18:02:50 +02:00
log.php Migrazione parziale ad AdminLTE 3 2024-05-16 18:02:50 +02:00
mail.php Fix invio mail 2024-05-21 18:03:38 +02:00
oauth2.php Gestione login tramite Microsoft 2024-01-26 17:00:02 +01:00
oauth2_login.php Formattazione codice 2024-01-31 14:23:46 +01:00
package.json Aggiunta script rector 2024-05-21 15:03:47 +02:00
pdfgen.php Aggiunta tabella zz_prints_lang 2024-03-12 12:31:49 +01:00
psalm.xml Aggiunta psalm per migliorare lo sviluppo 2022-11-14 22:25:54 +01:00
rector.php Aggiornamento rector.php 2024-05-10 09:27:42 +02:00
reset.php Migrazione parziale ad AdminLTE 3 2024-05-16 18:02:50 +02:00
shortcuts.php Fix minori 2024-05-21 16:26:19 +02:00
view.php Formattazione codice 2024-03-22 15:52:24 +01:00

README.md

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

Sito web · Documentazione · Forum


GitHub release Downloads SourceForge license

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 software

L'installazione del gestionale richiede la presenza di un server web con abilitato il DBMS MySQL e il linguaggio di programmazione PHP.

PHP EOL Supportato
8.3 23/11/2026 ✔️
8.2 08/12/2025 ✔️
8.1 25/11/2024 ✔️
8.0 26/11/2023
7.4 28/11/2022
7.3 06/12/2021
MYSQL EOL Supportato
8.3 30/04/2024 ✔️
8.2 31/01/2024 ✔️
8.1 25/10/2023 ✔️
8.0 30/04/2026 ✔️
5.7 21/10/2023 ✔️
5.6 05/02/2021

Alcune dipendenze presenti dalla versione 2.5 non sono più compatibili con PHP 7.4 e PHP 8.0. Per continuare a utilizzare tali versioni di PHP, sarà necessario ricompilare utilizzando il file composer_74.json.

Per semplificarne l'installazione, la versione 2.5.2 sarà disponibile in un doppio zip con entrambe le versioni (compatibile con php < 8.1 e compatibile con php >= 8.1).

Dalla versione 2.5.3 sarà richiesta una versione di php >= 8.1, non sarà quindi disponibile al download il secondo file zip.

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

Requisiti hardware

Minimi:

  • 1 CPU
  • 2GB di ram
  • 200MB di spazio per il gestionale

Consigliati:

  • 2 CPU
  • 4GB di ram
  • 2GB di spazio per il gestionale

Installazione rapida

git clone https://github.com/devcode-it/openstamanager.git
cd openstamanager

# Download di composer da https://getcomposer.org/download/

yarn develop-OSM

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.

Build

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 Yarn) del progetto.

php composer.phar install
yarn global add gulp
yarn install
gulp

In alternativa alla sequenza di comandi precedente, è possibile utilizzare il seguente comando (richiede l'installazione di GIT e Yarn, oltre che l'inserimento dell'archivio composer.phar nella cartella principale del progetto):

yarn run develop-OSM

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

Strumenti di sviluppo e debug

Consigliamo di installare psalm e configurarlo nel proprio IDE se supportato, in modo che vengano eseguiti ulteriori controlli automatici sul codice scritto.

E' già configurato su composer l'inclusione di PHP-CS-Fixer, uno strumento che permette di formattare in modo uniforme il codice scritto. Si può configurare nel proprio IDE se supportato. Il percorso dell'eseguibile è vendor/bin/php-cs-fixer.

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, Instagram, Twitter, YouTube, Telegram e Mastodon 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.

Contribuire

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

Se volete contribuire attivamente con semplici migliorie o correzioni potete cercare tra le issue per i nuovi contributori.

Bounty Program

Potresti trovare degli issue contrassegnati con il label bountysource. Questo significa che è disponibile una ricompensa per chi risolverà l'issue secondo i criteri descritti all'interno. Devi creare innanzitutto un account su BountySource.com. Successivamente, il funzionamento sarà il seguente:

  • esegui un fork del repository
  • risolvi l'issue
  • invia una pull request

Verificheremo se la pull request soddisferà i requisiti e, una volta approvata, provvederemo ad accreditare la ricompensa nel tuo account di BountySource.

Licenza

Questo progetto è tutelato dalla licenza GPL 3.