Add project documentation and initial analysis reports

docs/deployment-guide.md

@@ -0,0 +1,51 @@
+# Deployment Guide
+
+## Infrastructure Architecture
+
+PriceFlow is designed to be deployed using Docker Compose. The stack consists of:
+
+- **App**: The main FastAPI backend and application logic.
+- **Frontend**: Served typically via Nginx or embedded (in this setup, check docker-compose for service details).
+- **Database**: PostgreSQL container.
+- **Browserless**: Headless Chrome instance for scraping.
+
+## Services & Ports
+
+| Service | Internal Port | Host Port | Description |
+|---------|---------------|-----------|-------------|
+| **PriceFlow App** | 8555 | 8555 | Main Application API & UI Serving |
+| **PostgreSQL** | 5432 | 5488 | Database Access |
+| **Browserless** | 3000 | 3012 | Headless Browser Debugger |
+
+## Deployment Steps
+
+1. **Prepare the Host**: Ensure Docker and Docker Compose are installed.
+
+2. **Configuration**:
+    - Copy `.env.example` to `.env`.
+    - Set critical variables:
+        - `DATABASE_URL`: Connection string for PostgreSQL.
+        - `BROWSERLESS_URL`: WebSocket URL for Browserless.
+        - `OPENAI_API_KEY` / Other AI Keys: For AI analysis features.
+
+3. **Launch**:
+
+    ```bash
+    docker compose up -d
+    ```
+
+4. **Access**:
+    - Application: `http://localhost:8555`
+
+## Networking
+
+The application uses an external Docker network named `nginx_default`. Ensure this is created:
+
+```bash
+docker network create nginx_default
+```
+
+## Troubleshooting
+
+- **Scraping Issues**: Check `Browserless` container logs. Ensure the app can reach the browserless service URL.
+- **Database Connections**: Verify the `DATABASE_URL` matches the container name and credentials in `docker-compose.yml`.