Bell is YoVision's independently deployable alert intake and response product. It owns its users, roles, sessions, database, audit facts and release artifacts. Sense and Brain are not required for Bell to build or run.

Frozen baseline

Go 1.26.5
Node.js 22.22.1
pnpm 9.15.1
go-admin commit f06540883b41d03782bb6b2c4150f298f328c6b6
go-admin-ui commit 67d393d713877572fab0b897296a4c1d525fc81d

Exact upstream sources and retained MIT notices are in LICENSES/.

Configuration

Copy variable names from .env.example into the process environment. Replace every placeholder at deployment time. Bell intentionally has no built-in database password, session secret or administrator password.

The PostgreSQL role used by BELL_DATABASE_URL must be dedicated to Bell. Do not reuse a Sense role or database.

Backend

Set-Location Bell/server
go test ./...
go run . migrate
go run . serve

Health endpoints:

Invoke-RestMethod http://127.0.0.1:8082/healthz
Invoke-RestMethod http://127.0.0.1:8082/readyz

Migrations are embedded and applied transactionally. The migrate command is idempotent. To roll back this initial skeleton, stop Bell and drop only the dedicated Bell test database; migrations are forward-only and never touch another product database.

Web

Set-Location Bell/web
pnpm install --frozen-lockfile
pnpm lint
pnpm build:prod
pnpm dev

The web client listens on port 8083 in development and proxies /api to Bell only. The visible shell contains only Bell's product navigation; go-admin demonstration routes are neither registered nor served by the backend.

Independent smoke check

Run PostgreSQL with an empty Bell-only database, set BELL_DATABASE_URL, start the backend and then the web client. Keep Sense and Brain stopped. Verify /healthz, /readyz, the workbench shell, and a direct request to an unregistered framework demo route returns 404.

Logs and secrets

Application logs go to standard output. Never log database URLs, passwords, session tokens, event evidence credentials, customer data or production payloads.