From 8d2aaa8ae8dcad4cf2949fc116c2039d274db764 Mon Sep 17 00:00:00 2001
From: jason <stedwell@gmail.com>
Date: Sun, 29 Mar 2026 00:44:31 -0500
Subject: [PATCH] add workflow docs

---
 PROJECT.md | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/PROJECT.md b/PROJECT.md
index c3de8a9..9b5533b 100644
--- a/PROJECT.md
+++ b/PROJECT.md
@@ -1,7 +1,7 @@
 # UI Stock Tracker — Project Documentation
 
 **Status:** ✅ Complete and running
-**Last updated:** 2026-03-28
+**Last updated:** 2026-03-29
 
 ---
 
@@ -141,6 +141,24 @@ Stage 3 — runtime
 
 ---
 
+## CI/CD — Gitea Actions
+
+A workflow at `.gitea/workflows/docker-build.yml` automatically builds and pushes the Docker image on every push to `main`.
+
+**What it does:**
+1. Checks out the repo
+2. Logs in to the private container registry at `registry.alwisp.com` using `gitea.REGISTRY_USER` + `secrets.REGISTRY_TOKEN`
+3. Builds and pushes `registry.alwisp.com/{owner}/{repo}:latest`
+
+**Runner:** `catthehacker/ubuntu:act-latest` (self-hosted compatible)
+
+After a push triggers the build, pull the updated image on Unraid:
+```bash
+docker pull registry.alwisp.com/{owner}/{repo}:latest
+```
+
+---
+
 ## Build & Deploy
 
 ```bash
@@ -178,6 +196,9 @@ Original design used separate `frontend` and `backend` Docker services in docker
 
 ```
 ui-tracker/
+├── .gitea/
+│   └── workflows/
+│       └── docker-build.yml  # Build + push to registry.alwisp.com on push to main
 ├── Dockerfile              # 3-stage single-container build
 ├── docker-compose.yml      # Single service, port 8080, ./data volume
 ├── nginx.conf              # Serves frontend, proxies /api/ to Node