chore(docker): run full stack with compose and document startup flow

Start API and frontend services from docker compose with published ports.

Update Make targets and Docker docs for the 3-container setup.

Author: vharkins1

Makefile

@@ -1,4 +1,4 @@
-.PHONY: help build up down logs shell exec pull-model test clean fireform
+.PHONY: help build up down logs shell exec pull-model test clean fireform logs-app logs-ollama logs-frontend super-clean
 
 help:
 	@printf '%s\n' \
@@ -16,6 +16,9 @@ help:
 	@echo "make up           - Start all containers"
 	@echo "make down         - Stop all containers"
 	@echo "make logs         - View container logs"
+	@echo "make logs-app     - View API container logs"
+	@echo "make logs-frontend - View frontend container logs"
+	@echo "make logs-ollama  - View Ollama container logs"
 	@echo "make shell        - Open Python shell in app container"
 	@echo "make exec         - Execute Python script in container"
 	@echo "make pull-model   - Pull Mistral model into Ollama"
@@ -45,6 +48,9 @@ logs-app:
 logs-ollama:
 	docker compose logs -f ollama
 
+logs-frontend:
+	docker compose logs -f frontend
+
 shell:
 	docker compose exec app /bin/bash
 

container-init.sh

@@ -16,8 +16,9 @@ echo "============================================"
 make up
 echo "============================================"
 echo "Use make down to stop" 
-echo "Use docker ps to verify, you should see 2 containers:"
+echo "Use docker ps to verify, you should see 3 containers:"
 echo "\t* fireform-app"
+echo "\t* fireform-frontend"
 echo "\t* ollama/ollama:latest"
 docker ps
 echo "============================================"
@@ -26,4 +27,3 @@ echo "============================================"
 make pull-model
 echo "============================================"
 echo "Done"
-

docker-compose.yml

@@ -23,16 +23,32 @@ services:
     depends_on:
       ollama:
         condition: service_healthy
+    command: /bin/sh -c "python3 -m api.db.init_db && python3 -m uvicorn api.main:app --host 0.0.0.0 --port 8000"
     volumes:
       - .:/app
+    ports:
+      - "8000:8000"
     environment:
       - PYTHONUNBUFFERED=1
       - PYTHONPATH=/app/src
       - OLLAMA_HOST=http://ollama:11434
     networks:
       - fireform-network
-    stdin_open: true
-    tty: true
+
+  frontend:
+    image: python:3.11-slim
+    container_name: fireform-frontend
+    working_dir: /app
+    command: python3 -m http.server 5173 --directory frontend
+    volumes:
+      - .:/app
+    ports:
+      - "5173:5173"
+    depends_on:
+      app:
+        condition: service_started
+    networks:
+      - fireform-network
 
 volumes:
   ollama_data:

docs/docker.md

@@ -1,9 +1,10 @@
 # Docker documentation for FireForm
 
 ## Setup
-We will be using 2 different containers:
-1. `fireform-app` -> This container will hold the whole project itself.
-2. `ollama/ollama:latest` -> This is to deploy ollama, that way it's faster to set up.
+We will be using 3 containers:
+1. `fireform-app` -> Runs the FastAPI server on `http://127.0.0.1:8000`.
+2. `fireform-frontend` -> Serves the frontend on `http://127.0.0.1:5173`.
+3. `ollama/ollama:latest` -> Runs Ollama for LLM calls.
 
 ### Initial configuration steps
 For this I provided a script that can be run to automate the setup. 
@@ -46,6 +47,23 @@ make clean        # Remove all containers and volumes
 ```
 * You can see this list at any time by running `make help`.
 
+## Running the full stack
+
+```bash
+make build
+make up
+```
+
+Then open:
+- Frontend: `http://127.0.0.1:5173`
+- API docs: `http://127.0.0.1:8000/docs`
+
+If this is your first run, pull the model once:
+
+```bash
+make pull-model
+```
+
 ## Debugging
 For debugging with LLMs it's really useful to attach the logs.
 * You can obtain the logs using `make logs` or `docker compose logs`.