Bank Services tested and completed

BankServices/EmailService/README.md

@@ -0,0 +1,84 @@
+# Email Service
+
+## Overview
+The Email Service is the first component in a Redis pub/sub processing chain for bank-related email automation. It monitors a specified mailbox for emails with attachments, filters them based on IBAN criteria, and publishes the data to a Redis channel for further processing.
+
+## Features
+
+### Email Processing
+- Connects to a configured mailbox using IMAP
+- Implements smart date-based filtering:
+  - Checks emails from the past 14 days on the first run of each day
+  - Checks emails from the past 7 days on subsequent runs within the same day
+- Extracts attachments from emails
+- Filters attachments based on IBAN criteria
+- Uses a context manager to ensure emails are properly handled even during errors
+
+### Redis Integration
+- Publishes messages to a Redis pub/sub channel ("CollectedData")
+- Each message contains:
+  - Unique UUID
+  - Timestamp
+  - Initial stage marker ("red")
+  - Attachment payload and metadata
+- Connects to an external Redis server
+
+### Error Handling
+- Robust error management with context managers
+- Automatic marking of emails as unread if processing fails
+- Comprehensive logging
+
+## Configuration
+
+### Environment Variables
+```
+EMAIL_HOST=10.10.2.34
+EMAIL_USERNAME=isbank@mehmetkaratay.com.tr
+EMAIL_PASSWORD=system
+EMAIL_SLEEP=60
+AUTHORIZE_IBAN=4245-0093333
+REDIS_HOST=10.10.2.15
+REDIS_PORT=6379
+REDIS_PASSWORD=your_strong_password_here
+```
+
+## Deployment
+
+### Docker
+The service is containerized using Docker and can be deployed using the provided Dockerfile and docker-compose configuration.
+
+```bash
+# Build and start the service
+docker compose -f bank-services-docker-compose.yml up -d --build
+
+# View logs
+docker compose -f bank-services-docker-compose.yml logs -f email_service
+
+# Stop the service
+docker compose -f bank-services-docker-compose.yml down
+```
+
+### Service Management
+The `check_bank_services.sh` script provides a simple way to restart the service:
+
+```bash
+./check_bank_services.sh
+```
+
+## Architecture
+
+### Redis Pub/Sub Chain
+This service is the first in a multi-stage processing chain:
+1. **Email Service** (this service): Reads emails, extracts attachments, publishes to Redis with stage="red"
+2. **Processor Service**: Subscribes to stage="red" messages, processes data, republishes with stage="processed"
+3. **Writer Service**: Subscribes to stage="processed" messages, writes data to final destination, marks as stage="completed"
+
+## Development
+
+### Dependencies
+- Python 3.12
+- Redbox (email library)
+- Redis
+
+### State Management
+The service maintains a state file at `/tmp/email_service_last_run.json` to track when it last ran, enabling the smart date-based filtering feature.