Chore/portfolio polish productmanager

.dockerignore

@@ -0,0 +1,20 @@
+.env
+.env.*
+!.env.example
+.venv
+venv
+env
+__pycache__
+*.py[cod]
+.pytest_cache
+.mypy_cache
+.ruff_cache
+.git
+.gitignore
+.DS_Store
+data
+docs/assets/*.gif
+docs/assets/*.png
+docs/assets/*.jpg
+docs/assets/*.jpeg
+.langgraph_api

.env.example

@@ -1,7 +1,15 @@
-OPENAI_API_KEY=your_key_here
-OPENAI_MODEL=gpt-5.2
-OPENAI_FALLBACK_MODEL=5
+# Set DEMO_MODE=true to run the Streamlit UI without real OpenAI calls.
+DEMO_MODE=false
+
+# Required unless DEMO_MODE=true.
+OPENAI_API_KEY=
+
+# GPT-5.4 is the default portfolio model. If your account does not have access,
+# set OPENAI_MODEL to another model you can use and keep the fallback valid.
+OPENAI_MODEL=gpt-5.4
+OPENAI_FALLBACK_MODEL=gpt-5.4-mini
 OPENAI_REASONING_EFFORT=high
+
 OPENAI_EMBEDDING_MODEL=text-embedding-3-small
 DOCS_DIR=docs
 DATA_DIR=data

.github/workflows/ci.yml

@@ -0,0 +1,28 @@
+name: CI
+
+on:
+  push:
+    branches: ["main", "chore/**"]
+  pull_request:
+    branches: ["main"]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: "pip"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -r requirements.txt
+
+      - name: Run pytest
+        run: pytest

Dockerfile

@@ -0,0 +1,27 @@
+FROM python:3.11-slim
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    PYTHONPATH=/app/src \
+    STREAMLIT_SERVER_ADDRESS=0.0.0.0 \
+    STREAMLIT_SERVER_PORT=8501
+
+WORKDIR /app
+
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends build-essential curl \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY requirements.txt .
+RUN python -m pip install --upgrade pip \
+    && python -m pip install --no-cache-dir -r requirements.txt
+
+COPY app.py langgraph.json ./
+COPY src ./src
+COPY scripts ./scripts
+COPY docs ./docs
+COPY .env.example ./.env.example
+
+EXPOSE 8501
+
+CMD ["streamlit", "run", "app.py", "--server.address=0.0.0.0", "--server.port=8501"]