[session 1] docs(technical.profile): stub Profile SPA module (deploy + default-landing + inbox-badge xref) #37

2026-07-18T09:14:04-04:00

hiveiq commented

2026-07-18 09:14:04 -04:00

What

Adds the missing technical.profile Guide module (Overview + Gotchas), captured from the 2026-07-17 prod deploy of the inbox unread badge.

Why

Profile had no technical.* module. The deploy surfaced ops/architecture facts with no home in the Guide:

Frontend-only SPA — hiveiq-profile-frontend :5184, no backend/DB; composes auth (prefs incl. inboxPollSeconds), mgmt (institutions), messaging (inbox). Symptom→owner table so people check the right backend.
Default landing page — Profile is the sole is_default module in mgmt app_modules, so the HiveIQ Browser lands users here after login.
Deploy — PROFILE_VERSION=<sha> pin in services .env (was implicit :latest), single-instance recreate (not blue/green), rollback via captured image ID.
Gotcha — profile.bcos.cloud/ root 302 → www.bcos.cloud is intentional nginx routing, not an outage; verify via container health + served-bundle grep, not the public root.

Inbox badge behaviour is cross-linked to [profile.inbox] (already documented 2026-07-16), not duplicated.

coverage-reconcile.py green (131 modules). Develop-only; no prod Guide deploy.

## What Adds the missing **`technical.profile`** Guide module (Overview + Gotchas), captured from the 2026-07-17 prod deploy of the inbox unread badge. ## Why Profile had no `technical.*` module. The deploy surfaced ops/architecture facts with no home in the Guide: - **Frontend-only SPA** — `hiveiq-profile-frontend` :5184, no backend/DB; composes auth (prefs incl. `inboxPollSeconds`), mgmt (institutions), messaging (inbox). Symptom→owner table so people check the right backend. - **Default landing page** — Profile is the sole `is_default` module in mgmt `app_modules`, so the HiveIQ Browser lands users here after login. - **Deploy** — `PROFILE_VERSION=<sha>` pin in services `.env` (was implicit `:latest`), single-instance recreate (not blue/green), rollback via captured image ID. - **Gotcha** — `profile.bcos.cloud/` root `302 → www.bcos.cloud` is intentional nginx routing, not an outage; verify via container health + served-bundle grep, not the public root. Inbox badge behaviour is **cross-linked to [profile.inbox]** (already documented 2026-07-16), not duplicated. `coverage-reconcile.py` green (131 modules). Develop-only; no prod Guide deploy.

johannes approved these changes 2026-07-18 09:15:22 -04:00

Dismissed

hiveiq added 1 commit 2026-07-18 11:26:52 -04:00

docs(technical.profile): stub Profile SPA module (frontend-only, deploy, default-landing) 8960b03ec6

Profile had no technical.* module. Documents: frontend-only SPA (hiveiq-profile-frontend
:5184, no backend/DB — composes auth/mgmt/messaging), PROFILE_VERSION sha-pinning +
single-instance recreate, the profile.bcos.cloud->www.bcos.cloud root-redirect red herring,
and that Profile is the sole is_default module (browser landing page). Inbox unread badge
cross-links [profile.inbox] rather than duplicating. Captured from the 2026-07-17 prod deploy.

johannes approved these changes 2026-07-18 11:28:46 -04:00

hiveiq merged commit c301242539 into develop

2026-07-18 11:29:24 -04:00

hiveiq deleted branch docs/technical-profile

2026-07-18 11:30:32 -04:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: hiveiq-src/hiveops-guide#37