Chore/ops compose logs (#592)

* E2E: Odoo + Shopify wiring, Next image allow-list, VVD assets, smokes, and port hygiene

* chore(gitignore): dedupe PID ignores per CodeRabbit

* ci: backend+frontend workflows, env examples

* dx: dev and smoke scripts

* partcad: adapter + GLB/BOM endpoints, FE viewer

* chore: align env ordering and share port helper

* 📝 Add docstrings to `feat/partcad-adapter` (#581)

Docstrings generation was requested by @shayancoin.

* #580 (comment)

The following files were modified:

* `backend/api/routes_partcad.py`
* `backend/services/partcad/adapter.py`
* `frontend/app/partcad/[model]/page.tsx`
* `frontend/components/GLBViewer.tsx`
* `scripts/dev.sh`
* `scripts/smoke.sh`

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* feat: extend partcad integration and CI

* 📝 Add docstrings to `feat/partcad-adapter` (#583)

Docstrings generation was requested by @shayancoin.

* #582 (comment)

The following files were modified:

* `backend/api/routes_partcad.py`
* `backend/main.py`
* `backend/services/partcad/adapter.py`
* `frontend/app/partcad/[model]/page.tsx`
* `frontend/components/GLBViewer.tsx`
* `frontend/components/PartcadViewerShell.tsx`
* `scripts/dev.sh`
* `scripts/lib/common.sh`
* `scripts/smoke.sh`

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: Shayan <shayan@coin.link>

* feat: extend partcad integration and CI

* pricing: CPQ→Odoo quote+order endpoints

* fix: stabilize ci, pricing, and partcad viewers

* chore: harden pricing limiter and partcad integrations

* fix: ensure partcad limiter receives request and restore smoke executability

* chore: apply requested adjustments

* 3d: bake pipeline (assimp) and baked dir

* 3d: import vvd assets and baked glbs

* ops: dev compose profiles, logrotate doc

* ops: restore dev stack and polish partcad tooling

---------

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

Author: shayancoin

.github/workflows/backend-ci.yml

@@ -85,10 +85,10 @@ jobs:
             cat "${HEALTH_OUTPUT}"
             echo
             echo "== Odoo customer =="
-            curl -sS -X POST http://127.0.0.1:8000/api/odoo/sync/customer -H 'content-type: application/json' --data '{"name":"CI User","email":"ci@example.com"}' || true
+            curl -sS -X POST http://localhost:8000/api/odoo/sync/customer -H 'content-type: application/json' --data '{"name":"CI User","email":"ci@example.com"}' || true
             echo
             echo "== Odoo order =="
-            curl -sS -X POST http://127.0.0.1:8000/api/odoo/sync/order -H 'content-type: application/json' --data '{"external_id":"SO-CI","total":42.0,"lines":[{"qty":1,"price":42.0}]}' || true
+            curl -sS -X POST http://localhost:8000/api/odoo/sync/order -H 'content-type: application/json' --data '{"external_id":"SO-CI","total":42.0,"lines":[{"qty":1,"price":42.0}]}' || true
             echo
           } | tee -a logs/backend_e2e.txt
           rm -f "${HEALTH_OUTPUT}" "${HEALTH_ERROR}"

.github/workflows/frontend-ci.yml

@@ -63,7 +63,7 @@ jobs:
           HEALTH_OUTPUT="$(mktemp)"
           health_ok=0
           for _ in {1..60}; do
-            if curl -fsS http://127.0.0.1:3001/api/health > "${HEALTH_OUTPUT}"; then
+            if curl -fsS http://localhost:3001/api/health > "${HEALTH_OUTPUT}"; then
               health_ok=1
               break
             fi
@@ -81,7 +81,7 @@ jobs:
             cat "${HEALTH_OUTPUT}"
             echo
             echo "== FE /api/env =="
-            curl -fsS http://127.0.0.1:3001/api/env
+            curl -fsS http://localhost:3001/api/env
             echo
           } | tee -a ../logs/frontend_e2e.txt
 
@@ -93,7 +93,7 @@ import time
 import urllib.error
 import urllib.request
 
-BASE_URL = "http://127.0.0.1:3001"
+BASE_URL = "http://localhost:3001"
 
 
 def log(message: str) -> None:

backend/README.md

@@ -17,8 +17,14 @@ uvicorn api.main:app --reload
 ### With Docker
 
 ```bash
-# From the root directory
-docker compose --env-file .env.development -f docker-compose.dev.yml up backend-dev
+# Start the backend with hot-reload (requires ODOO_ADMIN_USER/ODOO_ADMIN_PASS)
+ODOO_ADMIN_USER=admin ODOO_ADMIN_PASS=admin scripts/dev.sh be
+```
+
+To launch only the supporting containers (Postgres + Odoo) run:
+
+```bash
+docker compose --env-file .env.development -f docker-compose.dev.yml --profile dev up -d
 ```
 
 ### Environment variables

backend/api/routes_partcad.py

@@ -4,6 +4,7 @@
 import logging
 import time
 from dataclasses import dataclass, field
+from functools import lru_cache
 from pathlib import Path
 from typing import Any, Dict, Optional
 from uuid import uuid4

backend/limiter.py

@@ -1,3 +1,6 @@
+import logging
+from collections.abc import Sequence
+
 from slowapi import Limiter
 from slowapi.util import get_ipaddr
 

backend/pyproject.toml

@@ -5,7 +5,7 @@ description = "MVP Backend API"
 readme = "README.md"
 requires-python = ">=3.12"
 dependencies = [
-    "fastapi>=0.115.0",
+    "fastapi>=0.112.2,<0.113.0",
     "uvicorn>=0.30.0",
     "python-dotenv>=1.0.0",
     "pydantic>=2.5.0",
@@ -14,7 +14,7 @@ dependencies = [
     "sqlalchemy>=2.0.36",
     "alembic>=1.13.2",
     "psycopg[binary]>=3.2.1",
-    "aiosqlite>=0.19.0",
+    "aiosqlite>=0.20.0",
     "email-validator>=2.2.0",
     "sentry-sdk[fastapi,httpx,opentelemetry]==2.42.0",
     "opentelemetry-api>=1.28.0",

docker-compose.dev.yml

@@ -65,6 +65,34 @@ services:
     networks:
       - app-network
 
+  db:
+    image: postgres:16
+    environment:
+      POSTGRES_USER: paform
+      POSTGRES_PASSWORD: paform
+    ports:
+      - "5432:5432"
+    profiles:
+      - dev
+    networks:
+      - app-network
+
+  odoo:
+    image: odoo:18
+    environment:
+      DB_HOST: db
+      DB_PORT: 5432
+      DB_USER: paform
+      DB_PASSWORD: paform
+    depends_on:
+      - db
+    ports:
+      - "8069:8069"
+    profiles:
+      - dev
+    networks:
+      - app-network
+
 networks:
   app-network:
     driver: bridge

frontend/README.md

@@ -11,11 +11,17 @@ npm install
 npm run dev
 ```
 
-### With Docker
+### With Docker/Helper Script
 
 ```bash
-# From the root directory
-docker compose --env-file .env.development -f docker-compose.dev.yml up frontend-dev
+# From the repository root
+scripts/dev.sh fe
+```
+
+To start only the shared Postgres and Odoo dependencies in containers:
+
+```bash
+docker compose --env-file .env.development -f docker-compose.dev.yml --profile dev up -d
 ```
 
 ## Project Structure

ops/logrotate.conf

@@ -0,0 +1,15 @@
+# run weekly via cron or CI (doc only)
+logs/*.log {
+  weekly
+  size 100M
+  maxage 28
+  rotate 4
+  compress
+  missingok
+  notifempty
+  copytruncate
+  postrotate
+    # TODO: send SIGHUP to long-running services if they need to reopen log files.
+    # e.g. kill -HUP $(cat /var/run/your-service.pid) || true
+  endscript
+}