# Backend Overview

## Repositories

* [github.com/schuettflix/backend](https://github.com/schuettflix/backend)
* [github.com/schuettflix/frontend](https://github.com/schuettflix/frontend)

## URLS

* [traefik.local.dev.schuett.tech/dashboard](https://traefik.local.dev.schuett.tech/dashboard)
* view ingress HTTP/TCP services
* found under: `dev-env/bin/reverse-proxy` :santa:
* Schuettflix Link Overview :globe_with_meridians:

    open /var/schuettflix/dev-env/schuettflix-links.html

## Core Tools

* PHPStorm
* PAW (API Testing)
* DBeaver (Database UI)
* Redis Insight

    brew install --cask redisinsight

* need a versioned local PHP on macOS?

    brew install 'shivammathur/php/php@8.0'
    brew install 'shivammathur/extensions/amqp@8.0'
    brew install 'shivammathur/extensions/apcu@8.0'
    brew install 'shivammathur/extensions/redis@8.0'
    brew install 'composer'
    brew install 'phive'

* reference
* [github.com/shivammathur/homebrew-php](https://github.com/shivammathur/homebrew-php)
* [github.com/shivammathur/homebrew-extensions](https://github.com/shivammathur/homebrew-extensions)
* [symfony-cli](https://github.com/symfony-cli/symfony-cli)

    brew install symfony-cli/tap/symfony-cli

## TODO

* [ ] PHPStorm license
* [ ] 1Password
* [ ] Investigation: SessionBox o.ä.
* [ ] XDebug Setup

## Missing from Setup

* [x] create `.env.local` in backend repo
* phrase credentials
* launch darkly credentials

## Basic Symfony Commands

# console in docker container
docker compose exec --user=www-data php bin/console

# show routes
bin/console debug:router
bin/console debug:router "${route_name}"

# service configuration
vi config/services.yaml

# container debugging
bin/console debug:container --parameters
bin/console debug:container --tags
bin/console debug:container --tag=console.command

# update phrase translations
bin/console phrase:translations:pull

# migrations - run after pulling code changes
bin/console doctrine:migrations:up-to-date
bin/console doctrine:migrations:migrate

# install PHAR dependencies (i.e. php-cs-fixer,[..]) - see phive.xml
# note: phive is not available in the development container
#       -> run on your host
phive install

## Frontend

The FE is started with `npm start` and available at [localhost:8080](https://localhost:8080)

The BE endpoint is configured in `./public/config.js`.

Note: Clear browser caches (localStorage etc.) and hard-reload on change.

## Other Information

* translations are managed in [Phrase](https://app.phrase.com/)
* shared account -> see 1Password / Okta
* [Launch Darkly](https://app.launchdarkly.com/) is our feature flag saas
* `~` is `option` + `N` followed by a `Space` on macOS with german keyboard :face_with_rolling_eyes: