Add project documentation and initial analysis reports

docs/development-guide.md

@@ -0,0 +1,100 @@
+# Development Guide
+
+## Prerequisites
+
+- **Docker** and **Docker Compose**
+- **Node.js** (for frontend development)
+- **Python 3.12+** (for backend development)
+- **Git**
+
+## Environment Setup
+
+1. Clone the repository:
+
+    ```bash
+    git clone https://github.com/R0m1k3/Priceflow.git
+    cd Priceflow
+    ```
+
+2. Configure environment variables:
+
+    ```bash
+    cp .env.example .env
+    # Edit .env to set your specific configurations (Database, AI keys, etc.)
+    ```
+
+3. Create the Docker network (if using specific network setup):
+
+    ```bash
+    docker network create nginx_default
+    ```
+
+## Local Development
+
+### Backend (FastAPI)
+
+1. Navigate to the backend directory:
+
+    ```bash
+    cd app
+    ```
+
+2. Install dependencies (recommended to use a virtual environment):
+
+    ```bash
+    pip install -r requirements.txt  # Or use a package manager like uv/poetry if configured
+    ```
+
+3. Run the development server with hot reload:
+
+    ```bash
+    uvicorn app.main:app --reload --port 8555
+    ```
+
+    The API will be available at `http://localhost:8555`.
+
+### Frontend (React)
+
+1. Navigate to the frontend directory:
+
+    ```bash
+    cd frontend
+    ```
+
+2. Install dependencies:
+
+    ```bash
+    npm install
+    ```
+
+3. Run the development server:
+
+    ```bash
+    npm run dev
+    ```
+
+    The frontend will be available at the URL provided by Vite (usually `http://localhost:5173`).
+
+## Database Migrations
+
+This project uses Alembic for database migrations.
+
+1. **Create a new migration** (after modifying models):
+
+    ```bash
+    alembic revision --autogenerate -m "description of changes"
+    ```
+
+2. **Apply migrations**:
+
+    ```bash
+    alembic upgrade head
+    ```
+
+## Testing
+
+*(To be configured - check `tests/` directory for `pytest` usage)*
+
+```bash
+pytest
+```