/azebo

Ein Arbeitszeitbogen

Primary LanguagePHPGNU General Public License v3.0GPL-3.0

Azebo

Azebo is a Web-Application to record working times of employees. It was originally started by the Kunsthochschule Berlin Weißensee, the Hochschule für Musik Hanns Eisler Berlin and the Hochschule für Schauspielkunst Ernst Busch. It is meant to create PDF documents with monthly working times for each employee. It runs on a LAMP architecture. The name is an acronym for the german "Arbeitszeiterfassungsbogen".

Getting Started

Dependencies

Azebo depends depends on the LAMP-Stack with following versions:

  • Linux (>= 4.19.27)
  • Apache (>= 2.4.39)
  • MariaDB (>= 10.2.22)
  • PHP (>= 7.2.16)

It depends also on Zend Framework 1.12 and the Dojo Toolkit in version 1.10.2. These versions are no longer maintained, are security problems and are first priority to be updated.

Optionally it depends on a LDAP-Server to authenticate and authorise the users.

Installing

Azebo ist installed as any other LAMP Application.

Configure Apache

Make sure your apache has the modules mod_php, mod_rewrite and mod_alias installed and enabled. Configure your vhost for example with 000-azebo.conf. Adjust that file to your used paths. (The URL /Zend should point to your copy ZF1 and the URL /javascript should point to your copy of Dojo Toolkit 1.10.2 .)

Initialise your database

Create a database named whatever you like and run /resources/sql/azebo.sql on it to create the needed database structure. In the table named mitarbeiter create a line with your username.

Configure .ini files

Copy /aspplication/application.php.dist to /aspplication/application.php and adjust paths. Copy all .dist files in /application/configs to the same directory and remove the .dist suffix. In app.ini adjust your timezone and your database name and credentials.

If you plan to use a LDAP-Server adjust server name and domain name and group names in ldap.ini. If you don't plan to use an LDAP-Server comment out lines 67 to 71 (approximately, but the lines are commented) of /application/services/Authentifizierung.php.

Adjust the remaining .ini files to your convenience.

Remove debugging

For a production environment remove test.php.

Initialise log files

In root directory of the application create a directory named data and a subdirectory called logs. Inside that directory create two files named azebo.log and loginLog.log. Make these files writable for the apache user.

Contributing

Feel free to e-mail me in case you want to contribute.

License

This software is licensed under the GPLv3 - see the License file for details.

TODOs

  • Update project to use PHP 7.2 and Zend Framework 2 and Dojo Toolkit 1.15
  • Create a REST API.
  • Rewrite as a SPA (Single Page Application) using Angular