Docs Updated

Author: alokemajumder

README.md

@@ -11,9 +11,9 @@
 - 🏆 **Professional QC**: 20+ advanced quality control categories beyond basic FFprobe
 - 💡 **Executive Summaries**: AI translates technical data for non-technical stakeholders
 
-[![Production Ready](https://img.shields.io/badge/production-ready-green.svg)](PRODUCTION_READINESS_REPORT.md)
+[![Production Ready](https://img.shields.io/badge/production-ready-green.svg)](docs/PRODUCTION_READINESS_REPORT.md)
 [![QC Analysis](https://img.shields.io/badge/QC-20%20Categories-blue.svg)](#advanced-quality-control-features)
-[![Docker](https://img.shields.io/badge/docker-ready--to--deploy-blue.svg)](docker-image/QUICK_START.md)
+[![Docker](https://img.shields.io/badge/docker-ready--to--deploy-blue.svg)](#quick-start)
 
 ## 🧠 Core GenAI Differentiators
 
@@ -53,19 +53,18 @@
 **🤖 The setup script automatically validates your system meets the requirements for your chosen deployment mode:**
 
 ```bash
-# 🎯 Interactive setup with automatic system validation (recommended)
-curl -fsSL https://raw.githubusercontent.com/rendiffdev/ffprobe-api/main/setup.sh | bash
-
-# ⚡ Non-interactive modes with automatic requirements checking:
-curl -fsSL setup.sh | bash -s -- --quick      # 3GB RAM, 8GB disk
-curl -fsSL setup.sh | bash -s -- --minimal    # 2GB RAM, 6GB disk
-curl -fsSL setup.sh | bash -s -- --production # 8GB RAM, 20GB disk
-curl -fsSL setup.sh | bash -s -- --development # 4GB RAM, 15GB disk
-
-# 🔧 Manual setup (no requirements checking)
-git clone https://github.com/rendiffdev/ffprobe-api.git
+# 🔧 Clone and setup (recommended)
+git clone <your-repo-url>
 cd ffprobe-api
 make quick
+
+# ⚡ Alternative quick modes:
+make minimal     # 2GB RAM, 6GB disk - core services only
+make dev         # 4GB RAM, 15GB disk - development environment  
+make prod        # 8GB RAM, 20GB disk - production with monitoring
+
+# 🎯 Interactive setup with system validation
+./setup.sh       # Automatically detects best deployment mode
 ```
 
 **✨ What the smart installer checks:**
@@ -173,7 +172,7 @@ make prod
 
 The FFprobe API provides **comprehensive professional QC analysis** with industry-standard compliance checking.
 
-📋 **[Complete QC Analysis List](QC_ANALYSIS_LIST.md)** - Detailed breakdown of all 20+ QC categories
+📋 **[Complete QC Analysis List](docs/QC_ANALYSIS_LIST.md)** - Detailed breakdown of all 20+ QC categories
 
 ### QC Analysis Categories Overview
 
@@ -538,10 +537,9 @@ docker compose exec ollama ollama pull gemma3:270m
 
 ## 📚 Documentation
 
-- **[🚀 Quick Start (Docker)](docker-image/QUICK_START.md)** - One-command deployment
 - **[📖 Complete Documentation](docs/README.md)** - Full documentation index  
 - **[📡 API Reference](docs/api/README.md)** - REST and GraphQL APIs
-- **[🔍 QC Features](QC_ANALYSIS_LIST.md)** - All 20+ quality control categories
+- **[🔍 QC Features](docs/QC_ANALYSIS_LIST.md)** - All 20+ quality control categories
 - **[🏢 Production Guide](docs/deployment/README.md)** - Enterprise deployment
 - **[🤖 AI Setup](docs/tutorials/local-llm-setup.md)** - Local AI analysis setup
 
@@ -560,8 +558,8 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 ## 🆘 Support
 
 - **Documentation**: [docs/](docs/)
-- **Issues**: [GitHub Issues](https://github.com/rendiffdev/ffprobe-api/issues)
-- **Discussions**: [GitHub Discussions](https://github.com/rendiffdev/ffprobe-api/discussions)
+- **Issues**: Create GitHub Issues for bug reports
+- **Questions**: Check documentation or create discussions
 
 ---
 

docs/CONTRIBUTING.md

@@ -11,7 +11,7 @@ Thank you for your interest in contributing to FFprobe API! This document provid
 2. **Clone** your fork: `git clone https://github.com/YOUR-USERNAME/ffprobe-api.git`
 3. **Add upstream**: `git remote add upstream https://github.com/rendiffdev/ffprobe-api.git`
 3. **Read** [Technical Guidelines](CONTRIBUTOR-GUIDELINES.md) for detailed setup instructions
-4. **Install** dependencies: `docker compose up -d` 
+4. **Install** dependencies: `docker compose -f docker-image/compose.yaml up -d` 
 5. **Run** tests: `go test ./...`
 6. **Start** development: `go run cmd/ffprobe-api/main.go`
 
@@ -31,7 +31,7 @@ git clone https://github.com/rendiffdev/ffprobe-api.git
 cd ffprobe-api
 
 # Start development environment (includes PostgreSQL, Redis, FFmpeg)
-docker compose -f compose.yaml -f compose.development.yaml up -d
+docker compose -f docker-image/compose.yaml -f docker-image/compose.development.yaml up -d
 
 # Verify setup
 curl http://localhost:8080/health

docs/README.md

@@ -6,7 +6,7 @@
 
 ### 🚀 Getting Started
 - **[Quick Start Guide](../README.md#quick-start)** - Get running in 2 minutes
-- **[Docker Deployment](../docker-image/QUICK_START.md)** - Zero-config Docker deployment
+- **[Docker Deployment](../README.md#deployment-modes)** - Zero-config Docker deployment
 - **[Local AI Setup](tutorials/local-llm-setup.md)** - AI-powered analysis setup
 
 ### 📡 API Reference
@@ -19,20 +19,20 @@
 - **[Production Deployment](deployment/README.md)** - Production deployment strategies
 - **[Architecture Overview](development/architecture.md)** - System architecture and design
 - **[Secret Rotation](api/SECRET_ROTATION_GUIDE.md)** - API key and JWT management
-- **[Complete QC Analysis List](../QC_ANALYSIS_LIST.md)** - All 20+ QC categories detailed
+- **[Complete QC Analysis List](QC_ANALYSIS_LIST.md)** - All 20+ QC categories detailed
 - **[GraphQL API Guide](api/GRAPHQL_API_GUIDE.md)** - GraphQL endpoints  
 - **[Authentication Guide](api/authentication.md)** - API keys and security
 - **[Secret Rotation Guide](api/SECRET_ROTATION_GUIDE.md)** - Security management
 
 ### 🏗️ Development & Architecture
 - **[System Architecture](development/architecture.md)** - Technical design overview
-- **[Video Comparison System](COMPARISON_SYSTEM.md)** - Quality comparison features
+- **[Video Comparison System](../README.md#advanced-quality-control-features)** - Quality comparison features
 
 ### 🔧 Operations & Monitoring
 - **[FFmpeg Management](operations/ffmpeg-management.md)** - FFmpeg updates and configuration
 - **[Monitoring Setup](operations/monitoring.md)** - Prometheus and Grafana
 - **[Security Guide](operations/security.md)** - Security best practices
-- **[Troubleshooting](TROUBLESHOOTING.md)** - Common issues and solutions
+- **[Troubleshooting](../README.md#troubleshooting)** - Common issues and solutions
 
 ### 📋 Production Readiness
 - **[Production Checklist](deployment/PRODUCTION_READINESS_CHECKLIST.md)** - Pre-deployment validation
@@ -45,7 +45,7 @@
 
 #### **Analyze videos**
 - [Upload and analyze a video file →](api/README.md)
-- [Compare video quality improvements →](COMPARISON_SYSTEM.md)
+- [Compare video quality improvements →](../README.md#genai-analysis-examples-core-usp)
 - [Enable AI-powered insights →](tutorials/local-llm-setup.md)
 
 #### **Deploy to production**
@@ -54,14 +54,14 @@
 - [Monitoring setup →](operations/monitoring.md)
 
 #### **Develop and extend**
-- [API development tutorial →](tutorials/api_usage.md)
+- [API development guide →](api/README.md)
 - [System architecture →](development/architecture.md)
 - [Contributing guidelines →](../CONTRIBUTING.md)
 
 #### **Troubleshoot issues**
-- [Common problems and solutions →](TROUBLESHOOTING.md)
+- [Common problems and solutions →](../README.md#troubleshooting)
 - [FFmpeg issues →](operations/ffmpeg-management.md)
-- [Docker Compose issues →](deployment/modern-docker-compose.md)
+- [Docker setup help →](../README.md#quick-start)
 
 ---
 
@@ -99,9 +99,9 @@
 
 ## 🆘 Support
 
-- **Documentation Issues**: Check [troubleshooting guide](TROUBLESHOOTING.md)
-- **Bug Reports**: [GitHub Issues](https://github.com/rendiffdev/ffprobe-api/issues)
-- **Feature Requests**: [GitHub Discussions](https://github.com/rendiffdev/ffprobe-api/discussions)
+- **Documentation Issues**: Check [troubleshooting guide](../README.md#troubleshooting)
+- **Bug Reports**: Create GitHub Issues for bugs
+- **Feature Requests**: Create GitHub Issues for feature requests
 
 ---
 

docs/deployment/README.md

@@ -22,11 +22,11 @@ FFprobe API supports multiple deployment strategies to meet different scales and
 
 ```bash
 # Clone repository
-git clone https://github.com/rendiffdev/ffprobe-api.git
+git clone <your-repo-url>
 cd ffprobe-api
 
 # Start all services
-docker compose up -d
+docker compose -f docker-image/compose.yaml up -d
 
 # Verify deployment
 curl http://localhost:8080/health
@@ -40,10 +40,10 @@ curl http://localhost:8080/health
 
 ```bash
 # Basic services only
-docker compose up -d
+docker compose -f docker-image/compose.yaml up -d
 
 # Verify services
-docker compose ps
+docker compose -f docker-image/compose.yaml ps
 ```
 
 **Resources**: 4GB RAM, 2 CPU cores, 10GB storage
@@ -54,10 +54,10 @@ docker compose ps
 
 ```bash
 # Production configuration with monitoring
-docker compose -f compose.yml -f compose.production.yml up -d
+docker compose -f docker-image/compose.yaml -f docker-image/compose.production.yaml up -d
 
 # Scale API instances
-docker compose -f compose.yml -f compose.production.yml up -d --scale ffprobe-api=2
+docker compose -f docker-image/compose.yaml -f docker-image/compose.production.yaml up -d --scale ffprobe-api=2
 ```
 
 **Resources**: 8GB RAM, 4 CPU cores, 50GB storage  
@@ -69,10 +69,9 @@ docker compose -f compose.yml -f compose.production.yml up -d --scale ffprobe-ap
 
 ```bash
 # Enterprise deployment with full monitoring stack
-docker compose -f compose.yml -f compose.enterprise.yml up -d \
+docker compose -f docker-image/compose.yaml -f docker-image/compose.production.yaml up -d \
   --scale ffprobe-api=3 \
-  --scale ffprobe-worker=5 \
-  --scale llm-service=2
+  --scale ollama=2
 ```
 
 **Resources**: 16GB+ RAM, 8+ CPU cores, 100GB+ storage  
@@ -92,13 +91,13 @@ docker compose -f compose.yml -f compose.enterprise.yml up -d \
 
 ```bash
 # Horizontal scaling
-docker compose up -d --scale ffprobe-api=3
+docker compose -f docker-image/compose.yaml up -d --scale ffprobe-api=3
 
 # Resource limits (production)
-docker compose -f compose.yml -f compose.production.yml up -d
+docker compose -f docker-image/compose.yaml -f docker-image/compose.production.yaml up -d
 
 # Enterprise with monitoring
-docker compose -f compose.yml -f compose.enterprise.yml up -d
+docker compose -f docker-image/compose.yaml -f docker-image/compose.production.yaml up -d
 ```
 
 ## Environment Configuration
@@ -303,10 +302,10 @@ Available at `http://localhost:8080/metrics`:
 
 ```bash
 # View application logs
-docker compose logs -f ffprobe-api
+docker compose -f docker-image/compose.yaml logs -f ffprobe-api
 
 # Monitor specific service
-docker compose logs -f postgres
+docker compose -f docker-image/compose.yaml logs -f postgres
 ```
 
 ## Backup and Recovery
@@ -315,10 +314,10 @@ docker compose logs -f postgres
 
 ```bash
 # Create backup
-docker compose exec postgres pg_dump -U postgres ffprobe_api > backup.sql
+docker compose -f docker-image/compose.yaml exec postgres pg_dump -U postgres ffprobe_api > backup.sql
 
 # Restore backup
-docker compose exec -T postgres psql -U postgres ffprobe_api < backup.sql
+docker compose -f docker-image/compose.yaml exec -T postgres psql -U postgres ffprobe_api < backup.sql
 ```
 
 ### Configuration Backup
@@ -357,10 +356,10 @@ docker compose exec postgres psql -U postgres -c "SELECT * FROM pg_stat_activity
 
 ```bash
 # Pull latest images
-docker compose pull
+docker compose -f docker-image/compose.yaml pull
 
 # Restart with new version
-docker compose up -d
+docker compose -f docker-image/compose.yaml up -d
 
 # Verify update
 curl http://localhost:8080/health
@@ -372,16 +371,14 @@ Database migrations run automatically on startup. For manual migration:
 
 ```bash
 # Run migrations manually
-docker compose exec ffprobe-api ./migrate -path ./migrations -database "postgres://..." up
+docker compose -f docker-image/compose.yaml exec ffprobe-api ./migrate -path ./migrations -database "postgres://..." up
 ```
 
 ---
 
 ## Next Steps
 
-- [Configuration Reference](configuration.md)
-- [Monitoring Setup](monitoring.md) 
-- [Production Readiness Checklist](PRODUCTION_READINESS_CHECKLIST.md)
-- [Troubleshooting Guide](../troubleshooting/README.md)
-
-*For support, see [GitHub Issues](https://github.com/rendiffdev/ffprobe-api/issues)*
+- [Monitoring Setup](../operations/monitoring.md) 
+- [Security Guide](../operations/security.md)
+- [Production Readiness Report](../PRODUCTION_READINESS_REPORT.md)
+- [Troubleshooting Guide](../../README.md#troubleshooting)

docs/operations/monitoring.md

@@ -457,11 +457,11 @@ curl http://prometheus:9090/api/v1/query?query=prometheus_tsdb_symbol_table_size
 ### Log Overflow
 ```bash
 # Check log volume
-docker compose logs ffprobe-api | wc -l
+docker compose -f docker-image/compose.yaml logs ffprobe-api | wc -l
 
 # Adjust log level
 export LOG_LEVEL=warn
-docker compose restart ffprobe-api
+docker compose -f docker-image/compose.yaml restart ffprobe-api
 ```
 
 ---

docs/tutorials/local-llm-setup.md

@@ -14,12 +14,12 @@ The FFprobe API uses an optimized dual-model AI approach:
 
 ### 🐳 **Fully Containerized Services**
 ```bash
-docker compose up -d
+docker compose -f docker-image/compose.yaml up -d
 # That's it! Everything is configured automatically:
-# ✅ Ollama with Phi-3 Mini model
-# ✅ PostgreSQL database  
-# ✅ Redis caching
-# ✅ FFmpeg/FFprobe workers
+# ✅ Ollama with Gemma 3 270M + Phi-3 Mini models
+# ✅ SQLite/PostgreSQL database  
+# ✅ Valkey caching
+# ✅ FFmpeg/FFprobe integration
 # ✅ API server with authentication
 ```