# Oya Domain Reference

Generated on May 8, 2026. This folder is the uniform Oshun-local documentation
home for the Oya domain.

## Executive Summary

**Domain Name**: Oya (Yoruba goddess of wind, storms, lightning, and
transformation) **Scope**: scope:oya **Type**: Platform Capability Domain
**Purpose**: Comprehensive AI-controlled drone and swarm management capabilities
consumed by product domains (Lilith, Yemaya, Aphrodite)

## Documentation Contract

- [Feature Inventory](feature-inventory.md)
- [Implementation Map](implementation-map.md)

## Domain Profile

- Domain slug: `oya`
- Display name: Oya
- Aliases: None
- TODO phase coverage: `33`
- TODO phase titles: `Oya - AI-Controlled Drone & Swarm Management Platform`
- Repository status: Repository implementation exists under apps/libs/services.
- Oshun integration status: Referenced in Oshun apps, libraries, or docs.
- Source confidence: Implementation-backed

## Evidence Profile

| Source                    | Status  | Notes                                   |
| ------------------------- | ------- | --------------------------------------- |
| Repository implementation | present | 6 app/lib/service entries discovered    |
| Standalone domain docs    | absent  | 0 entries under docs/domains/oya        |
| TODO phase coverage       | present | 1 mapped phase(s), 2372 checklist items |
| Tests                     | absent  | 0 matching test files discovered        |
| Oshun integration         | present | 1 Oshun-local references discovered     |

## Capability Pillars

