OXDEV-8623 Add root recipe

Author: hkreuter

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "recipes/parts"]
+	path = recipes/parts
+	url = https://github.com/OXID-eSales/docker-eshop-sdk-recipe-parts

README.md

@@ -188,6 +188,56 @@ $ ./vendor/bin/phpunit -c vendor/oxid-esales/graphql-base/tests/phpunit.xml
 $ SELENIUM_SERVER_HOST=selenium MODULE_IDS=oe_graphql_base vendor/bin/codecept run acceptance -c vendor/oxid-esales/graphql-base/tests/codeception.yml
 ```
 
+# Development installation
+
+To be able running the tests and other preconfigured quality tools, please install the module as a [root package](https://getcomposer.org/doc/04-schema.md#root-package).
+
+The next section shows how to install the module as a root package by using the OXID eShop SDK.
+
+In case of different environment usage, please adjust by your own needs.
+
+# Development installation on OXID eShop SDK
+
+The installation instructions below are shown for the current [SDK](https://github.com/OXID-eSales/docker-eshop-sdk)
+for shop 7.3. Make sure your system meets the requirements of the SDK.
+
+0. Ensure all docker containers are down to avoid port conflicts
+
+1. Clone the SDK for the new project
+```shell
+echo MyProject && git clone https://github.com/OXID-eSales/docker-eshop-sdk.git $_ && cd $_
+```
+
+2. Clone the repository to the source directory
+```shell
+git clone --recurse-submodules https://github.com/OXID-eSales/graphql-base-module.git --branch=b-7.3.x ./source
+```
+
+3. Run the recipe to setup the development environment, you can decide which shop edition to install. Omitting the flag installs EE.
+```shell
+./source/recipes/setup-development.sh -s CE
+```
+
+You should be able to access the shop with http://localhost.local and the admin panel with http://localhost.local/admin
+(credentials: noreply@oxid-esales.com / admin)
+
+### Running tests locally
+
+Check the "scripts" section in the `composer.json` file for the available commands. Those commands can be executed
+by connecting to the php container and running the command from there, example:
+
+```shell
+make php
+composer tests-coverage
+```
+
+Commands can be also triggered directly on the container with docker compose, example:
+
+```shell
+docker compose exec -T php composer tests-coverage
+```
+
+
 ## Issues
 
 To report issues with GraphQL module please use the [OXID eShop bugtracking system](https://bugs.oxid-esales.com/).

composer.json

@@ -31,7 +31,7 @@
         "codeception/module-asserts": "^3.0"
     },
   "conflict": {
-    "oxid-esales/oxideshop-ce": "<7.2"
+    "oxid-esales/oxideshop-ce": "<7.3"
   },
     "autoload": {
         "psr-4": {
@@ -72,7 +72,12 @@
         "allow-plugins": {
             "infection/extension-installer": true,
             "oxid-esales/oxideshop-unified-namespace-generator": true,
-            "oxid-esales/oxideshop-composer-plugin": false
+            "oxid-esales/oxideshop-composer-plugin": true
         }
+    },
+  "autoload-dev": {
+    "psr-4": {
+      "OxidEsales\\EshopCommunity\\Tests\\": "./vendor/oxid-esales/oxideshop-ce/tests"
     }
+  }
 }

recipes/parts

@@ -0,0 +1,81 @@
+#!/bin/bash
+# Flags possible:
+# -e for shop edition. Possible values: CE/EE
+
+edition='EE'
+while getopts e: flag; do
+  case "${flag}" in
+  e) edition=${OPTARG} ;;
+  *) ;;
+  esac
+done
+
+SCRIPT_PATH=$(dirname ${BASH_SOURCE[0]})
+cd $SCRIPT_PATH/../../ || exit
+
+# Prepare services configuration
+make setup
+make addbasicservices
+make file=services/adminer.yml addservice
+make file=services/selenium-chrome.yml addservice
+make file=services/node.yml addservice
+
+# Configure containers
+perl -pi\
+  -e 's#error_reporting = .*#error_reporting = E_ALL ^ E_WARNING ^ E_DEPRECATED#g;'\
+  containers/php/custom.ini
+
+perl -pi\
+  -e 's#/var/www/#/var/www/source/#g;'\
+  containers/httpd/project.conf
+
+perl -pi\
+  -e 's#PHP_VERSION=.*#PHP_VERSION=8.2#g;'\
+  .env
+
+docker compose up --build -d php
+
+docker compose exec -T php git config --global --add safe.directory /var/www
+
+$SCRIPT_PATH/parts/shared/require_shop_edition_packages.sh -e"${edition}" -v"dev-b-7.3.x"
+$SCRIPT_PATH/parts/shared/require_twig_components.sh -e"${edition}" -b"b-7.3.x"
+$SCRIPT_PATH/parts/shared/require.sh -n"oxid-esales/developer-tools" -v"dev-b-7.3.x"
+$SCRIPT_PATH/parts/shared/require.sh -n"oxid-esales/oxideshop-doctrine-migration-wrapper" -v"dev-b-7.3.x"
+docker compose exec -T php composer require oxid-esales/apex-theme dev-b-7.3.x
+
+git clone https://github.com/OXID-eSales/oxapi-documentation source/documentation/oxapi-documentation
+make docpath=./source/documentation/oxapi-documentation addsphinxservice
+
+docker-compose exec -T -w /var/www php \
+       composer config allow-plugins.oxid-esales/oxideshop-composer-plugin true
+
+perl -pi -e '
+    BEGIN {
+        $inserted = 0;
+        $autoload_dev = qq(  "autoload-dev": {\n    "psr-4": {\n      "OxidEsales\\\\EshopCommunity\\\\Tests\\\\": "./vendor/oxid-esales/oxideshop-ce/tests"\n    }\n  },\n);
+    }
+    if (!$inserted && $_ =~ /"repositories":/) {
+        $_ = $autoload_dev . $_;
+        $inserted = 1;
+    }
+' source/composer.json
+
+
+make up
+
+docker compose exec php composer update --no-interaction
+
+perl -pi\
+  -e 'print "SetEnvIf Authorization \"(.*)\" HTTP_AUTHORIZATION=\$1\n\n" if $. == 1'\
+  source/source/.htaccess
+
+$SCRIPT_PATH/parts/shared/setup_database.sh --no-demodata
+
+docker compose exec -T php vendor/bin/oe-console oe:module:install ./
+
+$SCRIPT_PATH/parts/shared/reset_database.sh --no-demodata
+
+docker compose exec -T php vendor/bin/oe-console oe:module:activate oe_graphql_base
+docker compose exec -T php vendor/bin/oe-console oe:theme:activate apex
+
+$SCRIPT_PATH/parts/shared/create_admin.sh