From 2c3dc3fcc3297fb3854bf140dd804e65def1fae8 Mon Sep 17 00:00:00 2001 From: Kevin Frantz Date: Sat, 19 Jan 2019 11:48:31 +0100 Subject: [PATCH] Implemented a detailed description for the administration scripts and renamed DOCUMENTATION.md to DOCUMENTATION_CONVENTION.md --- ...ENTATION.md => DOCUMENTATION_CONVENTION.md | 0 README.md | 4 +- administration/README.md | 121 +++++++++++++++++- 3 files changed, 119 insertions(+), 6 deletions(-) rename DOCUMENTATION.md => DOCUMENTATION_CONVENTION.md (100%) diff --git a/DOCUMENTATION.md b/DOCUMENTATION_CONVENTION.md similarity index 100% rename from DOCUMENTATION.md rename to DOCUMENTATION_CONVENTION.md diff --git a/README.md b/README.md index c299158..920833e 100644 --- a/README.md +++ b/README.md @@ -37,8 +37,8 @@ Further information you will find in the [administration README.md](./administra ## Application Further information you will find in the [application README.md](./application/README.md). -## Documentation -Further information you will find in the [DOCUMENTATION.md](./DOCUMENTATION.md). +## Documentation Convention +Further information you will find in the [DOCUMENTATION.md](./DOCUMENTATION_CONVENTION.md). ## Author [Kevin Veen-Birkenbach](kevin@veen.world) \\ [Frantz](mail@Kevin-Frantz.de)
diff --git a/administration/README.md b/administration/README.md index 8cffdaf..5cc89bf 100644 --- a/administration/README.md +++ b/administration/README.md @@ -1,14 +1,16 @@ -#administration +# Administration -In this folder you will find all necessary scripts to run and configure the application. +**You MUST document all administration scripts in this file** -## requirements +In this folder you will find all necessary scripts to run and configure the application. The purpose of this scripts is to automize the administration process and help programmers to speed up their development and reduce the administration tasks of them. + +## Requirements This scripts are optimized for Ubuntu, but may they will run on MAC OS. Tested on a Ubuntu 18.04.1 LTS machine. -## initialization +## Initialization To initialize the docker environment, please execute in the root: @@ -17,3 +19,114 @@ bash administration/init.sh ``` Afterwards you can access the service via http://127.0.0.1:80. + +## Scripts +### [build.sh](./build.sh) +This script builds the [docker-compose environment](https://docs.docker.com/compose/) and sets it up. + +### [cleanup-ignored.sh](./cleanup-ignored.sh) +This script removes all files and folders which are ignored by git. Be careful with using it. + +**ATTENTION:** You MUST study this script before you execute it! + +### [clear.sh](./clear.sh) +This folder clears the productive and environment cache of the [Symfony](https://symfony.com/) application. + +### [composer-update.sh](./composer-update.sh) +This script updates the composer components. + +### [copy-configuration.sh](./copy-configuration.sh) +This script copies the ***.env.dist*** files to the right locations. + +### [format-code.sh](./format-code.sh) +This script formats the PHP code with [PHP-CS-Fixer](https://github.com/FriendsOfPHP/PHP-CS-Fixer). + +### [generate-coverage-report.sh](./generate-coverage-report.sh.sh) +This script generates a coverage report with PHPUnit [PHPUnit](https://phpunit.de/). + +### [init.sh](./init.sh) + +This script initialize the whole environment to let the application run local. + +### [load-fixtures.sh](./load-fixtures.sh) + +This script loads the [Doctrine Fixtures](https://symfony.com/doc/master/bundles/DoctrineFixturesBundle/index.html). + +### [mysql.sh](./mysql.sh) +This script offers a CLI to interact with the database. + +### [node-container-cli.sh](./node-container-cli.sh) + +This script offers a CLI to interact with the node container. + +### [recreate-database.sh](./recreate-database.sh) + +This script drops and creates the database. + +### [router.sh](./router.sh) + +This script shows the possible [Symfony routes](https://symfony.com/doc/current/routing.html). + + +### [schema-update.sh](./schema-update.sh) + +This script updates the database schema based on [Doctrines ORM](https://www.doctrine-project.org/projects/doctrine-orm/en/2.6/reference/working-with-objects.html) + +### [schema-validate.sh](./schema-validate.sh) + +This script validates the database schema based on [Doctrines ORM](https://www.doctrine-project.org/projects/doctrine-orm/en/2.6/reference/working-with-objects.html) + +### [services.sh](./services.sh) + +This script shows the possible [Symfony services](https://symfony.com/doc/current/service_container.html). + +### [schema-validate.sh](./schema-validate.sh) + +This script validates the administration scripts with [shellcheck](https://www.shellcheck.net/) + + +### [start.sh](./start.sh) + +This script starts the local instance of the software. It can just be executed in an initialized environment. + +### [stop.sh](./stop.sh) + +This script stops the local instance of the software. + +### [submodule.sh](./submodule.sh) + +This script pulls the [git submodules](https://git-scm.com/book/en/v2/Git-Tools-Submodules). + +### [submodule-init.sh](./submodule-init.sh) + +This script initializes the [git submodules](https://git-scm.com/book/en/v2/Git-Tools-Submodules). + +### [submodule-sync.sh](./submodule-sync.sh) + +This script synchronizes the [git submodules](https://git-scm.com/book/en/v2/Git-Tools-Submodules). + +### [symfony-container-cli.sh](./symfony-container-cli.sh) + +This script offers a cli for the symfony container. + +### [test-code-format.sh](./test-code-format.sh) + +This script tests if the PHP code is formated well. + +### [test-everything.sh](./test-everything.sh) + +This script tests if all of the other test scripts succeed. + +### [test.sh](./test.sh) + +This script executes the following tests of [PHPUnit](https://phpunit.de/): + +- [Functional tests](https://en.wikipedia.org/wiki/Functional_testing) +- [Integration tests](https://de.wikipedia.org/wiki/Integrationstest) +- [Unit Tests](https://en.wikipedia.org/wiki/Unit_testing) + +### [total-clean.sh](./total-clean.sh) + +This script tests cleans all data of the local environment. + +**ATTENTION:** You MUST study this script before you execute it!