134 lines
7.8 KiB
Markdown
134 lines
7.8 KiB
Markdown
# OpenSTAManager
|
|
|
|
OpenSTAManager ("Gestore Aperto del Servizio Tecnico di Assistenza") è un software open source, web based, modulare e semplice da usare, ideato e sviluppato da Fabio Lovato per gestire ed archiviare il servizio di assistenza tecnica e la fatturazione.
|
|
|
|
Funzioni principali:
|
|
|
|
- dashboard con Interventi e Appuntamenti;
|
|
- gestione Anagrafiche;
|
|
- gestione Contabilità;
|
|
- gestione Contratti;
|
|
- gestione Magazzino;
|
|
- gestione Impianti.
|
|
|
|
## Tabella dei contenuti
|
|
|
|
<!-- TOC depthFrom:2 depthTo:6 orderedList:false updateOnSave:true withLinks:true -->
|
|
|
|
- [Tabella dei contenuti](#tabella-dei-contenuti)
|
|
- [Requisiti](#requisiti)
|
|
- [Installazione](#installazione)
|
|
- [Versioni](#versioni)
|
|
- [SourceForge](#sourceforge)
|
|
- [Perché software open source](#perché-software-open-source)
|
|
- [Componenti esterni](#componenti-esterni)
|
|
- [Community](#community)
|
|
- [Contribuire](#contribuire)
|
|
- [Sviluppatori](#sviluppatori)
|
|
- [Licenza](#licenza)
|
|
|
|
<!-- /TOC -->
|
|
|
|
## Requisiti
|
|
|
|
Prima di iniziare l'installazione, è necessario procedere al download di una versione del progetto da [SourceForge](https://sourceforge.net/p/openstamanager/). Si consiglia inoltre di controllare che i prerequisiti del software, elencati di seguito, siano soddisfatti.
|
|
|
|
L'installazione del gestionale richiede la presenza di un server web con abilitato il [DBMS (Database Management System)](https://it.wikipedia.org/wiki/Database_management_system) MySQL e il linguaggio di programmazione [PHP](http://php.net/).
|
|
|
|
- PHP >= 5.4 (si consiglia come minimo la versione 5.6 per poter usufruire di tutte le funzionalità del progetto)
|
|
- MySQL >= 5.0
|
|
|
|
Per ulteriori informazioni sui pacchetti che forniscono questi elementi di default, visitare la sezione [Informazioni](https://sourceforge.net/p/openstamanager/wiki/Installazione/) della documentazione.
|
|
|
|
## Installazione
|
|
|
|
Per procedere all'installazione è necessario seguire i seguenti punti:
|
|
|
|
1. Creare una cartella (ad esempio `openstamanager`) nella root del sever 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).
|
|
|
|
2. Creare un database vuoto (tramite [PHPMyAdmin](http://localhost/phpmyadmin/) o riga di comando).
|
|
3. Accedere a <http://localhost/openstamanager> dal vostro browser.
|
|
4. Inserire i dati per collegarsi al database e cliccare su **Installa** per completare l'installazione.
|
|
|
|
**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)](http://semver.org/) per definire le versioni del progetto. Per vedere tutte le versioni disponibili al download, visitare la [pagina relativa](https://sourceforge.net/projects/openstamanager/files/) su SourceForge.
|
|
|
|
### SourceForge
|
|
|
|
Nel caso si stia utilizzando la versione direttamente ottenuta dalla repository di SourceForge, è necessario eseguire i seguenti comandi da linea di comando per completare le dipendenze PHP (tramite [Composer](https://getcomposer.org/)) e gli asssets (tramite [Yarn](https://yarnpkg.com/)) del progetto.
|
|
|
|
```bash
|
|
php composer.phar install
|
|
php composer.phar update
|
|
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):
|
|
|
|
```bash
|
|
yarn run develop-OSM
|
|
```
|
|
|
|
Per ulteriori informazioni, visitare le sezioni [Assets](https://sourceforge.net/p/openstamanager/wiki/Assets/) e [Framework](https://sourceforge.net/p/openstamanager/wiki/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).
|
|
|
|
Nel caso utilizziate il programma per uso commerciale, si consiglia di non utilizzare le versioni ottenibili direttamente dalla repository su SourceForge (SVN) ma di scaricare le release ufficiali disponibili nel nostro sito ufficiale <http://www.openstamanager.com>; se siete inoltre interessati a supporto e assistenza professionali, li potete richiedere nella [sezione dedicata](http://www.openstamanager.com/per-le-aziende/).
|
|
|
|
## Componenti esterni
|
|
|
|
OpenSTAManager è stato progettato utilizzando altro software open source, tra cui principalmente:
|
|
|
|
- [PHP](https://secure.php.net/) - A popular general-purpose scripting language especially suited to web development
|
|
- [MySQL](https://www.mysql.com/) - The world's most popular open source database
|
|
- [JQuery](https://jquery.com/) - New Wave JavaScript
|
|
- [Bootstrap](http://getbootstrap.com/) - The world's most popular mobile-first and responsive front-end framework
|
|
- [FontAwesome](http://fontawesome.io/) - The iconic font and CSS toolkit
|
|
- [HTML2PDF](http://html2pdf.fr/en/default) - HTML to PDF converter written in PHP
|
|
|
|
## 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.
|
|
|
|
Il forum ufficiale è disponibile all'indirizzo <http://www.openstamanager.com/forum/>, e potete segnalare i vostri problemi e soddisfare le vostre curiosità nelle sezioni più adeguate:
|
|
|
|
- [Idee, suggerimenti e consigli](http://www.openstamanager.com/forum/viewforum.php?f=1)
|
|
- [Problemi con la prima installazione](http://www.openstamanager.com/forum/viewforum.php?f=2)
|
|
- [Sicurezza](http://www.openstamanager.com/forum/viewforum.php?f=3)
|
|
- [Altro tipo di assistenza](http://www.openstamanager.com/forum/viewforum.php?f=4)
|
|
- [Tutorial](http://www.openstamanager.com/forum/viewforum.php?f=5)
|
|
|
|
**Attenzione**: vi ricordiamo che non vi è nessuna garanzia che qualcuno risponda in tempo alle vostre richieste o problemi.
|
|
|
|
Siamo inoltre presenti su [Facebook](https://www.facebook.com/openstamanager) e su SourceForge con una [mailing-list](https://sourceforge.net/p/openstamanager/mailman/).
|
|
|
|
## Contribuire
|
|
|
|
Per poter contribuire, si consiglia di seguire le indicazioni descritte all'interno della [documentazione ufficiale](https://sourceforge.net/p/openstamanager/wiki/Contribuire/); in particolare, prestare attenzione al codice di condotta e allo stile del codice.
|
|
|
|
## Sviluppatori
|
|
|
|
- **Fabio Lovato**, fondatore e sviluppatore ([loviuz](https://sourceforge.net/u/loviuz/profile/))
|
|
- **Fabio Piovan**, sviluppatore ([magreba](https://sourceforge.net/u/magreba/profile/))
|
|
- **Luca Salvà**, sviluppatore ([lucasalva](https://sourceforge.net/u/lucasalva/profile/))
|
|
|
|
Per la lista completa delle persone che hanno partecipato al progetto, consultare la [pagina principale della documentazione](https://sourceforge.net/p/openstamanager/wiki/Home/) su SourceForge.
|
|
|
|
## Licenza
|
|
|
|
Questo progetto è tutelato dalla licenza **GPL 3** (vedere [LICENSE](https://sourceforge.net/p/openstamanager/code/HEAD/tree/trunk/openstamanager/LICENSE) per ulteriori dettagli).
|