# reactoria

> Nuclear Power & Energy Mix Analysis API - Comprehensive nuclear energy assessment including

## Endpoints

### `GET /health`

Health Check

**Responses:**
- `200` — Service is healthy
- `503` — Service unavailable

### `GET /api/v1/info`

API Information

**Responses:**
- `200` — API information

### `GET /api/v1/disclaimer`

API Disclaimer

**Responses:**
- `200` — Important disclaimers

### `POST /api/v1/energy-mix/simulate`

Simulate Energy Mix

Simulates energy mix with solar, wind, and nuclear sources to optimize
grid stability and cost.

**Responses:**
- `200` — Energy mix simulation results
- `400` — Invalid request
- `429` — Rate limit exceeded
- `500` — Internal server error

### `POST /api/v1/nuclear/residential-impact`

Assess Residential Impact

Evaluates residential impact zones and population exposure for nuclear facilities.
Calculates PAZ (Precautionary Action Zone) and UPZ (Urgent Protective Action Planning Zone)
based on reactor type, capacity, and location characteristics.

**Responses:**
- `200` — Residential impact assessment
- `400` — Invalid request
- `500` — Internal server error

### `POST /api/v1/nuclear/smr-datacenter`

Analyze SMR for AI Datacenter

Evaluates SMR suitability for powering AI datacenters with analysis of baseload power,
cogeneration potential for cooling, grid independence, and economic viability.
Considers PUE (Power Usage Effectiveness) and 99.99% uptime requirements.

**Responses:**
- `200` — SMR datacenter suitability analysis
- `400` — Invalid request
- `500` — Internal server error

### `POST /api/v1/nuclear/cogeneration`

Analyze Nuclear Cogeneration

Evaluates cogeneration applications for nuclear facilities including district heating,
hydrogen production, desalination, and industrial process heat. Analyzes total efficiency
improvements, economics, and additional revenue opportunities.

**Responses:**
- `200` — Cogeneration analysis
- `400` — Invalid request
- `500` — Internal server error

### `POST /api/v1/nuclear/decommissioning-cost`

Estimate Decommissioning Cost

Calculates comprehensive decommissioning costs for nuclear facilities including
dismantling, waste management, site clearance, and long-term monitoring.
Supports multiple decommissioning strategies and regulatory frameworks.

**Responses:**
- `200` — Decommissioning cost estimate
- `400` — Invalid request
- `500` — Internal server error

### `POST /api/v1/nuclear/lifecycle-carbon`

Calculate Lifecycle Carbon

Comprehensive lifecycle carbon footprint analysis for nuclear facilities including
construction, fuel cycle (mining, enrichment, fabrication), operation, and decommissioning.
Provides comparison with other energy sources and IPCC methodology compliance.

**Responses:**
- `200` — Lifecycle carbon analysis
- `400` — Invalid request
- `500` — Internal server error

### `POST /api/v1/nuclear/reactor-comparison`

Compare Reactor Technologies

Comprehensive multi-criteria comparison of reactor technologies including safety,
economics, environmental impact, scalability, and technological maturity.
Supports weighted scoring and application-specific recommendations.

**Responses:**
- `200` — Reactor comparison results
- `400` — Invalid request
- `500` — Internal server error

### `POST /api/v1/economics/roi-analysis`

Economic ROI Analysis

Comprehensive economic analysis for nuclear facilities including ROI, payback period,
NPV (Net Present Value), IRR (Internal Rate of Return), and LCOE (Levelized Cost of Energy).
Supports sensitivity analysis for electricity prices, capacity factors, and project lifespans.

**Responses:**
- `200` — ROI analysis results
- `400` — Invalid request
- `500` — Internal server error

## Machine-readable spec

- OpenAPI: `/.well-known/openapi.yaml`