# `app_setup`

Creates the standard app filesystem layout and runtime services:

- `/srv/app/backend` and `/srv/app/frontend`
- `/srv/app/.env.<dev|qa|prod>`
- `/usr/local/bin/deploy_app.sh` (git pull, install deps, build, migrate, restart services)
- systemd units:
  - `app-backend.service`
  - `app-frontend.service`

All behavior is driven by variables so you can reuse this role for multiple projects.

## Variables

See [`defaults/main.yml`](defaults/main.yml). Common inputs in the app stack:

- `app_project`, `app_env` (used for naming and `.env.<env>` selection)
- `app_repo_url`, `app_repo_dest`, `app_repo_branch`
- `app_env_vars` (map written into `/srv/app/.env.<env>`)
- `components.backend`, `components.frontend` (enable/disable backend/frontend setup)
- `app_backend_dir`, `app_frontend_dir`, ports and Node.js commands