Priceflow/docs/deployment-guide.md

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:

   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:

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.