fix: remove unnecessary env_file entries and correct OPENAI_API_KEY format

Reviewed-on: #8

.env.example

@@ -26,8 +26,12 @@ IMAP_INBOX_FOLDER=INBOX
 OPENAI_API_KEY=sk-replace-me
 OPENAI_MODEL=gpt-4o
 
+# ── Llama / Ollama (backend preview generation) ───────────────────────────────
+LLAMA_BASE_URL=http://celtinha.desktop:11434
+LLAMA_MODEL=gemma3:4b
+
 # ── Application ───────────────────────────────────────────────────────────────
 APP_RECIPIENTS=friend1@example.com,friend2@example.com
 
-# ── Frontend (Vite build-time) ────────────────────────────────────────────────
+# ── Frontend (Vite dev proxy) ─────────────────────────────────────────────────
 VITE_API_BASE_URL=http://localhost

.gitea/workflows/build.yml

@@ -0,0 +1,180 @@
+name: Build And Publish Production Image
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build:
+    name: Build And Publish Production Image
+    runs-on: ubuntu-latest
+    env:
+      REGISTRY: gitea.lab:80
+      IMAGE_NAME: sancho41/condado-newsletter
+      REGISTRY_USERNAME: ${{ secrets.REGISTRY_USERNAME }}
+      REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          github-server-url: http://gitea.lab
+
+      - name: Verify Docker CLI
+        run: docker version
+
+      - name: Log in to Docker Hub (optional)
+        if: ${{ secrets.DOCKERHUB_USERNAME != '' && secrets.DOCKERHUB_TOKEN != '' }}
+        run: echo "${{ secrets.DOCKERHUB_TOKEN }}" | docker login docker.io -u "${{ secrets.DOCKERHUB_USERNAME }}" --password-stdin
+
+      - name: Build all-in-one image
+        run: docker build -t sancho41/condado-newsletter:latest -f Dockerfile.allinone .
+        
+      - name: Deploy stack via Portainer API
+        env:
+          STACK_NAME: codado-newsletter-stack
+          PORTAINER_URL: http://portainer.lab/  
+          PORTAINER_API_KEY: ${{ secrets.PORTAINER_API_KEY }}
+          PORTAINER_ENDPOINT_ID: ${{ secrets.PORTAINER_ENDPOINT_ID }}
+        run: |
+          set -u
+          set +e
+
+          PORTAINER_BASE_URL=$(printf '%s' "${PORTAINER_URL}" | sed -E 's/[[:space:]]+$//; s#/*$##')
+
+          echo "Portainer deploy debug"
+          echo "PORTAINER_URL=${PORTAINER_URL}"
+          echo "PORTAINER_BASE_URL=${PORTAINER_BASE_URL}"
+          echo "STACK_NAME=${STACK_NAME}"
+          echo "PORTAINER_ENDPOINT_ID=${PORTAINER_ENDPOINT_ID}"
+          echo "HTTP_PROXY=${HTTP_PROXY:-<empty>}"
+          echo "HTTPS_PROXY=${HTTPS_PROXY:-<empty>}"
+          echo "NO_PROXY=${NO_PROXY:-<empty>}"
+
+          echo "Current runner network info:"
+          if command -v ip >/dev/null 2>&1; then
+            ip -4 addr show || true
+            ip route || true
+          else
+            hostname -I || true
+          fi
+
+          PORTAINER_HOST=$(printf '%s' "${PORTAINER_BASE_URL}" | sed -E 's#^[a-zA-Z]+://##; s#/.*$##; s/:.*$//')
+          echo "Resolved host target: ${PORTAINER_HOST}"
+
+          PORTAINER_IP=""
+          ACTIVE_PORTAINER_BASE_URL="${PORTAINER_BASE_URL}"
+
+          if command -v getent >/dev/null 2>&1; then
+            echo "Host lookup (getent):"
+            getent hosts "${PORTAINER_HOST}" || true
+            PORTAINER_IP=$(getent hosts "${PORTAINER_HOST}" | awk 'NR==1{print $1}')
+            if [ -n "${PORTAINER_IP}" ]; then
+              PORTAINER_IP_BASE_URL="${PORTAINER_BASE_URL/${PORTAINER_HOST}/${PORTAINER_IP}}"
+              echo "Portainer IP fallback URL: ${PORTAINER_IP_BASE_URL}"
+            fi
+          fi
+
+          STACKS_BODY=$(mktemp)
+          STACKS_ERR=$(mktemp)
+
+          STACKS_HTTP_CODE=$(curl -sS \
+            --noproxy "*" \
+            -o "${STACKS_BODY}" \
+            -w "%{http_code}" \
+            "${ACTIVE_PORTAINER_BASE_URL}/api/stacks" \
+            -H "X-API-Key: ${PORTAINER_API_KEY}" \
+            2>"${STACKS_ERR}")
+          STACKS_CURL_EXIT=$?
+
+          if [ "${STACKS_CURL_EXIT}" -eq 6 ] && [ -n "${PORTAINER_IP:-}" ]; then
+            echo "Retrying GET /api/stacks with IP fallback due to DNS failure"
+            STACKS_HTTP_CODE=$(curl -sS \
+              --noproxy "*" \
+              -o "${STACKS_BODY}" \
+              -w "%{http_code}" \
+              "${PORTAINER_IP_BASE_URL}/api/stacks" \
+              -H "X-API-Key: ${PORTAINER_API_KEY}" \
+              2>"${STACKS_ERR}")
+            STACKS_CURL_EXIT=$?
+            if [ "${STACKS_CURL_EXIT}" -eq 0 ]; then
+              ACTIVE_PORTAINER_BASE_URL="${PORTAINER_IP_BASE_URL}"
+            fi
+          fi
+
+          echo "GET /api/stacks curl exit: ${STACKS_CURL_EXIT}"
+          echo "GET /api/stacks http code: ${STACKS_HTTP_CODE}"
+          echo "GET /api/stacks stderr:"
+          cat "${STACKS_ERR}" || true
+          echo "GET /api/stacks response (sanitized):"
+          jq -r '.[] | "Id=\(.Id) Name=\(.Name) EndpointId=\(.EndpointId)"' "${STACKS_BODY}" || true
+
+          if [ "${STACKS_CURL_EXIT}" -ne 0 ]; then
+            echo "Failed to reach Portainer API while listing stacks."
+            exit "${STACKS_CURL_EXIT}"
+          fi
+
+          if [ "${STACKS_HTTP_CODE}" -lt 200 ] || [ "${STACKS_HTTP_CODE}" -ge 300 ]; then
+            echo "Portainer returned a non-success status for stack listing."
+            exit 1
+          fi
+
+          STACK_ID=$(jq -r --arg stack_name "${STACK_NAME}" '.[] | select(.Name == $stack_name) | .Id' "${STACKS_BODY}" | head -n 1)
+
+          APPLY_BODY=$(mktemp)
+          APPLY_ERR=$(mktemp)
+
+          if [ -n "${STACK_ID}" ]; then
+            echo "Existing stack found with id=${STACK_ID}; sending update request"
+
+            PAYLOAD=$(jq -n \
+              --rawfile stack_file docker-compose.prod.yml \
+              '{StackFileContent: $stack_file, Env: [], Prune: false, PullImage: false}')
+
+            APPLY_HTTP_CODE=$(curl -sS -X PUT \
+              --noproxy "*" \
+              -o "${APPLY_BODY}" \
+              -w "%{http_code}" \
+              "${ACTIVE_PORTAINER_BASE_URL}/api/stacks/${STACK_ID}?endpointId=${PORTAINER_ENDPOINT_ID}" \
+              -H "X-API-Key: ${PORTAINER_API_KEY}" \
+              -H "Content-Type: application/json" \
+              -d "${PAYLOAD}" \
+              2>"${APPLY_ERR}")
+            APPLY_CURL_EXIT=$?
+          else
+            echo "Stack not found; sending create request"
+
+            PAYLOAD=$(jq -n \
+              --arg name "${STACK_NAME}" \
+              --rawfile stack_file docker-compose.prod.yml \
+              '{Name: $name, StackFileContent: $stack_file, Env: [], FromAppTemplate: false}')
+
+            APPLY_HTTP_CODE=$(curl -sS -X POST \
+              --noproxy "*" \
+              -o "${APPLY_BODY}" \
+              -w "%{http_code}" \
+              "${ACTIVE_PORTAINER_BASE_URL}/api/stacks/create/standalone/string?endpointId=${PORTAINER_ENDPOINT_ID}" \
+              -H "X-API-Key: ${PORTAINER_API_KEY}" \
+              -H "Content-Type: application/json" \
+              -d "${PAYLOAD}" \
+              2>"${APPLY_ERR}")
+            APPLY_CURL_EXIT=$?
+          fi
+
+          echo "Apply curl exit: ${APPLY_CURL_EXIT}"
+          echo "Apply http code: ${APPLY_HTTP_CODE}"
+          echo "Apply stderr:"
+          cat "${APPLY_ERR}" || true
+          echo "Apply response body:"
+          cat "${APPLY_BODY}" || true
+
+          if [ "${APPLY_CURL_EXIT}" -ne 0 ]; then
+            echo "Failed to reach Portainer API while applying stack changes."
+            exit "${APPLY_CURL_EXIT}"
+          fi
+
+          if [ "${APPLY_HTTP_CODE}" -lt 200 ] || [ "${APPLY_HTTP_CODE}" -ge 300 ]; then
+            echo "Portainer returned a non-success status while applying stack changes."
+            exit 1
+          fi
+
+          echo "Portainer deploy step completed successfully"

