Skip to content

consiglionazionaledellericerche/epas-service

Repository files navigation

ePAS Service

Electronic Personnel Attendance System - REST Services

license Supported JVM Versions contributors Downloads ePAS on developers.italia.it Version

ePAS Service è la nuova versione della parte di backend di ePAS, fornirà solo endopoint REST ed è pensato per essere compatibile al 100% con il database di ePAS.

ePAS Service deve essere affiancato ad un'istanza funzionante di ePAS, condividendo lo stesso database. Al momento non sono ancora presenti le procedure ed i dati per utilizzare ePAS Service senza un database configurato di ePAS.

Il progetto è attualmente in fase avanzata di sviluppo e fornirà molte delle funzionalità necessarie alla nuova interfaccia web di ePAS che sarà parte di un nuovo progetto e sarà rilasciata a breve in versione preliminare.

Per maggiori informazioni su ePAS è possibile consultare la documentazione completa all'indirizzo:

ePAS Service

ePAS Service fornisce già alcuni servizi REST utilizzabili in produzione per:

  • la ricezione delle timbrature
  • la gestione degli uffici
  • la gestione dei dipendenti
  • la gestione dei contratti
  • l'esportazione della situazione mensile di un dipendente

I servizi saranno estesi per coprire la maggior parte delle attuali funzionalità di ePAS lato server.

Altri servizi saranno sviluppati per coprire alcune delle funzionalità di ePAS lato server non presenti in questo progetto come per esempio https://github.com/consiglionazionaledellericerche/epas-helpdesk-service

Al momento è possibile utilizzare l'autenticazione tramite Bearer Token OAUTH2 oppure Basic Auth.

ePAS Service fornisce la documentazione di utilizzo degli endpoint REST in formato openapi ed integrare lo Swagger per la visualizzazione della documentazione e l'interfaccia di prova dei servizi.

L'interfaccia Swagger è disponibile nella url relativa alla propria installazione di ePAS Service con il path /swagger-ui/index.html. Es.: https://epas-service.amministrazione.cnr.it/swagger-ui/index.html.

👏 Come Contribuire

Lo scopo principale di questo repository è continuare ad evolvere ePAS. Vogliamo contribuire a questo progetto nel modo più semplice e trasparente possibile e siamo grati alla comunità per ogni contribuito a correggere bug e miglioramenti.

📄 Licenza

ePAS Service è concesso in licenza GNU AFFERO GENERAL PUBLIC LICENSE, come si trova nel file LICENSE.

Startup

Per avviare una istanza di ePAS con postgres locale

ePAS può essere facilmente installato via docker-compose su server Linux utilizzando il file docker-compose.yml presente in questo repository.

Accertati di aver installato docker e docker-compose dove vuoi installare ePAS ed in seguito esegui il comando successivo per un setup di esempio.

docker-compose up -d

Credits

Istituto di Informatica e Telematica del CNR

Vedi anche