Enhance development environment with documentation, email testing and shell tools

This comprehensive update improves several aspects of the development environment:

- Add MailHog service for testing emails without sending real messages
- Restructure API documentation with generation (apidocs-generate) and serving (apidocs-serve)
- Add convenient container shell access commands (php-connect and db-connect)
- Standardize naming with APP_DIR and consistent command patterns
- Refactor Makefile with reusable components and better organization
- Add flexible composer-script command for running arbitrary Composer scripts
- Update environment variables in .env files for consistency
- Configure proper .gitignore settings for generated documentation

These improvements make the development environment more functional and
user-friendly while maintaining a clean project organization.

Author: nanoninja

.env

@@ -40,8 +40,12 @@ XDEBUG_ENABLED=1
 
 # Application configuration
 APP_WORKSPACE=default
-APP_PUBLIC_DIR=app/public
-
-# Workspace installation directories
-SYMFONY_DIR=symfony-app
-LARAVEL_DIR=laravel-app
+APP_DIR=app
+APP_PUBLIC_DIR=$(APP_DIR)/public
+
+# MailHog configuration
+MAILHOG_SMTP_PORT=1025
+MAILHOG_UI_PORT=8025
+MAILHOG_STORAGE=memory
+MAILHOG_HOSTNAME=mailhog
+MAILHOG_CORS_ORIGIN=*

.env.dev

@@ -40,8 +40,12 @@ XDEBUG_ENABLED=1
 
 # Application configuration
 APP_WORKSPACE=default
-APP_PUBLIC_DIR=app/public
-
-# Workspace installation directories
-SYMFONY_DIR=symfony-app
-LARAVEL_DIR=laravel-app
+APP_DIR=app
+APP_PUBLIC_DIR=$(APP_DIR)/public
+
+# MailHog configuration
+MAILHOG_SMTP_PORT=1025
+MAILHOG_UI_PORT=8025
+MAILHOG_STORAGE=memory
+MAILHOG_HOSTNAME=mailhog
+MAILHOG_CORS_ORIGIN=*

.env.prod

@@ -38,8 +38,12 @@ PHPMYADMIN_PROFILE=none
 
 # Application configuration
 APP_WORKSPACE=default
-APP_PUBLIC_DIR=app/public
-
-# Workspace installation directories
-SYMFONY_DIR=symfony-app
-LARAVEL_DIR=laravel-app
+APP_DIR=app
+APP_PUBLIC_DIR=$(APP_DIR)/public
+
+# MailHog configuration
+MAILHOG_SMTP_PORT=1025
+MAILHOG_UI_PORT=8025
+MAILHOG_STORAGE=memory
+MAILHOG_HOSTNAME=mailhog
+MAILHOG_CORS_ORIGIN=*

.gitignore

@@ -19,6 +19,7 @@ web/app/vendor/
 web/app/doc/
 web/app/report/
 .phpdoc/
+/docs/api
 
 # Workspace directories
 /web/symfony-app/