.gitea/workflows/ci.yml

@@ -1,10 +1,8 @@
 name: CI
 
 on:
-  push:
-    branches: ["**"]
   pull_request:
-    branches: ["**"]
+    branches: ["develop"]
 
 jobs:
   backend-test:
@@ -15,6 +13,8 @@ jobs:
         working-directory: backend
     steps:
       - uses: actions/checkout@v4
+        with:
+          github-server-url: http://gitea.lab
 
       - name: Set up JDK 21
         uses: actions/setup-java@v4
@@ -44,6 +44,8 @@ jobs:
         working-directory: frontend
     steps:
       - uses: actions/checkout@v4
+        with:
+          github-server-url: http://gitea.lab
 
       - name: Set up Node 20
         uses: actions/setup-node@v4

.github/agents/backend.agent.md

@@ -98,3 +98,5 @@ cd backend
 - DO NOT put business logic in controllers.
 - DO NOT put prompt construction logic outside `PromptBuilderService`.
 - DO NOT modify frontend code — your scope is `backend/` only.
+- DO enforce server-side persistence for all business/domain data; frontend must not be required to persist domain data.
+- DO model generated test-message history as backend-owned task-related data with referential integrity and cleanup on task deletion.

.github/agents/frontend.agent.md

@@ -39,6 +39,8 @@ frontend/src/
 7. **Routes:** new pages go in `src/pages/`, registered in `src/router/index.tsx`, lazy-loaded.
 8. **Strings:** no hardcoded user-facing strings outside of constants.
 9. **No over-engineering:** only add what is explicitly needed — no extra abstractions, helpers, or features.
+10. **Data ownership:** domain/business data must stay server-side; frontend never persists entities, tasks, generated messages, logs, or similar domain data in `localStorage`, `sessionStorage`, or `IndexedDB`.
+11. **LLM calls:** frontend must never call OpenAI/Ollama/Llama directly; use backend APIs only.
 
 ## TDD Cycle
 
@@ -60,3 +62,4 @@ frontend/src/
 - DO NOT build custom UI primitives when a shadcn/ui component exists.
 - DO NOT write implementation code before the failing test exists.
 - DO NOT modify backend code — your scope is `frontend/` only.
+- DO NOT store business/domain data in browser storage; only the backend-issued `httpOnly` session cookie is allowed for auth state.

.github/agents/infra.agent.md

@@ -1,6 +1,6 @@
 ---
 name: infra
-description: "Use when working on Docker configuration, Docker Compose files, Dockerfiles, Nginx config, Supervisor config, GitHub Actions workflows, CI/CD pipelines, environment variables, or overall project architecture in the condado-news-letter project. Trigger phrases: docker, dockerfile, compose, nginx, ci/cd, github actions, publish image, build fails, infra, architecture, environment variables, container, supervisor, allinone image, docker hub."
+description: "Use when working on Docker configuration, Docker Compose files, Dockerfiles, Nginx config, Supervisor config, Gitea Actions workflows, CI/CD pipelines, deploy flows, environment variables, or overall project architecture in the condado-news-letter project. Trigger phrases: docker, dockerfile, compose, nginx, ci/cd, gitea actions, deploy, build fails, infra, architecture, environment variables, container, supervisor, allinone image."
 tools: [read, edit, search, execute, todo]
 argument-hint: "Describe the infrastructure change or Docker/CI task to implement."
 ---
@@ -15,14 +15,14 @@ You are a senior DevOps / infrastructure engineer and software architect for the
 | `backend/Dockerfile` | Backend-only multi-stage build image |
 | `frontend/Dockerfile` | Frontend build + Nginx image |
 | `docker-compose.yml` | Dev stack (postgres + backend + nginx + mailhog) |
-| `docker-compose.prod.yml` | Prod stack (postgres + backend + nginx, no mailhog) |
+| `docker-compose.prod.yml` | Prod stack (single all-in-one image) |
 | `nginx/nginx.conf` | Nginx config for multi-container compose flavours |
 | `nginx/nginx.allinone.conf` | Nginx config for the all-in-one image (localhost backend) |
 | `frontend/nginx.docker.conf` | Nginx config embedded in frontend image |
 | `docker/supervisord.conf` | Supervisor config (manages postgres + java + nginx inside allinone) |
 | `docker/entrypoint.sh` | Allinone container entrypoint (DB init, env wiring, supervisord start) |
-| `.github/workflows/ci.yml` | CI: backend tests + frontend tests on every push/PR |
-| `.github/workflows/publish.yml` | CD: build & push allinone image to Docker Hub on `main` merge |
+| `.gitea/workflows/ci.yml` | CI: backend tests + frontend tests on pull requests to `develop` |
+| `.gitea/workflows/build.yml` | Build: create and publish the all-in-one image on approved PRs to `main` |
 | `.env.example` | Template for all environment variables |
 
 ## System Topology
@@ -54,7 +54,7 @@ Docker volume → /var/lib/postgresql/data
 | Flavour | Command | Notes |
 |---|---|---|
 | Dev | `docker compose up --build` | Includes Mailhog on :1025/:8025 |
-| Prod (compose) | `docker compose -f docker-compose.prod.yml up --build` | External DB/SMTP |
+| Prod (compose) | `docker compose -f docker-compose.prod.yml up -d` | Prebuilt all-in-one image with internal PostgreSQL |
 | All-in-one | `docker run -p 80:80 -e APP_PASSWORD=... <image>` | Everything in one container |
 
 ## Key Environment Variables
@@ -74,20 +74,16 @@ All injected at runtime — never hardcoded in images.
 | `IMAP_HOST` / `IMAP_PORT` / `IMAP_INBOX_FOLDER` | Backend | IMAP server |
 | `OPENAI_API_KEY` / `OPENAI_MODEL` | Backend | OpenAI credentials |
 | `APP_RECIPIENTS` | Backend | Comma-separated recipient emails |
-| `VITE_API_BASE_URL` | Frontend (build-time ARG) | Backend API base URL |
+| `VITE_API_BASE_URL` | Frontend dev server | Backend API base URL for Vite proxy |
 
 ## CI/CD Pipeline
 
 | Workflow | Trigger | What it does |
 |---|---|---|
-| `ci.yml` | Push / PR to any branch | Backend `./gradlew test` + Frontend `npm run test` |
-| `publish.yml` | Push to `main` | Builds `Dockerfile.allinone`, pushes `latest` + `<sha>` tags to Docker Hub |
+| `ci.yml` | Pull request to `develop` | Backend `./gradlew test` + Frontend `npm run test` |
+| `build.yml` | Approved PR review to `main` | Builds `condado-newsletter` on the target Docker host, then pushes `latest` and `${github.sha}` tags to Gitea container registry |
 
