Add FIX UI Client to HuggingFace Space via nginx reverse proxy

- Add fix_server_hf.cfg and client_hf.cfg with localhost paths for single-container use
- Add nginx.conf routing port 7860: / → dashboard (5000), /fix/ → fix-ui-client (5002)
- Update Dockerfile: add nginx, QuickFIX build deps, copy fix_oeg and fix-ui-client code
- Update entrypoint.sh: start fix_oeg, fix-ui-client, nginx before dashboard
- Add "FIX UI" nav link in dashboard pointing to /fix/

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Dockerfile

@@ -1,5 +1,5 @@
 # HuggingFace Spaces – StockEx Trading Demo
-# Single container: Kafka (KRaft) + Matcher + MD Feeder + Dashboard
+# Single container: Kafka (KRaft) + Matcher + MD Feeder + Dashboard + FIX OEG + FIX UI Client
 
 FROM python:3.11-slim
 
@@ -8,10 +8,15 @@ ENV PYTHONUNBUFFERED=1
 # Limit Kafka JVM heap to fit free-tier RAM
 ENV KAFKA_HEAP_OPTS="-Xmx400m -Xms256m"
 
-# Install Java (required by Kafka) + wget
+# Install Java (required by Kafka) + wget + nginx + C++ build tools (for QuickFIX)
 RUN apt-get update && apt-get install -y --no-install-recommends \
       default-jre-headless \
       wget \
