Skip to content

Story 15.5 — internal-ops dashboards doc mirror (elasticsql)#121

Closed
fupelaqu wants to merge 1 commit into
release-r1from
feature/15.5
Closed

Story 15.5 — internal-ops dashboards doc mirror (elasticsql)#121
fupelaqu wants to merge 1 commit into
release-r1from
feature/15.5

Conversation

@fupelaqu

Copy link
Copy Markdown
Contributor

Story 15.5 — internal-ops dashboards doc mirror (Epic 15, last story)

Docs-only. Core-project mirror of the license-server R1 success-criteria Grafana dashboard, per the dual-doc convention (feedback_dual_docs_sync) and the spec's Product Decision P4 — this is the internal-ops operator view (Grafana has no public Ingress); the customer-facing privacy page stays telemetry.md (Story 15.6).

Closes #120 · Closes #119 (Epic 15 — R1 Telemetry, this story completes the epic).

Changes

  • NEW documentation/sql/internal_ops_dashboards.md — points at the license-server dashboard (softclient4es-license-server/docs/ops/grafana/softclient4es-r1-success-criteria.json): the "R1 succeeded" threshold table (downloads >=500/wk, paid signups >=5/90d, case studies >=3/180d), the aggregate-only privacy rule (distinct-instance count never projected), the mandated psql -f apply for r1_sales_signals, and the collapsed-PENDING-row note.
  • UPDATE documentation/sql/README.md — index entry for the new note.

No Scala, no sbt, no scalafmt — Markdown only.

Companion PR

The dashboard itself + migration + ansible wiring ship in softclient4es-license-server#86 (base release-r1).

🤖 Generated with Claude Code

… (Story 15.5)

Core-project mirror of the license-server R1 success-criteria Grafana
dashboard, per the dual-doc convention. Internal-ops operator view (Grafana
has no public Ingress); the customer-facing privacy page stays telemetry.md
(Story 15.6).

- documentation/sql/internal_ops_dashboards.md (NEW): points at
  softclient4es-license-server/docs/ops/grafana/softclient4es-r1-success-
  criteria.json; "R1 succeeded" threshold table (downloads >=500/wk, paid
  signups >=5/90d, case studies >=3/180d), aggregate-only privacy rule
  (distinct-instance count never projected), the mandated psql -f apply for
  r1_sales_signals, and the collapsed-PENDING-row note.
- documentation/sql/README.md: index entry for the new note.

Markdown only (no Scala, no sbt, no scalafmt).

Closed Issue #120
Refs #119

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

Copy link
Copy Markdown
Contributor Author

Closing — Story 15.5 is a license-server ops story, and its operator / internal-dashboard documentation belongs to the license server only.

The dual-docs-sync convention applies to customer-facing docs (privacy/telemetry, client/driver guides, SQL reference) — not to internal ops/operator docs. Mirroring an ops runbook into the elasticsql core project was a misapplication of that rule.

The authoritative ops documentation already lives in softclient4es-license-server:

  • docs/ops/grafana/README.md (R1 success-criteria threshold/privacy/populate detail)
  • docs/ops/grafana/softclient4es-r1-success-criteria.json (the dashboard)

(see license-server PR #86). No elasticsql mirror is needed — this matches the earlier closure of the 15.4 mirror PR #113.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant