Few fixes

README.md

@@ -0,0 +1,136 @@
+# Bakery Forecasting Platform - Microservices
+
+## Overview
+AI-powered demand forecasting platform for bakeries in Madrid, Spain using microservices architecture.
+
+## Architecture
+- **API Gateway**: Central entry point for all client requests
+- **Auth Service**: User authentication and authorization
+- **Training Service**: ML model training for demand forecasting
+- **Forecasting Service**: Generate predictions using trained models
+- **Data Service**: External data integration (weather, traffic, events)
+- **Tenant Service**: Multi-tenant management
+- **Notification Service**: Email and WhatsApp notifications
+
+## Quick Start
+
+### Prerequisites
+- Docker and Docker Compose
+- Python 3.11+
+- Node.js 18+
+
+### Setup
+```bash
+# Run setup script (this script!)
+./scripts/setup.sh
+
+# Start services
+docker-compose up -d
+
+# Check service health
+curl http://localhost:8000/health
+```
+
+### Services
+- **Gateway**: http://localhost:8000
+- **API Docs**: http://localhost:8000/docs
+- **Grafana**: http://localhost:3002
+- **Prometheus**: http://localhost:9090
+- **RabbitMQ Management**: http://localhost:15672
+
+### Development
+
+#### Running Tests
+```bash
+./scripts/test.sh
+```
+
+#### Building Services
+```bash
+docker-compose build
+```
+
+#### Viewing Logs
+```bash
+# All services
+docker-compose logs -f
+
+# Specific service
+docker-compose logs -f auth-service
+```
+
+#### Service URLs (Development)
+- Gateway: http://localhost:8000
+- Auth Service: http://localhost:8001
+- Training Service: http://localhost:8002
+- Forecasting Service: http://localhost:8003
+- Data Service: http://localhost:8004
+- Tenant Service: http://localhost:8005
+- Notification Service: http://localhost:8006
+
+## Environment Variables
+
+Copy `.env.example` to `.env` and update the following:
+
+```bash
+# External API Keys
+AEMET_API_KEY=your-aemet-api-key
+MADRID_OPENDATA_API_KEY=your-madrid-opendata-key
+
+# Email Configuration
+SMTP_USER=your-email@gmail.com
+SMTP_PASSWORD=your-email-password
+
+# WhatsApp API
+WHATSAPP_API_KEY=your-whatsapp-api-key
+
+# JWT Secret (change in production!)
+JWT_SECRET_KEY=your-super-secret-jwt-key
+```
+
+## Troubleshooting
+
+### Services won't start
+```bash
+# Check if ports are available
+docker-compose ps
+netstat -tulpn | grep :8000
+
+# Restart services
+docker-compose down
+docker-compose up -d
+```
+
+### Database connection issues
+```bash
+# Check database containers
+docker-compose logs auth-db
+docker-compose logs training-db
+
+# Reset databases
+docker-compose down -v
+docker-compose up -d
+```
+
+### Service communication issues
+```bash
+# Check service health
+curl http://localhost:8000/health
+curl http://localhost:8001/health
+curl http://localhost:8002/health
+
+# Check RabbitMQ
+open http://localhost:15672
+# User: bakery, Password: forecast123
+```
+
+## Next Steps
+
+1. **Configure External APIs**: Add your AEMET and Madrid Open Data API keys
+2. **Test Authentication**: Register a user and test login
+3. **Upload Sales Data**: Import historical sales data
+4. **Train Models**: Start your first training job
+5. **Generate Forecasts**: Create demand predictions
+
+## License
+MIT License