Add Docker setup for unified local development

[Copilot]

Implements containerized development environment supporting single-command launch of frontend and database services, with separate production and development configurations.

Production Setup

Multi-stage Dockerfile builds React app with Node.js 20, serves via nginx:

• Stage 1: npm install → npm run build → /app/dist
• Stage 2: nginx alpine serving static files on port 80
• Security headers (X-Frame-Options, X-Content-Type-Options, X-XSS-Protection)
• Static asset caching (1 year) with no-cache index.html

Exposed as port 3000 in docker-compose.yml

Development Setup

Vite dev server with hot-reload on port 5173:

• Selective volume mounting: source files only (src/, public/, config files)
• Preserves image node_modules to avoid re-install on container start
• Same PostgreSQL service shared between prod/dev

Database

PostgreSQL 15 included for future backend integration:

• Port 5432, persistent volume postgres-data
• Health checks configured (pg_isready)
• Credentials via DB_PASSWORD environment variable

npm Timeout Handling

Build reliability achieved through fetch timeout configuration:

RUN npm config set fetch-retry-maxtimeout 120000 && \
    npm config set fetch-retry-mintimeout 20000 && \
    npm config set fetch-timeout 300000 && \
    npm install

Usage

# Production
docker compose up -d

# Development with hot-reload
docker compose -f docker-compose.dev.yml up

Documentation added to README.md, web-ui/README.md, and DOCKER.md.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• 127.0.0.11
  • Triggering command: REDACTED, pid is -1 (packet block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[TR-0001] Add Docker setup for unified local development</issue_title>
<issue_description>Provide a Dockerfile and (if necessary) a docker-compose.yml to support local setup for both frontend and backend components. The setup should allow developers to launch the environment with a single command and prepare for later deployment modes.

Definition of Ready:

• This issue is labeled with TR-0001 and 'status:Backlog'.
• Clarity about which components are to be containerized.
• Task is sized for a single developer.

Definition of Done:

• Dockerfile(s) and/or docker-compose.yml in repo.
• Verified that frontend and backend start together locally.
• Readme updated with new setup/launch instructions.
• Product Owner review/accepts containerization approach.
  </issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes [TR-0001] Add Docker setup for unified local development #17

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.