From 930a4b968e152176c838b60b9e9b5a7fc9759c1d Mon Sep 17 00:00:00 2001 From: Johannes Date: Wed, 1 Jul 2026 17:11:00 -0400 Subject: [PATCH] feat(guide): dev audience tier + GUIDE_SERVED_AUDIENCES env cap (prod = customer,internal) 4-tier ladder customerdev; Processes stays bcos. Backend visible() enforces a per-instance served-audiences cap at the API. bcos.dev/DLX serve all; production sets GUIDE_SERVED_AUDIENCES=customer,internal so dev/bcos never leave dev. Verified: capped instance returns only Customer+Internal, 404s dev/bcos. Co-Authored-By: Claude Opus 4.8 --- .../guide/service/MarkdownGuideService.java | 33 ++++++++++++++++--- .../src/main/resources/application.properties | 4 +++ .../content/analytics/adoons/architect.md | 2 +- .../content/analytics/adoons/claude.md | 2 +- .../content/analytics/adoons/testing.md | 2 +- .../content/analytics/agents/architect.md | 2 +- .../content/analytics/agents/claude.md | 2 +- .../content/analytics/agents/testing.md | 2 +- .../content/analytics/cash/architect.md | 2 +- .../content/analytics/cash/claude.md | 2 +- .../content/analytics/cash/testing.md | 2 +- .../analytics/fleet-health/architect.md | 2 +- .../content/analytics/fleet-health/claude.md | 2 +- .../content/analytics/fleet-health/testing.md | 2 +- .../content/analytics/incidents/architect.md | 2 +- .../content/analytics/incidents/claude.md | 2 +- .../content/analytics/incidents/testing.md | 2 +- .../analytics/transactions/architect.md | 2 +- .../content/analytics/transactions/claude.md | 2 +- .../content/analytics/transactions/testing.md | 2 +- .../content/analytics/uptime/architect.md | 2 +- .../content/analytics/uptime/claude.md | 2 +- .../content/analytics/uptime/testing.md | 2 +- .../content/aria/dashboard/architect.md | 2 +- .../content/aria/dashboard/claude.md | 2 +- .../content/aria/dashboard/testing.md | 2 +- .../content/aria/device-posture/architect.md | 2 +- .../content/aria/device-posture/claude.md | 2 +- .../content/aria/device-posture/testing.md | 2 +- .../content/aria/ioc-feeds/architect.md | 2 +- .../content/aria/ioc-feeds/claude.md | 2 +- .../content/aria/ioc-feeds/testing.md | 2 +- .../content/aria/ioc-management/architect.md | 2 +- .../content/aria/ioc-management/claude.md | 2 +- .../content/aria/ioc-management/testing.md | 2 +- .../aria/precursor-alerts/architect.md | 2 +- .../content/aria/precursor-alerts/claude.md | 2 +- .../content/aria/precursor-alerts/testing.md | 2 +- .../content/aria/threat-events/architect.md | 2 +- .../content/aria/threat-events/claude.md | 2 +- .../content/aria/threat-events/testing.md | 2 +- .../content/claims/claim-detail/architect.md | 2 +- .../content/claims/claim-detail/claude.md | 2 +- .../content/claims/claim-detail/testing.md | 2 +- .../content/claims/dashboard/architect.md | 2 +- .../content/claims/dashboard/claude.md | 2 +- .../content/claims/dashboard/testing.md | 2 +- .../content/claims/settings/architect.md | 2 +- .../content/claims/settings/claude.md | 2 +- .../content/claims/settings/testing.md | 2 +- .../content/claims/vendors/architect.md | 2 +- .../content/claims/vendors/claude.md | 2 +- .../content/claims/vendors/testing.md | 2 +- .../content/dashboard/cash-stats/architect.md | 2 +- .../content/dashboard/cash-stats/claude.md | 2 +- .../content/dashboard/cash-stats/testing.md | 2 +- .../content/dashboard/overview/architect.md | 2 +- .../content/dashboard/overview/claude.md | 2 +- .../content/dashboard/overview/testing.md | 2 +- .../devices/agent-profile/architect.md | 2 +- .../content/devices/agent-profile/claude.md | 2 +- .../content/devices/agent-profile/testing.md | 2 +- .../devices/agent-scripts/architect.md | 2 +- .../content/devices/agent-scripts/claude.md | 2 +- .../content/devices/agent-scripts/testing.md | 2 +- .../content/devices/config-audit/architect.md | 2 +- .../content/devices/config-audit/claude.md | 2 +- .../content/devices/config-audit/testing.md | 2 +- .../devices/device-detail/architect.md | 2 +- .../content/devices/device-detail/claude.md | 2 +- .../content/devices/device-detail/testing.md | 2 +- .../devices/device-groups/architect.md | 2 +- .../content/devices/device-groups/claude.md | 2 +- .../content/devices/device-groups/testing.md | 2 +- .../content/devices/device-list/architect.md | 2 +- .../content/devices/device-list/claude.md | 2 +- .../content/devices/device-list/testing.md | 2 +- .../content/devices/map/architect.md | 2 +- .../resources/content/devices/map/claude.md | 2 +- .../resources/content/devices/map/testing.md | 2 +- .../content/devices/sw-deploy/architect.md | 2 +- .../content/devices/sw-deploy/claude.md | 2 +- .../content/devices/sw-deploy/testing.md | 2 +- .../content/fleet/artifacts/architect.md | 2 +- .../content/fleet/artifacts/claude.md | 2 +- .../content/fleet/artifacts/testing.md | 2 +- .../content/fleet/dashboard/architect.md | 2 +- .../content/fleet/dashboard/claude.md | 2 +- .../content/fleet/dashboard/testing.md | 2 +- .../content/fleet/modules/architect.md | 2 +- .../resources/content/fleet/modules/claude.md | 2 +- .../content/fleet/modules/testing.md | 2 +- .../content/fleet/patch-windows/architect.md | 2 +- .../content/fleet/patch-windows/claude.md | 2 +- .../content/fleet/patch-windows/testing.md | 2 +- .../content/fleet/tasks/architect.md | 2 +- .../resources/content/fleet/tasks/claude.md | 2 +- .../resources/content/fleet/tasks/testing.md | 2 +- .../content/incident/dashboard/architect.md | 2 +- .../content/incident/dashboard/claude.md | 2 +- .../content/incident/dashboard/testing.md | 2 +- .../incident/incident-management/architect.md | 2 +- .../incident/incident-management/claude.md | 2 +- .../incident/incident-management/testing.md | 2 +- .../incident/incident-tracker/architect.md | 2 +- .../incident/incident-tracker/claude.md | 2 +- .../incident/incident-tracker/testing.md | 2 +- .../incident/journal-events/architect.md | 2 +- .../content/incident/journal-events/claude.md | 2 +- .../incident/journal-events/testing.md | 2 +- .../incident/processing-rules/architect.md | 2 +- .../incident/processing-rules/claude.md | 2 +- .../incident/processing-rules/testing.md | 2 +- .../content/msp/contact-groups/architect.md | 2 +- .../content/msp/contact-groups/claude.md | 2 +- .../content/msp/contact-groups/testing.md | 2 +- .../content/msp/institution-keys/architect.md | 2 +- .../content/msp/institution-keys/claude.md | 2 +- .../content/msp/institution-keys/testing.md | 2 +- .../content/msp/institutions/architect.md | 2 +- .../content/msp/institutions/claude.md | 2 +- .../content/msp/institutions/testing.md | 2 +- .../msp/module-allocations/architect.md | 2 +- .../content/msp/module-allocations/claude.md | 2 +- .../content/msp/module-allocations/testing.md | 2 +- .../resources/content/msp/users/architect.md | 2 +- .../resources/content/msp/users/claude.md | 2 +- .../resources/content/msp/users/testing.md | 2 +- .../content/platform/auth/overview.md | 2 +- .../platform/data-architecture/overview.md | 2 +- .../content/platform/data-stores/overview.md | 2 +- .../content/platform/deployment/overview.md | 2 +- .../content/platform/git-workflow/overview.md | 2 +- .../content/platform/gotchas/overview.md | 2 +- .../content/platform/kafka/overview.md | 2 +- .../content/platform/module-map/overview.md | 2 +- .../platform/nginx-routing/overview.md | 2 +- .../platform/service-ownership/overview.md | 2 +- .../content/platform/topology/overview.md | 2 +- .../content/profile/appearance/architect.md | 2 +- .../content/profile/appearance/claude.md | 2 +- .../content/profile/appearance/testing.md | 2 +- .../content/profile/display/architect.md | 2 +- .../content/profile/display/claude.md | 2 +- .../content/profile/display/testing.md | 2 +- .../content/profile/inbox/architect.md | 2 +- .../resources/content/profile/inbox/claude.md | 2 +- .../content/profile/inbox/testing.md | 2 +- .../profile/notifications/architect.md | 2 +- .../content/profile/notifications/claude.md | 2 +- .../content/profile/notifications/testing.md | 2 +- .../content/profile/profile/architect.md | 2 +- .../content/profile/profile/claude.md | 2 +- .../content/profile/profile/testing.md | 2 +- .../content/profile/security/architect.md | 2 +- .../content/profile/security/claude.md | 2 +- .../content/profile/security/testing.md | 2 +- .../recon/atm-cycle-history/architect.md | 2 +- .../content/recon/atm-cycle-history/claude.md | 2 +- .../recon/atm-cycle-history/testing.md | 2 +- .../content/recon/cash-forecast/architect.md | 2 +- .../content/recon/cash-forecast/claude.md | 2 +- .../content/recon/cash-forecast/testing.md | 2 +- .../recon/cash-reconciliation/architect.md | 2 +- .../recon/cash-reconciliation/claude.md | 2 +- .../recon/cash-reconciliation/testing.md | 2 +- .../recon/device-cycle-mgmt/architect.md | 2 +- .../content/recon/device-cycle-mgmt/claude.md | 2 +- .../recon/device-cycle-mgmt/testing.md | 2 +- .../content/recon/recon-rules/architect.md | 2 +- .../content/recon/recon-rules/claude.md | 2 +- .../content/recon/recon-rules/testing.md | 2 +- .../content/reports/builder/architect.md | 2 +- .../content/reports/builder/claude.md | 2 +- .../content/reports/builder/testing.md | 2 +- .../content/reports/queries/architect.md | 2 +- .../content/reports/queries/claude.md | 2 +- .../content/reports/queries/testing.md | 2 +- .../content/reports/runs/architect.md | 2 +- .../resources/content/reports/runs/claude.md | 2 +- .../resources/content/reports/runs/testing.md | 2 +- .../content/reports/schedule/architect.md | 2 +- .../content/reports/schedule/claude.md | 2 +- .../content/reports/schedule/testing.md | 2 +- .../content/reports/templates/architect.md | 2 +- .../content/reports/templates/claude.md | 2 +- .../content/reports/templates/testing.md | 2 +- .../content/technical/agent-proxy/overview.md | 2 +- .../content/technical/agent/overview.md | 2 +- .../content/technical/ai/overview.md | 2 +- .../content/technical/analytics/overview.md | 2 +- .../content/technical/aria/overview.md | 2 +- .../content/technical/auth/overview.md | 2 +- .../content/technical/claims/overview.md | 2 +- .../content/technical/config/overview.md | 2 +- .../content/technical/devices/overview.md | 2 +- .../content/technical/fleet/overview.md | 2 +- .../content/technical/incident/overview.md | 2 +- .../content/technical/journal/overview.md | 2 +- .../content/technical/messaging/overview.md | 2 +- .../content/technical/mgmt/overview.md | 2 +- .../content/technical/recon/overview.md | 2 +- .../content/technical/remote/overview.md | 2 +- .../content/technical/reports/overview.md | 2 +- .../technical/transactions/overview.md | 2 +- .../content/technical/vault/overview.md | 2 +- .../content/transactions/browser/architect.md | 2 +- .../content/transactions/browser/claude.md | 2 +- .../content/transactions/browser/testing.md | 2 +- .../customer-journey/architect.md | 2 +- .../transactions/customer-journey/claude.md | 2 +- .../transactions/customer-journey/testing.md | 2 +- .../transactions/journal-parsing/architect.md | 2 +- .../transactions/journal-parsing/claude.md | 2 +- .../transactions/journal-parsing/testing.md | 2 +- .../processing-rules/architect.md | 2 +- .../transactions/processing-rules/claude.md | 2 +- .../transactions/processing-rules/testing.md | 2 +- .../content/transactions/reparse/architect.md | 2 +- .../content/transactions/reparse/claude.md | 2 +- .../content/transactions/reparse/testing.md | 2 +- .../content/vault/cit-visits/architect.md | 2 +- .../content/vault/cit-visits/claude.md | 2 +- .../content/vault/cit-visits/testing.md | 2 +- .../content/vault/dashboard/architect.md | 2 +- .../content/vault/dashboard/claude.md | 2 +- .../content/vault/dashboard/testing.md | 2 +- .../content/vault/import/architect.md | 2 +- .../resources/content/vault/import/claude.md | 2 +- .../resources/content/vault/import/testing.md | 2 +- frontend/src/components/GuideReader.svelte | 2 +- 231 files changed, 262 insertions(+), 233 deletions(-) diff --git a/backend/src/main/java/com/hiveops/guide/service/MarkdownGuideService.java b/backend/src/main/java/com/hiveops/guide/service/MarkdownGuideService.java index d7f96a3..49a6534 100644 --- a/backend/src/main/java/com/hiveops/guide/service/MarkdownGuideService.java +++ b/backend/src/main/java/com/hiveops/guide/service/MarkdownGuideService.java @@ -22,6 +22,26 @@ public class MarkdownGuideService { private volatile List docs = List.of(); + /** Which audience tiers this instance serves — the per-environment cap. + * bcos.dev/DLX = all; production = customer,internal. */ + @org.springframework.beans.factory.annotation.Value("${guide.served-audiences:customer,internal,dev,bcos}") + private String servedRaw; + private volatile Set served; + + private Set served() { + Set s = served; + if (s == null) { + s = new HashSet<>(); + for (String x : servedRaw.split(",")) { + x = x.trim().toLowerCase(Locale.ROOT); + if (!x.isEmpty()) s.add(x); + } + served = s; + log.info("Guide serving audience tiers: {}", s); + } + return s; + } + @PostConstruct public void load() { List loaded = new ArrayList<>(); @@ -79,12 +99,17 @@ public class MarkdownGuideService { return new GuideDoc(app, module, title, tab, order, audience, body); } - /** audience tiers: customer (all) < internal (MSP/BCOS admin) < bcos (BCOS admin only). */ + /** Audience ladder: customer < internal < dev < bcos. + * First the environment cap (served tiers), then the caller's role. + * customer→all · internal/dev→MSP or BCOS admin · bcos→BCOS admin only. */ private boolean visible(GuideDoc d, boolean includeInternal, boolean includeBcos) { String a = d.audience(); - if ("bcos".equals(a)) return includeBcos; - if ("internal".equals(a)) return includeInternal; - return true; + if (!served().contains(a)) return false; // environment cap (prod = customer,internal) + return switch (a) { + case "bcos" -> includeBcos; + case "internal", "dev" -> includeInternal; + default -> true; // customer + }; } /** apps → modules → tabs, filtered by audience. */ diff --git a/backend/src/main/resources/application.properties b/backend/src/main/resources/application.properties index 2bbe856..293afa8 100644 --- a/backend/src/main/resources/application.properties +++ b/backend/src/main/resources/application.properties @@ -23,6 +23,10 @@ internal.secret=${INTERNAL_SECRET:dev-internal-secret} cors.allowed-origins=${CORS_ALLOWED_ORIGINS:http://localhost:5188} +# Audience tiers this instance serves (per-environment cap). +# bcos.dev / DLX = all four; production = customer,internal (dev/bcos never leave dev). +guide.served-audiences=${GUIDE_SERVED_AUDIENCES:customer,internal,dev,bcos} + # In-guide feedback → Gitea issues (server-side token; reaches Gitea via public route) gitea.base-url=${GITEA_BASE_URL:https://hiveiq-gitea.directlx.dev} gitea.feedback.token=${GITEA_FEEDBACK_TOKEN:} diff --git a/backend/src/main/resources/content/analytics/adoons/architect.md b/backend/src/main/resources/content/analytics/adoons/architect.md index e1a63ff..028091c 100644 --- a/backend/src/main/resources/content/analytics/adoons/architect.md +++ b/backend/src/main/resources/content/analytics/adoons/architect.md @@ -3,7 +3,7 @@ module: analytics.adoons title: Adoons Insights tab: Architect order: 30 -audience: internal +audience: dev --- > **Internal · architecture.** Written 2026-07-01 from `hiveops-analytics` source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/analytics/adoons/claude.md b/backend/src/main/resources/content/analytics/adoons/claude.md index b44e377..60cf4a3 100644 --- a/backend/src/main/resources/content/analytics/adoons/claude.md +++ b/backend/src/main/resources/content/analytics/adoons/claude.md @@ -3,7 +3,7 @@ module: analytics.adoons title: Adoons Insights tab: Claude order: 40 -audience: internal +audience: dev --- > **Internal · agent reference.** Grounded in `hiveops-analytics` @ 2026-07-01. Only confirmed facts below. diff --git a/backend/src/main/resources/content/analytics/adoons/testing.md b/backend/src/main/resources/content/analytics/adoons/testing.md index 6b7ffad..4695944 100644 --- a/backend/src/main/resources/content/analytics/adoons/testing.md +++ b/backend/src/main/resources/content/analytics/adoons/testing.md @@ -3,7 +3,7 @@ module: analytics.adoons title: Adoons Insights tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Adoons Insights** (the **Fleet Insights** tab in Analytics, `analytics.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/analytics/agents/architect.md b/backend/src/main/resources/content/analytics/agents/architect.md index 8fb13c6..39d90f7 100644 --- a/backend/src/main/resources/content/analytics/agents/architect.md +++ b/backend/src/main/resources/content/analytics/agents/architect.md @@ -3,7 +3,7 @@ module: analytics.agents title: Agents tab: Architect order: 30 -audience: internal +audience: dev --- > **Internal · architecture.** Grounded in hiveops-analytics + hiveops-devices source (2026-07-01). Cross-link [platform.data-architecture], [platform.kafka], [platform.service-ownership], [technical.analytics]. diff --git a/backend/src/main/resources/content/analytics/agents/claude.md b/backend/src/main/resources/content/analytics/agents/claude.md index 8cb8bb8..0fdeab1 100644 --- a/backend/src/main/resources/content/analytics/agents/claude.md +++ b/backend/src/main/resources/content/analytics/agents/claude.md @@ -3,7 +3,7 @@ module: analytics.agents title: Agents tab: Claude order: 40 -audience: internal +audience: dev --- > **Internal · AI agent quick-ref.** Confirmed against source 2026-07-01. Act on confirmed facts only. diff --git a/backend/src/main/resources/content/analytics/agents/testing.md b/backend/src/main/resources/content/analytics/agents/testing.md index 58ad803..6c90c2b 100644 --- a/backend/src/main/resources/content/analytics/agents/testing.md +++ b/backend/src/main/resources/content/analytics/agents/testing.md @@ -3,7 +3,7 @@ module: analytics.agents title: Agents tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Agents** tab in HiveIQ Analytics (`analytics.bcos.dev`). This tab is **view-only** — there is nothing to create, edit, or push. Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/analytics/cash/architect.md b/backend/src/main/resources/content/analytics/cash/architect.md index fbfa396..92b7c1a 100644 --- a/backend/src/main/resources/content/analytics/cash/architect.md +++ b/backend/src/main/resources/content/analytics/cash/architect.md @@ -3,7 +3,7 @@ module: analytics.cash title: Cash Intelligence tab: Architect order: 30 -audience: internal +audience: dev --- > **Internal · architecture.** Grounded in `hiveops-analytics` + `hiveops-recon` source, 2026-07-01. Key point: Cash Intelligence is a **synchronous fan-out**, not the usual executor→Kafka→record-store pattern. Analytics stores nothing for this feature and consumes no Kafka topic to build it. diff --git a/backend/src/main/resources/content/analytics/cash/claude.md b/backend/src/main/resources/content/analytics/cash/claude.md index 349d3cc..3891c05 100644 --- a/backend/src/main/resources/content/analytics/cash/claude.md +++ b/backend/src/main/resources/content/analytics/cash/claude.md @@ -3,7 +3,7 @@ module: analytics.cash title: Cash Intelligence tab: Claude order: 40 -audience: internal +audience: dev --- > Terse agent reference. Cash Intelligence = **read-only pass-through**: analytics re-shapes one recon call. Analytics owns NO cash data. diff --git a/backend/src/main/resources/content/analytics/cash/testing.md b/backend/src/main/resources/content/analytics/cash/testing.md index 4b06d95..5a49c3e 100644 --- a/backend/src/main/resources/content/analytics/cash/testing.md +++ b/backend/src/main/resources/content/analytics/cash/testing.md @@ -3,7 +3,7 @@ module: analytics.cash title: Cash Intelligence tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Cash Intelligence** tab (`analytics.bcos.dev`). Open the tab in the UI and mark each row Pass or Fail. This tab is **view-only** — there is nothing to create, edit, or delete. diff --git a/backend/src/main/resources/content/analytics/fleet-health/architect.md b/backend/src/main/resources/content/analytics/fleet-health/architect.md index 2749f0b..8607749 100644 --- a/backend/src/main/resources/content/analytics/fleet-health/architect.md +++ b/backend/src/main/resources/content/analytics/fleet-health/architect.md @@ -3,7 +3,7 @@ module: analytics.fleet-health title: Fleet Health tab: Architect order: 30 -audience: internal +audience: dev --- > **How it's built.** Fleet Health is a **synchronous fan-out aggregation** — not a snapshot/Kafka read. Grounded in `FleetHealthController` + `FleetHealthService` (hiveops-analytics) and the frontend `FleetHealthTab.svelte`. Cross-link [platform.data-architecture], [platform.kafka], [platform.service-ownership]. diff --git a/backend/src/main/resources/content/analytics/fleet-health/claude.md b/backend/src/main/resources/content/analytics/fleet-health/claude.md index 4467e98..5835dbc 100644 --- a/backend/src/main/resources/content/analytics/fleet-health/claude.md +++ b/backend/src/main/resources/content/analytics/fleet-health/claude.md @@ -3,7 +3,7 @@ module: analytics.fleet-health title: Fleet Health tab: Claude order: 40 -audience: internal +audience: dev --- > Act-without-guessing reference. All facts from `FleetHealthController`/`FleetHealthService`/`SecurityConfig` (hiveops-analytics) + `FleetHealthTab.svelte`/`api.ts`. diff --git a/backend/src/main/resources/content/analytics/fleet-health/testing.md b/backend/src/main/resources/content/analytics/fleet-health/testing.md index 9f1043f..bb2c3d6 100644 --- a/backend/src/main/resources/content/analytics/fleet-health/testing.md +++ b/backend/src/main/resources/content/analytics/fleet-health/testing.md @@ -3,7 +3,7 @@ module: analytics.fleet-health title: Fleet Health tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Fleet Health** tab in **Analytics** (`analytics.bcos.dev`). Click through in the UI and mark each row Pass or Fail. This screen is **read-only** — there is nothing to create, edit, or delete. diff --git a/backend/src/main/resources/content/analytics/incidents/architect.md b/backend/src/main/resources/content/analytics/incidents/architect.md index 129327c..9ffad7e 100644 --- a/backend/src/main/resources/content/analytics/incidents/architect.md +++ b/backend/src/main/resources/content/analytics/incidents/architect.md @@ -3,7 +3,7 @@ module: analytics.incidents title: Incident Trends tab: Architect order: 30 -audience: internal +audience: dev --- > How the **Incident Trends** tab is built. Grounded in `hiveops-analytics` + `hiveops-incident` source, 2026-07-01. Cross-link [platform.data-architecture], [platform.kafka], [platform.service-ownership]. diff --git a/backend/src/main/resources/content/analytics/incidents/claude.md b/backend/src/main/resources/content/analytics/incidents/claude.md index 137443f..b29aef4 100644 --- a/backend/src/main/resources/content/analytics/incidents/claude.md +++ b/backend/src/main/resources/content/analytics/incidents/claude.md @@ -3,7 +3,7 @@ module: analytics.incidents title: Incident Trends tab: Claude order: 40 -audience: internal +audience: dev --- > Terse agent reference. All facts confirmed in source 2026-07-01. `hiveops-ai` = "Adoons". diff --git a/backend/src/main/resources/content/analytics/incidents/testing.md b/backend/src/main/resources/content/analytics/incidents/testing.md index b9b7da6..a868947 100644 --- a/backend/src/main/resources/content/analytics/incidents/testing.md +++ b/backend/src/main/resources/content/analytics/incidents/testing.md @@ -3,7 +3,7 @@ module: analytics.incidents title: Incident Trends tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Incident Trends** tab in Analytics (`analytics.bcos.dev`). This tab is **read-only** — there is nothing to create, edit, or delete, so the tests focus on the four panels rendering correctly and on role scoping. Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/analytics/transactions/architect.md b/backend/src/main/resources/content/analytics/transactions/architect.md index 2388751..e943ee1 100644 --- a/backend/src/main/resources/content/analytics/transactions/architect.md +++ b/backend/src/main/resources/content/analytics/transactions/architect.md @@ -3,7 +3,7 @@ module: analytics.transactions title: Transactions tab: Architect order: 30 -audience: internal +audience: dev --- > How the **Transactions** tab is built. It is a **synchronous pull-through aggregation**, not an event-driven or snapshot-backed view. Cross-link [platform.service-ownership], [platform.data-architecture], [platform.kafka]. diff --git a/backend/src/main/resources/content/analytics/transactions/claude.md b/backend/src/main/resources/content/analytics/transactions/claude.md index 78a7772..d0a181c 100644 --- a/backend/src/main/resources/content/analytics/transactions/claude.md +++ b/backend/src/main/resources/content/analytics/transactions/claude.md @@ -3,7 +3,7 @@ module: analytics.transactions title: Transactions tab: Claude order: 40 -audience: internal +audience: dev --- > Act-without-guessing reference. Transactions tab = analytics UI tab `id: 'journal', label: 'Transactions'` → `JournalCoverageTab.svelte` → `GET /api/analytics/journal-coverage`. Data source of truth is **hiveops-journal**, not analytics. diff --git a/backend/src/main/resources/content/analytics/transactions/testing.md b/backend/src/main/resources/content/analytics/transactions/testing.md index 0683e19..cf7c02a 100644 --- a/backend/src/main/resources/content/analytics/transactions/testing.md +++ b/backend/src/main/resources/content/analytics/transactions/testing.md @@ -3,7 +3,7 @@ module: analytics.transactions title: Transactions tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Transactions** tab in **Analytics** (`analytics.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/analytics/uptime/architect.md b/backend/src/main/resources/content/analytics/uptime/architect.md index 3b1ea1e..10758b1 100644 --- a/backend/src/main/resources/content/analytics/uptime/architect.md +++ b/backend/src/main/resources/content/analytics/uptime/architect.md @@ -3,7 +3,7 @@ module: analytics.uptime title: Uptime tab: Architect order: 30 -audience: internal +audience: dev --- > **How Uptime is built.** Grounded in `hiveops-analytics` source (2026-07-01). Cross-link [platform.data-architecture], [platform.kafka], [platform.service-ownership]. diff --git a/backend/src/main/resources/content/analytics/uptime/claude.md b/backend/src/main/resources/content/analytics/uptime/claude.md index 248d200..f1fcefb 100644 --- a/backend/src/main/resources/content/analytics/uptime/claude.md +++ b/backend/src/main/resources/content/analytics/uptime/claude.md @@ -3,7 +3,7 @@ module: analytics.uptime title: Uptime tab: Claude order: 40 -audience: internal +audience: dev --- > Terse agent reference for `analytics.uptime`. Only confirmed facts. Act, don't guess. diff --git a/backend/src/main/resources/content/analytics/uptime/testing.md b/backend/src/main/resources/content/analytics/uptime/testing.md index f06b97a..6bd0bfc 100644 --- a/backend/src/main/resources/content/analytics/uptime/testing.md +++ b/backend/src/main/resources/content/analytics/uptime/testing.md @@ -3,7 +3,7 @@ module: analytics.uptime title: Uptime tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Uptime** tab in Analytics (`analytics.bcos.dev`). This screen is **read-only** — there are no buttons, forms, or actions, so the tests are all about what you can *see*. Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/aria/dashboard/architect.md b/backend/src/main/resources/content/aria/dashboard/architect.md index cf067f0..5535910 100644 --- a/backend/src/main/resources/content/aria/dashboard/architect.md +++ b/backend/src/main/resources/content/aria/dashboard/architect.md @@ -3,7 +3,7 @@ module: aria.dashboard title: Threat Dashboard tab: Architect order: 30 -audience: internal +audience: dev --- How the ARIA Threat Dashboard is built. The dashboard is a **thin read-only aggregation view** — it does not own data, run detection, or consume Kafka. It renders one snapshot from `hiveops-aria`'s tables. All the interesting machinery (ingestion, IOC matching, sequence detection) runs upstream and only *populates* the tables this view reads. diff --git a/backend/src/main/resources/content/aria/dashboard/claude.md b/backend/src/main/resources/content/aria/dashboard/claude.md index 4555e59..2402454 100644 --- a/backend/src/main/resources/content/aria/dashboard/claude.md +++ b/backend/src/main/resources/content/aria/dashboard/claude.md @@ -3,7 +3,7 @@ module: aria.dashboard title: Threat Dashboard tab: Claude order: 40 -audience: internal +audience: dev --- Terse act-without-guessing reference. Owner service: **`hiveops-aria`** (port **8095**, DB **`hiveiq_aria`**). Frontend: `hiveops-aria/frontend/src/components/Dashboard.svelte`. diff --git a/backend/src/main/resources/content/aria/dashboard/testing.md b/backend/src/main/resources/content/aria/dashboard/testing.md index 42cedec..f5aa532 100644 --- a/backend/src/main/resources/content/aria/dashboard/testing.md +++ b/backend/src/main/resources/content/aria/dashboard/testing.md @@ -3,7 +3,7 @@ module: aria.dashboard title: Threat Dashboard tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **ARIA Threat Dashboard** (`aria.bcos.dev`) — the landing screen of the ARIA SPA. Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/aria/device-posture/architect.md b/backend/src/main/resources/content/aria/device-posture/architect.md index 365c5c3..31a6c54 100644 --- a/backend/src/main/resources/content/aria/device-posture/architect.md +++ b/backend/src/main/resources/content/aria/device-posture/architect.md @@ -3,7 +3,7 @@ module: aria.device-posture title: Device Posture tab: Architect order: 30 -audience: internal +audience: dev --- > **How Device Posture is built.** Grounded in `hiveops-aria` backend + `hiveops-agent/hiveops-module-aria-signals`. See also [technical.aria] for the wider ARIA service. Cross-links: [platform.data-architecture], [platform.kafka], [platform.service-ownership]. diff --git a/backend/src/main/resources/content/aria/device-posture/claude.md b/backend/src/main/resources/content/aria/device-posture/claude.md index 6f1b07f..8929b5f 100644 --- a/backend/src/main/resources/content/aria/device-posture/claude.md +++ b/backend/src/main/resources/content/aria/device-posture/claude.md @@ -3,7 +3,7 @@ module: aria.device-posture title: Device Posture tab: Claude order: 40 -audience: internal +audience: dev --- > Terse agent reference. Every item below confirmed in `hiveops-aria` + `hiveops-agent/hiveops-module-aria-signals`. Act without guessing. diff --git a/backend/src/main/resources/content/aria/device-posture/testing.md b/backend/src/main/resources/content/aria/device-posture/testing.md index a22c096..01b422d 100644 --- a/backend/src/main/resources/content/aria/device-posture/testing.md +++ b/backend/src/main/resources/content/aria/device-posture/testing.md @@ -3,7 +3,7 @@ module: aria.device-posture title: Device Posture tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Device Posture** (`aria.bcos.dev`). Click through in the UI and mark each row Pass or Fail. This screen is **read-only** — there is nothing to create, edit, or delete. diff --git a/backend/src/main/resources/content/aria/ioc-feeds/architect.md b/backend/src/main/resources/content/aria/ioc-feeds/architect.md index f122552..8d762bb 100644 --- a/backend/src/main/resources/content/aria/ioc-feeds/architect.md +++ b/backend/src/main/resources/content/aria/ioc-feeds/architect.md @@ -3,7 +3,7 @@ module: aria.ioc-feeds title: IOC Feeds tab: Architect order: 30 -audience: internal +audience: dev --- How the **IOC Feeds** feature is built. Everything for this feature lives inside **`hiveops-aria`** — it does not call any other HiveIQ service. Cross-link [platform.service-ownership]. diff --git a/backend/src/main/resources/content/aria/ioc-feeds/claude.md b/backend/src/main/resources/content/aria/ioc-feeds/claude.md index 5c901b4..6aad59e 100644 --- a/backend/src/main/resources/content/aria/ioc-feeds/claude.md +++ b/backend/src/main/resources/content/aria/ioc-feeds/claude.md @@ -3,7 +3,7 @@ module: aria.ioc-feeds title: IOC Feeds tab: Claude order: 40 -audience: internal +audience: dev --- Terse agent reference. Everything below is confirmed in `hiveops-aria` source. diff --git a/backend/src/main/resources/content/aria/ioc-feeds/testing.md b/backend/src/main/resources/content/aria/ioc-feeds/testing.md index e433df0..a55e306 100644 --- a/backend/src/main/resources/content/aria/ioc-feeds/testing.md +++ b/backend/src/main/resources/content/aria/ioc-feeds/testing.md @@ -3,7 +3,7 @@ module: aria.ioc-feeds title: IOC Feeds tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **IOC Feeds** in ARIA (`aria.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/aria/ioc-management/architect.md b/backend/src/main/resources/content/aria/ioc-management/architect.md index bceae19..9f3e71d 100644 --- a/backend/src/main/resources/content/aria/ioc-management/architect.md +++ b/backend/src/main/resources/content/aria/ioc-management/architect.md @@ -3,7 +3,7 @@ module: aria.ioc-management title: IOC Management tab: Architect order: 30 -audience: internal +audience: dev --- How the IOC watchlist is built and how it plugs into ARIA's threat pipeline. Cross-link [platform.service-ownership], [platform.data-architecture], [platform.kafka]. diff --git a/backend/src/main/resources/content/aria/ioc-management/claude.md b/backend/src/main/resources/content/aria/ioc-management/claude.md index 7cb331b..ed19e2a 100644 --- a/backend/src/main/resources/content/aria/ioc-management/claude.md +++ b/backend/src/main/resources/content/aria/ioc-management/claude.md @@ -3,7 +3,7 @@ module: aria.ioc-management title: IOC Management tab: Claude order: 40 -audience: internal +audience: dev --- Terse act-without-guessing reference. Owning service: **`hiveops-aria`** (port 8095, DB `hiveiq_aria`). Frontend: `hiveops-aria/frontend/src/components/IocManagement.svelte` via `ariaApi` → base `/api/aria`. diff --git a/backend/src/main/resources/content/aria/ioc-management/testing.md b/backend/src/main/resources/content/aria/ioc-management/testing.md index 4eda328..c65d9a8 100644 --- a/backend/src/main/resources/content/aria/ioc-management/testing.md +++ b/backend/src/main/resources/content/aria/ioc-management/testing.md @@ -3,7 +3,7 @@ module: aria.ioc-management title: IOC Management tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **IOC Management** in ARIA (`aria.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/aria/precursor-alerts/architect.md b/backend/src/main/resources/content/aria/precursor-alerts/architect.md index 6ca25ba..20ee493 100644 --- a/backend/src/main/resources/content/aria/precursor-alerts/architect.md +++ b/backend/src/main/resources/content/aria/precursor-alerts/architect.md @@ -3,7 +3,7 @@ module: aria.precursor-alerts title: Precursor Alerts tab: Architect order: 30 -audience: internal +audience: dev --- How the **Precursor Alerts** feature is built. Everything lives in **hiveops-aria** (port 8095, DB `hiveiq_aria`). ARIA owns detection end-to-end — it does not read another service's tables to build alerts. See [platform.service-ownership]. diff --git a/backend/src/main/resources/content/aria/precursor-alerts/claude.md b/backend/src/main/resources/content/aria/precursor-alerts/claude.md index 546ec35..1012347 100644 --- a/backend/src/main/resources/content/aria/precursor-alerts/claude.md +++ b/backend/src/main/resources/content/aria/precursor-alerts/claude.md @@ -3,7 +3,7 @@ module: aria.precursor-alerts title: Precursor Alerts tab: Claude order: 40 -audience: internal +audience: dev --- Terse agent reference. Owned by **hiveops-aria** (port 8095, DB `hiveiq_aria`). All facts below confirmed in code. diff --git a/backend/src/main/resources/content/aria/precursor-alerts/testing.md b/backend/src/main/resources/content/aria/precursor-alerts/testing.md index 2ba7f89..7fefe09 100644 --- a/backend/src/main/resources/content/aria/precursor-alerts/testing.md +++ b/backend/src/main/resources/content/aria/precursor-alerts/testing.md @@ -3,7 +3,7 @@ module: aria.precursor-alerts title: Precursor Alerts tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Precursor Alerts** (`aria.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/aria/threat-events/architect.md b/backend/src/main/resources/content/aria/threat-events/architect.md index 5e7b36e..4508517 100644 --- a/backend/src/main/resources/content/aria/threat-events/architect.md +++ b/backend/src/main/resources/content/aria/threat-events/architect.md @@ -3,7 +3,7 @@ module: aria.threat-events title: Threat Events tab: Architect order: 30 -audience: internal +audience: dev --- How the **Threat Events** feature is built. It is owned end-to-end by **`hiveops-aria`** (the threat-intelligence service, `spring.application.name=hiveops-aria`, DB `hiveiq_aria`). The screen is a thin read view; the interesting work happens in the ingest → classify → store → (optionally) publish pipeline. Cross-link [platform.service-ownership], [platform.data-architecture], [platform.kafka]. diff --git a/backend/src/main/resources/content/aria/threat-events/claude.md b/backend/src/main/resources/content/aria/threat-events/claude.md index 3a45d8a..fdb9f48 100644 --- a/backend/src/main/resources/content/aria/threat-events/claude.md +++ b/backend/src/main/resources/content/aria/threat-events/claude.md @@ -3,7 +3,7 @@ module: aria.threat-events title: Threat Events tab: Claude order: 40 -audience: internal +audience: dev --- Terse act-without-guessing reference. Owner service: **`hiveops-aria`** (`hiveiq_aria` DB, port 8095). All facts below confirmed in `hiveops-aria` source. diff --git a/backend/src/main/resources/content/aria/threat-events/testing.md b/backend/src/main/resources/content/aria/threat-events/testing.md index 4ab4a04..7515490 100644 --- a/backend/src/main/resources/content/aria/threat-events/testing.md +++ b/backend/src/main/resources/content/aria/threat-events/testing.md @@ -3,7 +3,7 @@ module: aria.threat-events title: Threat Events tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Threat Events** (`aria.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/claims/claim-detail/architect.md b/backend/src/main/resources/content/claims/claim-detail/architect.md index d33b871..215bd49 100644 --- a/backend/src/main/resources/content/claims/claim-detail/architect.md +++ b/backend/src/main/resources/content/claims/claim-detail/architect.md @@ -3,7 +3,7 @@ module: claims.claim-detail title: Claim Detail tab: Architect order: 30 -audience: internal +audience: dev --- How the **Claim Detail** panel is built end-to-end. See [platform.service-ownership] — this feature is owned entirely by **hiveops-claims**; no other HiveOps service is called for claim, message, note, attachment, or payment data. The only external dependency is the device mirror (below). diff --git a/backend/src/main/resources/content/claims/claim-detail/claude.md b/backend/src/main/resources/content/claims/claim-detail/claude.md index d87ed94..01a5c26 100644 --- a/backend/src/main/resources/content/claims/claim-detail/claude.md +++ b/backend/src/main/resources/content/claims/claim-detail/claude.md @@ -3,7 +3,7 @@ module: claims.claim-detail title: Claim Detail tab: Claude order: 40 -audience: internal +audience: dev --- Terse agent reference for the **Claim Detail** panel (`ClaimPanel.svelte`). diff --git a/backend/src/main/resources/content/claims/claim-detail/testing.md b/backend/src/main/resources/content/claims/claim-detail/testing.md index 3540b3f..bdade7f 100644 --- a/backend/src/main/resources/content/claims/claim-detail/testing.md +++ b/backend/src/main/resources/content/claims/claim-detail/testing.md @@ -3,7 +3,7 @@ module: claims.claim-detail title: Claim Detail tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Claim Detail** panel (`claims.bcos.dev`). Open a claim, click through each tab, and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/claims/dashboard/architect.md b/backend/src/main/resources/content/claims/dashboard/architect.md index 922288c..0c56f2e 100644 --- a/backend/src/main/resources/content/claims/dashboard/architect.md +++ b/backend/src/main/resources/content/claims/dashboard/architect.md @@ -3,7 +3,7 @@ module: claims.dashboard title: Claims Dashboard tab: Architect order: 30 -audience: internal +audience: dev --- How the **Claims Dashboard** is built. It is a thin read view over one service — **hiveops-claims** owns all the data it shows. See [platform.service-ownership]. diff --git a/backend/src/main/resources/content/claims/dashboard/claude.md b/backend/src/main/resources/content/claims/dashboard/claude.md index 67b0707..09b22b5 100644 --- a/backend/src/main/resources/content/claims/dashboard/claude.md +++ b/backend/src/main/resources/content/claims/dashboard/claude.md @@ -3,7 +3,7 @@ module: claims.dashboard title: Claims Dashboard tab: Claude order: 40 -audience: internal +audience: dev --- Terse agent reference for the Claims Dashboard view. Owner service: **hiveops-claims** (`hiveiq-claims`, port 8092, image `hiveiq-claims`). Frontend: `Dashboard.svelte` in `hiveops-claims/frontend`. diff --git a/backend/src/main/resources/content/claims/dashboard/testing.md b/backend/src/main/resources/content/claims/dashboard/testing.md index 4cf115c..1bfab10 100644 --- a/backend/src/main/resources/content/claims/dashboard/testing.md +++ b/backend/src/main/resources/content/claims/dashboard/testing.md @@ -3,7 +3,7 @@ module: claims.dashboard title: Claims Dashboard tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Claims Dashboard** (`claims.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/claims/settings/architect.md b/backend/src/main/resources/content/claims/settings/architect.md index 1536c75..4c2fa95 100644 --- a/backend/src/main/resources/content/claims/settings/architect.md +++ b/backend/src/main/resources/content/claims/settings/architect.md @@ -3,7 +3,7 @@ module: claims.settings title: Settings tab: Architect order: 30 -audience: internal +audience: dev --- How the Claims **Settings** (vendor email templates) feature is built. Single-service, synchronous, DB-backed — **no Kafka, no executor/record-store pattern** in this feature. See [platform.service-ownership]. diff --git a/backend/src/main/resources/content/claims/settings/claude.md b/backend/src/main/resources/content/claims/settings/claude.md index 0266fd6..cbbd138 100644 --- a/backend/src/main/resources/content/claims/settings/claude.md +++ b/backend/src/main/resources/content/claims/settings/claude.md @@ -3,7 +3,7 @@ module: claims.settings title: Settings tab: Claude order: 40 -audience: internal +audience: dev --- Terse reference. Feature = **vendor email templates** shown on the Claims Settings screen (read-only display of the *effective* template). diff --git a/backend/src/main/resources/content/claims/settings/testing.md b/backend/src/main/resources/content/claims/settings/testing.md index 338c0a3..399d2f4 100644 --- a/backend/src/main/resources/content/claims/settings/testing.md +++ b/backend/src/main/resources/content/claims/settings/testing.md @@ -3,7 +3,7 @@ module: claims.settings title: Settings tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Claims → Settings** (`claims.bcos.dev`). The Settings screen is a **read-only** view of the effective vendor-email template — there is nothing to create or edit here. Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/claims/vendors/architect.md b/backend/src/main/resources/content/claims/vendors/architect.md index d36d291..e6ef5dc 100644 --- a/backend/src/main/resources/content/claims/vendors/architect.md +++ b/backend/src/main/resources/content/claims/vendors/architect.md @@ -3,7 +3,7 @@ module: claims.vendors title: Vendors tab: Architect order: 30 -audience: internal +audience: dev --- > **Internal · architecture.** How the Vendor Registry feature is built. All facts grounded in hiveops-claims source (2026-07-01). See [platform.service-ownership], [platform.data-architecture], [platform.kafka]. diff --git a/backend/src/main/resources/content/claims/vendors/claude.md b/backend/src/main/resources/content/claims/vendors/claude.md index 832d112..4e16f3e 100644 --- a/backend/src/main/resources/content/claims/vendors/claude.md +++ b/backend/src/main/resources/content/claims/vendors/claude.md @@ -3,7 +3,7 @@ module: claims.vendors title: Vendors tab: Claude order: 40 -audience: internal +audience: dev --- > Act-without-guessing reference. All items code-confirmed in hiveops-claims (2026-07-01) unless marked (unverified). diff --git a/backend/src/main/resources/content/claims/vendors/testing.md b/backend/src/main/resources/content/claims/vendors/testing.md index 4766fb2..c993c64 100644 --- a/backend/src/main/resources/content/claims/vendors/testing.md +++ b/backend/src/main/resources/content/claims/vendors/testing.md @@ -3,7 +3,7 @@ module: claims.vendors title: Vendors tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Vendor Registry** (`claims.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/dashboard/cash-stats/architect.md b/backend/src/main/resources/content/dashboard/cash-stats/architect.md index 6d06cef..aca6871 100644 --- a/backend/src/main/resources/content/dashboard/cash-stats/architect.md +++ b/backend/src/main/resources/content/dashboard/cash-stats/architect.md @@ -3,7 +3,7 @@ module: dashboard.cash-stats title: Cash Stats tab: Architect order: 30 -audience: internal +audience: dev --- How the **Cash Stats** page is built end-to-end. It is a thin read view over data that another service derives — the interesting work happens in `hiveops-journal`, not in the dashboard. See [platform.service-ownership]. diff --git a/backend/src/main/resources/content/dashboard/cash-stats/claude.md b/backend/src/main/resources/content/dashboard/cash-stats/claude.md index 1c8b6e7..afcdd9a 100644 --- a/backend/src/main/resources/content/dashboard/cash-stats/claude.md +++ b/backend/src/main/resources/content/dashboard/cash-stats/claude.md @@ -3,7 +3,7 @@ module: dashboard.cash-stats title: Cash Stats tab: Claude order: 40 -audience: internal +audience: dev --- Terse agent reference for `dashboard.cash-stats`. Read view over cassette bill counts. diff --git a/backend/src/main/resources/content/dashboard/cash-stats/testing.md b/backend/src/main/resources/content/dashboard/cash-stats/testing.md index 9556c61..70a0e09 100644 --- a/backend/src/main/resources/content/dashboard/cash-stats/testing.md +++ b/backend/src/main/resources/content/dashboard/cash-stats/testing.md @@ -3,7 +3,7 @@ module: dashboard.cash-stats title: Cash Stats tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Cash Stats** page (`dashboard.bcos.dev`). Click through in the UI and mark each row Pass or Fail. The page is **read-only** — there is nothing to create, edit, or delete, so testing is about what you can **see** and **filter**. diff --git a/backend/src/main/resources/content/dashboard/overview/architect.md b/backend/src/main/resources/content/dashboard/overview/architect.md index 4364710..a100e79 100644 --- a/backend/src/main/resources/content/dashboard/overview/architect.md +++ b/backend/src/main/resources/content/dashboard/overview/architect.md @@ -3,7 +3,7 @@ module: dashboard.overview title: Fleet Overview tab: Architect order: 30 -audience: internal +audience: dev --- ## Shape of the feature diff --git a/backend/src/main/resources/content/dashboard/overview/claude.md b/backend/src/main/resources/content/dashboard/overview/claude.md index 1539ea1..28041a2 100644 --- a/backend/src/main/resources/content/dashboard/overview/claude.md +++ b/backend/src/main/resources/content/dashboard/overview/claude.md @@ -3,7 +3,7 @@ module: dashboard.overview title: Fleet Overview tab: Claude order: 40 -audience: internal +audience: dev --- ## Identity diff --git a/backend/src/main/resources/content/dashboard/overview/testing.md b/backend/src/main/resources/content/dashboard/overview/testing.md index e82ca34..ce81a5b 100644 --- a/backend/src/main/resources/content/dashboard/overview/testing.md +++ b/backend/src/main/resources/content/dashboard/overview/testing.md @@ -3,7 +3,7 @@ module: dashboard.overview title: Fleet Overview tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Fleet Overview** landing page (`dashboard.bcos.dev`). Click through in the UI and mark each row Pass or Fail. This screen is **read-only** — there is nothing to create, edit, or delete, so testing focuses on what each card shows and on role scoping. diff --git a/backend/src/main/resources/content/devices/agent-profile/architect.md b/backend/src/main/resources/content/devices/agent-profile/architect.md index 1869e4e..929e623 100644 --- a/backend/src/main/resources/content/devices/agent-profile/architect.md +++ b/backend/src/main/resources/content/devices/agent-profile/architect.md @@ -3,7 +3,7 @@ module: devices.agent-profile title: Agent Profile tab: Architect order: 30 -audience: internal +audience: dev --- How the **Agent Profile** feature is built end to end. Profiles are lightweight hardware-grouping records; the "which modules" logic is resolved at render time by joining profile records against a CDN-hosted module manifest. See [platform.service-ownership], [platform.data-architecture], [platform.kafka]. diff --git a/backend/src/main/resources/content/devices/agent-profile/claude.md b/backend/src/main/resources/content/devices/agent-profile/claude.md index 41826a5..95513e8 100644 --- a/backend/src/main/resources/content/devices/agent-profile/claude.md +++ b/backend/src/main/resources/content/devices/agent-profile/claude.md @@ -3,7 +3,7 @@ module: devices.agent-profile title: Agent Profile tab: Claude order: 40 -audience: internal +audience: dev --- Terse act-without-guessing reference. Feature = hardware profiles controlling agent module provisioning. diff --git a/backend/src/main/resources/content/devices/agent-profile/testing.md b/backend/src/main/resources/content/devices/agent-profile/testing.md index c0c48e2..481ebac 100644 --- a/backend/src/main/resources/content/devices/agent-profile/testing.md +++ b/backend/src/main/resources/content/devices/agent-profile/testing.md @@ -3,7 +3,7 @@ module: devices.agent-profile title: Agent Profile tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Agent Profile** (Devices › Settings › Agent Profile, `devices.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/devices/agent-scripts/architect.md b/backend/src/main/resources/content/devices/agent-scripts/architect.md index bdc73f2..4c1e700 100644 --- a/backend/src/main/resources/content/devices/agent-scripts/architect.md +++ b/backend/src/main/resources/content/devices/agent-scripts/architect.md @@ -3,7 +3,7 @@ module: devices.agent-scripts title: Agent Scripts tab: Architect order: 30 -audience: internal +audience: dev --- > **Architect · internal.** Written 2026-07-01 from source. Describes both what is **built** (a devices-owned CRUD store) and the **intended** signed-delivery pipeline that partly exists in hiveops-fleet + the agent but is **not yet connected** to this module's Push action. diff --git a/backend/src/main/resources/content/devices/agent-scripts/claude.md b/backend/src/main/resources/content/devices/agent-scripts/claude.md index cc0122f..8f0a85a 100644 --- a/backend/src/main/resources/content/devices/agent-scripts/claude.md +++ b/backend/src/main/resources/content/devices/agent-scripts/claude.md @@ -3,7 +3,7 @@ module: devices.agent-scripts title: Agent Scripts tab: Claude order: 40 -audience: internal +audience: dev --- > Act-without-guessing reference. Only confirmed facts (hiveops-devices source, 2026-07-01). diff --git a/backend/src/main/resources/content/devices/agent-scripts/testing.md b/backend/src/main/resources/content/devices/agent-scripts/testing.md index 04be6f3..198e4fa 100644 --- a/backend/src/main/resources/content/devices/agent-scripts/testing.md +++ b/backend/src/main/resources/content/devices/agent-scripts/testing.md @@ -3,7 +3,7 @@ module: devices.agent-scripts title: Agent Scripts tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Agent Scripts** (`devices.bcos.dev` → **Settings → Agent Scripts**). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/devices/config-audit/architect.md b/backend/src/main/resources/content/devices/config-audit/architect.md index fd45c49..833f576 100644 --- a/backend/src/main/resources/content/devices/config-audit/architect.md +++ b/backend/src/main/resources/content/devices/config-audit/architect.md @@ -3,7 +3,7 @@ module: devices.config-audit title: Config Audit tab: Architect order: 30 -audience: internal +audience: dev --- > **Internal · architecture view.** How Config Audit is built inside `hiveops-devices`. Grounded in source 2026-07-01. diff --git a/backend/src/main/resources/content/devices/config-audit/claude.md b/backend/src/main/resources/content/devices/config-audit/claude.md index 39e27c0..5786cac 100644 --- a/backend/src/main/resources/content/devices/config-audit/claude.md +++ b/backend/src/main/resources/content/devices/config-audit/claude.md @@ -3,7 +3,7 @@ module: devices.config-audit title: Config Audit tab: Claude order: 40 -audience: internal +audience: dev --- > Terse agent reference. All facts below verified in `hiveops-devices` source (2026-07-01). diff --git a/backend/src/main/resources/content/devices/config-audit/testing.md b/backend/src/main/resources/content/devices/config-audit/testing.md index 1a45155..07973bb 100644 --- a/backend/src/main/resources/content/devices/config-audit/testing.md +++ b/backend/src/main/resources/content/devices/config-audit/testing.md @@ -3,7 +3,7 @@ module: devices.config-audit title: Config Audit tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Config Audit** in the Devices app (`devices.bcos.dev` → **Settings → Config Audit**, header reads **Config Change Audit**). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/devices/device-detail/architect.md b/backend/src/main/resources/content/devices/device-detail/architect.md index 959c5bd..f41f490 100644 --- a/backend/src/main/resources/content/devices/device-detail/architect.md +++ b/backend/src/main/resources/content/devices/device-detail/architect.md @@ -3,7 +3,7 @@ module: devices.device-detail title: Device Detail tab: Architect order: 30 -audience: internal +audience: dev --- How the single-device page is built. Component `AtmDetail.svelte` (~4.2k lines) is a tabbed shell; the "Details" surface is owned by **hiveops-devices**, but the page is a **multi-service aggregator** — most tabs fan out to other backends. See [platform.service-ownership] and [technical.devices]. diff --git a/backend/src/main/resources/content/devices/device-detail/claude.md b/backend/src/main/resources/content/devices/device-detail/claude.md index bb6f2d8..578755d 100644 --- a/backend/src/main/resources/content/devices/device-detail/claude.md +++ b/backend/src/main/resources/content/devices/device-detail/claude.md @@ -3,7 +3,7 @@ module: devices.device-detail title: Device Detail tab: Claude order: 40 -audience: internal +audience: dev --- Act-without-guessing reference for `devices.device-detail` (`AtmDetail.svelte`). diff --git a/backend/src/main/resources/content/devices/device-detail/testing.md b/backend/src/main/resources/content/devices/device-detail/testing.md index 482919b..fdf65e9 100644 --- a/backend/src/main/resources/content/devices/device-detail/testing.md +++ b/backend/src/main/resources/content/devices/device-detail/testing.md @@ -3,7 +3,7 @@ module: devices.device-detail title: Device Detail tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Device Detail** page (`devices.bcos.dev`). Open a device, click through the tabs and actions, and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/devices/device-groups/architect.md b/backend/src/main/resources/content/devices/device-groups/architect.md index 2a9ef2d..c0dafaa 100644 --- a/backend/src/main/resources/content/devices/device-groups/architect.md +++ b/backend/src/main/resources/content/devices/device-groups/architect.md @@ -3,7 +3,7 @@ module: devices.device-groups title: Device Groups tab: Architect order: 30 -audience: internal +audience: dev --- > **Internal · architecture.** Grounded in `hiveops-devices` backend + `AtmGroups.svelte` + `api.ts` (2026-07-01). diff --git a/backend/src/main/resources/content/devices/device-groups/claude.md b/backend/src/main/resources/content/devices/device-groups/claude.md index ffcebb6..8f0f6f8 100644 --- a/backend/src/main/resources/content/devices/device-groups/claude.md +++ b/backend/src/main/resources/content/devices/device-groups/claude.md @@ -3,7 +3,7 @@ module: devices.device-groups title: Device Groups tab: Claude order: 40 -audience: internal +audience: dev --- ## Owner diff --git a/backend/src/main/resources/content/devices/device-groups/testing.md b/backend/src/main/resources/content/devices/device-groups/testing.md index d2415e4..014e6c3 100644 --- a/backend/src/main/resources/content/devices/device-groups/testing.md +++ b/backend/src/main/resources/content/devices/device-groups/testing.md @@ -3,7 +3,7 @@ module: devices.device-groups title: Device Groups tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Device Groups** (`devices.bcos.dev` → **Device Groups**). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/devices/device-list/architect.md b/backend/src/main/resources/content/devices/device-list/architect.md index 885ec81..f567da4 100644 --- a/backend/src/main/resources/content/devices/device-list/architect.md +++ b/backend/src/main/resources/content/devices/device-list/architect.md @@ -3,7 +3,7 @@ module: devices.device-list title: Device List tab: Architect order: 30 -audience: internal +audience: dev --- How the Device List is built. Frontend: `hiveops-devices/frontend/src/components/AtmManagement/AtmList.svelte`. Backend of record: **hiveops-devices** (Spring Boot, port **8096**, DB `hiveiq_devices`). See [platform.service-ownership], [platform.data-architecture], [platform.kafka]. diff --git a/backend/src/main/resources/content/devices/device-list/claude.md b/backend/src/main/resources/content/devices/device-list/claude.md index d8ea48d..cf9c28a 100644 --- a/backend/src/main/resources/content/devices/device-list/claude.md +++ b/backend/src/main/resources/content/devices/device-list/claude.md @@ -3,7 +3,7 @@ module: devices.device-list title: Device List tab: Claude order: 40 -audience: internal +audience: dev --- Terse agent reference. Frontend: `hiveops-devices/frontend/src/components/AtmManagement/AtmList.svelte`. diff --git a/backend/src/main/resources/content/devices/device-list/testing.md b/backend/src/main/resources/content/devices/device-list/testing.md index d122eee..fc3e424 100644 --- a/backend/src/main/resources/content/devices/device-list/testing.md +++ b/backend/src/main/resources/content/devices/device-list/testing.md @@ -3,7 +3,7 @@ module: devices.device-list title: Device List tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Device List** (`devices.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/devices/map/architect.md b/backend/src/main/resources/content/devices/map/architect.md index c6a58a8..ab2859f 100644 --- a/backend/src/main/resources/content/devices/map/architect.md +++ b/backend/src/main/resources/content/devices/map/architect.md @@ -3,7 +3,7 @@ module: devices.map title: Map tab: Architect order: 30 -audience: internal +audience: dev --- > **Internal · architecture.** Grounded in `AtmMap.svelte`, `frontend/src/lib/{api,stores}.ts`, and the devices/incident controllers, 2026-07-01. diff --git a/backend/src/main/resources/content/devices/map/claude.md b/backend/src/main/resources/content/devices/map/claude.md index 3bdbfae..282b759 100644 --- a/backend/src/main/resources/content/devices/map/claude.md +++ b/backend/src/main/resources/content/devices/map/claude.md @@ -3,7 +3,7 @@ module: devices.map title: Map tab: Claude order: 40 -audience: internal +audience: dev --- > Terse agent reference. Grounded in `AtmMap.svelte`, `lib/api.ts`, `lib/stores.ts`, `AtmController`, `AtmGroupController`, `IncidentController` (2026-07-01). Read-only view — no writes, no dedicated backend. diff --git a/backend/src/main/resources/content/devices/map/testing.md b/backend/src/main/resources/content/devices/map/testing.md index 6a45ff3..58258f4 100644 --- a/backend/src/main/resources/content/devices/map/testing.md +++ b/backend/src/main/resources/content/devices/map/testing.md @@ -3,7 +3,7 @@ module: devices.map title: Map tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Fleet Map** (`devices.bcos.dev` → **Map**). It's a read-only view — no create/edit/delete. Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/devices/sw-deploy/architect.md b/backend/src/main/resources/content/devices/sw-deploy/architect.md index aa585a8..822edfd 100644 --- a/backend/src/main/resources/content/devices/sw-deploy/architect.md +++ b/backend/src/main/resources/content/devices/sw-deploy/architect.md @@ -3,7 +3,7 @@ module: devices.sw-deploy title: Software Deployment tab: Architect order: 30 -audience: internal +audience: dev --- > **Internal · architecture.** Written 2026-07-01 from `hiveops-devices/frontend` + `hiveops-fleet/backend`. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/devices/sw-deploy/claude.md b/backend/src/main/resources/content/devices/sw-deploy/claude.md index 5f7c13e..00b8768 100644 --- a/backend/src/main/resources/content/devices/sw-deploy/claude.md +++ b/backend/src/main/resources/content/devices/sw-deploy/claude.md @@ -3,7 +3,7 @@ module: devices.sw-deploy title: Software Deployment tab: Claude order: 40 -audience: internal +audience: dev --- **Owner service:** `hiveops-fleet` (port **8097**, DB **`hiveiq_fleet`**). Frontend `DeviceSoftwareTab.svelte` lives in `hiveops-devices` but calls fleet only. NOT owned by devices/incident. diff --git a/backend/src/main/resources/content/devices/sw-deploy/testing.md b/backend/src/main/resources/content/devices/sw-deploy/testing.md index 18a7e26..55a0d98 100644 --- a/backend/src/main/resources/content/devices/sw-deploy/testing.md +++ b/backend/src/main/resources/content/devices/sw-deploy/testing.md @@ -3,7 +3,7 @@ module: devices.sw-deploy title: Software Deployment tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **SW Deploy** tab (`devices.bcos.dev` → open a device → **SW Deploy** tab). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/fleet/artifacts/architect.md b/backend/src/main/resources/content/fleet/artifacts/architect.md index d0f11e5..a73b0cf 100644 --- a/backend/src/main/resources/content/fleet/artifacts/architect.md +++ b/backend/src/main/resources/content/fleet/artifacts/architect.md @@ -3,7 +3,7 @@ module: fleet.artifacts title: Artifact Import Guide tab: Architect order: 30 -audience: internal +audience: dev --- > How artifact import is built inside **hiveops-fleet**. Scope: the `fleet_artifacts` lifecycle — CDN import, multipart upload, and how an agent ultimately gets the bytes. Cross-link [platform.data-architecture], [platform.kafka]. diff --git a/backend/src/main/resources/content/fleet/artifacts/claude.md b/backend/src/main/resources/content/fleet/artifacts/claude.md index 1b0b04e..dca591c 100644 --- a/backend/src/main/resources/content/fleet/artifacts/claude.md +++ b/backend/src/main/resources/content/fleet/artifacts/claude.md @@ -3,7 +3,7 @@ module: fleet.artifacts title: Artifact Import Guide tab: Claude order: 40 -audience: internal +audience: dev --- > Act-without-guessing cheat-sheet. Owner service: **hiveops-fleet** (`com.hiveops.fleet`, port 8097, DB `hiveiq_fleet`). Never write artifact data anywhere else. diff --git a/backend/src/main/resources/content/fleet/artifacts/testing.md b/backend/src/main/resources/content/fleet/artifacts/testing.md index 8fab8fd..2a94f7e 100644 --- a/backend/src/main/resources/content/fleet/artifacts/testing.md +++ b/backend/src/main/resources/content/fleet/artifacts/testing.md @@ -3,7 +3,7 @@ module: fleet.artifacts title: Artifact Import Guide tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Fleet → Artifacts** (`fleet.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/fleet/dashboard/architect.md b/backend/src/main/resources/content/fleet/dashboard/architect.md index 8554686..04fcfc4 100644 --- a/backend/src/main/resources/content/fleet/dashboard/architect.md +++ b/backend/src/main/resources/content/fleet/dashboard/architect.md @@ -3,7 +3,7 @@ module: fleet.dashboard title: Fleet Dashboard tab: Architect order: 30 -audience: internal +audience: dev --- How the **Fleet Stats** dashboard is built. It is a thin read-only view over hiveops-fleet's own database — no cross-service HTTP at request time. Cross-link [platform.service-ownership], [platform.data-architecture], [platform.kafka]. diff --git a/backend/src/main/resources/content/fleet/dashboard/claude.md b/backend/src/main/resources/content/fleet/dashboard/claude.md index 0d94670..2c51a07 100644 --- a/backend/src/main/resources/content/fleet/dashboard/claude.md +++ b/backend/src/main/resources/content/fleet/dashboard/claude.md @@ -3,7 +3,7 @@ module: fleet.dashboard title: Fleet Dashboard tab: Claude order: 40 -audience: internal +audience: dev --- Terse agent reference for the **Fleet Stats** dashboard (`FleetDashboard.svelte`). diff --git a/backend/src/main/resources/content/fleet/dashboard/testing.md b/backend/src/main/resources/content/fleet/dashboard/testing.md index bdc876d..a1000e7 100644 --- a/backend/src/main/resources/content/fleet/dashboard/testing.md +++ b/backend/src/main/resources/content/fleet/dashboard/testing.md @@ -3,7 +3,7 @@ module: fleet.dashboard title: Fleet Dashboard tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Fleet Stats** dashboard (`fleet.bcos.dev`). It is a read-only screen — no create/edit/delete. Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/fleet/modules/architect.md b/backend/src/main/resources/content/fleet/modules/architect.md index 692a41c..a6d8d1b 100644 --- a/backend/src/main/resources/content/fleet/modules/architect.md +++ b/backend/src/main/resources/content/fleet/modules/architect.md @@ -3,7 +3,7 @@ module: fleet.modules title: Modules tab: Architect order: 30 -audience: internal +audience: dev --- > **Internal · architecture.** Written 2026-07-01 from `hiveops-fleet` source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/fleet/modules/claude.md b/backend/src/main/resources/content/fleet/modules/claude.md index 92cfce4..866c70c 100644 --- a/backend/src/main/resources/content/fleet/modules/claude.md +++ b/backend/src/main/resources/content/fleet/modules/claude.md @@ -3,7 +3,7 @@ module: fleet.modules title: Modules tab: Claude order: 40 -audience: internal +audience: dev --- > **Internal · agent reference.** Terse. Confirmed against `hiveops-fleet` source 2026-07-01. diff --git a/backend/src/main/resources/content/fleet/modules/testing.md b/backend/src/main/resources/content/fleet/modules/testing.md index b32f3ba..f358443 100644 --- a/backend/src/main/resources/content/fleet/modules/testing.md +++ b/backend/src/main/resources/content/fleet/modules/testing.md @@ -3,7 +3,7 @@ module: fleet.modules title: Modules tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Agent Modules** screen (`fleet.bcos.dev`). This screen is a read-only reference catalog — there is nothing to create, edit, or delete. Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/fleet/patch-windows/architect.md b/backend/src/main/resources/content/fleet/patch-windows/architect.md index 2507e53..83e7f2d 100644 --- a/backend/src/main/resources/content/fleet/patch-windows/architect.md +++ b/backend/src/main/resources/content/fleet/patch-windows/architect.md @@ -3,7 +3,7 @@ module: fleet.patch-windows title: Patch Window Guide tab: Architect order: 30 -audience: internal +audience: dev --- How HiveIQ Patch Windows are built. Everything lives inside **hiveops-fleet** (`com.hiveops.fleet`, Spring Boot 3.4, port 8097, DB `hiveiq_fleet`). Patch windows are a scheduling overlay on the existing fleet-task pipeline — no dedicated microservice. Cross-link [platform.data-architecture], [platform.kafka]. diff --git a/backend/src/main/resources/content/fleet/patch-windows/claude.md b/backend/src/main/resources/content/fleet/patch-windows/claude.md index f3b4ce2..430be15 100644 --- a/backend/src/main/resources/content/fleet/patch-windows/claude.md +++ b/backend/src/main/resources/content/fleet/patch-windows/claude.md @@ -3,7 +3,7 @@ module: fleet.patch-windows title: Patch Window Guide tab: Claude order: 40 -audience: internal +audience: dev --- Act-without-guessing cheat-sheet. Everything confirmed in `hiveops-fleet` source. diff --git a/backend/src/main/resources/content/fleet/patch-windows/testing.md b/backend/src/main/resources/content/fleet/patch-windows/testing.md index 6dade7a..e22b5c5 100644 --- a/backend/src/main/resources/content/fleet/patch-windows/testing.md +++ b/backend/src/main/resources/content/fleet/patch-windows/testing.md @@ -3,7 +3,7 @@ module: fleet.patch-windows title: Patch Window Guide tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Fleet → Patch Windows** (`fleet.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/fleet/tasks/architect.md b/backend/src/main/resources/content/fleet/tasks/architect.md index f19e812..c916943 100644 --- a/backend/src/main/resources/content/fleet/tasks/architect.md +++ b/backend/src/main/resources/content/fleet/tasks/architect.md @@ -3,7 +3,7 @@ module: fleet.tasks title: Fleet Task Workflow tab: Architect order: 30 -audience: internal +audience: dev --- How Fleet Task Workflow is built. Owner service: **hiveops-fleet** (`com.hiveops.fleet`, Spring Boot 3.4, port 8097, DB `hiveiq_fleet`). Frontend: `FleetManagement/FleetTasks.svelte` → `lib/api.ts` (`fleetAPI`, base `…/api/fleet`). See also [platform.data-architecture] and [platform.kafka]; service-level scope in the technical `fleet/overview` doc. diff --git a/backend/src/main/resources/content/fleet/tasks/claude.md b/backend/src/main/resources/content/fleet/tasks/claude.md index 58bff09..d0f9557 100644 --- a/backend/src/main/resources/content/fleet/tasks/claude.md +++ b/backend/src/main/resources/content/fleet/tasks/claude.md @@ -3,7 +3,7 @@ module: fleet.tasks title: Fleet Task Workflow tab: Claude order: 40 -audience: internal +audience: dev --- Act-without-guessing cheat-sheet. Owner service: **hiveops-fleet** ONLY. diff --git a/backend/src/main/resources/content/fleet/tasks/testing.md b/backend/src/main/resources/content/fleet/tasks/testing.md index fb1e5e6..bd6228c 100644 --- a/backend/src/main/resources/content/fleet/tasks/testing.md +++ b/backend/src/main/resources/content/fleet/tasks/testing.md @@ -3,7 +3,7 @@ module: fleet.tasks title: Fleet Task Workflow tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Fleet Tasks** (`fleet.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/incident/dashboard/architect.md b/backend/src/main/resources/content/incident/dashboard/architect.md index d5e89d1..d082f33 100644 --- a/backend/src/main/resources/content/incident/dashboard/architect.md +++ b/backend/src/main/resources/content/incident/dashboard/architect.md @@ -3,7 +3,7 @@ module: incident.dashboard title: Dashboard tab: Architect order: 30 -audience: internal +audience: dev --- > **How it's built.** The Dashboard is a thin read-only aggregation view: one Svelte component, three GET endpoints, all served by **hiveops-incident**. There is no dedicated dashboard aggregation service — most of the "analytics" (trend chart, incidents-by-type, device/agent status breakdowns) is computed **client-side** in the component from two data stores. See [platform.service-ownership]. diff --git a/backend/src/main/resources/content/incident/dashboard/claude.md b/backend/src/main/resources/content/incident/dashboard/claude.md index c6b29de..e7da2a2 100644 --- a/backend/src/main/resources/content/incident/dashboard/claude.md +++ b/backend/src/main/resources/content/incident/dashboard/claude.md @@ -3,7 +3,7 @@ module: incident.dashboard title: Dashboard tab: Claude order: 40 -audience: internal +audience: dev --- ## Owner diff --git a/backend/src/main/resources/content/incident/dashboard/testing.md b/backend/src/main/resources/content/incident/dashboard/testing.md index a09b967..c65663c 100644 --- a/backend/src/main/resources/content/incident/dashboard/testing.md +++ b/backend/src/main/resources/content/incident/dashboard/testing.md @@ -3,7 +3,7 @@ module: incident.dashboard title: Dashboard tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Dashboard** (the **Overview** landing screen in the Incident app). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/incident/incident-management/architect.md b/backend/src/main/resources/content/incident/incident-management/architect.md index 0b4b224..576a893 100644 --- a/backend/src/main/resources/content/incident/incident-management/architect.md +++ b/backend/src/main/resources/content/incident/incident-management/architect.md @@ -3,7 +3,7 @@ module: incident.incident-management title: Incident Management tab: Architect order: 30 -audience: internal +audience: dev --- > How the Incident Management screen is built. Owner service: **hiveops-incident**. See [platform.service-ownership], [platform.data-architecture], [platform.kafka]. diff --git a/backend/src/main/resources/content/incident/incident-management/claude.md b/backend/src/main/resources/content/incident/incident-management/claude.md index 4ae368c..da013dd 100644 --- a/backend/src/main/resources/content/incident/incident-management/claude.md +++ b/backend/src/main/resources/content/incident/incident-management/claude.md @@ -3,7 +3,7 @@ module: incident.incident-management title: Incident Management tab: Claude order: 40 -audience: internal +audience: dev --- ## Ownership diff --git a/backend/src/main/resources/content/incident/incident-management/testing.md b/backend/src/main/resources/content/incident/incident-management/testing.md index eba34b9..dd24a05 100644 --- a/backend/src/main/resources/content/incident/incident-management/testing.md +++ b/backend/src/main/resources/content/incident/incident-management/testing.md @@ -3,7 +3,7 @@ module: incident.incident-management title: Incident Management tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Incident Management** (`incident.bcos.dev` → **Incident Mgmt › Incident List**). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/incident/incident-tracker/architect.md b/backend/src/main/resources/content/incident/incident-tracker/architect.md index 876fa91..1ca5831 100644 --- a/backend/src/main/resources/content/incident/incident-tracker/architect.md +++ b/backend/src/main/resources/content/incident/incident-tracker/architect.md @@ -3,7 +3,7 @@ module: incident.incident-tracker title: Incident Tracker tab: Architect order: 30 -audience: internal +audience: dev --- > How the Incident Tracker is built. Grounded in `hiveops-incident` frontend + backend as of 2026-07-01. See [platform.data-architecture], [platform.kafka], [platform.service-ownership]. diff --git a/backend/src/main/resources/content/incident/incident-tracker/claude.md b/backend/src/main/resources/content/incident/incident-tracker/claude.md index 2e4d6e9..a6673a1 100644 --- a/backend/src/main/resources/content/incident/incident-tracker/claude.md +++ b/backend/src/main/resources/content/incident/incident-tracker/claude.md @@ -3,7 +3,7 @@ module: incident.incident-tracker title: Incident Tracker tab: Claude order: 40 -audience: internal +audience: dev --- > Terse act-without-guessing reference. Confirmed against `hiveops-incident` code 2026-07-01. diff --git a/backend/src/main/resources/content/incident/incident-tracker/testing.md b/backend/src/main/resources/content/incident/incident-tracker/testing.md index f1a34b3..b55f489 100644 --- a/backend/src/main/resources/content/incident/incident-tracker/testing.md +++ b/backend/src/main/resources/content/incident/incident-tracker/testing.md @@ -3,7 +3,7 @@ module: incident.incident-tracker title: Incident Tracker tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Incident Tracker** board (`incident.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/incident/journal-events/architect.md b/backend/src/main/resources/content/incident/journal-events/architect.md index ea66eab..91b6ab2 100644 --- a/backend/src/main/resources/content/incident/journal-events/architect.md +++ b/backend/src/main/resources/content/incident/journal-events/architect.md @@ -3,7 +3,7 @@ module: incident.journal-events title: Journal Events tab: Architect order: 30 -audience: internal +audience: dev --- How the **Event Journal** feature is built. This module is a thin read view over the journal-event store that **hiveops-incident** owns; the write side is agent ingestion routed through **hiveops-agent-proxy**. See [platform.service-ownership]. diff --git a/backend/src/main/resources/content/incident/journal-events/claude.md b/backend/src/main/resources/content/incident/journal-events/claude.md index 0f6cfb1..f7156cd 100644 --- a/backend/src/main/resources/content/incident/journal-events/claude.md +++ b/backend/src/main/resources/content/incident/journal-events/claude.md @@ -3,7 +3,7 @@ module: incident.journal-events title: Journal Events tab: Claude order: 40 -audience: internal +audience: dev --- Act-without-guessing reference. Everything below is confirmed in code. diff --git a/backend/src/main/resources/content/incident/journal-events/testing.md b/backend/src/main/resources/content/incident/journal-events/testing.md index 5425e4f..337e08b 100644 --- a/backend/src/main/resources/content/incident/journal-events/testing.md +++ b/backend/src/main/resources/content/incident/journal-events/testing.md @@ -3,7 +3,7 @@ module: incident.journal-events title: Journal Events tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Event Journal** screen (the incident app on **bcos.dev**). This is a read-only, per-ATM event viewer — there is nothing to create, edit, or delete. Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/incident/processing-rules/architect.md b/backend/src/main/resources/content/incident/processing-rules/architect.md index 464bcd8..b301e3e 100644 --- a/backend/src/main/resources/content/incident/processing-rules/architect.md +++ b/backend/src/main/resources/content/incident/processing-rules/architect.md @@ -3,7 +3,7 @@ module: incident.processing-rules title: Processing Rules tab: Architect order: 30 -audience: internal +audience: dev --- > **Architecture view.** How Processing Rules are built and how events flow through them. All rule storage + evaluation is owned by **hiveops-incident**; Adoons suggestions are delegated to **hiveops-ai** over Kafka + a sync proxy. Grounded in code 2026-07-01. See [platform.service-ownership]. diff --git a/backend/src/main/resources/content/incident/processing-rules/claude.md b/backend/src/main/resources/content/incident/processing-rules/claude.md index 0271607..ce112af 100644 --- a/backend/src/main/resources/content/incident/processing-rules/claude.md +++ b/backend/src/main/resources/content/incident/processing-rules/claude.md @@ -3,7 +3,7 @@ module: incident.processing-rules title: Processing Rules tab: Claude order: 40 -audience: internal +audience: dev --- > Terse agent reference. Every endpoint/table/topic/role below is confirmed in hiveops-incident source (2026-07-01). Controller paths are as mapped in code; externally reached via NGINX `/api/incident/` (incident, port 8080). diff --git a/backend/src/main/resources/content/incident/processing-rules/testing.md b/backend/src/main/resources/content/incident/processing-rules/testing.md index c514a55..115c633 100644 --- a/backend/src/main/resources/content/incident/processing-rules/testing.md +++ b/backend/src/main/resources/content/incident/processing-rules/testing.md @@ -3,7 +3,7 @@ module: incident.processing-rules title: Processing Rules tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Processing Rules** (the incident app, `incident.bcos.dev`). Open the **Processing Rules** menu in the left sidebar and click through in the UI. Mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/msp/contact-groups/architect.md b/backend/src/main/resources/content/msp/contact-groups/architect.md index d8cfc53..cb5eb9d 100644 --- a/backend/src/main/resources/content/msp/contact-groups/architect.md +++ b/backend/src/main/resources/content/msp/contact-groups/architect.md @@ -3,7 +3,7 @@ module: msp.contact-groups title: Contact Groups tab: Architect order: 30 -audience: internal +audience: dev --- How the **Contact Groups** feature is built and wired. See also [platform.data-architecture], [platform.kafka], [platform.service-ownership]. diff --git a/backend/src/main/resources/content/msp/contact-groups/claude.md b/backend/src/main/resources/content/msp/contact-groups/claude.md index 078d371..a418bad 100644 --- a/backend/src/main/resources/content/msp/contact-groups/claude.md +++ b/backend/src/main/resources/content/msp/contact-groups/claude.md @@ -3,7 +3,7 @@ module: msp.contact-groups title: Contact Groups tab: Claude order: 40 -audience: internal +audience: dev --- Act-without-guessing reference. All facts confirmed in `hiveops-messaging` + `hiveops-msp` source. diff --git a/backend/src/main/resources/content/msp/contact-groups/testing.md b/backend/src/main/resources/content/msp/contact-groups/testing.md index a36b2ae..7e3c900 100644 --- a/backend/src/main/resources/content/msp/contact-groups/testing.md +++ b/backend/src/main/resources/content/msp/contact-groups/testing.md @@ -3,7 +3,7 @@ module: msp.contact-groups title: Contact Groups tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Contact Groups** (MSP app → **Contact Groups**). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/msp/institution-keys/architect.md b/backend/src/main/resources/content/msp/institution-keys/architect.md index 7a09c93..c3a2ff8 100644 --- a/backend/src/main/resources/content/msp/institution-keys/architect.md +++ b/backend/src/main/resources/content/msp/institution-keys/architect.md @@ -3,7 +3,7 @@ module: msp.institution-keys title: Institution Keys tab: Architect order: 30 -audience: internal +audience: dev --- > How it's built. Grounded in `hiveops-devices` + `hiveops-msp` code, 2026-07-01. Cross-links: [platform.data-architecture], [platform.kafka], [platform.service-ownership]. diff --git a/backend/src/main/resources/content/msp/institution-keys/claude.md b/backend/src/main/resources/content/msp/institution-keys/claude.md index f440653..320625a 100644 --- a/backend/src/main/resources/content/msp/institution-keys/claude.md +++ b/backend/src/main/resources/content/msp/institution-keys/claude.md @@ -3,7 +3,7 @@ module: msp.institution-keys title: Institution Keys tab: Claude order: 40 -audience: internal +audience: dev --- > Terse act-without-guessing reference. Confirmed against `hiveops-devices` + `hiveops-msp` code 2026-07-01. diff --git a/backend/src/main/resources/content/msp/institution-keys/testing.md b/backend/src/main/resources/content/msp/institution-keys/testing.md index 732992c..fa4ef0b 100644 --- a/backend/src/main/resources/content/msp/institution-keys/testing.md +++ b/backend/src/main/resources/content/msp/institution-keys/testing.md @@ -3,7 +3,7 @@ module: msp.institution-keys title: Institution Keys tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Institution Keys** in the MSP app (`msp.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/msp/institutions/architect.md b/backend/src/main/resources/content/msp/institutions/architect.md index 09cb5d1..9ba0409 100644 --- a/backend/src/main/resources/content/msp/institutions/architect.md +++ b/backend/src/main/resources/content/msp/institutions/architect.md @@ -3,7 +3,7 @@ module: msp.institutions title: Institutions tab: Architect order: 30 -audience: internal +audience: dev --- How the MSP **Institutions** feature is built. It is a thin Svelte SPA that composes data from **two independently-owned backends** — no aggregation layer, no message bus in the read/write path. diff --git a/backend/src/main/resources/content/msp/institutions/claude.md b/backend/src/main/resources/content/msp/institutions/claude.md index 4c7cba1..c232622 100644 --- a/backend/src/main/resources/content/msp/institutions/claude.md +++ b/backend/src/main/resources/content/msp/institutions/claude.md @@ -3,7 +3,7 @@ module: msp.institutions title: Institutions tab: Claude order: 40 -audience: internal +audience: dev --- Act-without-guessing reference. Frontend = `hiveops-msp/frontend` `Institutions/InstitutionsView.svelte` (port 5186, `msp.bcos.cloud`, image `hiveiq-msp-frontend`, no own backend). diff --git a/backend/src/main/resources/content/msp/institutions/testing.md b/backend/src/main/resources/content/msp/institutions/testing.md index ecc1d12..754bcdf 100644 --- a/backend/src/main/resources/content/msp/institutions/testing.md +++ b/backend/src/main/resources/content/msp/institutions/testing.md @@ -3,7 +3,7 @@ module: msp.institutions title: Institutions tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the MSP **Institutions** screen (`msp.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/msp/module-allocations/architect.md b/backend/src/main/resources/content/msp/module-allocations/architect.md index d946a22..5b64631 100644 --- a/backend/src/main/resources/content/msp/module-allocations/architect.md +++ b/backend/src/main/resources/content/msp/module-allocations/architect.md @@ -3,7 +3,7 @@ module: msp.module-allocations title: Module Allocations tab: Architect order: 30 -audience: internal +audience: dev --- How the **Module Allocations** feature is built. See also [platform.data-architecture], [platform.kafka], [platform.service-ownership]. diff --git a/backend/src/main/resources/content/msp/module-allocations/claude.md b/backend/src/main/resources/content/msp/module-allocations/claude.md index 39451e8..5d02564 100644 --- a/backend/src/main/resources/content/msp/module-allocations/claude.md +++ b/backend/src/main/resources/content/msp/module-allocations/claude.md @@ -3,7 +3,7 @@ module: msp.module-allocations title: Module Allocations tab: Claude order: 40 -audience: internal +audience: dev --- Terse agent reference. Frontend: `hiveops-msp/frontend` (`AllocationsView.svelte`). No dedicated backend. diff --git a/backend/src/main/resources/content/msp/module-allocations/testing.md b/backend/src/main/resources/content/msp/module-allocations/testing.md index d4aa2bb..2ad8bcc 100644 --- a/backend/src/main/resources/content/msp/module-allocations/testing.md +++ b/backend/src/main/resources/content/msp/module-allocations/testing.md @@ -3,7 +3,7 @@ module: msp.module-allocations title: Module Allocations tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Module Allocations** in the MSP admin SPA (`msp.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/msp/users/architect.md b/backend/src/main/resources/content/msp/users/architect.md index 5f02c30..b68f892 100644 --- a/backend/src/main/resources/content/msp/users/architect.md +++ b/backend/src/main/resources/content/msp/users/architect.md @@ -3,7 +3,7 @@ module: msp.users title: Users tab: Architect order: 30 -audience: internal +audience: dev --- How the **Users** screen is built. It is a two-service read/write feature: user records are owned by **hiveops-auth**; the institution dropdown/scoping data is owned by **hiveops-mgmt**. The `msp` SPA has **no backend of its own** — it calls both services directly. There is **no Kafka** and no executor→record-store pattern in this feature; every mutation is a synchronous REST call. See [platform.service-ownership]. diff --git a/backend/src/main/resources/content/msp/users/claude.md b/backend/src/main/resources/content/msp/users/claude.md index 55f9fea..d1fb475 100644 --- a/backend/src/main/resources/content/msp/users/claude.md +++ b/backend/src/main/resources/content/msp/users/claude.md @@ -3,7 +3,7 @@ module: msp.users title: Users tab: Claude order: 40 -audience: internal +audience: dev --- Act-without-guessing reference. Everything below is confirmed in code. diff --git a/backend/src/main/resources/content/msp/users/testing.md b/backend/src/main/resources/content/msp/users/testing.md index e6ecb49..24ff651 100644 --- a/backend/src/main/resources/content/msp/users/testing.md +++ b/backend/src/main/resources/content/msp/users/testing.md @@ -3,7 +3,7 @@ module: msp.users title: Users tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Users** screen (`msp.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/platform/auth/overview.md b/backend/src/main/resources/content/platform/auth/overview.md index d4ae264..7f4a677 100644 --- a/backend/src/main/resources/content/platform/auth/overview.md +++ b/backend/src/main/resources/content/platform/auth/overview.md @@ -3,7 +3,7 @@ module: platform.auth title: Auth & JWT Flow tab: Overview order: 40 -audience: internal +audience: dev --- > **DRAFT · internal** (2026-07-01). Verify claim names / secret handling against diff --git a/backend/src/main/resources/content/platform/data-architecture/overview.md b/backend/src/main/resources/content/platform/data-architecture/overview.md index 9dab556..8bf5d16 100644 --- a/backend/src/main/resources/content/platform/data-architecture/overview.md +++ b/backend/src/main/resources/content/platform/data-architecture/overview.md @@ -3,7 +3,7 @@ module: platform.data-architecture title: Data Architecture — Executors, Kafka, Record Stores tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01 to stop the most expensive recurring mistake: diff --git a/backend/src/main/resources/content/platform/data-stores/overview.md b/backend/src/main/resources/content/platform/data-stores/overview.md index 7af7b6a..76911eb 100644 --- a/backend/src/main/resources/content/platform/data-stores/overview.md +++ b/backend/src/main/resources/content/platform/data-stores/overview.md @@ -3,7 +3,7 @@ module: platform.data-stores title: Data Stores — Postgres DBs & Table Ownership tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01. Pairs with **platform.data-architecture** (the diff --git a/backend/src/main/resources/content/platform/deployment/overview.md b/backend/src/main/resources/content/platform/deployment/overview.md index 7f0006e..4c5fbce 100644 --- a/backend/src/main/resources/content/platform/deployment/overview.md +++ b/backend/src/main/resources/content/platform/deployment/overview.md @@ -3,7 +3,7 @@ module: platform.deployment title: Deployment Topology & bcos.dev tab: Overview order: 30 -audience: internal +audience: dev --- > **DRAFT · internal** (2026-07-01). Server paths verified today; re-check before prod actions. diff --git a/backend/src/main/resources/content/platform/git-workflow/overview.md b/backend/src/main/resources/content/platform/git-workflow/overview.md index fb205f4..4ac862e 100644 --- a/backend/src/main/resources/content/platform/git-workflow/overview.md +++ b/backend/src/main/resources/content/platform/git-workflow/overview.md @@ -3,7 +3,7 @@ module: platform.git-workflow title: Git & Deploy Workflow tab: Overview order: 50 -audience: internal +audience: dev --- > **DRAFT · internal** (2026-07-01). Written after violating this repeatedly in one session. diff --git a/backend/src/main/resources/content/platform/gotchas/overview.md b/backend/src/main/resources/content/platform/gotchas/overview.md index 8daef16..d807c3d 100644 --- a/backend/src/main/resources/content/platform/gotchas/overview.md +++ b/backend/src/main/resources/content/platform/gotchas/overview.md @@ -3,7 +3,7 @@ module: platform.gotchas title: Common Mistakes & Gotchas tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01. The running list of things that have bitten us, in one diff --git a/backend/src/main/resources/content/platform/kafka/overview.md b/backend/src/main/resources/content/platform/kafka/overview.md index 71da94b..822237f 100644 --- a/backend/src/main/resources/content/platform/kafka/overview.md +++ b/backend/src/main/resources/content/platform/kafka/overview.md @@ -3,7 +3,7 @@ module: platform.kafka title: Kafka Topics & Event Flows tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01. Topic **names** below are grounded in the Java source; diff --git a/backend/src/main/resources/content/platform/module-map/overview.md b/backend/src/main/resources/content/platform/module-map/overview.md index 1a15e45..c97ea2f 100644 --- a/backend/src/main/resources/content/platform/module-map/overview.md +++ b/backend/src/main/resources/content/platform/module-map/overview.md @@ -3,7 +3,7 @@ module: platform.module-map title: Module Map (what each app does + its data source) tab: Overview order: 60 -audience: internal +audience: dev --- > **DRAFT · internal** (2026-07-01). Ports/routes from CLAUDE.md; expand + verify per module. diff --git a/backend/src/main/resources/content/platform/nginx-routing/overview.md b/backend/src/main/resources/content/platform/nginx-routing/overview.md index d317202..4cd7144 100644 --- a/backend/src/main/resources/content/platform/nginx-routing/overview.md +++ b/backend/src/main/resources/content/platform/nginx-routing/overview.md @@ -3,7 +3,7 @@ module: platform.nginx-routing title: NGINX Routing, CORS & Blue/Green tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01. NGINX on the services VM (`173.231.195.250`) is the diff --git a/backend/src/main/resources/content/platform/service-ownership/overview.md b/backend/src/main/resources/content/platform/service-ownership/overview.md index e834a7e..7caf06b 100644 --- a/backend/src/main/resources/content/platform/service-ownership/overview.md +++ b/backend/src/main/resources/content/platform/service-ownership/overview.md @@ -3,7 +3,7 @@ module: platform.service-ownership title: Service Ownership & Where Data Lives tab: Overview order: 20 -audience: internal +audience: dev --- > **DRAFT · internal** (2026-07-01). Verify service/endpoint details against the code. diff --git a/backend/src/main/resources/content/platform/topology/overview.md b/backend/src/main/resources/content/platform/topology/overview.md index 23b9d92..ec8d0f5 100644 --- a/backend/src/main/resources/content/platform/topology/overview.md +++ b/backend/src/main/resources/content/platform/topology/overview.md @@ -3,7 +3,7 @@ module: platform.topology title: Infrastructure Topology — VMs, Access, Deploy Paths tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01 to stop the most expensive recurring mistake: diff --git a/backend/src/main/resources/content/profile/appearance/architect.md b/backend/src/main/resources/content/profile/appearance/architect.md index 6941a87..c9f2f5d 100644 --- a/backend/src/main/resources/content/profile/appearance/architect.md +++ b/backend/src/main/resources/content/profile/appearance/architect.md @@ -3,7 +3,7 @@ module: profile.appearance title: Appearance tab: Architect order: 30 -audience: internal +audience: dev --- How the **Appearance** feature is built. It is a thin CRUD over a JSONB column — **no Kafka, no executor→record-store pattern, no cross-service events**. Theme rendering is entirely client-side. diff --git a/backend/src/main/resources/content/profile/appearance/claude.md b/backend/src/main/resources/content/profile/appearance/claude.md index 883a0f9..dc9f27a 100644 --- a/backend/src/main/resources/content/profile/appearance/claude.md +++ b/backend/src/main/resources/content/profile/appearance/claude.md @@ -3,7 +3,7 @@ module: profile.appearance title: Appearance tab: Claude order: 40 -audience: internal +audience: dev --- Terse agent reference. **Owner: hiveops-auth.** Self-service per-user preference. No Kafka, no admin gate. diff --git a/backend/src/main/resources/content/profile/appearance/testing.md b/backend/src/main/resources/content/profile/appearance/testing.md index 2fdf85e..fc5e2fa 100644 --- a/backend/src/main/resources/content/profile/appearance/testing.md +++ b/backend/src/main/resources/content/profile/appearance/testing.md @@ -3,7 +3,7 @@ module: profile.appearance title: Appearance tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Appearance** panel in Profile (`profile.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/profile/display/architect.md b/backend/src/main/resources/content/profile/display/architect.md index 7b5d1d2..9a78913 100644 --- a/backend/src/main/resources/content/profile/display/architect.md +++ b/backend/src/main/resources/content/profile/display/architect.md @@ -3,7 +3,7 @@ module: profile.display title: Display tab: Architect order: 30 -audience: internal +audience: dev --- How **Profile → Display** is built. Two moving parts: a thin Svelte view in `hiveops-profile` and a preferences store owned entirely by `hiveops-auth`. There is **no Kafka, no executor/record-store pipeline, and no dedicated table** for this feature — it is a synchronous read/write of a JSONB blob. diff --git a/backend/src/main/resources/content/profile/display/claude.md b/backend/src/main/resources/content/profile/display/claude.md index 30498b5..3d71d18 100644 --- a/backend/src/main/resources/content/profile/display/claude.md +++ b/backend/src/main/resources/content/profile/display/claude.md @@ -3,7 +3,7 @@ module: profile.display title: Display tab: Claude order: 40 -audience: internal +audience: dev --- Terse agent reference for **Profile → Display** (items-per-page, date/time format, timezone). diff --git a/backend/src/main/resources/content/profile/display/testing.md b/backend/src/main/resources/content/profile/display/testing.md index 5e41e3a..56b4797 100644 --- a/backend/src/main/resources/content/profile/display/testing.md +++ b/backend/src/main/resources/content/profile/display/testing.md @@ -3,7 +3,7 @@ module: profile.display title: Display tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Profile → Display** (`profile.bcos.dev`). These are personal, per-user preferences — click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/profile/inbox/architect.md b/backend/src/main/resources/content/profile/inbox/architect.md index 84c5abc..4b03c21 100644 --- a/backend/src/main/resources/content/profile/inbox/architect.md +++ b/backend/src/main/resources/content/profile/inbox/architect.md @@ -3,7 +3,7 @@ module: profile.inbox title: Inbox tab: Architect order: 30 -audience: internal +audience: dev --- How the Profile **Inbox** is built and how data flows. The feature spans three services: the SPA (`hiveops-profile`), the message store (`hiveops-messaging`), plus two read-only lookups (`hiveops-auth`, `hiveops-mgmt`). See [platform.service-ownership]. diff --git a/backend/src/main/resources/content/profile/inbox/claude.md b/backend/src/main/resources/content/profile/inbox/claude.md index cc137e2..e9829d6 100644 --- a/backend/src/main/resources/content/profile/inbox/claude.md +++ b/backend/src/main/resources/content/profile/inbox/claude.md @@ -3,7 +3,7 @@ module: profile.inbox title: Inbox tab: Claude order: 40 -audience: internal +audience: dev --- Terse agent reference. Owner service: **`hiveops-messaging`** (port 8086, DB `hiveiq_messaging`). UI: `hiveops-profile/frontend/src/components/Profile/Inbox.svelte`. diff --git a/backend/src/main/resources/content/profile/inbox/testing.md b/backend/src/main/resources/content/profile/inbox/testing.md index e9f522f..3106371 100644 --- a/backend/src/main/resources/content/profile/inbox/testing.md +++ b/backend/src/main/resources/content/profile/inbox/testing.md @@ -3,7 +3,7 @@ module: profile.inbox title: Inbox tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the Profile **Inbox** (on `bcos.dev`, open **Profile → Inbox**). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/profile/notifications/architect.md b/backend/src/main/resources/content/profile/notifications/architect.md index 8fe84d6..d44c497 100644 --- a/backend/src/main/resources/content/profile/notifications/architect.md +++ b/backend/src/main/resources/content/profile/notifications/architect.md @@ -3,7 +3,7 @@ module: profile.notifications title: Notifications tab: Architect order: 30 -audience: internal +audience: dev --- How the **Notifications** preference feature is built. It is a thin, self-scoped CRUD over a JSON column — no async pipeline, no Kafka, no executor→topic→record-store pattern. diff --git a/backend/src/main/resources/content/profile/notifications/claude.md b/backend/src/main/resources/content/profile/notifications/claude.md index 6c64e9f..7801c88 100644 --- a/backend/src/main/resources/content/profile/notifications/claude.md +++ b/backend/src/main/resources/content/profile/notifications/claude.md @@ -3,7 +3,7 @@ module: profile.notifications title: Notifications tab: Claude order: 40 -audience: internal +audience: dev --- Terse agent reference. Act from this; do not infer beyond it. diff --git a/backend/src/main/resources/content/profile/notifications/testing.md b/backend/src/main/resources/content/profile/notifications/testing.md index b7cb5ff..0a48f79 100644 --- a/backend/src/main/resources/content/profile/notifications/testing.md +++ b/backend/src/main/resources/content/profile/notifications/testing.md @@ -3,7 +3,7 @@ module: profile.notifications title: Notifications tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Notifications** settings screen (`profile.bcos.dev` → **Profile → Notifications**). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/profile/profile/architect.md b/backend/src/main/resources/content/profile/profile/architect.md index 9497583..5299a02 100644 --- a/backend/src/main/resources/content/profile/profile/architect.md +++ b/backend/src/main/resources/content/profile/profile/architect.md @@ -3,7 +3,7 @@ module: profile.profile title: Profile tab: Architect order: 30 -audience: internal +audience: dev --- How the **Profile** tab is built. It is a self-service editor over a single `users` row, served entirely by **hiveops-auth**, with one synchronous cross-service call to **hiveops-mgmt** to resolve the display institution. There is **no Kafka, no executor, and no record-store** in this feature — it is a plain request/response CRUD over a relational table plus a jsonb column. diff --git a/backend/src/main/resources/content/profile/profile/claude.md b/backend/src/main/resources/content/profile/profile/claude.md index dc2c3cc..d09b2c1 100644 --- a/backend/src/main/resources/content/profile/profile/claude.md +++ b/backend/src/main/resources/content/profile/profile/claude.md @@ -3,7 +3,7 @@ module: profile.profile title: Profile tab: Claude order: 40 -audience: internal +audience: dev --- Terse agent reference for the **Profile** tab (`ProfileInfo.svelte`). Self-service edit of the caller's own `users` row. diff --git a/backend/src/main/resources/content/profile/profile/testing.md b/backend/src/main/resources/content/profile/profile/testing.md index 6d91585..59d5897 100644 --- a/backend/src/main/resources/content/profile/profile/testing.md +++ b/backend/src/main/resources/content/profile/profile/testing.md @@ -3,7 +3,7 @@ module: profile.profile title: Profile tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Profile** tab (`profile.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/profile/security/architect.md b/backend/src/main/resources/content/profile/security/architect.md index b18020b..0c7ab1c 100644 --- a/backend/src/main/resources/content/profile/security/architect.md +++ b/backend/src/main/resources/content/profile/security/architect.md @@ -3,7 +3,7 @@ module: profile.security title: Security tab: Architect order: 30 -audience: internal +audience: dev --- > **Internal · architecture.** Written 2026-07-01 from `hiveops-profile` frontend + `hiveops-auth` source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/profile/security/claude.md b/backend/src/main/resources/content/profile/security/claude.md index d632c4e..2f81d59 100644 --- a/backend/src/main/resources/content/profile/security/claude.md +++ b/backend/src/main/resources/content/profile/security/claude.md @@ -3,7 +3,7 @@ module: profile.security title: Security tab: Claude order: 40 -audience: internal +audience: dev --- > **Internal · agent reference.** Confirmed against `hiveops-profile` frontend + `hiveops-auth` source 2026-07-01. diff --git a/backend/src/main/resources/content/profile/security/testing.md b/backend/src/main/resources/content/profile/security/testing.md index 060df41..8b5a6e7 100644 --- a/backend/src/main/resources/content/profile/security/testing.md +++ b/backend/src/main/resources/content/profile/security/testing.md @@ -3,7 +3,7 @@ module: profile.security title: Security tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Security** screen in the **Profile** app. Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/recon/atm-cycle-history/architect.md b/backend/src/main/resources/content/recon/atm-cycle-history/architect.md index 2bbaa4f..57b191f 100644 --- a/backend/src/main/resources/content/recon/atm-cycle-history/architect.md +++ b/backend/src/main/resources/content/recon/atm-cycle-history/architect.md @@ -3,7 +3,7 @@ module: recon.atm-cycle-history title: ATM Cycle History tab: Architect order: 30 -audience: internal +audience: dev --- How the ATM Cycle History feature is built. Owned end-to-end by **hiveops-recon** — see [platform.service-ownership]. Recon does its own reconciliation math and only reaches out to hiveops-journal and hiveops-incident for raw inputs. diff --git a/backend/src/main/resources/content/recon/atm-cycle-history/claude.md b/backend/src/main/resources/content/recon/atm-cycle-history/claude.md index 802ca44..5362148 100644 --- a/backend/src/main/resources/content/recon/atm-cycle-history/claude.md +++ b/backend/src/main/resources/content/recon/atm-cycle-history/claude.md @@ -3,7 +3,7 @@ module: recon.atm-cycle-history title: ATM Cycle History tab: Claude order: 40 -audience: internal +audience: dev --- Terse act-without-guessing reference. Owner: **hiveops-recon** (port 8091, NGINX `/api/recon/`, prod external 8013). DB `hiveiq_recon`. diff --git a/backend/src/main/resources/content/recon/atm-cycle-history/testing.md b/backend/src/main/resources/content/recon/atm-cycle-history/testing.md index e3beab4..e0b948c 100644 --- a/backend/src/main/resources/content/recon/atm-cycle-history/testing.md +++ b/backend/src/main/resources/content/recon/atm-cycle-history/testing.md @@ -3,7 +3,7 @@ module: recon.atm-cycle-history title: ATM Cycle History tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **ATM Cycle History** in the Reconciliation app (`recon.bcos.dev`). Open Reconciliation inside the HiveIQ Browser (**Cash Reconciliation** in the sidebar), click through in the UI, and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/recon/cash-forecast/architect.md b/backend/src/main/resources/content/recon/cash-forecast/architect.md index 844d57f..9bbd379 100644 --- a/backend/src/main/resources/content/recon/cash-forecast/architect.md +++ b/backend/src/main/resources/content/recon/cash-forecast/architect.md @@ -3,7 +3,7 @@ module: recon.cash-forecast title: Cash Forecast tab: Architect order: 30 -audience: internal +audience: dev --- > **Internal — architecture.** Grounded in `hiveops-recon` source. Cross-links: [platform.data-architecture], [platform.kafka], [platform.service-ownership]. diff --git a/backend/src/main/resources/content/recon/cash-forecast/claude.md b/backend/src/main/resources/content/recon/cash-forecast/claude.md index 5b73ce3..6eae01d 100644 --- a/backend/src/main/resources/content/recon/cash-forecast/claude.md +++ b/backend/src/main/resources/content/recon/cash-forecast/claude.md @@ -3,7 +3,7 @@ module: recon.cash-forecast title: Cash Forecast tab: Claude order: 40 -audience: internal +audience: dev --- > Terse agent reference. Every path/table/topic below is confirmed in `hiveops-recon` source. diff --git a/backend/src/main/resources/content/recon/cash-forecast/testing.md b/backend/src/main/resources/content/recon/cash-forecast/testing.md index 11067e8..ce90c38 100644 --- a/backend/src/main/resources/content/recon/cash-forecast/testing.md +++ b/backend/src/main/resources/content/recon/cash-forecast/testing.md @@ -3,7 +3,7 @@ module: recon.cash-forecast title: Cash Forecast tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Cash Forecast** (`recon.bcos.dev` → **Cash Forecast**). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/recon/cash-reconciliation/architect.md b/backend/src/main/resources/content/recon/cash-reconciliation/architect.md index bf2e3d4..242a13b 100644 --- a/backend/src/main/resources/content/recon/cash-reconciliation/architect.md +++ b/backend/src/main/resources/content/recon/cash-reconciliation/architect.md @@ -3,7 +3,7 @@ module: recon.cash-reconciliation title: Cash Reconciliation tab: Architect order: 30 -audience: internal +audience: dev --- > **Internal · Architecture.** How the Cash Reconciliation fleet grid is built. Owned end-to-end by **hiveops-recon** (`hiveiq_recon` DB). See [platform.service-ownership], [platform.data-architecture], [platform.kafka]. diff --git a/backend/src/main/resources/content/recon/cash-reconciliation/claude.md b/backend/src/main/resources/content/recon/cash-reconciliation/claude.md index 8059dbe..c24e61b 100644 --- a/backend/src/main/resources/content/recon/cash-reconciliation/claude.md +++ b/backend/src/main/resources/content/recon/cash-reconciliation/claude.md @@ -3,7 +3,7 @@ module: recon.cash-reconciliation title: Cash Reconciliation tab: Claude order: 40 -audience: internal +audience: dev --- > Act-without-guessing reference for the Cash Reconciliation fleet grid ("ATM Cash Positions"). diff --git a/backend/src/main/resources/content/recon/cash-reconciliation/testing.md b/backend/src/main/resources/content/recon/cash-reconciliation/testing.md index 6394e60..f73ab1f 100644 --- a/backend/src/main/resources/content/recon/cash-reconciliation/testing.md +++ b/backend/src/main/resources/content/recon/cash-reconciliation/testing.md @@ -3,7 +3,7 @@ module: recon.cash-reconciliation title: Cash Reconciliation tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Cash Reconciliation** — the fleet grid "ATM Cash Positions" (`recon.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/recon/device-cycle-mgmt/architect.md b/backend/src/main/resources/content/recon/device-cycle-mgmt/architect.md index 128f899..6cd0df9 100644 --- a/backend/src/main/resources/content/recon/device-cycle-mgmt/architect.md +++ b/backend/src/main/resources/content/recon/device-cycle-mgmt/architect.md @@ -3,7 +3,7 @@ module: recon.device-cycle-mgmt title: Device Cycle Management tab: Architect order: 30 -audience: internal +audience: dev --- > **Architecture.** How the device-selection feature is built and wired. Grounded in `hiveops-recon` source (2026-07-01). Cross-links: [platform.data-architecture], [platform.kafka], [platform.service-ownership]. diff --git a/backend/src/main/resources/content/recon/device-cycle-mgmt/claude.md b/backend/src/main/resources/content/recon/device-cycle-mgmt/claude.md index a7a173b..4cf02f8 100644 --- a/backend/src/main/resources/content/recon/device-cycle-mgmt/claude.md +++ b/backend/src/main/resources/content/recon/device-cycle-mgmt/claude.md @@ -3,7 +3,7 @@ module: recon.device-cycle-mgmt title: Device Cycle Management tab: Claude order: 40 -audience: internal +audience: dev --- > Terse agent reference. Only confirmed facts. Owner service: **`hiveops-recon`**. diff --git a/backend/src/main/resources/content/recon/device-cycle-mgmt/testing.md b/backend/src/main/resources/content/recon/device-cycle-mgmt/testing.md index 343a081..f872349 100644 --- a/backend/src/main/resources/content/recon/device-cycle-mgmt/testing.md +++ b/backend/src/main/resources/content/recon/device-cycle-mgmt/testing.md @@ -3,7 +3,7 @@ module: recon.device-cycle-mgmt title: Device Cycle Management tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Device Cycle Mgmt** in Cash Reconciliation (`recon.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/recon/recon-rules/architect.md b/backend/src/main/resources/content/recon/recon-rules/architect.md index 62d7f8b..8c557ed 100644 --- a/backend/src/main/resources/content/recon/recon-rules/architect.md +++ b/backend/src/main/resources/content/recon/recon-rules/architect.md @@ -3,7 +3,7 @@ module: recon.recon-rules title: Recon Rules tab: Architect order: 30 -audience: internal +audience: dev --- > **Internal · architecture.** How the Recon Rules feature is built, grounded in `hiveops-recon` source (2026-07-01). See [platform.service-ownership], [platform.data-architecture], [platform.kafka]. diff --git a/backend/src/main/resources/content/recon/recon-rules/claude.md b/backend/src/main/resources/content/recon/recon-rules/claude.md index 921b27d..5d7a3be 100644 --- a/backend/src/main/resources/content/recon/recon-rules/claude.md +++ b/backend/src/main/resources/content/recon/recon-rules/claude.md @@ -3,7 +3,7 @@ module: recon.recon-rules title: Recon Rules tab: Claude order: 40 -audience: internal +audience: dev --- > Act-without-guessing reference. All facts confirmed in `hiveops-recon` source (2026-07-01). diff --git a/backend/src/main/resources/content/recon/recon-rules/testing.md b/backend/src/main/resources/content/recon/recon-rules/testing.md index e828c97..1e5c6ad 100644 --- a/backend/src/main/resources/content/recon/recon-rules/testing.md +++ b/backend/src/main/resources/content/recon/recon-rules/testing.md @@ -3,7 +3,7 @@ module: recon.recon-rules title: Recon Rules tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Recon Rules** (`recon.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/reports/builder/architect.md b/backend/src/main/resources/content/reports/builder/architect.md index 5550856..2a1052d 100644 --- a/backend/src/main/resources/content/reports/builder/architect.md +++ b/backend/src/main/resources/content/reports/builder/architect.md @@ -3,7 +3,7 @@ module: reports.builder title: Report Builder tab: Architect order: 30 -audience: internal +audience: dev --- How the Report Builder is actually wired. It is owned end-to-end by **hiveops-reports**, which stores definitions/runs and orchestrates async execution against *other* services' live APIs. See [platform.service-ownership], [platform.data-architecture], [platform.kafka]. diff --git a/backend/src/main/resources/content/reports/builder/claude.md b/backend/src/main/resources/content/reports/builder/claude.md index 8237c7b..de85867 100644 --- a/backend/src/main/resources/content/reports/builder/claude.md +++ b/backend/src/main/resources/content/reports/builder/claude.md @@ -3,7 +3,7 @@ module: reports.builder title: Report Builder tab: Claude order: 40 -audience: internal +audience: dev --- Terse act-without-guessing reference. **Owner service: `hiveops-reports`** (`hiveiq-reports`, internal `:8088`, external `:8011`). Route `api.bcos.cloud/reports/` → `hiveiq-reports:8088/api/reports/`. DB `hiveiq_reports` (split `DB_HOST/DB_PORT/DB_NAME/DB_USERNAME/DB_PASSWORD`, NOT `DB_URL`). diff --git a/backend/src/main/resources/content/reports/builder/testing.md b/backend/src/main/resources/content/reports/builder/testing.md index 704d5e3..67d02cb 100644 --- a/backend/src/main/resources/content/reports/builder/testing.md +++ b/backend/src/main/resources/content/reports/builder/testing.md @@ -3,7 +3,7 @@ module: reports.builder title: Report Builder tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Report Builder** (`report.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/reports/queries/architect.md b/backend/src/main/resources/content/reports/queries/architect.md index c97b38e..c1e7ad2 100644 --- a/backend/src/main/resources/content/reports/queries/architect.md +++ b/backend/src/main/resources/content/reports/queries/architect.md @@ -3,7 +3,7 @@ module: reports.queries title: Saved Queries tab: Architect order: 30 -audience: internal +audience: dev --- > **Architect view.** Grounded in `hiveops-reports` source. Cross-links: [platform.data-architecture], [platform.kafka], [platform.service-ownership], [technical.reports]. diff --git a/backend/src/main/resources/content/reports/queries/claude.md b/backend/src/main/resources/content/reports/queries/claude.md index ee34b29..515ce86 100644 --- a/backend/src/main/resources/content/reports/queries/claude.md +++ b/backend/src/main/resources/content/reports/queries/claude.md @@ -3,7 +3,7 @@ module: reports.queries title: Saved Queries tab: Claude order: 40 -audience: internal +audience: dev --- > Terse agent reference. Only confirmed facts. Owner service: **hiveops-reports** (all query CRUD is self-contained; no other service, no Kafka topic in this path). diff --git a/backend/src/main/resources/content/reports/queries/testing.md b/backend/src/main/resources/content/reports/queries/testing.md index 71a8d8f..0d107fd 100644 --- a/backend/src/main/resources/content/reports/queries/testing.md +++ b/backend/src/main/resources/content/reports/queries/testing.md @@ -3,7 +3,7 @@ module: reports.queries title: Saved Queries tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Saved Queries** (`report.bcos.dev`). Saved Queries live on the **Templates** tab — each report row has a **Queries** button. Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/reports/runs/architect.md b/backend/src/main/resources/content/reports/runs/architect.md index 2328158..360ecad 100644 --- a/backend/src/main/resources/content/reports/runs/architect.md +++ b/backend/src/main/resources/content/reports/runs/architect.md @@ -3,7 +3,7 @@ module: reports.runs title: Run History tab: Architect order: 30 -audience: internal +audience: dev --- How **Run History** is built. It is a thin CRUD/list surface over the `report_runs` table, backed by an **async executor → live downstream fetch → store → Kafka distribute** pipeline. hiveops-reports owns the run lifecycle end to end; it holds no fleet data of its own. See [platform.service-ownership]. diff --git a/backend/src/main/resources/content/reports/runs/claude.md b/backend/src/main/resources/content/reports/runs/claude.md index 22fd76c..b6f8984 100644 --- a/backend/src/main/resources/content/reports/runs/claude.md +++ b/backend/src/main/resources/content/reports/runs/claude.md @@ -3,7 +3,7 @@ module: reports.runs title: Run History tab: Claude order: 40 -audience: internal +audience: dev --- Terse agent reference for **reports.runs**. Act only on what's below. diff --git a/backend/src/main/resources/content/reports/runs/testing.md b/backend/src/main/resources/content/reports/runs/testing.md index fbb35a4..965935f 100644 --- a/backend/src/main/resources/content/reports/runs/testing.md +++ b/backend/src/main/resources/content/reports/runs/testing.md @@ -3,7 +3,7 @@ module: reports.runs title: Run History tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Run History** (`report.bcos.dev` → **Run History** tab). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/reports/schedule/architect.md b/backend/src/main/resources/content/reports/schedule/architect.md index 68f9bf6..6c2095e 100644 --- a/backend/src/main/resources/content/reports/schedule/architect.md +++ b/backend/src/main/resources/content/reports/schedule/architect.md @@ -3,7 +3,7 @@ module: reports.schedule title: Scheduling & Distribution tab: Architect order: 30 -audience: internal +audience: dev --- How the **schedule + distribution** feature is built. Owner: **hiveops-reports**. Two collaborators at runtime: whichever data-source service the template targets (incident/journal/fleet) and **hiveops-messaging** for delivery. See [platform.service-ownership]. diff --git a/backend/src/main/resources/content/reports/schedule/claude.md b/backend/src/main/resources/content/reports/schedule/claude.md index f13c4e6..cb57397 100644 --- a/backend/src/main/resources/content/reports/schedule/claude.md +++ b/backend/src/main/resources/content/reports/schedule/claude.md @@ -3,7 +3,7 @@ module: reports.schedule title: Scheduling & Distribution tab: Claude order: 40 -audience: internal +audience: dev --- Act-without-guessing reference. Owner service: **hiveops-reports**. Delivery: **hiveops-messaging**. All facts below confirmed in code. diff --git a/backend/src/main/resources/content/reports/schedule/testing.md b/backend/src/main/resources/content/reports/schedule/testing.md index 9c82126..438d311 100644 --- a/backend/src/main/resources/content/reports/schedule/testing.md +++ b/backend/src/main/resources/content/reports/schedule/testing.md @@ -3,7 +3,7 @@ module: reports.schedule title: Scheduling & Distribution tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Reports — scheduling & distribution** (`report.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/reports/templates/architect.md b/backend/src/main/resources/content/reports/templates/architect.md index 5d670f3..21952e2 100644 --- a/backend/src/main/resources/content/reports/templates/architect.md +++ b/backend/src/main/resources/content/reports/templates/architect.md @@ -3,7 +3,7 @@ module: reports.templates title: Report Templates tab: Architect order: 30 -audience: internal +audience: dev --- > **Internal — architecture.** How the Report Templates feature is built. Owner: **hiveops-reports** (see [platform.service-ownership]). diff --git a/backend/src/main/resources/content/reports/templates/claude.md b/backend/src/main/resources/content/reports/templates/claude.md index f99031c..928f02f 100644 --- a/backend/src/main/resources/content/reports/templates/claude.md +++ b/backend/src/main/resources/content/reports/templates/claude.md @@ -3,7 +3,7 @@ module: reports.templates title: Report Templates tab: Claude order: 40 -audience: internal +audience: dev --- > Terse act-without-guessing reference. Owner service: **hiveops-reports**. Nothing here is guessed — all confirmed in source. diff --git a/backend/src/main/resources/content/reports/templates/testing.md b/backend/src/main/resources/content/reports/templates/testing.md index dc55886..be8971c 100644 --- a/backend/src/main/resources/content/reports/templates/testing.md +++ b/backend/src/main/resources/content/reports/templates/testing.md @@ -3,7 +3,7 @@ module: reports.templates title: Report Templates tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Report Templates** (`report.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/technical/agent-proxy/overview.md b/backend/src/main/resources/content/technical/agent-proxy/overview.md index 6c84f92..a8d7a53 100644 --- a/backend/src/main/resources/content/technical/agent-proxy/overview.md +++ b/backend/src/main/resources/content/technical/agent-proxy/overview.md @@ -3,7 +3,7 @@ module: technical.agent-proxy title: Agent-Proxy — agent-facing API gateway tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01 from hiveops-agent-proxy source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/technical/agent/overview.md b/backend/src/main/resources/content/technical/agent/overview.md index 255a048..e22586f 100644 --- a/backend/src/main/resources/content/technical/agent/overview.md +++ b/backend/src/main/resources/content/technical/agent/overview.md @@ -3,7 +3,7 @@ module: technical.agent title: HiveOps Agent — on-ATM Java monitoring agent tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01 from hiveops-agent source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/technical/ai/overview.md b/backend/src/main/resources/content/technical/ai/overview.md index 6ed664b..b67b50a 100644 --- a/backend/src/main/resources/content/technical/ai/overview.md +++ b/backend/src/main/resources/content/technical/ai/overview.md @@ -3,7 +3,7 @@ module: technical.ai title: Adoons (hiveops-ai) — Spring AI fleet assistant & incident/rule intelligence tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01 from hiveops-ai source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/technical/analytics/overview.md b/backend/src/main/resources/content/technical/analytics/overview.md index 2c626be..b97d533 100644 --- a/backend/src/main/resources/content/technical/analytics/overview.md +++ b/backend/src/main/resources/content/technical/analytics/overview.md @@ -3,7 +3,7 @@ module: technical.analytics title: Analytics — fleet dashboard aggregation & snapshots tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01 from hiveops-analytics source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/technical/aria/overview.md b/backend/src/main/resources/content/technical/aria/overview.md index 2a04a98..86b53b3 100644 --- a/backend/src/main/resources/content/technical/aria/overview.md +++ b/backend/src/main/resources/content/technical/aria/overview.md @@ -3,7 +3,7 @@ module: technical.aria title: ARIA — ATM threat intelligence & precursor-sequence detection tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01 from hiveops-aria source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/technical/auth/overview.md b/backend/src/main/resources/content/technical/auth/overview.md index ba6dfd4..ced2dbd 100644 --- a/backend/src/main/resources/content/technical/auth/overview.md +++ b/backend/src/main/resources/content/technical/auth/overview.md @@ -3,7 +3,7 @@ module: technical.auth title: hiveops-auth — Customer authentication + TOTP MFA + JWT issuer tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01 from hiveops-auth source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/technical/claims/overview.md b/backend/src/main/resources/content/technical/claims/overview.md index feab569..a95552d 100644 --- a/backend/src/main/resources/content/technical/claims/overview.md +++ b/backend/src/main/resources/content/technical/claims/overview.md @@ -3,7 +3,7 @@ module: technical.claims title: hiveops-claims — ATM cash-shortage loss recovery service tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01 from hiveops-claims source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/technical/config/overview.md b/backend/src/main/resources/content/technical/config/overview.md index 51577a2..46cc998 100644 --- a/backend/src/main/resources/content/technical/config/overview.md +++ b/backend/src/main/resources/content/technical/config/overview.md @@ -3,7 +3,7 @@ module: technical.config title: hiveops-config — Spring Cloud Config Server (centralized configuration) tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01 from hiveops-config source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/technical/devices/overview.md b/backend/src/main/resources/content/technical/devices/overview.md index 8978276..b17f49b 100644 --- a/backend/src/main/resources/content/technical/devices/overview.md +++ b/backend/src/main/resources/content/technical/devices/overview.md @@ -3,7 +3,7 @@ module: technical.devices title: Devices — device management & source of truth for device data tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01 from hiveops-devices source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/technical/fleet/overview.md b/backend/src/main/resources/content/technical/fleet/overview.md index d64c65b..253ffe3 100644 --- a/backend/src/main/resources/content/technical/fleet/overview.md +++ b/backend/src/main/resources/content/technical/fleet/overview.md @@ -3,7 +3,7 @@ module: technical.fleet title: Fleet — fleet task orchestration & artifact delivery tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01 from hiveops-fleet source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/technical/incident/overview.md b/backend/src/main/resources/content/technical/incident/overview.md index 1191f99..7937e82 100644 --- a/backend/src/main/resources/content/technical/incident/overview.md +++ b/backend/src/main/resources/content/technical/incident/overview.md @@ -3,7 +3,7 @@ module: technical.incident title: hiveops-incident — ATM incident management & journal-event store tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01 from hiveops-incident source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/technical/journal/overview.md b/backend/src/main/resources/content/technical/journal/overview.md index 6de9b9a..fc57566 100644 --- a/backend/src/main/resources/content/technical/journal/overview.md +++ b/backend/src/main/resources/content/technical/journal/overview.md @@ -3,7 +3,7 @@ module: technical.journal title: Journal Service — ATM journal storage, parsing & gap detection tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01 from hiveops-journal source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/technical/messaging/overview.md b/backend/src/main/resources/content/technical/messaging/overview.md index ccff76e..445b323 100644 --- a/backend/src/main/resources/content/technical/messaging/overview.md +++ b/backend/src/main/resources/content/technical/messaging/overview.md @@ -3,7 +3,7 @@ module: technical.messaging title: Messaging — user messages, broadcasts & system alerts tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01 from hiveops-messaging source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/technical/mgmt/overview.md b/backend/src/main/resources/content/technical/mgmt/overview.md index c34dd63..e3969bd 100644 --- a/backend/src/main/resources/content/technical/mgmt/overview.md +++ b/backend/src/main/resources/content/technical/mgmt/overview.md @@ -3,7 +3,7 @@ module: technical.mgmt title: hiveops-mgmt — Management, licensing & internal identity service tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01 from hiveops-mgmt source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/technical/recon/overview.md b/backend/src/main/resources/content/technical/recon/overview.md index 093cbae..8253f04 100644 --- a/backend/src/main/resources/content/technical/recon/overview.md +++ b/backend/src/main/resources/content/technical/recon/overview.md @@ -3,7 +3,7 @@ module: technical.recon title: Recon — ATM cash reconciliation service tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01 from hiveops-recon source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/technical/remote/overview.md b/backend/src/main/resources/content/technical/remote/overview.md index 3d0b2c7..2a44070 100644 --- a/backend/src/main/resources/content/technical/remote/overview.md +++ b/backend/src/main/resources/content/technical/remote/overview.md @@ -3,7 +3,7 @@ module: technical.remote title: Remote — Remote screen capture, file access & module deployment for ATMs tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01 from hiveops-remote source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/technical/reports/overview.md b/backend/src/main/resources/content/technical/reports/overview.md index 1fb1d5e..3756a2d 100644 --- a/backend/src/main/resources/content/technical/reports/overview.md +++ b/backend/src/main/resources/content/technical/reports/overview.md @@ -3,7 +3,7 @@ module: technical.reports title: hiveops-reports — Custom report builder, scheduling & distribution tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01 from hiveops-reports source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/technical/transactions/overview.md b/backend/src/main/resources/content/technical/transactions/overview.md index e5b5107..07c9b61 100644 --- a/backend/src/main/resources/content/technical/transactions/overview.md +++ b/backend/src/main/resources/content/technical/transactions/overview.md @@ -3,7 +3,7 @@ module: technical.transactions title: Transactions — stateless proxy gateway for the transaction browser SPA tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01 from hiveops-transactions source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/technical/vault/overview.md b/backend/src/main/resources/content/technical/vault/overview.md index d2e56bc..6b2e177 100644 --- a/backend/src/main/resources/content/technical/vault/overview.md +++ b/backend/src/main/resources/content/technical/vault/overview.md @@ -3,7 +3,7 @@ module: technical.vault title: Vault — CIT visit tracking & cash count service tab: Overview order: 10 -audience: internal +audience: dev --- > **DRAFT · internal.** Written 2026-07-01 from hiveops-vault source. Verify against code before relying on specifics. diff --git a/backend/src/main/resources/content/transactions/browser/architect.md b/backend/src/main/resources/content/transactions/browser/architect.md index e34c0c0..1a7874a 100644 --- a/backend/src/main/resources/content/transactions/browser/architect.md +++ b/backend/src/main/resources/content/transactions/browser/architect.md @@ -3,7 +3,7 @@ module: transactions.browser title: Transactions Browser tab: Architect order: 30 -audience: internal +audience: dev --- How the transaction browser is built end to end. Three services participate; **only journal owns data**. See [platform.service-ownership]. diff --git a/backend/src/main/resources/content/transactions/browser/claude.md b/backend/src/main/resources/content/transactions/browser/claude.md index 658a071..6024b0d 100644 --- a/backend/src/main/resources/content/transactions/browser/claude.md +++ b/backend/src/main/resources/content/transactions/browser/claude.md @@ -3,7 +3,7 @@ module: transactions.browser title: Transactions Browser tab: Claude order: 40 -audience: internal +audience: dev --- Act-without-guessing reference. Confirmed from source unless marked `(unverified)`. diff --git a/backend/src/main/resources/content/transactions/browser/testing.md b/backend/src/main/resources/content/transactions/browser/testing.md index 719741d..d1cf45e 100644 --- a/backend/src/main/resources/content/transactions/browser/testing.md +++ b/backend/src/main/resources/content/transactions/browser/testing.md @@ -3,7 +3,7 @@ module: transactions.browser title: Transactions Browser tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Transactions Browser** (`transactions.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/transactions/customer-journey/architect.md b/backend/src/main/resources/content/transactions/customer-journey/architect.md index 2fc15e3..c3d942c 100644 --- a/backend/src/main/resources/content/transactions/customer-journey/architect.md +++ b/backend/src/main/resources/content/transactions/customer-journey/architect.md @@ -3,7 +3,7 @@ module: transactions.customer-journey title: Customer Journey tab: Architect order: 30 -audience: internal +audience: dev --- How the Customer Journey drawer is built. It is a **read-mostly composition across four services**, orchestrated entirely by the Svelte component `CustomerJourney.svelte` — there is no single "journey" backend endpoint. See [platform.service-ownership]. diff --git a/backend/src/main/resources/content/transactions/customer-journey/claude.md b/backend/src/main/resources/content/transactions/customer-journey/claude.md index ee522c8..6ada3f6 100644 --- a/backend/src/main/resources/content/transactions/customer-journey/claude.md +++ b/backend/src/main/resources/content/transactions/customer-journey/claude.md @@ -3,7 +3,7 @@ module: transactions.customer-journey title: Customer Journey tab: Claude order: 40 -audience: internal +audience: dev --- Terse act-without-guessing reference. Component: `hiveops-transactions/frontend/src/components/Transactions/CustomerJourney.svelte`. diff --git a/backend/src/main/resources/content/transactions/customer-journey/testing.md b/backend/src/main/resources/content/transactions/customer-journey/testing.md index bec2391..b636609 100644 --- a/backend/src/main/resources/content/transactions/customer-journey/testing.md +++ b/backend/src/main/resources/content/transactions/customer-journey/testing.md @@ -3,7 +3,7 @@ module: transactions.customer-journey title: Customer Journey tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Customer Journey** (`transactions.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/transactions/journal-parsing/architect.md b/backend/src/main/resources/content/transactions/journal-parsing/architect.md index d10b247..42bd7d3 100644 --- a/backend/src/main/resources/content/transactions/journal-parsing/architect.md +++ b/backend/src/main/resources/content/transactions/journal-parsing/architect.md @@ -3,7 +3,7 @@ module: transactions.journal-parsing title: Journal Parsing Rules tab: Architect order: 30 -audience: internal +audience: dev --- How the Journal Parsing feature is actually built. The UI lives in the Transactions SPA, but the entire domain — rules, files, transactions, parsing — is owned by **hiveops-journal**. See [platform.service-ownership] and [platform.data-architecture]. diff --git a/backend/src/main/resources/content/transactions/journal-parsing/claude.md b/backend/src/main/resources/content/transactions/journal-parsing/claude.md index 09ea7da..1f631a4 100644 --- a/backend/src/main/resources/content/transactions/journal-parsing/claude.md +++ b/backend/src/main/resources/content/transactions/journal-parsing/claude.md @@ -3,7 +3,7 @@ module: transactions.journal-parsing title: Journal Parsing Rules tab: Claude order: 40 -audience: internal +audience: dev --- ## Ownership diff --git a/backend/src/main/resources/content/transactions/journal-parsing/testing.md b/backend/src/main/resources/content/transactions/journal-parsing/testing.md index 155fa15..bea52ee 100644 --- a/backend/src/main/resources/content/transactions/journal-parsing/testing.md +++ b/backend/src/main/resources/content/transactions/journal-parsing/testing.md @@ -3,7 +3,7 @@ module: transactions.journal-parsing title: Journal Parsing Rules tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Journal Parsing** in the Transactions SPA (`transactions.bcos.dev`). Click through in the UI and mark each row Pass or Fail. The screen lives under **Settings → Journal → Parsing → ATM**. diff --git a/backend/src/main/resources/content/transactions/processing-rules/architect.md b/backend/src/main/resources/content/transactions/processing-rules/architect.md index 9850ac8..5602524 100644 --- a/backend/src/main/resources/content/transactions/processing-rules/architect.md +++ b/backend/src/main/resources/content/transactions/processing-rules/architect.md @@ -3,7 +3,7 @@ module: transactions.processing-rules title: Journal Processing Rules tab: Architect order: 30 -audience: internal +audience: dev --- How the **Journal Processing Rules** feature is built. The screen is served by the Transactions SPA, but the feature is **owned end-to-end by hiveops-journal**. See [platform.service-ownership]. diff --git a/backend/src/main/resources/content/transactions/processing-rules/claude.md b/backend/src/main/resources/content/transactions/processing-rules/claude.md index 6a130b9..166f066 100644 --- a/backend/src/main/resources/content/transactions/processing-rules/claude.md +++ b/backend/src/main/resources/content/transactions/processing-rules/claude.md @@ -3,7 +3,7 @@ module: transactions.processing-rules title: Journal Processing Rules tab: Claude order: 40 -audience: internal +audience: dev --- Terse act-without-guessing reference. Owned by **hiveops-journal** (upload role). Transactions app is only the UI + proxy. diff --git a/backend/src/main/resources/content/transactions/processing-rules/testing.md b/backend/src/main/resources/content/transactions/processing-rules/testing.md index 103f5c1..d3dff72 100644 --- a/backend/src/main/resources/content/transactions/processing-rules/testing.md +++ b/backend/src/main/resources/content/transactions/processing-rules/testing.md @@ -3,7 +3,7 @@ module: transactions.processing-rules title: Journal Processing Rules tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Journal Processing Rules** (Transactions app › Settings, `transactions.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/transactions/reparse/architect.md b/backend/src/main/resources/content/transactions/reparse/architect.md index cc5d768..51ee731 100644 --- a/backend/src/main/resources/content/transactions/reparse/architect.md +++ b/backend/src/main/resources/content/transactions/reparse/architect.md @@ -3,7 +3,7 @@ module: transactions.reparse title: Journal Reparse tab: Architect order: 30 -audience: internal +audience: dev --- How **Journal Reparse** is built end to end. The feature spans two services: the **transactions** SPA/proxy (UI + auth pass-through) and **hiveops-journal** (the actual owner of files, transactions, and the reparse action). See [platform.service-ownership]. diff --git a/backend/src/main/resources/content/transactions/reparse/claude.md b/backend/src/main/resources/content/transactions/reparse/claude.md index a9e3f21..8cd5cff 100644 --- a/backend/src/main/resources/content/transactions/reparse/claude.md +++ b/backend/src/main/resources/content/transactions/reparse/claude.md @@ -3,7 +3,7 @@ module: transactions.reparse title: Journal Reparse tab: Claude order: 40 -audience: internal +audience: dev --- ## Ownership diff --git a/backend/src/main/resources/content/transactions/reparse/testing.md b/backend/src/main/resources/content/transactions/reparse/testing.md index 7d1123b..3e365ea 100644 --- a/backend/src/main/resources/content/transactions/reparse/testing.md +++ b/backend/src/main/resources/content/transactions/reparse/testing.md @@ -3,7 +3,7 @@ module: transactions.reparse title: Journal Reparse tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Journal Reparse** (Transactions SPA → **Settings → Journal Reparse**, `transactions.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/vault/cit-visits/architect.md b/backend/src/main/resources/content/vault/cit-visits/architect.md index 5d9a84f..9ad59b6 100644 --- a/backend/src/main/resources/content/vault/cit-visits/architect.md +++ b/backend/src/main/resources/content/vault/cit-visits/architect.md @@ -3,7 +3,7 @@ module: vault.cit-visits title: CIT Visits tab: Architect order: 30 -audience: internal +audience: dev --- How the CIT Visits feature is built. See [platform.service-ownership] — **hiveops-vault owns CIT visit data end to end**; it holds only a read-only mirror of device metadata. diff --git a/backend/src/main/resources/content/vault/cit-visits/claude.md b/backend/src/main/resources/content/vault/cit-visits/claude.md index f027b1b..31b93c4 100644 --- a/backend/src/main/resources/content/vault/cit-visits/claude.md +++ b/backend/src/main/resources/content/vault/cit-visits/claude.md @@ -3,7 +3,7 @@ module: vault.cit-visits title: CIT Visits tab: Claude order: 40 -audience: internal +audience: dev --- Terse act-without-guessing reference. All facts grounded in `hiveops-vault` source. diff --git a/backend/src/main/resources/content/vault/cit-visits/testing.md b/backend/src/main/resources/content/vault/cit-visits/testing.md index e0821e6..db6ec0d 100644 --- a/backend/src/main/resources/content/vault/cit-visits/testing.md +++ b/backend/src/main/resources/content/vault/cit-visits/testing.md @@ -3,7 +3,7 @@ module: vault.cit-visits title: CIT Visits tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **CIT Visits** (`vault.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/vault/dashboard/architect.md b/backend/src/main/resources/content/vault/dashboard/architect.md index 3f1e2c0..63e1710 100644 --- a/backend/src/main/resources/content/vault/dashboard/architect.md +++ b/backend/src/main/resources/content/vault/dashboard/architect.md @@ -3,7 +3,7 @@ module: vault.dashboard title: Dashboard tab: Architect order: 30 -audience: internal +audience: dev --- How the Vault Dashboard is built. It is a thin read view over `hiveops-vault` — no cross-service calls at request time, no executor/Kafka on the read path. See [platform.service-ownership]. diff --git a/backend/src/main/resources/content/vault/dashboard/claude.md b/backend/src/main/resources/content/vault/dashboard/claude.md index 9a81f3c..78c9c49 100644 --- a/backend/src/main/resources/content/vault/dashboard/claude.md +++ b/backend/src/main/resources/content/vault/dashboard/claude.md @@ -3,7 +3,7 @@ module: vault.dashboard title: Dashboard tab: Claude order: 40 -audience: internal +audience: dev --- Terse act-without-guessing reference. Owner: **`hiveops-vault`** (port 8094, DB `hiveiq_vault`). Frontend view `hiveops-vault/frontend/src/components/Dashboard/DashboardView.svelte`. diff --git a/backend/src/main/resources/content/vault/dashboard/testing.md b/backend/src/main/resources/content/vault/dashboard/testing.md index f779444..6a2709b 100644 --- a/backend/src/main/resources/content/vault/dashboard/testing.md +++ b/backend/src/main/resources/content/vault/dashboard/testing.md @@ -3,7 +3,7 @@ module: vault.dashboard title: Dashboard tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for the **Vault Dashboard** (`vault.bcos.dev`). Click through in the UI and mark each row Pass or Fail. diff --git a/backend/src/main/resources/content/vault/import/architect.md b/backend/src/main/resources/content/vault/import/architect.md index 5846ac0..4e9f2d8 100644 --- a/backend/src/main/resources/content/vault/import/architect.md +++ b/backend/src/main/resources/content/vault/import/architect.md @@ -3,7 +3,7 @@ module: vault.import title: Import tab: Architect order: 30 -audience: internal +audience: dev --- How the CIT CSV import feature is built. Single owning service — no cross-service or event fan-out on this path. See [platform.service-ownership]. diff --git a/backend/src/main/resources/content/vault/import/claude.md b/backend/src/main/resources/content/vault/import/claude.md index 985392a..a6ffa07 100644 --- a/backend/src/main/resources/content/vault/import/claude.md +++ b/backend/src/main/resources/content/vault/import/claude.md @@ -3,7 +3,7 @@ module: vault.import title: Import tab: Claude order: 40 -audience: internal +audience: dev --- Terse agent reference for CIT CSV import. **Owner: `hiveops-vault`** (port 8094, image `hiveiq-vault`, DB `hiveiq_vault`). Frontend: `hiveops-vault/frontend` `components/Import/ImportView.svelte`. diff --git a/backend/src/main/resources/content/vault/import/testing.md b/backend/src/main/resources/content/vault/import/testing.md index 9ac6230..27eaf47 100644 --- a/backend/src/main/resources/content/vault/import/testing.md +++ b/backend/src/main/resources/content/vault/import/testing.md @@ -3,7 +3,7 @@ module: vault.import title: Import tab: Testing order: 35 -audience: internal +audience: dev --- Frontend test checklist for **Import CIT Data** in Vault (`vault.bcos.dev` → **Import** in the sidebar). Click through in the UI and mark each row Pass or Fail. diff --git a/frontend/src/components/GuideReader.svelte b/frontend/src/components/GuideReader.svelte index 890ac51..e2e8bb2 100644 --- a/frontend/src/components/GuideReader.svelte +++ b/frontend/src/components/GuideReader.svelte @@ -245,7 +245,7 @@ > {#if ROLE_ICON[t.tab]}{ROLE_ICON[t.tab]}{/if} {t.tab} - {#if t.audience === 'internal'}internal{/if} + {#if t.audience !== 'customer'}{t.audience}{/if} {/each}