PersonalMan is a open source employee management software for non-profit organisations or other companies. It provides management and self-service features in the areas of absences, overtime, trip and room bookings. In addition, it can note when employees have been paid but the payment and tax processes cannot be covered by PersonalMan.
Folder | Description |
---|---|
desktop | Desktop Client for PersonalMan based on Electron and React for Windows, Linux and Mac OS. |
docs | Current PersonalMan website with more information about the goals of the PersonalMan project. |
java-api | The current API of PersonalMan in the Java language. This can be used to write a Java client which talks with the Personalman server. To use these libraries you can simply define the API module as a maven dependency in your Java Client. |
server | This is the server application of PersonalMan with a RESTful API which any client can then implement in any programming language. |
- To use the server you need to specify the user specific configuration parameters in application.properties
- Create an executable jar using mvn clean install.
- Run the jar (for example in dev-test mode): java -Dspring.profiles.active=dev-test -jar personalman_server.jar
Personalman comes with a Swagger API documentation which can be used to implement the API in a client on any programming language. The swagger user interface is available at: http://your-personalman-server:your-port/swagger-ui.html
- dev-test - This profile activates the swagger API documentation. This works well for development and testing.
The current architecture of PersonalMan allows multiple clients to be built - each client simply has to implement the API provided by the server. Currently there is a single client available for download: the PersonalMan Web & Desktop Client. This client implements the API in React and can be used in most modern web browsers which support JavaScript. Additional versions of this client are also supplied which run natively on desktop operating systems such as Windows, Linux and Mac by utilising the Electron framework.
- Absence management is available but the approval workflow for absences is not yet implemented.
- Overtime can be managed but there is not yet a management workflow for overtime analysis.
- Trip management is available but the approval workflow for trips is not yet implemented.
- Room bookings and departments / teams are not yet implemented.