Diseri Pearson
e17921a122
Add portal: customer-facing white-labeled monitoring stack
...
New top-level portal/ project, peer to console/ and firmware/. Delivers a
.NET 10 + React 18 + TimescaleDB + Grafana stack, one container set per
customer behind Traefik. Built in 12 phases per FrontEndPrompt spec; no
changes to existing console or firmware.
Backend (src/Tau.Acuvim.Portal/):
- .NET 10 minimal API, Serilog, ASP.NET Identity (cookie auth, lockout).
- Single AppDbContext with identity / app / monitoring schemas.
- MigrateAsync + TimescaleBootstrapper (idempotent hypertable creation)
+ IdentityBootstrapper (seeded admin + branding) on startup.
- Pure CostCalculator + DB-backed RateService for tariffs (effective-dated,
TOU periods, VAT, fixed charges, per-municipality timezone).
- BrandingService with logo upload to mounted volume.
- Time-series ingest + bucketed query services (time_bucket aggregates,
ON CONFLICT for idempotent re-delivery).
- ConfigOverviewService with redaction-by-construction (passwords never in
payload).
- DataProtection keys persisted to /data/keys volume for cookie survival
across container restarts.
Frontend (frontend/):
- React 18 + TypeScript + Vite + Ant Design 5 + TanStack Query.
- BrandingProvider + ThemedRoot for live re-themed white-labelling.
- RequireAuth / RequireRole guards.
- Pages: Login, Dashboard, Dashboards (embedded Grafana), Sites (admin),
Settings tabs (Branding / Rates / Users / Grafana / App config).
Infra:
- Dev (docker-compose.yml) and prod (docker-compose.prod.yml) compose
files. Three services per customer; Traefik subdomain + same-origin
/grafana path-prefix routing wired with labels.
- Grafana 11 with provisioned timescaledb datasource (uid pinned) and
starter power-overview.json dashboard with device template variable.
- Compose project name documented as lowercase (Compose v2 requirement).
Tests (tests/Tau.Acuvim.Portal.Tests/):
- xUnit, 40 tests. Covers CostCalculator (period match, TZ, overlap,
VAT, fixed), ConnectionStringResolver (all 4 precedence branches incl.
Production refusal), TariffValidator, DayOfWeekFlag.
- All passing locally against .NET 10.
Docs:
- README.md (onboarding + 11 spec sections), OPERATIONS.md (per-customer
provisioning, secret rotation, backup, troubleshooting), TESTING.md
(manual integration scenarios, frontend test scaffolding recipe).
Production safety guards:
- Refuses to start if Authentication:DefaultAdminPassword is unchanged
default in Production.
- Refuses to start if Database:AutoProvisionLocalTimescaleDb=true in
Production.
- Prod Grafana ships with anonymous off and auth mode unset (three
options documented in README Security) so iframe refuses to load
until a deliberate prod auth choice is made.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-18 09:30:30 +02:00
Renier Forster
99864d0a8b
Add CLAUDE.md project onboarding guide
...
Build commands, architecture overview, library gotchas, and conventions
for the firmware, backend, and frontend components.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-05-16 19:07:00 +02:00
Renier Forster
84a0668c54
Initial commit: Tau Acuvim IoT monitoring system
...
Complete IoT monitoring platform for Acuvim II power meters via ESP32.
Firmware (Phases 1-7):
- ESP32-WROVER-B (TTGO T-Call v1.4) with RS485 Modbus RTU
- WiFi STA+AP concurrent mode with GSM/GPRS failover
- Transport abstraction layer with 4 priority modes
- MQTT protocol with 20 commands, LWT, QoS, exponential backoff
- SD card offline buffering with JSONL rotation and non-blocking drain
- OTA firmware updates with dual partition rollback protection
- Watchdog timer, crash loop detection, Acuvim health monitoring
- Captive portal provisioning with AP mode
Console backend (Phase 8):
- .NET 10 minimal API with PostgreSQL + EF Core
- JWT authentication, SignalR real-time updates
- MQTTnet 5.x bridge service with health monitoring
- Device, telemetry, firmware, alert, group management
- Rate limiting, security headers, Swagger/OpenAPI
Frontend (Phase 9):
- React 18 + TypeScript + Vite with Ant Design 5
- ECharts telemetry visualization, TanStack Query
- SignalR live updates, device management UI
- Dashboard, fleet management, firmware deployment
Testing & Production (Phase 10):
- 28 firmware unit tests (Modbus, JSON, config, version)
- 23 xUnit backend tests (device, telemetry, command, alert)
- Docker Compose with nginx, TLS MQTT, PostgreSQL
- Production deployment, commissioning, and troubleshooting docs
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-05-16 19:05:32 +02:00