-**Required GitHub Secrets:** `DOCKERHUB_USERNAME`, `DOCKERHUB_TOKEN`
-
-**Image tags on main merge:**
-- `<user>/condado-newsletter:latest`
-- `<user>/condado-newsletter:<git-sha>`
+The runner shares the target Docker host, so this workflow builds the image locally, tags it for `gitea.lab/sancho41/condado-newsletter`, and pushes it to Gitea container registry. `docker-compose.prod.yml` must reference that published image and not local build directives.
 
 ## Implementation Rules
 

.github/agents/orchestrator.agent.md

@@ -8,6 +8,8 @@ argument-hint: "Describe the feature, bug, or change to deliver end-to-end."
 
 You are the **delivery orchestrator** for the **Condado Abaixo da Média SA** project. You own the full lifecycle of a work item — from the moment the user describes what they want, to a merged-ready pull request with the version bumped. You never implement code yourself; you coordinate specialist agents and run git/shell commands.
 
+Git hosting is Gitea at `http://gitea.lab/sancho41/condado-newsletter.git`, and workflow follows strict Git Flow.
+
 ## Pipeline Overview
 
 ```
@@ -41,10 +43,10 @@ Announce the label before proceeding: **"Classified as: `<label>`"**
 ## Step 2 — Create Branch
 
 1. Verify the working tree is clean: `git status --short`. If dirty, stop and warn the user.
-2. Ensure you are on `main` and it is up to date: `git checkout main && git pull`.
+2. Ensure `main` and `develop` are up to date: `git checkout main && git pull && git checkout develop && git pull`.
 3. Create and checkout the branch:
    ```bash
-   git checkout -b <prefix>/<kebab-case-short-description>
+   git checkout -b <prefix>/<kebab-case-short-description> develop
    ```
    Branch name must be lowercase, kebab-case, max 50 chars.
 4. Announce the branch name.
@@ -118,11 +120,12 @@ Read the new version from `frontend/package.json` after bumping.
    git push -u origin <branch-name>
    ```
 
-2. Open a pull request using the GitHub CLI:
+2. Open a pull request targeting `develop`.
+    If `tea` (Gitea CLI) is available, use:
    ```bash
-   gh pr create \
-     --title "<conventional-commit-type>(<scope>): <short description>" \
-     --body "$(cat <<'EOF'
+    tea pr create \
+       --title "<conventional-commit-type>(<scope>): <short description>" \
+       --description "$(cat <<'EOF'
    ## Summary
    <1-3 sentences describing what was done and why>
 
@@ -141,9 +144,10 @@ Read the new version from `frontend/package.json` after bumping.
    - Build green: `./gradlew build` + `npm run build`
    EOF
    )" \
-     --base main \
-     --head <branch-name>
+       --base develop \
+       --head <branch-name>
    ```
+    If `tea` is unavailable, provide the exact PR title/body and instruct opening a PR in the Gitea web UI with base `develop`.
 
 3. Announce the PR URL.
 
@@ -152,13 +156,15 @@ Read the new version from `frontend/package.json` after bumping.
 ## Constraints
 
 - DO NOT implement any code yourself — delegate everything to specialist agents.
-- DO NOT commit directly to `main`.
+- DO NOT commit directly to `main` or `develop`.
 - DO NOT use `--force`, `--no-verify`, or `git reset --hard`.
 - DO NOT proceed to the next step if the current step's tests are not green.
 - DO NOT bump the version before all implementation commits are done.
 - ALWAYS verify `git status` is clean before creating the branch.
-- ALWAYS use `gh pr create` (GitHub CLI) for pull requests — never instruct the user to open one manually unless `gh` is unavailable.
-- If `gh` is not installed, clearly tell the user and provide the exact PR title and body to paste into the GitHub UI.
+- ALWAYS target `develop` for regular feature/fix/chore PRs.
+- Use Gitea flow for PR creation (`tea` if available, otherwise web UI instructions with exact PR metadata).
+- ALWAYS enforce backend ownership of business/domain data; do not accept frontend browser storage solutions for domain persistence.
+- ALWAYS enforce backend-mediated LLM calls; frontend must never call LLM providers directly.
 
 ---
 

.github/agents/planner.agent.md

@@ -14,7 +14,7 @@ Full-stack monorepo:
 - **Frontend:** React 18 + Vite + TypeScript + shadcn/ui + TanStack Query v5 + Axios + React Router v6
 - **Auth:** Single admin, password via `APP_PASSWORD` env var, JWT in `httpOnly` cookie
 - **Infra:** Docker Compose (dev + prod) + all-in-one Dockerfile, Nginx reverse proxy
-- **CI/CD:** GitHub Actions — tests on every PR, Docker Hub publish on `main` merge
+- **CI/CD:** Gitea Actions — tests on pull requests to `develop`
 
 ## Your Workflow
 
@@ -52,6 +52,8 @@ For each step output:
 - DO reference specific existing files by path when relevant (e.g., `backend/src/main/kotlin/.../EntityService.kt`).
 - ALWAYS check the existing codebase before planning — never assume something doesn't exist.
 - ALWAYS respect the architecture: business logic in services, thin controllers, API layer in `src/api/`, React Query for server state.
+- ALWAYS enforce backend-first data ownership in plans: domain/business data persistence belongs to backend/database, not browser storage.
+- NEVER plan frontend direct LLM calls; all LLM interactions must be backend-mediated endpoints.
 
 ## Delegation Hint
 

.github/workflows/bump-version.yml

@@ -1,60 +0,0 @@
-name: Bump Frontend Version
-
-on:
-  workflow_dispatch:
-    inputs:
-      bump:
-        description: Version bump type
-        required: true
-        default: patch
-        type: choice
-        options:
-          - patch
-          - minor
-          - major
-
-permissions:
-  contents: write
-
-jobs:
-  bump-version:
-    name: Bump frontend package version
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Set up Node 20
-        uses: actions/setup-node@v4
-        with:
-          node-version: "20"
-
-      - name: Bump frontend version
-        working-directory: frontend
-        run: npm version ${{ inputs.bump }} --no-git-tag-version
-
-      - name: Commit and push version update
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
-          git add frontend/package.json
-          if [ -f frontend/package-lock.json ]; then
-            git add frontend/package-lock.json
-          fi
-          if git diff --cached --quiet; then
-            echo "No version changes to commit"
-            exit 0
-          fi
-          NEW_VERSION=$(node -p "require('./frontend/package.json').version")
-          TAG_NAME="frontend-v${NEW_VERSION}"
-          git commit -m "chore(frontend): bump version to ${NEW_VERSION}"
-          if git rev-parse "${TAG_NAME}" >/dev/null 2>&1; then
-            echo "Tag ${TAG_NAME} already exists"
-            exit 1
-          fi
-          git tag -a "${TAG_NAME}" -m "Frontend ${NEW_VERSION}"
-          git push
-          git push origin "${TAG_NAME}"

.github/workflows/publish.yml

@@ -1,36 +0,0 @@
-name: Publish to Docker Hub
-
-on:
-  push:
-    branches:
-      - main
-
-jobs:
-  build-and-push:
-    name: Build & Push All-in-one Image
-    runs-on: ubuntu-latest
-    environment:
-      name: production
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
-
-      - name: Log in to Docker Hub
-        uses: docker/login-action@v3
-        with:
-          username: ${{ secrets.DOCKERHUB_USERNAME }}
-          password: ${{ secrets.DOCKERHUB_TOKEN }}
-
-      - name: Build and push
-        uses: docker/build-push-action@v5
-        with:
-          context: .
-          file: Dockerfile.allinone
-          push: true
-          tags: |
-            ${{ secrets.DOCKERHUB_USERNAME }}/condado-newsletter:latest
-            ${{ secrets.DOCKERHUB_USERNAME }}/condado-newsletter:${{ github.sha }}
-          cache-from: type=gha
-          cache-to: type=gha,mode=max

