31 lines
1.5 KiB
Markdown
31 lines
1.5 KiB
Markdown
# SolarSphere Offline-First MVP
|
||
|
||
Overview
|
||
- A Python-based MVP for offline-first geospatial visualization and telemetry replay. Focuses on simple, well-defined data contracts and deterministic delta reconciliation that can run entirely offline with optional data-sync when connectivity returns.
|
||
|
||
What’s included
|
||
- Core data primitives: Asset, TelemetryPoint, WeatherLayer, Event
|
||
- CSV-based telemetry adapter for MVP data ingestion
|
||
- Delta reconciliation utilities for deterministic merges
|
||
- Lightweight render summary producing JSON suitable for downstream tooling
|
||
- Minimal CLI and a test suite to validate core behavior
|
||
|
||
Getting started
|
||
- Install dependencies and run tests: `bash test.sh`
|
||
- Package: `python3 -m build` (also in test script)
|
||
|
||
Project structure (high level)
|
||
- src/idea78_solarsphere_offline_first/: Python package with core models, adapters, delta logic, and rendering helpers
|
||
- tests/: Unit tests for models, delta logic, and adapters
|
||
- AGENTS.md: Architecture and contribution guidance
|
||
- test.sh: Test runner that executes tests and packaging checks
|
||
|
||
Usage example (quick)
|
||
- Load a CSV telemetry file via CSVAdapter, reconcile with a local delta, and render a snapshot:
|
||
- adapter = CSVAdapter("telemetry.csv")
|
||
- telem = adapter.load_telemetry()
|
||
- snapshot = render.render_snapshot([asset], telem, weather, events)
|
||
- print(snapshot)
|
||
|
||
This repository adheres to the contribution guidelines described in AGENTS.md and is designed to be extended in sprint fashion.
|