+      nginx \
+      build-essential \
+      libssl-dev \
+      zlib1g-dev \
+      libbz2-dev \
     && rm -rf /var/lib/apt/lists/*
 
 # Download Apache Kafka 3.7.0 (KRaft mode – no ZooKeeper needed)
@@ -23,11 +28,12 @@ RUN wget -q \
     && mv /opt/kafka_2.13-${KAFKA_VERSION} /opt/kafka \
     && rm /tmp/kafka.tgz
 
-# Install Python dependencies
+# Install Python dependencies (quickfix compiles from source – allow extra time)
 RUN pip install --no-cache-dir \
       kafka-python==2.0.2 \
       Flask==2.2.5 \
-      requests==2.31.0
+      requests==2.31.0 \
+      quickfix
 
 # ── Application code (flat layout matching /app container paths) ──────────────
 WORKDIR /app
@@ -46,9 +52,23 @@ COPY md_feeder/mdf_simulator.py       /app/mdf_simulator.py
 COPY dashboard/dashboard.py           /app/dashboard.py
 COPY dashboard/templates/             /app/templates/
 
+# FIX OEG (Order Entry Gateway)
+COPY fix_oeg/fix_oeg_server.py        /app/fix_oeg/fix_oeg_server.py
+COPY fix_oeg/FIX44.xml                /app/fix_oeg/FIX44.xml
+# Use HF-specific config (localhost paths instead of container service names)
+COPY fix_server_hf.cfg                /app/fix_oeg/fix_server.cfg
+
+# FIX UI Client
+COPY fix-ui-client/fix-ui-client.py   /app/fix_ui/fix_ui_client.py
+COPY fix-ui-client/templates/         /app/fix_ui/templates/
+COPY client_hf.cfg                    /app/fix_ui/client_hf.cfg
+
 # ── Kafka KRaft configuration ─────────────────────────────────────────────────
 COPY kafka-kraft.properties           /opt/kafka/config/kraft/server.properties
 
+# ── nginx configuration ───────────────────────────────────────────────────────
+COPY nginx.conf                       /etc/nginx/nginx.conf
+
 # ── Startup script ────────────────────────────────────────────────────────────
 COPY entrypoint.sh /entrypoint.sh
 RUN chmod +x /entrypoint.sh

client_hf.cfg

@@ -0,0 +1,21 @@
+[DEFAULT]
+ConnectionType=initiator
+StartTime=00:00:00
+EndTime=23:59:59
+UseLocalTime=Y
+HeartBtInt=30
+FileStorePath=/tmp/fix_store
+FileLogPath=/tmp/fix_log
+UseDataDictionary=Y
+DataDictionary=/app/fix_oeg/FIX44.xml
+ReconnectInterval=5
+ResetOnLogon=Y
+ResetOnLogout=Y
+ResetOnDisconnect=Y
+
+[SESSION]
+BeginString=FIX.4.4
+SenderCompID=CLIENT1
+TargetCompID=FIX_SERVER
+SocketConnectHost=localhost
+SocketConnectPort=5001

dashboard/templates/index.html

@@ -163,6 +163,7 @@
     <span id="session-badge" class="status idle"><span class="dot"></span><span id="session-text">IDLE</span></span>
     <button onclick="startDay()" class="btn-day btn-start">Start of Day</button>
     <button onclick="endDay()" class="btn-day btn-end">End of Day</button>
+    <a href="/fix/" style="margin-left:auto; padding:4px 14px; background:#6c757d; color:#fff; border-radius:20px; font-size:12px; font-weight:bold; text-decoration:none;">FIX UI</a>
   </h1>
   <div class="container">
 

entrypoint.sh

@@ -6,7 +6,9 @@ KAFKA_DIR=/opt/kafka
 export PYTHONPATH=/app
 export KAFKA_BOOTSTRAP=localhost:9092
 export MATCHER_URL=http://localhost:6000
-export PORT=7860
+export PORT=5000
+export FIX_CONFIG=/app/fix_ui/client_hf.cfg
+export UI_PORT=5002
 
 # ── Kafka (KRaft) ─────────────────────────────────────────────────────────────
 echo "[startup] Formatting Kafka storage (KRaft)..."
@@ -53,5 +55,17 @@ sleep 8
 echo "[startup] Starting MD Feeder..."
 python3 /app/mdf_simulator.py &
 
-echo "[startup] Starting Dashboard on port 7860..."
+echo "[startup] Starting FIX OEG on port 5001..."
+(cd /app/fix_oeg && python3 /app/fix_oeg/fix_oeg_server.py) &
+sleep 3
+
+echo "[startup] Starting FIX UI Client on port 5002..."
+python3 /app/fix_ui/fix_ui_client.py &
+sleep 2
+
+# ── nginx (reverse proxy: port 7860 → dashboard:5000 + fix-ui:5002) ───────────
+echo "[startup] Starting nginx on port 7860..."
+nginx
+
+echo "[startup] Starting Dashboard on port 5000..."
 exec python3 /app/dashboard.py

fix_server_hf.cfg

@@ -0,0 +1,26 @@
+[DEFAULT]
+ConnectionType=acceptor
+SocketAcceptPort=5001
+SocketReuseAddress=Y
+StartTime=00:00:00
+EndTime=23:59:59
+UseLocalTime=Y
+UseDataDictionary=Y
+DataDictionary=/app/fix_oeg/FIX44.xml
+FileStorePath=/tmp/fix_store
+FileLogPath=/tmp/fix_log
+HeartBtInt=30
+ValidateUserDefinedFields=N
+ResetOnLogon=Y
+ResetOnLogout=Y
+ResetOnDisconnect=Y
+
+[SESSION]
+BeginString=FIX.4.4
+SenderCompID=FIX_SERVER
+TargetCompID=CLIENT1
+
+[SESSION]
+BeginString=FIX.4.4
+SenderCompID=FIX_SERVER
+TargetCompID=CLIENT2

nginx.conf

@@ -0,0 +1,45 @@
+worker_processes 1;
+events { worker_connections 256; }
+
+http {
+    include       /etc/nginx/mime.types;
+    default_type  application/octet-stream;
+    access_log    off;
+
+    server {
+        listen 7860;
+
+        # SSE – disable buffering for the dashboard's /stream endpoint
+        location /stream {
+            proxy_pass         http://localhost:5000/stream;
+            proxy_set_header   Host $host;
+            proxy_set_header   X-Real-IP $remote_addr;
+            proxy_buffering    off;
+            proxy_cache        off;
+            proxy_read_timeout 3600s;
+            chunked_transfer_encoding on;
+        }
+
+        # FIX UI Client – served under /fix/
+        location /fix/ {
+            proxy_pass         http://localhost:5002/;
+            proxy_set_header   Host $host;
+            proxy_set_header   X-Real-IP $remote_addr;
+            # Rewrite absolute links generated by Flask url_for()
+            sub_filter         'href="/'    'href="/fix/';
+            sub_filter         'action="/'  'action="/fix/';
+            sub_filter_once    off;
+            sub_filter_types   text/html;
+            # Rewrite Location headers on Flask redirects
+            proxy_redirect     / /fix/;
+        }
+
+        # Dashboard – everything else
+        location / {
+            proxy_pass         http://localhost:5000;
+            proxy_set_header   Host $host;
+            proxy_set_header   X-Real-IP $remote_addr;
+            proxy_buffering    off;
+        }
+    }
+}