♻️ Chapter 2: Core Concepts and Terminology

2.1 Energy Source Classification

WIA-ENE-004 defines a comprehensive taxonomy for renewable energy sources, providing standard identifiers and characteristics for each type. This classification enables consistent data modeling and system integration across diverse implementations.

Energy Source Metadata

Each energy source in WIA-ENE-004 is described using a standardized metadata schema:

{
  "sourceId": "SOLAR-PV-001",
  "sourceType": "SOLAR-PV",
  "metadata": {
    "installDate": "2024-03-15T00:00:00Z",
    "manufacturer": "ExampleSolar Corp",
    "model": "ES-5000-PRO",
    "serialNumber": "ES5K-2024-001234",
    "ratedCapacity": {
      "value": 5000,
      "unit": "kW"
    },
    "location": {
      "latitude": 37.7749,
      "longitude": -122.4194,
      "elevation": 52,
      "timezone": "America/Los_Angeles"
    },
    "certifications": [
      "IEC-61730",
      "UL-1703",
      "WIA-ENE-004-BASIC"
    ],
    "warrantyExpiry": "2034-03-15T00:00:00Z"
  }
}

2.2 Data Models and Schemas

WIA-ENE-004 defines standard data models for representing energy production, consumption, and system state. These models ensure interoperability across different implementations and vendors.

Production Data Model

The production data model captures real-time and historical energy generation information:

{
  "timestamp": "2025-12-25T14:30:00Z",
  "sourceId": "SOLAR-PV-001",
  "production": {
    "instantaneous": {
      "value": 4750,
      "unit": "kW"
    },
    "cumulative": {
      "today": 28500,
      "thisMonth": 845000,
      "lifetime": 12500000,
      "unit": "kWh"
    }
  },
  "efficiency": {
    "current": 95.0,
    "average24h": 94.2,
    "unit": "percent"
  },
  "environmentalConditions": {
    "solarIrradiance": 850,
    "ambientTemperature": 25,
    "panelTemperature": 45,
    "windSpeed": 3.2,
    "humidity": 45
  },
  "quality": {
    "voltage": 480,
    "frequency": 60.0,
    "powerFactor": 0.98,
    "harmonicDistortion": 2.1
  }
}

System State Model

The system state model represents operational status and health indicators:

{
  "sourceId": "WIND-ON-042",
  "timestamp": "2025-12-25T14:30:00Z",
  "operationalState": "ACTIVE",
  "healthStatus": "HEALTHY",
  "alerts": [],
  "components": [
    {
      "componentId": "TURBINE-ROTOR",
      "status": "OPERATIONAL",
      "metrics": {
        "rotationSpeed": 18.5,
        "vibration": 2.3,
        "temperature": 35
      }
    },
    {
      "componentId": "GENERATOR",
      "status": "OPERATIONAL",
      "metrics": {
        "temperature": 65,
        "bearingWear": 15,
        "efficiency": 96.5
      }
    },
    {
      "componentId": "INVERTER",
      "status": "OPERATIONAL",
      "metrics": {
        "temperature": 42,
        "efficiency": 98.2,
        "uptime": 99.97
      }
    }
  ],
  "maintenanceStatus": {
    "lastMaintenance": "2025-11-15T09:00:00Z",
    "nextScheduled": "2026-02-15T09:00:00Z",
    "hoursUntilService": 1234
  }
}

2.3 Communication Protocols

WIA-ENE-004 supports multiple communication protocols to accommodate diverse deployment scenarios and network constraints. Each protocol has specific use cases and trade-offs.

Protocol Selection Guidelines

• Cloud-based systems: Use HTTPS for reliability and compatibility
• Real-time monitoring: Use MQTT or WebSocket for low-latency updates
• Embedded devices: Use CoAP to minimize resource consumption
• Legacy integration: Use Modbus TCP with WIA-ENE-004 adapters
• Hybrid deployments: Combine protocols using protocol bridges

2.4 API Endpoints and Resources

WIA-ENE-004 defines a RESTful API structure for accessing and managing renewable energy resources. All implementations must support the core endpoints, with optional extended endpoints for advanced features.

Core API Endpoints

API Request Example

GET /api/v1/sources/SOLAR-PV-001/production?period=24h HTTP/1.1
Host: api.renewable-energy.example.com
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Accept: application/json

