ar-grid-tutor-mobile-ar-digital-twin-for/AGENTS.md

ARCHITECTURE

• Mobile AR Digital Twin MVP skeleton for cross-vendor assets (PV, inverter, wind, storage)
• Core: Python-based digital twin engine with TelemetrySample, AssetModel, TwinEngine
• API: FastAPI scaffold for telemetry ingestion and health endpoints
• Offline caching layer (intentional MVP kept in-memory for simplicity; ready to swap to SQLite)
• Data contracts and adapters: TelemetrySample, AnomalySignal, Alert, GovernanceLog (minimal stubs)

TECH STACK

• Language: Python 3.9+
• Core: ar_grid_tutor_mobile_ar_digital_twin_for.core
• API: api.app (FastAPI)
• Tests: tests/ with pytest
• Packaging: pyproject.toml with setuptools

TESTING & RUNNING

• Run unit tests: ./test.sh (requires pytest and build tooling)
• Build package: python3 -m build
• Run API locally (dev): uvicorn api.app:app --reload --port 8000

CONTRIBUTING RULES

• Use the provided test.sh to verify local changes before publishing
• Do not modify READY_TO_PUBLISH unless you completed a publishable milestone
• AGENTS.md is the canonical onboarding doc for agents; do not delete

NOTE

• This is an MVP skeleton designed for extension; future work will flesh out offline storage, adapters, and governance modules.