Priceflow/docs/source-tree-analysis.md

# Source Tree Analysis

## Critical Directories

```
Priceflow/
├── frontend/                  # React Frontend Application (Part: frontend)
│   ├── public/                # Static assets (favicons, logos)
│   ├── src/
│   │   ├── components/        # Reusable UI components (Radix UI, Custom)
│   │   ├── pages/             # Route components (Dashboard, Settings)
│   │   ├── hooks/             # Custom React hooks
│   │   ├── i18n/              # Internationalization configuration & locales
│   │   ├── lib/               # Utility libraries (utils, constants)
│   │   ├── App.jsx            # Main React component
│   │   └── main.jsx           # Application Entry Point
│   ├── package.json           # Frontend dependencies & scripts
│   └── vite.config.js         # Vite build configuration
├── app/                       # FastAPI Backend Application (Part: app)
│   ├── routers/               # API Endpoints (separated by feature)
│   ├── services/              # Business logic & External integrations (AI, Scraping)
│   ├── core/                  # Core configuration & config loading
│   ├── utils/                 # General utilities
│   ├── alembic/               # Database migrations
│   ├── models.py              # SQLAlchemy Database Models
│   ├── schemas.py             # Pydantic Schemas (Request/Response)
│   └── main.py                # Application Entry Point (FastAPI app)
├── docs/                      # Project Documentation
├── tests/                     # Test suite (Pytest)
├── scripts/                   # Utility scripts (e.g. setup)
├── docker-compose.yml         # Container orchestration config
├── Dockerfile                 # Backend container definition
├── init.sql                   # Database initialization script
└── README.md                  # Project Entry Documentation
```

## Entry Points

- **Frontend**: `frontend/src/main.jsx` - Bootstraps the React application and mounts it to the DOM.
- **Backend**: `app/main.py` - Initializes the FastAPI application, mounts routers, and configures middleware.

## Integration Points

- **API Communication**: The frontend communicates with the backend via REST API calls. Axios is likely used as the HTTP client (from package.json).
- **Database**: The backend connects to the PostgreSQL database container defined in `docker-compose.yml`.
- **Scraping**: The backend connects to the `browserless` service via WebSocket (`ws://browserless:3000`) for Playwright operations.

## Critical Files

- `docker-compose.yml`: Defines the entire stack (App, DB, Browserless).
- `frontend/vite.config.js`: Controls the frontend build process.
- `app/core/config.py` (implied): Likely handles environment variables like `DATABASE_URL`, `OPENAI_API_KEY`.
- `app/models.py`: Defines the data structure (Price, Product, etc.).