CLAUDE.md

@@ -83,8 +83,8 @@ The cycle for every step is:
 | Reverse Proxy     | Nginx (serves frontend + proxies `/api` to backend)          |
 | Dev Mail          | Mailhog (SMTP trap + web UI)                                 |
 | All-in-one image  | Single Docker image: Nginx + Spring Boot + PostgreSQL + Supervisor |
-| Image registry    | Docker Hub (`<dockerhub-user>/condado-newsletter`)           |
-| CI/CD             | GitHub Actions — build, test, push to Docker Hub on merge to `main` |
+| Image registry    | Gitea container registry (`gitea.lab/sancho41/condado-newsletter`) |
+| CI/CD             | Gitea Actions — test PRs to `develop`, build and publish the production image on approved PRs targeting `main` |
 
 ## Deployment Flavours
 
@@ -93,7 +93,7 @@ There are **three ways to run the project**:
 | Flavour             | Command                         | When to use                                    |
 |---------------------|---------------------------------|------------------------------------------------|
 | **Dev**             | `docker compose up`             | Local development — includes Mailhog           |
-| **Prod (compose)**  | `docker compose -f docker-compose.prod.yml up` | Production with external DB/SMTP |
+| **Prod (compose)**  | `docker compose -f docker-compose.prod.yml up -d` | Production with the prebuilt all-in-one image |
 | **All-in-one**      | `docker run ...`                | Simplest deploy — everything in one container  |
 
 ### All-in-one Image
@@ -104,7 +104,7 @@ The all-in-one image (`Dockerfile.allinone`) bundles **everything** into a singl
 - **PostgreSQL** — embedded database
 - **Supervisor** — process manager that starts and supervises all three processes
 
-This image is published to Docker Hub at `<dockerhub-user>/condado-newsletter:latest`.
+The all-in-one image is built on the runner host and then published to the Gitea container registry.
 
 **Minimal `docker run` command:**
 ```bash
@@ -121,7 +121,7 @@ docker run -d \
   -e IMAP_PORT=993 \
   -e APP_RECIPIENTS=friend1@example.com,friend2@example.com \
   -v condado-data:/var/lib/postgresql/data \
-  <dockerhub-user>/condado-newsletter:latest
+  gitea.lab/sancho41/condado-newsletter:latest
 ```
 
 The app is then available at `http://localhost`.
@@ -213,13 +213,15 @@ condado-news-letter/               ← repo root
 ├── .env.example                   ← template for all env vars
 ├── .gitignore
 ├── docker-compose.yml             ← dev stack (Nginx + Backend + PostgreSQL + Mailhog)
-├── docker-compose.prod.yml        ← prod stack (Nginx + Backend + PostgreSQL)
+├── docker-compose.prod.yml        ← prod stack (single all-in-one image)
 ├── Dockerfile.allinone            ← all-in-one image (Nginx + Backend + PostgreSQL + Supervisor)
 │
 ├── .github/
 │   └── workflows/
-│       ├── ci.yml                 ← run tests on every PR
-│       └── publish.yml            ← build & push all-in-one image to Docker Hub on main merge
+│       └── (legacy, unused after Gitea migration)
+├── .gitea/
+│   └── workflows/
+│       └── ci.yml                 ← run tests on pull requests targeting `develop`
 │
 ├── backend/                       ← Spring Boot (Kotlin + Gradle)
 │   ├── build.gradle.kts
@@ -310,7 +312,7 @@ npm run test
 docker compose up --build
 
 # Prod
-docker compose -f docker-compose.prod.yml up --build
+docker compose -f docker-compose.prod.yml up -d
 
 # Stop
 docker compose down
@@ -363,6 +365,19 @@ docker compose down
 
 ---
 
+## Data Ownership Policy (Critical)
+
+- **All business data must be persisted server-side** (PostgreSQL via backend APIs).
+- The frontend must treat the backend as the single source of truth for entities, tasks,
+  generated preview messages/history, logs, and any other domain data.
+- The frontend must **not** persist business/domain data in browser storage (`localStorage`,
+  `sessionStorage`, `IndexedDB`) or call LLM providers directly.
+- The only browser-stored auth state is the backend-issued session token cookie (`httpOnly` JWT).
+- If a required endpoint does not exist yet, implement it in the backend first; do not add
+  frontend-side persistence workarounds.
+
+---
+
 ## Naming Conventions
 
 ### Backend
@@ -441,7 +456,7 @@ Never hardcode any of these values.
 | `OPENAI_API_KEY`             | Backend  | OpenAI API key                                       |
 | `OPENAI_MODEL`               | Backend  | OpenAI model (default: `gpt-4o`)                     |
 | `APP_RECIPIENTS`             | Backend  | Comma-separated list of recipient emails             |
-| `VITE_API_BASE_URL`          | Frontend | Backend API base URL (used by Vite at build time)    |
+| `VITE_API_BASE_URL`          | Frontend | Backend API base URL for the Vite dev server proxy   |
 
 > ⚠️ Never hardcode credentials. Always use environment variables or a `.env` file (gitignored).
 
@@ -509,13 +524,17 @@ BODY:
 
 ## Git Workflow & CI/CD
 
