eerrrrrr

docs/07-troubleshooting.md

@@ -0,0 +1,20 @@
+# Troubleshooting
+
+## Cannot find template or routes
+- Clear cache: `docker compose exec php php bin/console cache:clear`
+- List routes: `docker compose exec php php bin/console debug:router`
+
+## Missing vendors
+- Install: `docker compose exec php composer install --no-interaction --prefer-dist`
+
+## .env not read in container
+- Ensure we mount `.env` or set env vars in compose; we mount `.env` in `docker-compose.yml`.
+
+## Login modal shows blank
+- Make sure Bootstrap JS loads before the modal script (handled in `base.html.twig`).
+
+## Hitting admin routes redirects to home
+- Expected when not logged in or lacking the required role.
+- Ensure your user has `ROLE_MODERATOR` for `/admin/dashboard` or `/admin/users`, and `ROLE_ADMIN` for `/admin/settings`.
+- Use the console commands in `06-admin-and-settings.md` to grant roles.
+