MQL5-Google-Onedrive/docs/Boat_House_Quick_Start.md

Boat House Quick Start Guide

Overview

This guide provides quick instructions for getting started with the Boat House restaurant management system that has been integrated into this repository.

Prerequisites

• Docker and Docker Compose installed
• At least 4GB of available RAM
• Ports 3306, 5000, 5001, 6001, 6379, 7001, 7002 available

Quick Start

1. Navigate to the boat-house directory

cd boat-house

2. Start all services with Docker Compose

docker-compose up -d

This command will:

• Build all service containers
• Start databases (MySQL, PostgreSQL, Redis)
• Launch all microservices
• Set up the required networks

3. Verify services are running

docker-compose ps

You should see all services in "Up" status.

4. Access the applications

Once all services are running, you can access:

• Customer Website: http://localhost:5000
• Management Dashboard: http://localhost:5001
• Statistics API: http://localhost:6001
• Product API: http://localhost:7001
• Account API: http://localhost:7002

Service Architecture

┌─────────────────┐     ┌──────────────────┐
│  Client (5000)  │     │ Management (5001)│
└────────┬────────┘     └────────┬─────────┘
         │                       │
    ┌────┴───────────────────────┴────┐
    │         API Services             │
    ├──────────────────────────────────┤
    │ Statistics (6001) + Redis (6379) │
    │ Product (7001) + MySQL (3306)    │
    │ Account (7002)                   │
    └──────────────────────────────────┘

Common Commands

View logs for all services

cd boat-house
docker-compose logs -f

View logs for a specific service

cd boat-house
docker-compose logs -f client

Stop all services

cd boat-house
docker-compose down

Stop and remove volumes (clean reset)

cd boat-house
docker-compose down -v

Rebuild services after code changes

cd boat-house
docker-compose up -d --build

Troubleshooting

Port conflicts

If you get port conflict errors, you can either:

1. Stop the conflicting service on your machine
2. Edit docker-compose.yml to use different ports

Database initialization issues

If services fail to connect to databases:

1. Check database logs: docker-compose logs statistics-service-db product-service-db
2. Ensure databases are fully initialized before services start
3. Restart services: docker-compose restart

Out of memory errors

If containers crash due to memory:

1. Check available resources: docker stats
2. Stop unnecessary services
3. Increase Docker's memory allocation in Docker Desktop settings

Development Workflow

Working on a specific service

1. Make changes to the service code
2. Rebuild only that service:

   docker-compose up -d --build service-name
   

3. View logs to verify:

   docker-compose logs -f service-name
   

Running tests

Each service has its own test suite. Refer to the service's README for specific test commands.

Next Steps

• Read the full integration documentation
• Explore individual service READMEs in their directories
• Check the original boat-house README

Support

For issues specific to:

• Boat House system: Refer to the original repository
• Integration: Open an issue in this repository