-- Branch naming: `feature/<short-description>`, `fix/<short-description>`, `chore/<short-description>`
+- Git hosting: Gitea instance at `http://gitea.lab`.
+- Canonical remote: `origin = http://gitea.lab/sancho41/condado-newsletter.git`.
+- Branch model: **Git Flow** (`main` + `develop` as permanent branches).
+- Branch naming: `feature/<short-description>`, `fix/<short-description>`, `hotfix/<short-description>`, `release/<short-description>`, `chore/<short-description>`
 - Commit messages follow [Conventional Commits](https://www.conventionalcommits.org/): `feat:`, `fix:`, `chore:`, `docs:`, `test:`
 - Scope your commits: `feat(backend):`, `feat(frontend):`, `chore(docker):`
 - **TDD commit order per step:** first `test(<scope>): add failing tests for <step>`, then
   `feat(<scope>): implement <step> — all tests passing`.
-- PRs require all CI checks to pass before merging.
-- Never commit directly to `main`.
+- Pull requests must target `develop` for regular work.
+- CI runs on pull requests to `develop` and must pass before merge.
+- Never commit directly to `main` or `develop`.
 
 ### Commit Rules (enforced by AI)
 
@@ -551,23 +570,14 @@ Good examples:
 - `feat(frontend): implement step 2 - per-entity scheduled task creation`
 - `docs(config): clarify english-first language policy and commit quality rules`
 
-### GitHub Actions Workflows
+### Gitea Actions Workflows
 
 | Workflow file              | Trigger                    | What it does                                              |
 |----------------------------|----------------------------|-----------------------------------------------------------|
-| `.github/workflows/ci.yml` | Push / PR to any branch    | Backend tests (`./gradlew test`) + Frontend tests (`npm run test`) |
-| `.github/workflows/publish.yml` | Push to `main`        | Builds `Dockerfile.allinone`, tags as `latest` + git SHA, pushes to Docker Hub |
+| `.gitea/workflows/ci.yml`  | PR to `develop`            | Backend tests (`./gradlew test`) + Frontend tests (`npm run test`) |
+| `.gitea/workflows/build.yml` | Approved PR review on `main` | Build `condado-newsletter`, then publish `latest` and `${github.sha}` tags to Gitea container registry |
 
-**Required GitHub Secrets:**
-
-| Secret                | Description                                |
-|-----------------------|--------------------------------------------|
-| `DOCKERHUB_USERNAME`  | Docker Hub account username                |
-| `DOCKERHUB_TOKEN`     | Docker Hub access token (not password)     |
-
-**Image tags pushed on every `main` merge:**
-- `<dockerhub-user>/condado-newsletter:latest`
-- `<dockerhub-user>/condado-newsletter:<git-sha>` (for pinning)
+Build policy: the runner shares the target Docker host, so the build workflow produces the image locally, tags it for `gitea.lab/sancho41/condado-newsletter`, and pushes it to Gitea container registry. `docker-compose.prod.yml` references that published image.
 
 ---
 

Dockerfile.allinone

@@ -15,6 +15,7 @@ FROM gradle:8-jdk21-alpine AS backend-build
 WORKDIR /app/backend
 
 COPY backend/build.gradle.kts backend/settings.gradle.kts ./
+COPY backend/gradle.properties ./
 COPY backend/gradle ./gradle
 RUN gradle dependencies --no-daemon --quiet || true
 
@@ -28,14 +29,10 @@ ENV DEBIAN_FRONTEND=noninteractive
 
 RUN apt-get update && apt-get install -y \
     nginx \
-    postgresql \
     supervisor \
     openjdk-21-jre-headless \
     && rm -rf /var/lib/apt/lists/*
 
-# PostgreSQL data directory
-RUN mkdir -p /var/lib/postgresql/data && chown -R postgres:postgres /var/lib/postgresql
-
 # Copy frontend static files
 COPY --from=frontend-build /app/frontend/dist /usr/share/nginx/html
 

backend/src/main/kotlin/com/condado/newsletter/dto/EntityTaskDtos.kt

@@ -9,7 +9,7 @@ import java.util.UUID
 data class EntityTaskCreateDto(
     @field:NotNull val entityId: UUID,
     @field:NotBlank val name: String,
-    @field:NotBlank val prompt: String,
+    val prompt: String,
     @field:NotBlank val scheduleCron: String,
     @field:NotBlank val emailLookback: String
 )

backend/src/main/kotlin/com/condado/newsletter/service/EntityService.kt

@@ -21,7 +21,7 @@ class EntityService(
 
     /** Returns all virtual entities. */
     fun findAll(): List<VirtualEntityResponseDto> =
-        virtualEntityRepository.findAll().map { VirtualEntityResponseDto.from(it) }
+        virtualEntityRepository.findAllByActiveTrue().map { VirtualEntityResponseDto.from(it) }
 
     /** Returns one entity by ID, or null if not found. */
     fun findById(id: UUID): VirtualEntityResponseDto? =

backend/src/main/kotlin/com/condado/newsletter/service/JwtService.kt

@@ -14,8 +14,10 @@ import java.util.Date
 @Service
 class JwtService(
     @Value("\${app.jwt.secret}") val secret: String,
-    @Value("\${app.jwt.expiration-ms}") val expirationMs: Long
+    @Value("\${app.jwt.expiration-ms:86400000}") expirationMsRaw: String
 ) {
+    private val expirationMs: Long = expirationMsRaw.toLongOrNull() ?: 86400000L
+
     private val signingKey by lazy {
         Keys.hmacShaKeyFor(secret.toByteArray(Charsets.UTF_8))
     }

backend/src/main/kotlin/com/condado/newsletter/service/LlamaPreviewService.kt

@@ -10,8 +10,8 @@ import org.springframework.web.client.RestClient
 @Service
 class LlamaPreviewService(
     private val restClient: RestClient,
-    @Value("\${llama.base-url:http://localhost:11434}") private val baseUrl: String,
-    @Value("\${llama.model:gemma3:4b}") private val model: String
+    @Value("\${llama.base-url}") private val baseUrl: String,
+    @Value("\${llama.model}") private val model: String
 ) {
 
     /**

backend/src/main/resources/application.yml

@@ -10,7 +10,7 @@ spring:
 
   jpa:
     hibernate:
-      ddl-auto: validate
+      ddl-auto: ${SPRING_JPA_HIBERNATE_DDL_AUTO:validate}
     show-sql: false
     properties:
       hibernate:
@@ -49,8 +49,8 @@ openai:
   model: ${OPENAI_MODEL:gpt-4o}
 
 llama:
-  base-url: ${LLAMA_BASE_URL:http://localhost:11434}
-  model: ${LLAMA_MODEL:gemma3:4b}
+  base-url: ${LLAMA_BASE_URL}
+  model: ${LLAMA_MODEL}
 
 springdoc:
   swagger-ui:

backend/src/test/kotlin/com/condado/newsletter/controller/EntityTaskControllerTest.kt

@@ -0,0 +1,74 @@
+package com.condado.newsletter.controller
+
+import com.condado.newsletter.model.VirtualEntity
+import com.condado.newsletter.repository.EntityTaskRepository
+import com.condado.newsletter.repository.GeneratedMessageHistoryRepository
+import com.condado.newsletter.repository.VirtualEntityRepository
+import com.condado.newsletter.scheduler.EntityScheduler
+import com.condado.newsletter.service.JwtService
+import com.ninjasquad.springmockk.MockkBean
+import jakarta.servlet.http.Cookie
+import org.junit.jupiter.api.AfterEach
+import org.junit.jupiter.api.Test
+import org.springframework.beans.factory.annotation.Autowired
+import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc
+import org.springframework.boot.test.context.SpringBootTest
+import org.springframework.http.MediaType
+import org.springframework.test.web.servlet.MockMvc
+import org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post
+import org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath
+import org.springframework.test.web.servlet.result.MockMvcResultMatchers.status
+
+@SpringBootTest
+@AutoConfigureMockMvc
+class EntityTaskControllerTest {
+
+    @Autowired lateinit var mockMvc: MockMvc
+    @Autowired lateinit var jwtService: JwtService
+    @Autowired lateinit var virtualEntityRepository: VirtualEntityRepository
+    @Autowired lateinit var entityTaskRepository: EntityTaskRepository
+    @Autowired lateinit var generatedMessageHistoryRepository: GeneratedMessageHistoryRepository
+
+    @MockkBean lateinit var entityScheduler: EntityScheduler
+
+    private fun authCookie() = Cookie("jwt", jwtService.generateToken())
+
+    @AfterEach
+    fun cleanUp() {
+        generatedMessageHistoryRepository.deleteAll()
+        entityTaskRepository.deleteAll()
+        virtualEntityRepository.deleteAll()
+    }
+
+    @Test
+    fun should_createTask_when_promptIsBlankInCreateRequest() {
+        val entity = virtualEntityRepository.save(
+            VirtualEntity(
+                name = "Entity A",
+                email = "entity-a@condado.com",
+                jobTitle = "Ops"
+            )
+        )
+
+        val payload = """
+            {
+              "entityId": "${entity.id}",
+              "name": "Morning Blast",
+              "prompt": "",
+              "scheduleCron": "0 8 * * 1-5",
+              "emailLookback": "last_week"
+            }
+        """.trimIndent()
+
+        mockMvc.perform(
+            post("/api/v1/tasks")
+                .cookie(authCookie())
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(payload)
+        )
+            .andExpect(status().isCreated)
+            .andExpect(jsonPath("$.entityId").value(entity.id.toString()))
+            .andExpect(jsonPath("$.name").value("Morning Blast"))
+            .andExpect(jsonPath("$.prompt").value(""))
+    }
+}

backend/src/test/kotlin/com/condado/newsletter/controller/TaskGeneratedMessageControllerTest.kt

@@ -138,4 +138,32 @@ class TaskGeneratedMessageControllerTest {
             .andExpect(jsonPath("$").isArray)
             .andExpect(jsonPath("$.length()").value(0))
     }
+
+    @Test
+    fun should_deleteOnlySelectedHistoryItem_when_multipleMessagesExist() {
+        val task = createTask()
+        val firstMessage = generatedMessageHistoryRepository.save(
+            GeneratedMessageHistory(
+                task = task,
+                label = "Message #1",
+                content = "SUBJECT: First\nBODY:\nHello"
+            )
+        )
+        val secondMessage = generatedMessageHistoryRepository.save(
+            GeneratedMessageHistory(
+                task = task,
+                label = "Message #2",
+                content = "SUBJECT: Second\nBODY:\nHi"
+            )
+        )
+
+        mockMvc.perform(delete("/api/v1/tasks/${task.id}/generated-messages/${firstMessage.id}").cookie(authCookie()))
+            .andExpect(status().isNoContent)
+
+        mockMvc.perform(get("/api/v1/tasks/${task.id}/generated-messages").cookie(authCookie()))
+            .andExpect(status().isOk)
+            .andExpect(jsonPath("$.length()").value(1))
+            .andExpect(jsonPath("$[0].id").value(secondMessage.id.toString()))
+            .andExpect(jsonPath("$[0].label").value("Message #2"))
+    }
 }

backend/src/test/kotlin/com/condado/newsletter/controller/VirtualEntityControllerTest.kt

@@ -62,6 +62,17 @@ class VirtualEntityControllerTest {
             .andExpect(status().isOk).andExpect(jsonPath("$").isArray).andExpect(jsonPath("$[0].name").value("Test Entity"))
     }
 
+    @Test
+    fun should_returnOnlyActiveEntities_when_getAllEntities() {
+        virtualEntityRepository.save(VirtualEntity(name = "Active Entity", email = "active@condado.com", jobTitle = "Tester", active = true))
+        virtualEntityRepository.save(VirtualEntity(name = "Inactive Entity", email = "inactive@condado.com", jobTitle = "Tester", active = false))
+
+        mockMvc.perform(get("/api/v1/virtual-entities").cookie(authCookie()))
+            .andExpect(status().isOk)
+            .andExpect(jsonPath("$.length()").value(1))
+            .andExpect(jsonPath("$[0].name").value("Active Entity"))
+    }
+
     @Test
     fun should_return200AndEntity_when_getById() {
         val entity = virtualEntityRepository.save(VirtualEntity(name = "Test Entity", email = "entity@condado.com", jobTitle = "Test Job"))

backend/src/test/kotlin/com/condado/newsletter/service/AuthServiceTest.kt

@@ -40,7 +40,7 @@ class AuthServiceTest {
     fun should_returnValidClaims_when_jwtTokenParsed() {
         val realJwtService = JwtService(
             secret = "test-secret-key-for-testing-only-must-be-at-least-32-characters",
-            expirationMs = 86400000L
+            expirationMsRaw = "86400000"
         )
         val token = realJwtService.generateToken()
 
@@ -51,7 +51,7 @@ class AuthServiceTest {
     fun should_returnFalse_when_expiredTokenValidated() {
         val realJwtService = JwtService(
             secret = "test-secret-key-for-testing-only-must-be-at-least-32-characters",
-            expirationMs = 1L
+            expirationMsRaw = "1"
         )
         val token = realJwtService.generateToken()
 

backend/src/test/kotlin/com/condado/newsletter/service/JwtServiceTest.kt

@@ -0,0 +1,26 @@
+package com.condado.newsletter.service
+
+import io.jsonwebtoken.Jwts
+import io.jsonwebtoken.security.Keys
+import org.junit.jupiter.api.Assertions.assertTrue
+import org.junit.jupiter.api.Test
+
+class JwtServiceTest {
+
+    private val secret = "12345678901234567890123456789012"
+
+    @Test
+    fun should_generate_token_when_expiration_is_empty() {
+        val jwtService = JwtService(secret, "")
+
+        val token = jwtService.generateToken()
+
+        val claims = Jwts.parser()
+            .verifyWith(Keys.hmacShaKeyFor(secret.toByteArray(Charsets.UTF_8)))
+            .build()
+            .parseSignedClaims(token)
+            .payload
+
+        assertTrue(claims.expiration.after(claims.issuedAt))
+    }
+}

backend/src/test/kotlin/com/condado/newsletter/service/LlamaConfigurationBindingTest.kt

@@ -0,0 +1,30 @@
+package com.condado.newsletter.service
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+import org.springframework.beans.factory.annotation.Value
+import java.nio.file.Files
+import java.nio.file.Path
+
+class LlamaConfigurationBindingTest {
+
+    @Test
+    fun should_bindLlamaBaseUrlAndModelWithoutFallback_when_readingServiceValueAnnotations() {
+        val constructor = LlamaPreviewService::class.java.declaredConstructors.single()
+        val baseUrlExpression = constructor.parameters[1].getAnnotation(Value::class.java).value
+        val modelExpression = constructor.parameters[2].getAnnotation(Value::class.java).value
+
+        assertThat(baseUrlExpression).isEqualTo("\${llama.base-url}")
+        assertThat(modelExpression).isEqualTo("\${llama.model}")
+    }
+
+    @Test
+    fun should_referenceEnvironmentPlaceholdersWithoutFallback_when_readingApplicationYaml() {
+        val yaml = Files.readString(Path.of("src/main/resources/application.yml"))
+
+        assertThat(yaml).contains("base-url: \${LLAMA_BASE_URL}")
+        assertThat(yaml).contains("model: \${LLAMA_MODEL}")
+        assertThat(yaml).doesNotContain("LLAMA_BASE_URL:http://localhost:11434")
+        assertThat(yaml).doesNotContain("LLAMA_MODEL:gemma3:4b")
+    }
+}

backend/src/test/resources/application.yml

@@ -38,3 +38,7 @@ imap:
 openai:
   api-key: test-api-key
   model: gpt-4o
+
+llama:
+  base-url: http://localhost:11434
+  model: gemma3:4b

docker-compose.prod.yml

@@ -1,40 +1,41 @@
 services:
-
-  # ── PostgreSQL ───────────────────────────────────────────────────────────────
-  postgres:
-    image: postgres:16-alpine
-    restart: always
+  condado-newsletter-postgres:
+    image: postgres:16
+    container_name: condado-newsletter-postgres
+    restart: unless-stopped
     environment:
-      POSTGRES_DB: condado
-      POSTGRES_USER: ${SPRING_DATASOURCE_USERNAME}
-      POSTGRES_PASSWORD: ${SPRING_DATASOURCE_PASSWORD}
+      POSTGRES_DB: ${APP_DB_NAME:-condado}
+      POSTGRES_USER: ${POSTGRES_USER:-condado}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-condado}
     volumes:
       - postgres-data:/var/lib/postgresql/data
     networks:
-      - condado-net
+      - default
     healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U ${SPRING_DATASOURCE_USERNAME} -d condado"]
+      test: ["CMD-SHELL", "pg_isready -h localhost -U $${POSTGRES_USER:-postgres}"]
       interval: 10s
       timeout: 5s
-      retries: 5
+      retries: 10
+      start_period: 10s
 
-  # ── Backend (Spring Boot) ────────────────────────────────────────────────────
-  backend:
-    build:
-      context: ./backend
-      dockerfile: Dockerfile
-    restart: always
+  condado-newsletter:
+    image: sancho41/condado-newsletter:latest
+    container_name: condado-newsletter
+    restart: unless-stopped
     depends_on:
-      postgres:
+      condado-newsletter-postgres:
         condition: service_healthy
+    networks:
+      - external
+      - default
     environment:
       SPRING_PROFILES_ACTIVE: prod
-      SPRING_DATASOURCE_URL: ${SPRING_DATASOURCE_URL}
-      SPRING_DATASOURCE_USERNAME: ${SPRING_DATASOURCE_USERNAME}
-      SPRING_DATASOURCE_PASSWORD: ${SPRING_DATASOURCE_PASSWORD}
-      APP_PASSWORD: ${APP_PASSWORD}
+      SPRING_JPA_HIBERNATE_DDL_AUTO: ${SPRING_JPA_HIBERNATE_DDL_AUTO:-update}
+      SPRING_DATASOURCE_URL: jdbc:postgresql://condado-newsletter-postgres:5432/${APP_DB_NAME:-condado}
+      SPRING_DATASOURCE_USERNAME: ${SPRING_DATASOURCE_USERNAME:-condado}
+      SPRING_DATASOURCE_PASSWORD: ${SPRING_DATASOURCE_PASSWORD:-condado}
       JWT_SECRET: ${JWT_SECRET}
-      JWT_EXPIRATION_MS: ${JWT_EXPIRATION_MS}
+      JWT_EXPIRATION_MS: ${JWT_EXPIRATION_MS:-86400000}
       MAIL_HOST: ${MAIL_HOST}
       MAIL_PORT: ${MAIL_PORT}
       MAIL_USERNAME: ${MAIL_USERNAME}
@@ -44,28 +45,30 @@ services:
       IMAP_INBOX_FOLDER: ${IMAP_INBOX_FOLDER}
       OPENAI_API_KEY: ${OPENAI_API_KEY}
       OPENAI_MODEL: ${OPENAI_MODEL}
+      LLAMA_BASE_URL: ${LLAMA_BASE_URL}
+      LLAMA_MODEL: ${LLAMA_MODEL}
       APP_RECIPIENTS: ${APP_RECIPIENTS}
-    networks:
-      - condado-net
-
-  # ── Frontend + Nginx ─────────────────────────────────────────────────────────
-  nginx:
-    build:
-      context: ./frontend
-      dockerfile: Dockerfile
-      args:
-        VITE_API_BASE_URL: ${VITE_API_BASE_URL}
-    restart: always
-    ports:
-      - "80:80"
-    depends_on:
-      - backend
-    networks:
-      - condado-net
+    extra_hosts:
+      - "celtinha.desktop:host-gateway"
+      - "host.docker.internal:host-gateway"
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.condado.rule=Host(`condado-newsletter.lab`)"
+      - "traefik.http.services.condado.loadbalancer.server.port=80"
+      - "traefik.docker.network=traefik"
+      - "homepage.group=Hyperlink"
+      - "homepage.name=Condado Newsletter"
+      - "homepage.description=Automated newsletter generator using AI"
+      - "homepage.logo=claude-dark.png"
+      - "homepage.href=http://condado-newsletter.lab"
 
 volumes:
   postgres-data:
 
 networks:
-  condado-net:
+  default:
     driver: bridge
+  
+  external:
+    name: traefik
+    external: true

docker-compose.yml

@@ -4,14 +4,13 @@ services:
   postgres:
     image: postgres:16-alpine
     restart: unless-stopped
+    container_name: condado-newsletter-postgres
     environment:
       POSTGRES_DB: condado
       POSTGRES_USER: ${SPRING_DATASOURCE_USERNAME}
       POSTGRES_PASSWORD: ${SPRING_DATASOURCE_PASSWORD}
     volumes:
       - postgres-data:/var/lib/postgresql/data
-    networks:
-      - condado-net
     healthcheck:
       test: ["CMD-SHELL", "pg_isready -U ${SPRING_DATASOURCE_USERNAME} -d condado"]
       interval: 10s
@@ -20,6 +19,7 @@ services:
 
   # ── Backend (Spring Boot) ────────────────────────────────────────────────────
   backend:
+    container_name: condado-newsletter-backend
     build:
       context: ./backend
       dockerfile: Dockerfile
@@ -29,7 +29,7 @@ services:
         condition: service_healthy
     environment:
       SPRING_PROFILES_ACTIVE: dev
-      SPRING_DATASOURCE_URL: ${SPRING_DATASOURCE_URL}
+      SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/condado
       SPRING_DATASOURCE_USERNAME: ${SPRING_DATASOURCE_USERNAME}
       SPRING_DATASOURCE_PASSWORD: ${SPRING_DATASOURCE_PASSWORD}
       APP_PASSWORD: ${APP_PASSWORD}
@@ -44,37 +44,48 @@ services:
       IMAP_INBOX_FOLDER: ${IMAP_INBOX_FOLDER}
       OPENAI_API_KEY: ${OPENAI_API_KEY}
       OPENAI_MODEL: ${OPENAI_MODEL}
+      LLAMA_BASE_URL: ${LLAMA_BASE_URL}
+      LLAMA_MODEL: ${LLAMA_MODEL}
       APP_RECIPIENTS: ${APP_RECIPIENTS}
-    networks:
-      - condado-net
+    extra_hosts:
+      - "celtinha.desktop:host-gateway"
+      - "host.docker.internal:host-gateway"
 
   # ── Frontend + Nginx ─────────────────────────────────────────────────────────
   nginx:
+    container_name: condado-newsletter-frontend
     build:
       context: ./frontend
       dockerfile: Dockerfile
       args:
         VITE_API_BASE_URL: ${VITE_API_BASE_URL}
     restart: unless-stopped
-    ports:
-      - "80:80"
     depends_on:
       - backend
     networks:
-      - condado-net
+      - traefik
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.condado.rule=Host(`condado-newsletter.lab`)"
+      - "traefik.http.services.condado.loadbalancer.server.port=80"
+      - "homepage.group=Hyperlink"
+      - "homepage.name=Condado Newsletter"
+      - "homepage.description=Automated newsletter generator using AI"  
+      - "homepage.logo=claude-dark.png"
+      - "homepage.href=http://condado-newsletter.lab"
 
   # ── Mailhog (DEV ONLY — SMTP trap) ───────────────────────────────────────────
   mailhog:
+    container_name: condado-newsletter-mailhog
     image: mailhog/mailhog:latest
     restart: unless-stopped
     ports:
       - "8025:8025"
-    networks:
-      - condado-net
 
 volumes:
   postgres-data:
 
 networks:
-  condado-net:
-    driver: bridge
+  traefik:
+    external: true
+    name: traefik

docker/entrypoint.sh

@@ -1,28 +1,33 @@
 #!/bin/bash
 set -e
 
-# ── Initialise PostgreSQL data directory on first run ─────────────────────────
-if [ ! -f /var/lib/postgresql/data/PG_VERSION ]; then
-    echo "Initialising PostgreSQL data directory..."
-    su -c "/usr/lib/postgresql/16/bin/initdb -D /var/lib/postgresql/data --encoding=UTF8 --locale=C" postgres
-
-    # Start postgres temporarily to create the app database and user
-    su -c "/usr/lib/postgresql/16/bin/pg_ctl -D /var/lib/postgresql/data -w start" postgres
-
-    su -c "psql -c \"CREATE USER condado WITH PASSWORD 'condado';\"" postgres
-    su -c "psql -c \"CREATE DATABASE condado OWNER condado;\"" postgres
-
-    su -c "/usr/lib/postgresql/16/bin/pg_ctl -D /var/lib/postgresql/data -w stop" postgres
-    echo "PostgreSQL initialised."
-fi
+APP_DB_NAME=${APP_DB_NAME:-condado}
+APP_DB_USER=${SPRING_DATASOURCE_USERNAME:-condado}
+APP_DB_PASSWORD=${SPRING_DATASOURCE_PASSWORD:-condado}
 
 # ── Ensure supervisor log directory exists ────────────────────────────────────
 mkdir -p /var/log/supervisor
 
-# ── Defaults for all-in-one local PostgreSQL ─────────────────────────────────
-export SPRING_DATASOURCE_URL=${SPRING_DATASOURCE_URL:-jdbc:postgresql://localhost:5432/condado}
-export SPRING_DATASOURCE_USERNAME=${SPRING_DATASOURCE_USERNAME:-condado}
-export SPRING_DATASOURCE_PASSWORD=${SPRING_DATASOURCE_PASSWORD:-condado}
+# ── Defaults for external PostgreSQL service in production compose ───────────
+export SPRING_DATASOURCE_URL=${SPRING_DATASOURCE_URL:-jdbc:postgresql://condado-newsletter-postgres:5432/${APP_DB_NAME}}
+export SPRING_DATASOURCE_USERNAME=${SPRING_DATASOURCE_USERNAME:-${APP_DB_USER}}
+export SPRING_DATASOURCE_PASSWORD=${SPRING_DATASOURCE_PASSWORD:-${APP_DB_PASSWORD}}
+export JWT_EXPIRATION_MS=${JWT_EXPIRATION_MS:-86400000}
+
+# ── Log all Spring Boot environment variables for debugging ──────────────────
+echo "========================================"
+echo "Spring Boot Configuration:"
+echo "========================================"
+echo "SPRING_DATASOURCE_URL=${SPRING_DATASOURCE_URL}"
+echo "SPRING_DATASOURCE_USERNAME=${SPRING_DATASOURCE_USERNAME}"
+echo "SPRING_DATASOURCE_PASSWORD=${SPRING_DATASOURCE_PASSWORD}"
+echo "JWT_EXPIRATION_MS=${JWT_EXPIRATION_MS}"
+echo "JAVA_OPTS=${JAVA_OPTS:-not set}"
+echo "OPENAI_API_KEY=${OPENAI_API_KEY:-not set}"
+echo "========================================"
 
 # ── Start all services via supervisord ───────────────────────────────────────
+# Export unbuffered output for both Python and Java
+export PYTHONUNBUFFERED=1
+export JAVA_OPTS="${JAVA_OPTS} -Dfile.encoding=UTF-8 -Djava.awt.headless=true"
 exec /usr/bin/supervisord -c /etc/supervisor/conf.d/supervisord.conf

docker/supervisord.conf

@@ -1,27 +1,26 @@
 [supervisord]
 nodaemon=true
-logfile=/var/log/supervisor/supervisord.log
+silent=false
+logfile=/dev/stdout
+logfile_maxbytes=0
 pidfile=/var/run/supervisord.pid
-
-[program:postgres]
-command=/usr/lib/postgresql/16/bin/postgres -D /var/lib/postgresql/data
-user=postgres
-autostart=true
-autorestart=true
-stdout_logfile=/var/log/supervisor/postgres.log
-stderr_logfile=/var/log/supervisor/postgres.err.log
+loglevel=info
 
 [program:backend]
-command=java -jar /app/app.jar
+command=java -Dspring.output.ansi.enabled=always -Dlogging.level.root=DEBUG -jar /app/app.jar
 autostart=true
 autorestart=true
 startsecs=15
-stdout_logfile=/var/log/supervisor/backend.log
-stderr_logfile=/var/log/supervisor/backend.err.log
+stdout_logfile=/dev/stdout
+stdout_logfile_maxbytes=0
+stderr_logfile=/dev/stderr
+stderr_logfile_maxbytes=0
 
 [program:nginx]
 command=/usr/sbin/nginx -g "daemon off;"
 autostart=true
 autorestart=true
-stdout_logfile=/var/log/supervisor/nginx.log
-stderr_logfile=/var/log/supervisor/nginx.err.log
+stdout_logfile=/dev/stdout
+stdout_logfile_maxbytes=0
+stderr_logfile=/dev/stderr
+stderr_logfile_maxbytes=0

frontend/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "condado-newsletter-frontend",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "condado-newsletter-frontend",
-      "version": "0.2.1",
+      "version": "0.2.2",
       "dependencies": {
         "@radix-ui/react-dialog": "^1.0.5",
         "@radix-ui/react-dropdown-menu": "^2.0.6",

frontend/package.json

@@ -1,7 +1,7 @@
 {
   "name": "condado-newsletter-frontend",
   "private": true,
-  "version": "0.2.1",
+  "version": "0.2.2",
   "type": "module",
   "scripts": {
     "dev": "vite",

frontend/src/__tests__/pages/EditTaskPage.test.tsx

@@ -294,6 +294,45 @@ describe('EditTaskPage', () => {
     })
   })
 
+  it('should_removeOnlyDeletedGeneratedMessage_when_deleteSucceedsWithoutRefetch', async () => {
+    persistedHistory = [
+      {
+        id: 'message-2',
+        taskId: 'task-1',
+        label: 'Message #2',
+        content: 'SUBJECT: Second\nBODY:\nSecond output',
+        createdAt: '2026-03-27T12:10:00Z',
+      },
+      {
+        id: 'message-1',
+        taskId: 'task-1',
+        label: 'Message #1',
+        content: 'SUBJECT: First\nBODY:\nFirst output',
+        createdAt: '2026-03-27T12:00:00Z',
+      },
+    ]
+    vi.mocked(tasksApi.getTaskGeneratedMessages).mockResolvedValue(persistedHistory)
+    vi.mocked(tasksApi.deleteTaskGeneratedMessage).mockResolvedValue(undefined)
+
+    renderPage()
+
+    const secondMessageHistoryItem = await screen.findByRole('button', { name: /^message #2$/i })
+    expect(await screen.findByRole('button', { name: /^message #1$/i })).toBeInTheDocument()
+
+    fireEvent.click(
+      screen.getByRole('button', {
+        name: /delete message #1/i,
+      })
+    )
+
+    await waitFor(() => {
+      expect(tasksApi.deleteTaskGeneratedMessage).toHaveBeenCalledWith('task-1', 'message-1')
+      expect(screen.queryByRole('button', { name: /^message #1$/i })).not.toBeInTheDocument()
+      expect(secondMessageHistoryItem).toBeInTheDocument()
+      expect(screen.getByText(/Second output/i)).toBeInTheDocument()
+    })
+  })
+
   it('should_loadPersistedGeneratedMessageHistory_when_pageLoads', async () => {
     persistedHistory = [
       {

frontend/src/__tests__/pages/EntitiesPage.test.tsx

@@ -89,6 +89,23 @@ describe('EntitiesPage', () => {
     })
   })
 
+  it('should_removeDeletedEntityFromList_when_deleteSucceeds', async () => {
+    vi.mocked(entitiesApi.getEntities).mockResolvedValue([mockEntity])
+    vi.mocked(entitiesApi.deleteEntity).mockResolvedValue(undefined)
+
+    render(<EntitiesPage />, { wrapper })
+
+    await waitFor(() => {
+      expect(screen.getByText('Test Entity')).toBeInTheDocument()
+    })
+
+    fireEvent.click(screen.getByRole('button', { name: /delete|deactivate/i }))
+
+    await waitFor(() => {
+      expect(screen.queryByText('Test Entity')).not.toBeInTheDocument()
+    })
+  })
+
   it('should_renderDetailLink_when_entitiesLoaded', async () => {
     vi.mocked(entitiesApi.getEntities).mockResolvedValue([mockEntity])
     render(<EntitiesPage />, { wrapper })

frontend/src/pages/DashboardPage.tsx

@@ -27,7 +27,7 @@ export default function DashboardPage() {
 
       <div className="grid gap-4 md:grid-cols-2">
         <div className="rounded-xl border border-slate-800 bg-slate-900/70 p-5 shadow-sm">
-          <p className="text-sm text-slate-400">Active Entities</p>
+          <p className="text-sm text-slate-400">Active Entities:</p>
           <p className="mt-1 text-2xl font-bold">{activeCount} active {activeCount === 1 ? 'entity' : 'entities'}</p>
         </div>
         <div className="rounded-xl border border-slate-800 bg-slate-900/70 p-5 shadow-sm">

frontend/src/pages/EditTaskPage.tsx

@@ -255,8 +255,15 @@ export default function EditTaskPage() {
 
   const deleteGeneratedMessageMutation = useMutation({
     mutationFn: (messageId: string) => deleteTaskGeneratedMessage(taskId, messageId),
-    onSuccess: async () => {
-      await queryClient.invalidateQueries({ queryKey: ['task-generated-messages', taskId] })
+    onSuccess: ( _data, messageId) => {
+      queryClient.setQueryData(
+        ['task-generated-messages', taskId],
+        (
+          currentMessages:
+            | Awaited<ReturnType<typeof getTaskGeneratedMessages>>
+            | undefined
+        ) => currentMessages?.filter((message) => message.id !== messageId) ?? []
+      )
     },
   })
 

frontend/src/pages/EntitiesPage.tsx

@@ -37,7 +37,13 @@ export default function EntitiesPage() {
 
   const deleteMutation = useMutation({
     mutationFn: (id: string) => deleteEntity(id),
-    onSuccess: () => queryClient.invalidateQueries({ queryKey: ['entities'] }),
+    onSuccess: (_data, id) => {
+      queryClient.setQueryData(
+        ['entities'],
+        (currentEntities: Awaited<ReturnType<typeof getEntities>> | undefined) =>
+          currentEntities?.filter((entity) => entity.id !== id) ?? []
+      )
+    },
   })
 
   return (

nginx/nginx.allinone.conf

@@ -15,6 +15,9 @@ http {
     gzip_types    text/plain text/css application/json application/javascript
                   text/xml application/xml application/xml+rss text/javascript;
 
+    access_log /dev/stdout;
+    error_log  /dev/stderr;
+
     server {
         listen 80;
         server_name _;