| Capability Pillar                           | Primary Source    | Status                           |
| ------------------------------------------- | ----------------- | -------------------------------- |
| Core Types and Definitions                  | TODOS.md phase 33 | planned-or-partially-implemented |
| Physical Constants and Limits               | TODOS.md phase 33 | planned-or-partially-implemented |
| Common Utilities                            | TODOS.md phase 33 | planned-or-partially-implemented |
| Domain-Specific Errors                      | TODOS.md phase 33 | planned-or-partially-implemented |
| Drone Kinematics                            | TODOS.md phase 33 | planned-or-partially-implemented |
| Attitude Control                            | TODOS.md phase 33 | planned-or-partially-implemented |
| Velocity Control                            | TODOS.md phase 33 | planned-or-partially-implemented |
| Position Control                            | TODOS.md phase 33 | planned-or-partially-implemented |
| Mission Execution                           | TODOS.md phase 33 | planned-or-partially-implemented |
| GPS Navigation                              | TODOS.md phase 33 | planned-or-partially-implemented |
| Indoor Positioning                          | TODOS.md phase 33 | planned-or-partially-implemented |
| Visual SLAM                                 | TODOS.md phase 33 | planned-or-partially-implemented |
| Path Planning                               | TODOS.md phase 33 | planned-or-partially-implemented |
| Obstacle Avoidance                          | TODOS.md phase 33 | planned-or-partially-implemented |
| Multi-Agent Coordination                    | TODOS.md phase 33 | planned-or-partially-implemented |
| Collision Avoidance (Multi-Agent)           | TODOS.md phase 33 | planned-or-partially-implemented |
| Formation Flying                            | TODOS.md phase 33 | planned-or-partially-implemented |
| Task Allocation                             | TODOS.md phase 33 | planned-or-partially-implemented |
| Consensus Algorithms                        | TODOS.md phase 33 | planned-or-partially-implemented |
| Inter-Drone Communication                   | TODOS.md phase 33 | planned-or-partially-implemented |
| Shot Planning                               | TODOS.md phase 33 | planned-or-partially-implemented |
| Subject Tracking                            | TODOS.md phase 33 | planned-or-partially-implemented |
| Trajectory Optimization                     | TODOS.md phase 33 | planned-or-partially-implemented |
| Multi-Camera Coordination                   | TODOS.md phase 33 | planned-or-partially-implemented |
| Gimbal Control                              | TODOS.md phase 33 | planned-or-partially-implemented |
| Video Streaming                             | TODOS.md phase 33 | planned-or-partially-implemented |
| Camera Systems                              | TODOS.md phase 33 | planned-or-partially-implemented |
| Depth Sensors                               | TODOS.md phase 33 | planned-or-partially-implemented |
| LiDAR Integration                           | TODOS.md phase 33 | planned-or-partially-implemented |
| IMU and Orientation                         | TODOS.md phase 33 | planned-or-partially-implemented |
| Audio Systems                               | TODOS.md phase 33 | planned-or-partially-implemented |
| Multi-Sensor Fusion                         | TODOS.md phase 33 | planned-or-partially-implemented |
| 2D Pose Detection                           | TODOS.md phase 33 | planned-or-partially-implemented |
| 3D Body Reconstruction                      | TODOS.md phase 33 | planned-or-partially-implemented |
| Multi-View Fusion                           | TODOS.md phase 33 | planned-or-partially-implemented |
| Temporal Tracking                           | TODOS.md phase 33 | planned-or-partially-implemented |
| Form Analysis and Metrics                   | TODOS.md phase 33 | planned-or-partially-implemented |
| DJI SDK Integration                         | TODOS.md phase 33 | planned-or-partially-implemented |
| PX4 Autopilot Integration                   | TODOS.md phase 33 | planned-or-partially-implemented |
| ArduPilot Integration                       | TODOS.md phase 33 | planned-or-partially-implemented |
| MAVLink Protocol                            | TODOS.md phase 33 | planned-or-partially-implemented |
| Generic Hardware Interface                  | TODOS.md phase 33 | planned-or-partially-implemented |
| Model Inference Runtime                     | TODOS.md phase 33 | planned-or-partially-implemented |
| Model Optimization                          | TODOS.md phase 33 | planned-or-partially-implemented |
| Pre-trained Models                          | TODOS.md phase 33 | planned-or-partially-implemented |
| Edge Deployment                             | TODOS.md phase 33 | planned-or-partially-implemented |
| Geofencing                                  | TODOS.md phase 33 | planned-or-partially-implemented |
| Emergency Procedures                        | TODOS.md phase 33 | planned-or-partially-implemented |
| Human-Aware Navigation                      | TODOS.md phase 33 | planned-or-partially-implemented |
| Regulatory Compliance                       | TODOS.md phase 33 | planned-or-partially-implemented |
| Data Collection                             | TODOS.md phase 33 | planned-or-partially-implemented |
| Real-Time Streaming                         | TODOS.md phase 33 | planned-or-partially-implemented |
| Flight Logging                              | TODOS.md phase 33 | planned-or-partially-implemented |
| Post-Flight Analysis                        | TODOS.md phase 33 | planned-or-partially-implemented |
| Gazebo Integration                          | TODOS.md phase 33 | planned-or-partially-implemented |
| AirSim Integration                          | TODOS.md phase 33 | planned-or-partially-implemented |
| jMAVSim Integration                         | TODOS.md phase 33 | planned-or-partially-implemented |
| Physics Simulation                          | TODOS.md phase 33 | planned-or-partially-implemented |
| TypeScript SDK Core                         | TODOS.md phase 33 | planned-or-partially-implemented |
| Drone Control API                           | TODOS.md phase 33 | planned-or-partially-implemented |
| Camera and Gimbal API                       | TODOS.md phase 33 | planned-or-partially-implemented |
| Swarm API                                   | TODOS.md phase 33 | planned-or-partially-implemented |
| Telemetry API                               | TODOS.md phase 33 | planned-or-partially-implemented |
| Schema Design                               | TODOS.md phase 33 | planned-or-partially-implemented |
| Time-Series Storage                         | TODOS.md phase 33 | planned-or-partially-implemented |
| Spatial Data                                | TODOS.md phase 33 | planned-or-partially-implemented |
| Data Access Layer                           | TODOS.md phase 33 | planned-or-partially-implemented |
| Aja Integration (Motion Intelligence)       | TODOS.md phase 33 | planned-or-partially-implemented |
| Aphrodite Integration (Live Streaming)      | TODOS.md phase 33 | planned-or-partially-implemented |
| Lilith Integration (Wellness Platform)      | TODOS.md phase 33 | planned-or-partially-implemented |
| Yemaya Integration (Creative Studio)        | TODOS.md phase 33 | planned-or-partially-implemented |
| Isis Integration (Generative Factory)       | TODOS.md phase 33 | planned-or-partially-implemented |
| Sophia Integration (Knowledge & Learning)   | TODOS.md phase 33 | planned-or-partially-implemented |
| Bellona Integration (Engine Bridges)        | TODOS.md phase 33 | planned-or-partially-implemented |
| Unit Testing                                | TODOS.md phase 33 | planned-or-partially-implemented |
| Integration Testing                         | TODOS.md phase 33 | planned-or-partially-implemented |
| Simulation Testing                          | TODOS.md phase 33 | planned-or-partially-implemented |
| Hardware-in-the-Loop Testing                | TODOS.md phase 33 | planned-or-partially-implemented |
| API Documentation                           | TODOS.md phase 33 | planned-or-partially-implemented |
| Integration Guides                          | TODOS.md phase 33 | planned-or-partially-implemented |
| Architecture Documentation                  | TODOS.md phase 33 | planned-or-partially-implemented |
| Tutorials and Examples                      | TODOS.md phase 33 | planned-or-partially-implemented |
| Build and Packaging                         | TODOS.md phase 33 | planned-or-partially-implemented |
| Service Deployment                          | TODOS.md phase 33 | planned-or-partially-implemented |
| Monitoring and Observability                | TODOS.md phase 33 | planned-or-partially-implemented |
| Foundation Models & Transformer Integration | TODOS.md phase 33 | planned-or-partially-implemented |
| Graph Neural Network Swarm Intelligence     | TODOS.md phase 33 | planned-or-partially-implemented |
| 3D Gaussian Splatting Integration           | TODOS.md phase 33 | planned-or-partially-implemented |
| Natural Language Drone Control              | TODOS.md phase 33 | planned-or-partially-implemented |
| 2025-2026 Hardware Platform Support         | TODOS.md phase 33 | planned-or-partially-implemented |
| Advanced SLAM and VIO (2025)                | TODOS.md phase 33 | planned-or-partially-implemented |
| Event Camera (Neuromorphic) Navigation      | TODOS.md phase 33 | planned-or-partially-implemented |
| FAA Part 108 BVLOS Compliance               | TODOS.md phase 33 | planned-or-partially-implemented |
| Modern Simulation Platforms                 | TODOS.md phase 33 | planned-or-partially-implemented |
| Advanced Pose Estimation Models             | TODOS.md phase 33 | planned-or-partially-implemented |
| Enterprise Platform Features                | TODOS.md phase 33 | planned-or-partially-implemented |
| Next-Gen Power Systems                      | TODOS.md phase 33 | planned-or-partially-implemented |

## Coverage Snapshot

- Code footprint entries: 6
- Standalone domain doc entries: 0
- OpenAPI/API doc entries: 0
- Test evidence files: 0
- Oshun-specific references: 1

## Source Precedence

1. Actual repository implementation under `apps/`, `libs/`, `services/`, and
   `openapi/`
2. Checklist-derived scope from `TODOS.md`
3. Existing standalone domain docs under `docs/domains/oya/`
4. No feature claims are introduced without one of the sources above
