# Veridian Edge Agent

SensorPush integration agent for the Veridian Cultivation Platform. Runs on Raspberry Pi or Ubuntu, polls SensorPush Cloud API, and syncs environmental readings to the Veridian backend.

## Features

- 🌡️ **SensorPush Integration** – OAuth 2.0 authentication with automatic token refresh
- 💾 **Offline Resilience** – SQLite buffer for network outages
- 🏥 **Health Monitoring** – HTTP endpoints for health checks and Prometheus metrics
- 🔄 **Auto-Recovery** – Systemd service with watchdog

## Quick Start

### Prerequisites

- Raspberry Pi 4 (2GB+ RAM) or Ubuntu 22.04+
- SensorPush G1 WiFi Gateway
- Bun 1.x runtime

### Installation

```bash
# Clone repository
git clone https://git.runfoo.run/malty/veridian-edge.git
cd veridian-edge

# Run installer
sudo ./scripts/install.sh
```

### Configuration

Edit `/opt/veridian-edge/config.json`:

```json
{
  "facilityId": "your-facility-uuid",
  "backendUrl": "https://api.veridian.runfoo.run",
  "backendApiKey": "your-api-key",
  "sensorpush": {
    "email": "sensors@facility.com",
    "password": "your-password"
  },
  "sensorMappings": [
    {
      "sensorId": "123456.7890",
      "roomId": "room-uuid",
      "name": "Flower Room 1"
    }
  ]
}
```

### Service Management

```bash
# Start service
sudo systemctl start veridian-edge

# Check status
sudo systemctl status veridian-edge

# View logs
journalctl -u veridian-edge -f

# Health check
curl http://localhost:3030/health
```

## Development

```bash
# Install dependencies
bun install

# Run in development mode
bun run dev
```

## Architecture

```
┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  SensorPush     │ ──▶ │  Veridian Edge   │ ──▶ │  Veridian API   │
│  Cloud API      │     │  Agent           │     │  Backend        │
└─────────────────┘     └────────┬─────────┘     └─────────────────┘
                                 │
                        ┌────────▼─────────┐
                        │  SQLite Buffer   │
                        │  (offline cache) │
                        └──────────────────┘
```

## License

Proprietary - Veridian Cultivation Platform