pos-transactions-web/docs/runbooks/containerization.md
José René White Enciso f48bcb1a4d feat(pos-web): add web baseline
Why: establish baseline web runtime scaffold before wave implementation.

What: add react app structure, docker runtime assets, docs runbooks, and ignore policy updates.

Rule: keep technical intent and repository workflow compliance.
2026-03-08 15:53:49 -06:00

532 B

Containerization Runbook

Image Build

docker build -t agilewebs/pos-transactions-web:dev .

Local Run

docker run --rm -p 8080:8080 \
  -e API_BASE_URL=http://host.docker.internal:8080 \
  --name pos-transactions-web agilewebs/pos-transactions-web:dev

Runtime Configuration Strategy

  • Build-time fallback: VITE_API_BASE_URL
  • Runtime override: container env API_BASE_URL
  • Runtime file generated at startup: /runtime-config.js

Health Check

curl -f http://localhost:8080/