Response:
{
  "sourceId": "SOLAR-PV-001",
  "period": {
    "start": "2025-12-24T14:30:00Z",
    "end": "2025-12-25T14:30:00Z",
    "resolution": "15min"
  },
  "data": [
    {
      "timestamp": "2025-12-24T14:30:00Z",
      "production": 4250,
      "efficiency": 94.4
    },
    {
      "timestamp": "2025-12-24T14:45:00Z",
      "production": 4380,
      "efficiency": 94.8
    }
    // ... 95 more data points
  ],
  "summary": {
    "total": 28500,
    "average": 1187.5,
    "peak": 4750,
    "efficiency": 94.2
  }
}

2.5 Authentication and Authorization

Security is paramount in renewable energy systems. WIA-ENE-004 mandates OAuth 2.0 and JWT-based authentication with role-based access control (RBAC).

Authentication Flow

// Step 1: Client obtains access token
POST /oauth/token HTTP/1.1
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
&client_id=renewable-app-123
&client_secret=secret_key_here
&scope=read:production write:config

// Step 2: Authorization server responds
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "read:production write:config"
}

// Step 3: Client uses token for API requests
GET /api/v1/sources HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Standard Roles and Permissions

2.6 Time Series Data Management

Renewable energy systems generate vast amounts of time-series data. WIA-ENE-004 provides guidelines for efficient storage, retrieval, and aggregation of this data.

Data Retention Policy

Aggregation Functions

WIA-ENE-004 supports standard aggregation functions for time-series data:

// Query aggregated production data
GET /api/v1/sources/SOLAR-PV-001/production/aggregate
  ?period=30d
  &resolution=1d
  &functions=sum,avg,max,min

Response:
{
  "sourceId": "SOLAR-PV-001",
  "aggregations": {
    "sum": 845000,
    "avg": 28166.67,
    "max": 35000,
    "min": 18500,
    "unit": "kWh"
  },
  "daily": [
    {
      "date": "2025-11-25",
      "sum": 28500,
      "avg": 1187.5,
      "max": 4750,
      "min": 0
    }
    // ... 29 more days
  ]
}

2.7 Event and Alert Management

WIA-ENE-004 defines a comprehensive event and alert system for proactive monitoring and rapid response to system conditions.

Alert Severity Levels

Alert Data Model

{
  "alertId": "ALT-2025-12-25-001234",
  "sourceId": "WIND-ON-042",
  "severity": "HIGH",
  "type": "PERFORMANCE_DEGRADATION",
  "title": "Turbine efficiency below threshold",
  "description": "Wind turbine WIND-ON-042 operating at 65% efficiency, below 80% threshold",
  "timestamp": "2025-12-25T14:30:00Z",
  "metadata": {
    "currentEfficiency": 65.0,
    "thresholdEfficiency": 80.0,
    "component": "GENERATOR",
    "possibleCause": "Bearing wear or lubrication issue"
  },
  "actions": [
    {
      "action": "SCHEDULE_MAINTENANCE",
      "priority": "HIGH",
      "estimatedDuration": "4 hours"
    },
    {
      "action": "NOTIFY_TEAM",
      "recipients": ["ops@example.com", "+1-555-0100"]
    }
  ],
  "status": "OPEN",
  "acknowledgedBy": null,
  "resolvedAt": null
}

2.8 Units and Measurements

To ensure consistency and avoid errors, WIA-ENE-004 mandates the use of standard units for all measurements. The International System of Units (SI) is used throughout, with specific conventions for energy-related quantities.

2.9 Metadata and Taxonomies

Comprehensive metadata enables effective discovery, filtering, and organization of renewable energy resources. WIA-ENE-004 defines standard metadata fields and controlled vocabularies.

Required Metadata Fields

• sourceId: Unique identifier (format: TYPE-XXX-NNNNN)
• sourceType: From standard taxonomy (SOLAR-PV, WIND-ON, etc.)
• location: Geographic coordinates (latitude, longitude, elevation)
• ratedCapacity: Maximum power output under standard conditions
• installDate: ISO 8601 date when system became operational
• operator: Legal entity responsible for operations
• compliance: Certifications and standards compliance

Optional Metadata Fields

• tags: User-defined labels for organization and search
• customFields: Domain-specific extensions
• relatedSources: Links to associated systems (e.g., battery storage)
• documentation: URLs to manuals, schematics, and reports
• contacts: Key personnel with roles and contact information

2.10 Terminology Glossary

Understanding the precise terminology used in WIA-ENE-004 is essential for correct implementation. This glossary defines key terms as used in the standard.