Skip to content

Multi-Container Docker Compose Document Management System #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Multi-Container Docker Compose Document Management System #1

wants to merge 1 commit into from

Conversation

@gepengan
Copy link
Owner

Summary

  • ✅ Created complete multi-container Docker Compose environment with 5 services
  • ✅ Implemented Debian-based Dockerfiles for Laravel/Filament frontend and FastAPI backend
  • ✅ Set up Celery worker for asynchronous document processing (OCR, file renaming)
  • ✅ Configured PostgreSQL database and Redis cache with health checks
  • ✅ Implemented shared storage volumes simulating NAS file shares (input/output folders)
  • ✅ Added comprehensive API endpoints for file management and task processing
  • ✅ Configured inter-service networking and proper service dependencies
  • ✅ Created development tooling with test scripts and comprehensive documentation

Services Architecture

  • Frontend (Port 8000): Laravel with Filament v3 admin panel, PHP 8.2, Node.js 18, Apache
  • Backend (Port 8001): FastAPI with Python 3.11, health checks, file management endpoints
  • Worker: Celery task processor for OCR and document processing operations
  • Database: PostgreSQL with persistent volume storage
  • Cache: Redis for caching and Celery message broker

Shared Storage

  • input_folder: Drop scanned PDFs for processing
  • output_folder: Processed and renamed documents appear here
  • Both volumes mounted to backend and worker services for shared access

Key Features

  • API proxy configuration from frontend to backend
  • Comprehensive health checks for all services
  • Environment variable configuration with .env.example
  • OCR processing tasks with Celery queue
  • File management endpoints (list, process, rename)
  • Development validation script and complete documentation

Test Plan

  • Validate docker-compose.yml syntax and service configuration
  • Verify all Dockerfiles are properly configured with Debian base images
  • Test shared volume mounting between backend and worker services
  • Confirm service dependencies and startup order
  • Validate environment variable configuration
  • Test API endpoints and health checks functionality
  • Verify Celery task configuration and worker setup

🤖 Generated with Claude Code

@claude
feat: implement multi-container Docker Compose document management sy…
3e8e742 
…stem

- Create docker-compose.yml with 5 services: frontend (Laravel/Filament), backend (FastAPI), worker (Celery), database (PostgreSQL), cache (Redis)
- Implement Debian-based Dockerfiles for frontend (PHP 8.2, Composer, Node.js) and backend (Python 3.11, FastAPI, Celery)
- Add shared storage volumes (input_folder, output_folder) simulating NAS file shares
- Configure inter-service networking, health checks, and proper service dependencies
- Create comprehensive FastAPI application with OCR processing tasks and file management endpoints
- Set up Celery task queue for asynchronous document processing
- Add environment configuration with .env.example template
- Include development tooling: test script, .dockerignore files, and comprehensive README
- Implement proper volume mounting for shared file access between backend and worker services
- Configure frontend Apache proxy to route /api requests to backend service

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@gepengan