Menu
Deploy the monorepo school management app (Laravel + Django) using Docker Compose, Nginx, and CI/CD. Covers local dev, Docker stack, and production setup for both services.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Implement AJAX for dynamic interactions in Laravel app, including data fetching, form submissions, and updates. Use with REST APIs and queue for background processing.
Implement authentication and role-based access control for the school management app. Use for securing endpoints and managing user permissions across different roles.
Create a new modular Django app in django/apps/{module}/ following the DI-container architecture. Each app mirrors a Laravel package โ models, repository, service, serializer, viewset, urls, AppConfig. Use whenever adding a new Python feature to the school management system.
Maintain comprehensive documentation for the school management monorepo (Laravel + Django). Covers API docs, architecture guides, and setup instructions for both services.
Generate Laravel migrations, models, factories, seeders, and relationships from markdown table definitions in the DB_Structure folder. Use for creating database schema and Eloquent models for the school management system.
Create and maintain module-wise folder structure in Laravel for organizing code by features like Student Management, Staff Management, etc. Includes controllers, models, views, routes, and migrations per module.
| name | deployment |
| description | Deploy the monorepo school management app (Laravel + Django) using Docker Compose, Nginx, and CI/CD. Covers local dev, Docker stack, and production setup for both services. |
school-management-app/
โโโ laravel/ โ PHP Laravel (PHP-FPM)
โโโ django/ โ Python Django (Gunicorn)
โโโ docker/
โโโ docker-compose.yml
โโโ nginx/default.conf
โโโ php/Dockerfile
cd laravel/
composer install
cp .env.example .env
php artisan key:generate
php artisan migrate
npm install && npm run dev
php artisan serve # http://localhost:8000
bash django/scripts/start.sh # reads DB creds from laravel/.env automatically
# http://localhost:8001
All services defined in docker/docker-compose.yml:
| Service | Image / Build | Port | Role |
|---|---|---|---|
nginx | nginx:1.27-alpine | 80 | Reverse proxy entry point |
php | docker/php/Dockerfile | 9000 | Laravel PHP-FPM |
django | django/Dockerfile | 8001 | Django Gunicorn |
celery | django/Dockerfile | โ | Async Django workers |
mysql | mysql:8.0 | 3306 | Shared database |
redis | redis:7-alpine | 6379 | Cache + queue |
# From project root
cp laravel/.env.example laravel/.env # fill DB/APP_KEY values
docker compose -f docker/docker-compose.yml up --build
# Run Laravel migrations
docker compose -f docker/docker-compose.yml exec php php artisan migrate
# Run Django migrations
docker compose -f docker/docker-compose.yml exec django python manage.py migrate
/* โ Laravel PHP-FPM (port 9000)/api/python/* โ Django Gunicorn (port 8001)/health/django โ Django health checkConfig: docker/nginx/default.conf
laravel/.env)APP_KEY=base64:...
DB_HOST=mysql
DB_DATABASE=school_db
DB_USERNAME=app
DB_PASSWORD=secret
REDIS_HOST=redis
PYTHON_SERVICE_URL=http://django:8001 โ points to Django container
django/.env)DJANGO_SETTINGS_MODULE=config.settings.production
DJANGO_SECRET_KEY=change-me
DB_HOST=mysql
DB_NAME=school_db
DB_USER=app
DB_PASS=secret
REDIS_URL=redis://redis:6379/1
PHP_APP_SECRET=base64:... โ same as Laravel APP_KEY
cd school-management-app/laravel/.env and django/.envdocker compose -f docker/docker-compose.yml up -d --builddocker compose ... exec php php artisan migrate --forcedocker compose ... exec php php artisan config:cachedocker compose ... exec django python manage.py migratedocker compose ... exec django python manage.py collectstatic --noinputjobs:
deploy:
steps:
- uses: actions/checkout@v4
- name: Build & push images
run: docker compose -f docker/docker-compose.yml build
- name: Run Laravel tests
run: docker compose ... exec php php artisan test
- name: Run Django tests
run: docker compose ... exec django python manage.py test
docker compose logs -f php / docker compose logs -f djangodocker compose up to start the full stack