idea78-solarsphere-offline-first/README.md

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.