an officerdev docker network, and the reasoning next to the port binding

One network for everything Officer provisions, created before anything joins it
and declared external in the compose file. Postgres needs nothing from it today —
the platform is a host process reaching it over loopback — but a reverse proxy in
front of the web UI does, and so does any app-store service that talks to
another. Creating it now means the later ones do not have to be migrated onto it.

Two things written next to the line they explain, rather than assumed:

Why loopback. Publishing a port makes Docker write its own DNAT and ACCEPT rules
into iptables, and those are evaluated BEFORE ufw sees the packet — so
`ports: "5432:5432"` is reachable from the internet while `ufw status` reports
everything denied. That is the same mechanism the machine-setup firewall section
hooks DOCKER-USER to close. Binding to 127.0.0.1 sidesteps it: the DNAT rule only
matches traffic arriving on loopback.

Why the password is not decoration. Loopback means nothing off this machine, but
every account ON it can open 127.0.0.1:5432 — including the per-user Linux
accounts Officer gives its members. What stops them is that they cannot
authenticate. The password is the boundary between the platform and anyone with a
login here, which is why it stays random and why both files holding it are 0600.

A unix socket would remove even that, and was ruled out for a specific reason:
postgres.js only treats a host as a socket path when the host FIELD contains a
slash (src/index.js:468), and officer_db/src/db.ts passes a bare URL string. It
would take a change to db.ts, which is not a setup-script change.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

scripts/setup/officer-setup.sh

@@ -342,6 +342,15 @@ if ! skip; then
   echo "     accounts and the job queue. Nothing else in the platform is a"
   echo "     database."
   echo ""
+  # One network for everything Officer provisions. Created before the compose
+  # file references it, since it is declared external there.
+  if ensure_docker_network; then
+    ok "docker network '${OFFICER_NETWORK}' created"
+    SUMMARY+=("Docker network: ${OFFICER_NETWORK} created")
+  elif docker_network_exists; then
+    echo "     network:       ${OFFICER_NETWORK} (already there)"
+  fi
+
   echo "     compose file:  $(pg_compose_exists && echo "$(pg_compose_file)" || echo 'not written yet')"
   echo "     container:     $(pg_container_running && echo "${PG_CONTAINER} running" || echo 'not running')"
   echo "     port ${PG_PORT}:    $(pg_port_in_use && echo 'something is listening' || echo 'free')"