iger
/
engelsystem
9
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
1,704 Commits 4 Branches 0 Tags 22 MiB
PHP 86.9%
Twig 8.4%
SCSS 3.3%
JavaScript 0.8%
HTML 0.3%
Other 0.3%
Go to file
Igor Scheller 3d245660c5 Updated .gitlab-ci.yaml to create a release archive 2018-08-05 17:28:10 +02:00
config there are no 5xl shirts 2017-12-29 12:43:20 +01:00
db add work date to work log 2017-12-29 18:57:11 +01:00
frontend Explose form Functions as globals 2018-08-03 13:58:33 +02:00
import camp 2011 export 2011-07-14 19:53:19 +02:00
includes remove unused code 2018-01-28 14:52:26 +01:00
locale Fixes issue:#401 for german 2018-01-02 20:52:55 +00:00
public Merge remote-tracking branch 'origin/master' 2018-02-08 22:57:41 +01:00
src changes based on igels review 2018-02-08 23:01:43 +01:00
templates changes based on igels review 2018-02-08 23:01:43 +01:00
tests Updated translation / Formatting / Test 2017-12-26 00:21:44 +01:00
.babelrc frontend stuff with babel and webpack 2018-01-03 01:19:31 +01:00
.gitignore Updated .gitlab-ci.yaml and other files to build the frontend 2018-08-03 12:56:33 +02:00
.gitlab-ci.yml Updated .gitlab-ci.yaml to create a release archive 2018-08-05 17:28:10 +02:00
LICENSE directory renames and cleanup 2011-06-11 18:08:56 +02:00
README.md Updated .gitlab-ci.yaml and other files to build the frontend 2018-08-03 12:56:33 +02:00
composer.json frontend stuff with babel and webpack 2018-01-03 01:19:31 +01:00
deploy.sh Updated .gitlab-ci.yaml to create a release archive 2018-08-05 17:28:10 +02:00
package.json add documentation, include old custom font again 2018-05-03 17:33:49 +02:00
phpunit.xml Merge branch 'noc0lour:fix_setup_bugs', closes #335 2017-10-31 13:41:17 +01:00
webpack.config.js No hardcoded publicPath for assets 2018-08-05 13:15:37 +02:00

README.md

Codacy Badge GPL

Engelsystem

Please visit https://engelsystem.de for a feature list.

To report bugs use engelsystem/issues

Installation

Requirements:

  • PHP >= 7.0
  • MySQL-Server >= 5.5 or MariaDB-Server >= 5.5
  • Webserver, i.e. lighttpd, nginx, or Apache
  • Node >= 8 (Development/Building only)
  • Yarn (Development/Building only)

Directions:

  • Clone the master branch: git clone https://github.com/engelsystem/engelsystem.git

  • Install Composer and Yarn (which requires Node.js)

  • Install project dependencies:

    composer install
yarn

    On production systems it is recommended to use

    composer install --no-dev
composer dump-autoload --optimize

    to install the engelsystem

  • Build the frontend assets

    yarn build

  • The webserver must have write access to the import directory and read access for all other directories

  • The webserver must point to the public directory.

  • The webserver must read the .htaccess file and mod_rewrite must be enabled

  • Recommended: Directory Listing should be disabled.

  • There must a be MySQL database created with a user who has full rights to that database.

  • It must be created by the db/install.sql and db/update.sql files.

  • If necessary, create a config/config.php to override values from config/config.default.php.

  • In the browser, login with credentials admin:asdfasdf and change the password.

Engelsystem can now be used.

Session Settings:

  • Make sure the config allows for sessions.
  • Both Apache and Nginx allow for different VirtualHost configurations.

Development

Since the engelsystem is open source, you can help to improve the system. We really love to get pull requests containing fixes or implementations of our Github issues.

Please create single pull requests for every feature instead of creating one big monster of pull request containing a complete rewrite.

Testing

To run the unit tests use

vendor/bin/phpunit --testsuite Unit

If a database is configured and the engelsystem is allowed to mess around with some files, you can run feature tests. The tests can potentially delete some database entries, so they should never be run on a production system!

vendor/bin/phpunit --testsuite Feature
# or for unit- and feature tests:
vendor/bin/phpunit

CI & Build Pipeline

The engelsystem can be tested and automatically deployed to a testing/staging/production environment. This functionality requires a GitLab server with a running docker minion.

To use the deployment features the following secret variables need to be defined (if undefined the step will be skipped):

SSH_PRIVATE_KEY         # The ssh private key
STAGING_REMOTE          # The staging server, e.g. user@remote.host
STAGING_REMOTE_PATH     # The path on the remote server, e.g. /var/www/engelsystem
PRODUCTION_REMOTE       # Same as STAGING_REMOTE but for the production environment
PRODUCTION_REMOTE_PATH  # Same as STAGING_REMOTE_PATH but for the production environment

deploy.sh

The deploy.sh script can be used to deploy the engelsystem. It uses rsync to deploy the application to a server over ssh.

For usage see ./deploy.sh -h

Codestyle

Please ensure that your pull requests follow PSR-2 and PSR-4.