Initial production analytics foundation

2026-09-04 05:34:52 +02:00
commit f017d187eb
30 changed files with 1219 additions and 0 deletions
@@ -0,0 +1,39 @@
+# Roadmap
+
+## 0. Bootstrap (this milestone)
+
+Establish package boundaries, architecture documentation, example calculation
+configuration, basic domain/protocol models, tests, and an optional local
+TimescaleDB Compose design.
+
+## 1. ENLYZE API exploration client/CLI (recommended exact next milestone)
+
+A read-only, GET-only raw inspection CLI and fixture sanitizer are implemented.
+The remaining work is live, authorized exploration of machines, signal catalog,
+bounded samples, state history, production-order history, and article/material
+context. Record sanitized fixtures and update `docs/enlyze-api.md` with
+evidence. Do not implement ingestion or a database schema before this is
+complete.
+
+## 2. Persistence foundation
+
+Design and migrate a TimescaleDB schema for derived metrics/events, calculation
+runs, context, and incremental state. Add Grafana-oriented query examples.
+
+## 3. First vertical slice
+
+Implement one configured integration calculation over a verified signal and
+production-order context. Include backfill, rerun/provenance behavior, and
+tests against sanitized fixtures.
+
+## 4. Peak detection
+
+Implement the configurable sawtooth peak detector: retain the current maximum;
+close a cycle after a configurable below-peak fraction remains true for a
+configurable duration; emit one completed peak event; preserve open-cycle
+state.
+
+## Later
+
+State/cycle durations, aggregates by order, rolling statistics, threshold
+events, derivatives, and specific-consumption calculations.