{"openapi":"3.1.0","info":{"title":"Reactoria API","version":"1.0.0","description":"Nuclear Power & Energy Mix Analysis API - Comprehensive nuclear energy assessment including\nSMR evaluation, residential impact, cogeneration, lifecycle carbon, reactor comparison, and economic analysis.\n","contact":{"name":"Harmonias Support","url":"https://harmonias.org/support"},"license":{"name":"Proprietary","url":"https://harmonias.org/license"}},"servers":[{"url":"https://reactoria.harmonias.org","description":"Production"}],"tags":[{"name":"Energy Mix","description":"Energy mix simulation and optimization"},{"name":"Nuclear Analysis","description":"Nuclear facility assessment and comparison"},{"name":"SMR","description":"Small Modular Reactor analysis"},{"name":"Lifecycle","description":"Carbon footprint and decommissioning"},{"name":"Economics","description":"Financial analysis and ROI calculations"},{"name":"System","description":"Health checks and API information"}],"paths":{"/health":{"get":{"tags":["System"],"summary":"Health Check","operationId":"healthCheck","responses":{"200":{"description":"Service is healthy","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"},"examples":{"normalOperation":{"summary":"Normal operation","value":{"status":"healthy","service":"Reactoria API","timestamp":"2025-11-25T10:30:00Z","version":"1.0.0","uptime":864000}},"maintenanceMode":{"summary":"Maintenance mode","value":{"status":"degraded","service":"Reactoria API","timestamp":"2025-11-25T10:30:00Z","version":"1.0.0","uptime":432000,"message":"Scheduled maintenance in progress"}}}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":"Service Unavailable","message":"Nuclear monitoring systems offline","code":"DATA_NOT_AVAILABLE","success":false}}}}},"security":[]}},"/api/v1/info":{"get":{"tags":["System"],"summary":"API Information","operationId":"getApiInfo","responses":{"200":{"description":"API information","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiInfo"},"example":{"service":"Reactoria API","version":"1.0.0","description":"Nuclear Power & Energy Mix Analysis API","endpoints":{"energyMix":"/api/v1/energy-mix/simulate","residentialImpact":"/api/v1/nuclear/residential-impact","smrDatacenter":"/api/v1/nuclear/smr-datacenter","cogeneration":"/api/v1/nuclear/cogeneration","decommissioning":"/api/v1/nuclear/decommissioning-cost","lifecycleCarbon":"/api/v1/nuclear/lifecycle-carbon","reactorComparison":"/api/v1/nuclear/reactor-comparison","roiAnalysis":"/api/v1/economics/roi-analysis"},"tiers":{"free":{"rateLimit":100,"features":["basic_analysis","energy_mix","reactor_comparison"]},"basic":{"rateLimit":1000,"features":["advanced_analysis","cogeneration","lifecycle"]},"pro":{"rateLimit":10000,"features":["all_features","priority_support","custom_models"]}}}}}}}}},"/api/v1/disclaimer":{"get":{"tags":["System"],"summary":"API Disclaimer","operationId":"getDisclaimer","responses":{"200":{"description":"Important disclaimers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Disclaimer"},"example":{"service":"Reactoria API","disclaimer":{"general":"This API provides theoretical analysis only. All nuclear facility decisions must comply with local regulations and IAEA standards.","safety":"Safety assessments are estimates based on standard models. Actual safety analysis requires site-specific evaluation by licensed nuclear engineers.","regulatory":"Users must comply with Nuclear Regulatory Authority (NRA) requirements and obtain necessary permits before any nuclear facility implementation.","liability":"Harmonias assumes no liability for decisions made based on API outputs.","dataAccuracy":"While we strive for accuracy, radiation measurements and safety metrics should be verified with official monitoring systems."},"lastUpdated":"2025-11-25T00:00:00Z"}}}}}}},"/api/v1/energy-mix/simulate":{"post":{"tags":["Energy Mix"],"summary":"Simulate Energy Mix","operationId":"simulateEnergyMix","description":"Simulates energy mix with solar, wind, and nuclear sources to optimize\ngrid stability and cost.\n","security":[{"ApiKeyAuth":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnergyMixInput"},"example":{"location":{"lat":35.6812,"lon":139.7671,"region":"kanto"},"demand":{"peak":1000,"annual":5000000},"sources":{"solar":{"capacity":200,"priority":1},"wind":{"capacity":100,"priority":2},"nuclear":{"capacity":500,"priority":3}}}}}},"responses":{"200":{"description":"Energy mix simulation results","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnergyMixResponse"},"example":{"success":true,"basic":{"totalOutput":4500000,"demandCoverage":0.9,"riskAssessment":{"overall":"low","score":0.25,"message":"Stable baseload with renewable integration"},"microReactorComparison":{"count":2,"message":"Equivalent to 2 SMRs"},"existingNuclear":{"recommendation":"Maintain existing capacity"}},"tier":"free"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missingFields":{"summary":"Missing required fields","value":{"error":"Validation Error","message":"Missing required parameters: location, demand, sources","code":"MISSING_REQUIRED_FIELDS","success":false}},"invalidLocation":{"summary":"Invalid location coordinates","value":{"error":"Validation Error","message":"Invalid coordinates: latitude must be between -90 and 90","code":"INVALID_LOCATION","details":{"field":"location.lat","value":95.5,"constraint":"range(-90, 90)"},"success":false}},"invalidCapacity":{"summary":"Invalid nuclear capacity","value":{"error":"Validation Error","message":"Nuclear capacity cannot exceed regional grid capacity","code":"INVALID_CAPACITY","details":{"requested":1200,"maximum":1000,"unit":"MW"},"success":false}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/nuclear/residential-impact":{"post":{"tags":["Nuclear Analysis"],"summary":"Assess Residential Impact","operationId":"assessResidentialImpact","description":"Evaluates residential impact zones and population exposure for nuclear facilities.\nCalculates PAZ (Precautionary Action Zone) and UPZ (Urgent Protective Action Planning Zone)\nbased on reactor type, capacity, and location characteristics.\n","security":[{"ApiKeyAuth":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResidentialImpactInput"},"examples":{"smrSuburban":{"summary":"SMR in suburban area","value":{"facility":{"type":"smr","capacity":300,"location":{"lat":35.5,"lon":139.5}},"populationDensity":"suburban","coastalProximity":"inland"}},"pwrCoastal":{"summary":"Large PWR coastal facility","value":{"facility":{"type":"pwr","capacity":1200,"location":{"lat":37.4224,"lon":138.5981,"region":"niigata"}},"populationDensity":"rural","coastalProximity":"coastal"}},"htgrUrban":{"summary":"HTGR near urban center","value":{"facility":{"type":"htgr","capacity":200,"location":{"lat":35.6812,"lon":139.7671}},"populationDensity":"urban","coastalProximity":"inland"}}}}}},"responses":{"200":{"description":"Residential impact assessment","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResidentialImpactResponse"},"examples":{"smrLowImpact":{"summary":"SMR with low population impact","value":{"success":true,"basic":{"safetyZones":[{"name":"PAZ","radius":5,"population":15000},{"name":"UPZ","radius":30,"population":250000}],"populationImpact":45000,"overallRisk":"low","microReactorAdvantages":["smaller_exclusion_zone","passive_safety","modular_deployment"]},"tier":"free"}},"pwrHighImpact":{"summary":"Large PWR with significant population exposure","value":{"success":true,"basic":{"safetyZones":[{"name":"PAZ","radius":10,"population":85000},{"name":"UPZ","radius":50,"population":1200000}],"populationImpact":320000,"overallRisk":"moderate","evacuationPlanning":{"estimatedTime":12,"routes":6,"shelters":45}},"tier":"free"}},"htgrUrbanConstraints":{"summary":"HTGR near dense urban area","value":{"success":true,"basic":{"safetyZones":[{"name":"PAZ","radius":3,"population":125000},{"name":"UPZ","radius":20,"population":850000}],"populationImpact":425000,"overallRisk":"moderate","constraints":["high_population_density","limited_evacuation_routes","urban_infrastructure_dependency"],"recommendations":["consider_alternative_location","enhanced_safety_systems","urban_emergency_planning"]},"tier":"free"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalidReactorType":{"summary":"Unsupported reactor type","value":{"error":"Validation Error","message":"Reactor type 'fusion' is not supported. Valid types: pwr, bwr, htgr, smr, msr, sfr","code":"INVALID_REACTOR_TYPE","success":false}},"unknownPopulationDensity":{"summary":"Invalid population density classification","value":{"error":"Validation Error","message":"Population density must be one of: urban, suburban, rural, remote","code":"POPULATION_DENSITY_UNKNOWN","details":{"provided":"metropolitan"},"success":false}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/nuclear/smr-datacenter":{"post":{"tags":["SMR"],"summary":"Analyze SMR for AI Datacenter","operationId":"analyzeSMRDatacenter","description":"Evaluates SMR suitability for powering AI datacenters with analysis of baseload power,\ncogeneration potential for cooling, grid independence, and economic viability.\nConsiders PUE (Power Usage Effectiveness) and 99.99% uptime requirements.\n","security":[{"ApiKeyAuth":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SMRDatacenterInput"},"examples":{"htgrDatacenter":{"summary":"HTGR for large AI datacenter","value":{"datacenter":{"capacity":100,"pue":1.2,"availability":0.9999},"smrSpecs":{"type":"htgr","capacity":150,"thermalOutput":400},"grid":{"connectionCapacity":50,"backupRequired":true}}},"mwrHyperscale":{"summary":"Multiple SMRs for hyperscale facility","value":{"datacenter":{"capacity":500,"pue":1.15,"availability":0.99999},"smrSpecs":{"type":"smr","capacity":300,"thermalOutput":800,"count":2},"grid":{"connectionCapacity":100,"backupRequired":true},"cogeneration":{"coolingIntegration":true,"wasteHeatRecovery":0.85}}},"edgeDatacenter":{"summary":"Small SMR for edge computing","value":{"datacenter":{"capacity":20,"pue":1.25,"availability":0.999},"smrSpecs":{"type":"smr","capacity":30,"thermalOutput":80},"grid":{"connectionCapacity":10,"backupRequired":false}}}}}}},"responses":{"200":{"description":"SMR datacenter suitability analysis","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SMRDatacenterResponse"},"examples":{"highSuitability":{"summary":"High suitability with cogeneration","value":{"success":true,"data":{"suitability":"high","benefits":["baseload_power","low_carbon","cogeneration_potential","grid_independence"],"powerMatching":{"datacenterLoad":100,"smrCapacity":150,"margin":50,"adequacy":"excellent"},"economics":{"lcoe":0.055,"payback":8,"carbonCredits":5000000,"coolingCostReduction":35},"availability":{"uptime":0.9995,"redundancy":"n_plus_1"}},"tier":"free"}},"moderateSuitability":{"summary":"Moderate suitability with grid backup","value":{"success":true,"data":{"suitability":"moderate","benefits":["consistent_baseload","reduced_carbon_footprint"],"concerns":["requires_grid_backup","capacity_margin_low","regulatory_approval_needed"],"powerMatching":{"datacenterLoad":500,"smrCapacity":600,"margin":100,"adequacy":"adequate"},"economics":{"lcoe":0.062,"payback":10,"carbonCredits":12000000},"availability":{"uptime":0.9992,"redundancy":"grid_backup_required"}},"tier":"free"}},"lowSuitability":{"summary":"Low suitability - inadequate capacity","value":{"success":true,"data":{"suitability":"low","concerns":["insufficient_capacity","poor_economics","high_grid_dependency"],"powerMatching":{"datacenterLoad":500,"smrCapacity":300,"deficit":200,"adequacy":"insufficient"},"recommendation":"Consider larger SMR capacity or multiple units","alternatives":["grid_primary_smr_backup","hybrid_renewable_smr","defer_until_capacity_available"]},"tier":"free"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalidSMRSpec":{"summary":"Invalid SMR specification","value":{"error":"Validation Error","message":"SMR capacity must be sufficient for datacenter baseload","code":"SMR_SPEC_INVALID","details":{"datacenterCapacity":500,"smrCapacity":200,"minimumRequired":400},"success":false}},"datacenterConfigError":{"summary":"Invalid datacenter configuration","value":{"error":"Validation Error","message":"PUE must be between 1.0 and 3.0","code":"DATACENTER_CONFIG_ERROR","details":{"field":"pue","value":0.8,"validRange":"1.0-3.0"},"success":false}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/nuclear/cogeneration":{"post":{"tags":["Nuclear Analysis"],"summary":"Analyze Nuclear Cogeneration","operationId":"analyzeNuclearCogeneration","description":"Evaluates cogeneration applications for nuclear facilities including district heating,\nhydrogen production, desalination, and industrial process heat. Analyzes total efficiency\nimprovements, economics, and additional revenue opportunities.\n","security":[{"ApiKeyAuth":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NuclearCogenerationInput"},"examples":{"districtHeating":{"summary":"District heating cogeneration","value":{"reactor":{"type":"smr","capacity":300,"thermalEfficiency":0.33},"application":"district_heating","heatDemand":{"winter":250,"summer":80,"averageAnnual":180},"economics":{"discountRate":0.08,"projectLife":40}}},"hydrogenProduction":{"summary":"Green hydrogen production via HTGR","value":{"reactor":{"type":"htgr","capacity":200,"thermalEfficiency":0.45,"thermalOutput":600},"application":"hydrogen_production","hydrogenTarget":{"dailyProduction":50,"purity":0.9999},"economics":{"discountRate":0.06,"projectLife":30,"hydrogenPrice":4.5}}},"desalination":{"summary":"Seawater desalination","value":{"reactor":{"type":"smr","capacity":150,"thermalEfficiency":0.33},"application":"desalination","waterDemand":{"dailyCapacity":100000,"targetPurity":"potable"},"economics":{"discountRate":0.07,"projectLife":35,"waterPrice":1.2}}},"industrialProcess":{"summary":"Industrial process heat","value":{"reactor":{"type":"htgr","capacity":250,"thermalEfficiency":0.4},"application":"industrial_process","processRequirements":{"temperature":850,"steamPressure":180,"continuousOperation":true},"economics":{"discountRate":0.08,"projectLife":40}}}}}}},"responses":{"200":{"description":"Cogeneration analysis","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NuclearCogenerationResponse"},"examples":{"districtHeatingSuccess":{"summary":"District heating - high efficiency","value":{"success":true,"data":{"efficiency":{"electrical":0.33,"thermal":0.55,"total":0.88},"heatOutput":{"capacity":495,"annualDelivery":180,"utilizationFactor":0.75},"economics":{"additionalRevenue":25000000,"paybackReduction":3,"heatPrice":0.08},"environmental":{"co2Avoided":45000,"comparedTo":"natural_gas_boilers"}},"tier":"free"}},"hydrogenProduction":{"summary":"Hydrogen production economics","value":{"success":true,"data":{"efficiency":{"electrical":0.45,"thermal":0.42,"total":0.87,"hydrogenConversion":0.65},"hydrogenOutput":{"dailyProduction":50,"annualProduction":18250,"purity":0.9999},"economics":{"additionalRevenue":82125000,"paybackReduction":5,"lcoh":2.8},"marketPotential":{"transportSector":"high","industrialDemand":"moderate","exportOpportunity":"viable"}},"tier":"free"}},"desalinationAnalysis":{"summary":"Seawater desalination viability","value":{"success":true,"data":{"efficiency":{"electrical":0.33,"thermal":0.5,"total":0.83},"waterProduction":{"dailyCapacity":100000,"annualProduction":36500000,"energyPerCubicMeter":3.5},"economics":{"additionalRevenue":43800000,"paybackReduction":4,"waterCost":1.2},"sustainability":{"freshwaterEquivalent":100000,"populationServed":300000}},"tier":"free"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"unsupportedApplication":{"summary":"Unsupported cogeneration application","value":{"error":"Validation Error","message":"Cogeneration application must be one of: district_heating, hydrogen_production, desalination, industrial_process","code":"COGENERATION_TYPE_UNSUPPORTED","details":{"provided":"cryptocurrency_mining"},"success":false}},"insufficientThermalOutput":{"summary":"Insufficient thermal capacity","value":{"error":"Configuration Error","message":"Reactor thermal output insufficient for process requirements","code":"SMR_SPEC_INVALID","details":{"requiredTemperature":950,"reactorMaxTemperature":750,"reactorType":"smr"},"success":false}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/nuclear/decommissioning-cost":{"post":{"tags":["Lifecycle"],"summary":"Estimate Decommissioning Cost","operationId":"estimateDecommissioningCost","description":"Calculates comprehensive decommissioning costs for nuclear facilities including\ndismantling, waste management, site clearance, and long-term monitoring.\nSupports multiple decommissioning strategies and regulatory frameworks.\n","security":[{"ApiKeyAuth":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecommissioningCostInput"},"examples":{"immediateDismantling":{"summary":"Immediate dismantling of PWR","value":{"reactor":{"type":"pwr","capacity":1000,"operationalYears":40,"location":{"lat":37.4224,"lon":138.5981}},"strategy":"immediate_dismantling","siteConditions":{"contamination":"moderate","accessibility":"good","wasteStorageAvailable":true},"wasteManagement":{"onSiteStorage":true,"repositoryDistance":200,"wasteVolume":15000},"regulations":{"country":"japan","regulatoryBody":"nra","clearanceLevels":"standard"},"economics":{"discountRate":0.03,"inflationRate":0.02,"fundingAvailable":70000000000}}},"safeEnclosure":{"summary":"Safe enclosure (SAFSTOR) strategy","value":{"reactor":{"type":"bwr","capacity":800,"operationalYears":35,"location":{"lat":35.3213,"lon":141.0264}},"strategy":"safe_enclosure","siteConditions":{"contamination":"high","accessibility":"limited","seismicRisk":"high"},"wasteManagement":{"onSiteStorage":true,"repositoryDistance":350,"wasteVolume":12000},"enclosurePeriod":30,"regulations":{"country":"japan","regulatoryBody":"nra","clearanceLevels":"stringent"},"economics":{"discountRate":0.03,"inflationRate":0.02,"fundingAvailable":50000000000}}},"smrDecommissioning":{"summary":"SMR decommissioning - lower cost","value":{"reactor":{"type":"smr","capacity":300,"operationalYears":25,"location":{"lat":35.5,"lon":139.5}},"strategy":"immediate_dismantling","siteConditions":{"contamination":"low","accessibility":"excellent","modularDesign":true},"wasteManagement":{"onSiteStorage":false,"repositoryDistance":150,"wasteVolume":3000},"regulations":{"country":"japan","regulatoryBody":"nra","clearanceLevels":"standard"},"economics":{"discountRate":0.04,"inflationRate":0.02,"fundingAvailable":15000000000}}}}}}},"responses":{"200":{"description":"Decommissioning cost estimate","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecommissioningCostResponse"},"examples":{"pwrImmediateDismantling":{"summary":"Large PWR immediate dismantling","value":{"success":true,"data":{"totalCost":80000000000,"breakdown":{"dismantling":32000000000,"wasteManagement":28000000000,"siteClearance":20000000000},"duration":15,"timeline":{"planning":2,"defueling":3,"dismantling":8,"siteClearance":2},"fundingGap":10000000000,"riskFactors":["contamination_uncertainty","waste_repository_availability","regulatory_changes"]},"tier":"free"}},"bwrSafeEnclosure":{"summary":"BWR SAFSTOR strategy","value":{"success":true,"data":{"totalCost":55000000000,"breakdown":{"initialSecurement":15000000000,"monitoring":8000000000,"finalDismantling":32000000000},"duration":45,"timeline":{"defueling":3,"safeEnclosure":2,"monitoringPeriod":30,"finalDismantling":10},"advantages":["reduced_near_term_costs","radioactive_decay_reduces_exposure","technology_improvements_available"],"costSavings":{"presentValue":12000000000,"comparedTo":"immediate_dismantling"}},"tier":"free"}},"smrLowerCost":{"summary":"SMR modular decommissioning","value":{"success":true,"data":{"totalCost":12000000000,"breakdown":{"dismantling":5000000000,"wasteManagement":4000000000,"siteClearance":3000000000},"duration":8,"timeline":{"planning":1,"defueling":1,"dismantling":5,"siteClearance":1},"advantages":["modular_design_simplifies_removal","smaller_waste_volume","lower_contamination_levels","faster_completion"],"costPerMW":40000000,"comparedToLargePWR":{"costReduction":85,"timeReduction":47}},"tier":"free"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalidStrategy":{"summary":"Invalid decommissioning strategy","value":{"error":"Validation Error","message":"Decommissioning strategy must be one of: immediate_dismantling, safe_enclosure, entombment","code":"DECOMMISSIONING_STRATEGY_INVALID","details":{"provided":"delayed_action"},"success":false}},"insufficientFunding":{"summary":"Funding gap warning","value":{"error":"Economic Warning","message":"Estimated cost exceeds available funding by 25%","code":"ROI_CALCULATION_ERROR","details":{"estimatedCost":100000000000,"fundingAvailable":75000000000,"gap":25000000000},"success":false}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/nuclear/lifecycle-carbon":{"post":{"tags":["Lifecycle"],"summary":"Calculate Lifecycle Carbon","operationId":"analyzeLifecycleCarbon","description":"Comprehensive lifecycle carbon footprint analysis for nuclear facilities including\nconstruction, fuel cycle (mining, enrichment, fabrication), operation, and decommissioning.\nProvides comparison with other energy sources and IPCC methodology compliance.\n","security":[{"ApiKeyAuth":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LifecycleCarbonInput"},"examples":{"pwrLifecycle":{"summary":"Large PWR lifecycle analysis","value":{"reactor":{"type":"pwr","capacity":1000,"operationalLife":60,"capacityFactor":0.9},"fuel":{"enrichmentLevel":4.5,"burnup":50,"sourceCountry":"australia"},"construction":{"concrete":250000,"steel":80000,"duration":8},"operation":{"maintenanceIntensity":"moderate","lifeExtension":true},"endOfLife":{"decommissioningStrategy":"immediate_dismantling","wasteDisposal":"deep_geological"}}},"smrLifecycle":{"summary":"SMR low-carbon profile","value":{"reactor":{"type":"smr","capacity":300,"operationalLife":40,"capacityFactor":0.92},"fuel":{"enrichmentLevel":4,"burnup":45,"sourceCountry":"canada","recycling":false},"construction":{"concrete":40000,"steel":15000,"duration":3,"modularConstruction":true},"operation":{"maintenanceIntensity":"low","lifeExtension":false},"endOfLife":{"decommissioningStrategy":"immediate_dismantling","wasteDisposal":"deep_geological"}}},"htgrAdvanced":{"summary":"HTGR advanced fuel cycle","value":{"reactor":{"type":"htgr","capacity":200,"operationalLife":40,"capacityFactor":0.88},"fuel":{"enrichmentLevel":19.75,"burnup":120,"sourceCountry":"japan","recycling":true,"trisoFuel":true},"construction":{"concrete":35000,"steel":12000,"duration":4},"operation":{"maintenanceIntensity":"low","highTemperature":true},"endOfLife":{"decommissioningStrategy":"immediate_dismantling","wasteDisposal":"deep_geological"}}}}}}},"responses":{"200":{"description":"Lifecycle carbon analysis","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LifecycleCarbonResponse"},"examples":{"pwrStandardProfile":{"summary":"PWR standard lifecycle emissions","value":{"success":true,"data":{"totalEmissions":12,"breakdown":{"construction":4,"fuel":5,"operation":1,"decommissioning":2},"detailedFuelCycle":{"mining":1.2,"conversion":0.8,"enrichment":2.5,"fabrication":0.5},"annualProduction":7884000,"lifetimeEmissions":5663040,"comparison":{"coal":820,"gas":490,"solar":48,"wind":11,"hydro":24},"carbonIntensityReduction":98.5},"tier":"free"}},"smrOptimizedProfile":{"summary":"SMR optimized low-carbon","value":{"success":true,"data":{"totalEmissions":9,"breakdown":{"construction":2.5,"fuel":4,"operation":0.8,"decommissioning":1.7},"detailedFuelCycle":{"mining":0.9,"conversion":0.7,"enrichment":1.8,"fabrication":0.6},"modularAdvantages":{"reducedConstruction":37.5,"efficientManufacturing":true,"lowerWaste":true},"annualProduction":2423520,"lifetimeEmissions":872467,"comparison":{"coal":820,"gas":490,"solar":48,"wind":11},"carbonIntensityReduction":98.9,"ipccCompliance":true},"tier":"free"}},"htgrAdvancedFuelCycle":{"summary":"HTGR with fuel recycling","value":{"success":true,"data":{"totalEmissions":8,"breakdown":{"construction":2.2,"fuel":3.5,"operation":0.8,"decommissioning":1.5},"detailedFuelCycle":{"mining":0.7,"conversion":0.5,"enrichment":1.8,"fabrication":0.5,"recycling":-0.2},"fuelRecyclingBenefit":{"emissionsAvoided":1.5,"wasteReduction":85},"annualProduction":1545216,"lifetimeEmissions":555437,"comparison":{"coal":820,"gas":490,"solar":48,"wind":11},"carbonIntensityReduction":99,"trisoFuelAdvantages":{"higherBurnup":true,"enhancedSafety":true,"reducedWaste":true}},"tier":"free"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"incompleteParameters":{"summary":"Missing lifecycle parameters","value":{"error":"Validation Error","message":"Incomplete lifecycle parameters: construction data required","code":"LIFECYCLE_PARAMS_INCOMPLETE","details":{"missing":["construction.concrete","construction.steel"]},"success":false}},"invalidFuelCycle":{"summary":"Invalid fuel cycle data","value":{"error":"Validation Error","message":"Enrichment level exceeds limit for reactor type","code":"INVALID_REACTOR_TYPE","details":{"reactorType":"smr","enrichmentLevel":20,"maximumAllowed":19.75},"success":false}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/nuclear/reactor-comparison":{"post":{"tags":["Nuclear Analysis"],"summary":"Compare Reactor Technologies","operationId":"compareReactors","description":"Comprehensive multi-criteria comparison of reactor technologies including safety,\neconomics, environmental impact, scalability, and technological maturity.\nSupports weighted scoring and application-specific recommendations.\n","security":[{"ApiKeyAuth":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReactorComparisonInput"},"examples":{"powerGeneration":{"summary":"Large-scale power generation comparison","value":{"comparisonSet":[{"type":"pwr","capacity":1000,"generation":"III+"},{"type":"bwr","capacity":1100,"generation":"III"},{"type":"smr","capacity":300,"generation":"IV"}],"evaluationCriteria":{"safety":0.35,"economics":0.25,"environmental":0.2,"scalability":0.1,"maturity":0.1},"applicationContext":{"purpose":"baseload_power","location":"coastal","gridCapacity":5000}}},"districtHeating":{"summary":"Cogeneration application comparison","value":{"comparisonSet":[{"type":"smr","capacity":300,"generation":"IV"},{"type":"htgr","capacity":200,"generation":"IV"},{"type":"msr","capacity":250,"generation":"IV"}],"evaluationCriteria":{"safety":0.3,"economics":0.2,"environmental":0.15,"cogeneration":0.25,"maturity":0.1},"applicationContext":{"purpose":"cogeneration","heatDemand":"high","location":"urban"}}},"remoteLocation":{"summary":"Remote area micro-reactor","value":{"comparisonSet":[{"type":"smr","capacity":50,"generation":"IV"},{"type":"msr","capacity":30,"generation":"IV"},{"type":"sfr","capacity":40,"generation":"IV"}],"evaluationCriteria":{"safety":0.4,"economics":0.2,"reliability":0.25,"maintenanceRequirements":0.15},"applicationContext":{"purpose":"remote_power","location":"arctic","accessibility":"limited","autonomousOperation":"required"}}}}}}},"responses":{"200":{"description":"Reactor comparison results","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReactorComparisonResponse"},"examples":{"powerGenerationComparison":{"summary":"Baseload power generation winner","value":{"success":true,"data":{"rankings":[{"type":"pwr","score":0.82,"strengths":["proven_technology","high_capacity","mature_supply_chain"],"weaknesses":["long_construction","high_capital_cost"]},{"type":"smr","score":0.81,"strengths":["passive_safety","modular_construction","lower_upfront_cost"],"weaknesses":["limited_deployment","regulatory_uncertainty"]},{"type":"bwr","score":0.75,"strengths":["proven_design","simplified_primary_loop"],"weaknesses":["containment_complexity","older_generation"]}],"recommendation":"pwr","analysis":{"safety":"PWR Gen III+ offers enhanced passive safety; SMR competitive with smaller exclusion zone","economics":"PWR lower LCOE at scale; SMR faster deployment reduces financial risk","environmental":"Comparable lifecycle emissions (11-13 gCO2eq/kWh)","maturity":"PWR proven at scale; SMR requiring regulatory pathways"},"sensitivityAnalysis":{"ifSafetyPriority":"smr","ifCostPriority":"pwr","ifTimeToMarket":"smr"}},"tier":"free"}},"cogenerationComparison":{"summary":"Cogeneration application winner","value":{"success":true,"data":{"rankings":[{"type":"htgr","score":0.89,"strengths":["high_temperature","excellent_cogeneration","passive_safety"],"weaknesses":["development_stage","limited_deployment"]},{"type":"smr","score":0.78,"strengths":["proven_technology","good_cogeneration","modular"],"weaknesses":["lower_temperature","moderate_efficiency"]},{"type":"msr","score":0.72,"strengths":["high_temperature","inherent_safety","fuel_flexibility"],"weaknesses":["early_development","material_challenges"]}],"recommendation":"htgr","analysis":{"safety":"HTGR passive safety with TRISO fuel containment superior for urban cogeneration","economics":"High-temperature enables 25-35% additional revenue from heat/hydrogen","cogeneration":"850°C outlet temperature ideal for hydrogen production, industrial process heat","maturity":"Commercial HTGRs operational in China; regulatory pathway clearer than MSR"},"applicationMatch":{"districtHeating":"excellent","hydrogenProduction":"excellent","industrialProcessHeat":"excellent"}},"tier":"free"}},"remotePowerComparison":{"summary":"Remote location micro-reactor","value":{"success":true,"data":{"rankings":[{"type":"smr","score":0.87,"strengths":["autonomous_operation","minimal_maintenance","proven_concept"],"weaknesses":["transportability_challenges"]},{"type":"msr","score":0.79,"strengths":["compact_design","load_following","atmospheric_pressure"],"weaknesses":["technology_maturity","maintenance_complexity"]},{"type":"sfr","score":0.74,"strengths":["compact_core","high_reliability","passive_cooling"],"weaknesses":["sodium_handling","specialized_expertise"]}],"recommendation":"smr","analysis":{"safety":"SMR passive cooling ideal for limited emergency response capability","reliability":"Autonomous operation 12+ months between refueling","maintenance":"Minimal on-site requirements; remote monitoring viable","economics":"Factory fabrication, barge/rail transport to site"},"deploymentConsiderations":{"transportMethod":"barge_or_rail","crewSize":"3-5","refuelingInterval":18,"remoteMonitoring":"enabled"}},"tier":"free"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"emptyComparisonSet":{"summary":"Empty comparison set","value":{"error":"Validation Error","message":"Comparison set must contain at least 2 reactor types","code":"COMPARISON_SET_EMPTY","success":false}},"invalidWeights":{"summary":"Invalid criteria weights","value":{"error":"Validation Error","message":"Evaluation criteria weights must sum to 1.0","code":"MISSING_REQUIRED_FIELDS","details":{"providedSum":0.85,"required":1},"success":false}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/economics/roi-analysis":{"post":{"tags":["Economics"],"summary":"Economic ROI Analysis","operationId":"analyzeROI","description":"Comprehensive economic analysis for nuclear facilities including ROI, payback period,\nNPV (Net Present Value), IRR (Internal Rate of Return), and LCOE (Levelized Cost of Energy).\nSupports sensitivity analysis for electricity prices, capacity factors, and project lifespans.\n","security":[{"ApiKeyAuth":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ROIAnalysisInput"},"examples":{"smrStandard":{"summary":"SMR standard economics","value":{"capacity":300,"installationCost":2000000000,"maintenanceCostPerYear":30000000,"electricityPrice":12,"capacityFactor":0.92,"projectLifespan":40,"discountRate":0.07}},"pwrLargeScale":{"summary":"Large PWR economics","value":{"capacity":1000,"installationCost":8000000000,"maintenanceCostPerYear":80000000,"fuelCostPerYear":60000000,"electricityPrice":10,"capacityFactor":0.9,"projectLifespan":60,"discountRate":0.05,"decommissioningFund":70000000000}},"htgrCogeneration":{"summary":"HTGR with cogeneration revenue","value":{"capacity":200,"installationCost":1500000000,"maintenanceCostPerYear":25000000,"fuelCostPerYear":20000000,"electricityPrice":11,"capacityFactor":0.88,"projectLifespan":40,"discountRate":0.06,"cogenerationRevenue":35000000,"carbonCredits":8000000}},"microReactorRemote":{"summary":"Micro-reactor remote location","value":{"capacity":50,"installationCost":200000000,"maintenanceCostPerYear":3000000,"electricityPrice":25,"capacityFactor":0.95,"projectLifespan":25,"discountRate":0.08,"dieselReplacement":true,"dieselCostSavings":15000000}}}}}},"responses":{"200":{"description":"ROI analysis results","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ROIAnalysisResponse"},"examples":{"smrPositiveROI":{"summary":"SMR positive economics","value":{"success":true,"data":{"roi":0.095,"paybackPeriod":15,"npv":800000000,"irr":0.078,"lcoe":0.055,"annualRevenue":307584000,"annualCosts":30000000,"totalLifetimeRevenue":12303360000,"profitMargin":0.35,"breakEvenYear":8,"sensitivityAnalysis":{"electricityPriceVariation":{"minus10percent":{"npv":450000000,"lcoe":0.061},"plus10percent":{"npv":1150000000,"lcoe":0.05}},"capacityFactorVariation":{"minus5percent":{"npv":620000000,"lcoe":0.058},"plus5percent":{"npv":980000000,"lcoe":0.052}}}},"tier":"free"}},"pwrLargeScaleEconomics":{"summary":"Large PWR long-term economics","value":{"success":true,"data":{"roi":0.112,"paybackPeriod":18,"npv":3200000000,"irr":0.068,"lcoe":0.048,"annualRevenue":788400000,"annualCosts":140000000,"totalLifetimeRevenue":47304000000,"profitMargin":0.42,"breakEvenYear":12,"lifeExtensionBenefit":{"additionalYears":20,"additionalNPV":1200000000,"lcoeReduction":0.008},"decommissioningProvision":70000000000},"tier":"free"}},"htgrCogenerationBoost":{"summary":"HTGR cogeneration revenue advantage","value":{"success":true,"data":{"roi":0.128,"paybackPeriod":12,"npv":1100000000,"irr":0.092,"lcoe":0.051,"annualRevenue":236544000,"annualCosts":45000000,"cogenerationRevenue":35000000,"carbonCreditRevenue":8000000,"totalAdditionalRevenue":43000000,"totalLifetimeRevenue":11181760000,"profitMargin":0.48,"breakEvenYear":7,"cogenerationImpact":{"revenueIncrease":22,"paybackReduction":3,"lcoeReduction":0.012}},"tier":"free"}},"microReactorViable":{"summary":"Micro-reactor diesel replacement economics","value":{"success":true,"data":{"roi":0.165,"paybackPeriod":8,"npv":180000000,"irr":0.145,"lcoe":0.082,"annualRevenue":103950000,"annualCosts":3000000,"dieselCostSavings":15000000,"totalSavings":375000000,"totalLifetimeRevenue":2598750000,"profitMargin":0.55,"breakEvenYear":4,"dieselComparisonAdvantage":{"costSavings":60,"emissionsReduction":95,"reliabilityImprovement":"99.9% vs 92%","maintenanceReduction":70}},"tier":"free"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalidCapacity":{"summary":"Invalid capacity value","value":{"error":"Validation Error","message":"Capacity must be greater than zero","code":"INVALID_CAPACITY","details":{"provided":-100},"success":false}},"calculationError":{"summary":"Economic calculation error","value":{"error":"Calculation Error","message":"NPV calculation failed: discount rate exceeds IRR","code":"ROI_CALCULATION_ERROR","details":{"discountRate":0.12,"estimatedIRR":0.08,"recommendation":"Review discount rate or improve project economics"},"success":false}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/update/history":{"get":{"summary":"Get history","description":"Auto-generated stub. Schema/responses/parameters TBD.\nPath verified against the mounted URL (updateRoutes at /update, #4298).\n","x-stub":true,"responses":{"200":{"description":"Successful response (schema TBD)"}}}},"/{id}":{"get":{"summary":"Get id","description":"Auto-generated stub. Schema/responses/parameters TBD.\nVerify path matches the actual mounted URL (sub-router prefix may be missing).\n","x-stub":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response (schema TBD)"}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"API key in format: Bearer <api_key>"}},"schemas":{"ReactorType":{"type":"string","enum":["pwr","bwr","htgr","smr","msr","sfr"],"description":"Type of nuclear reactor"},"ReactorGeneration":{"type":"string","enum":["II","III","III+","IV"],"description":"Reactor generation"},"DecommissioningStrategy":{"type":"string","enum":["immediate_dismantling","safe_enclosure","entombment"],"description":"Decommissioning strategy"},"CogenerationApplication":{"type":"string","enum":["district_heating","hydrogen_production","desalination","industrial_process"],"description":"Cogeneration application"},"PopulationDensity":{"type":"string","enum":["urban","suburban","rural","remote"],"description":"Population density classification"},"CoastalProximity":{"type":"string","enum":["coastal","inland"],"description":"Coastal proximity"},"RiskLevel":{"type":"string","enum":["very_low","low","moderate","high","very_high"],"description":"Risk assessment level"},"MeasurementUnit":{"type":"string","enum":["kW","MW","GW","gCO2eq/kWh","km","years"],"description":"Unit of measurement"},"ErrorCode":{"type":"string","enum":["INVALID_REACTOR_ID","SAFETY_THRESHOLD_EXCEEDED","DATA_NOT_AVAILABLE","RADIATION_SENSOR_ERROR","AUTHORIZATION_REQUIRED","EMERGENCY_MODE_ACTIVE","INVALID_LOCATION","INVALID_CAPACITY","MISSING_REQUIRED_FIELDS","INVALID_REACTOR_TYPE","POPULATION_DENSITY_UNKNOWN","COASTAL_DATA_UNAVAILABLE","SMR_SPEC_INVALID","DATACENTER_CONFIG_ERROR","COGENERATION_TYPE_UNSUPPORTED","DECOMMISSIONING_STRATEGY_INVALID","LIFECYCLE_PARAMS_INCOMPLETE","COMPARISON_SET_EMPTY","ROI_CALCULATION_ERROR","RATE_LIMIT_EXCEEDED"],"description":"Standardized error codes for API responses"},"Location":{"type":"object","required":["lat","lon"],"properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lon":{"type":"number","minimum":-180,"maximum":180},"region":{"type":"string"}}},"HealthResponse":{"type":"object","properties":{"status":{"type":"string"},"service":{"type":"string"}}},"ApiInfo":{"type":"object","properties":{"service":{"type":"string"},"version":{"type":"string"},"description":{"type":"string"},"endpoints":{"type":"object"},"tiers":{"type":"object"}}},"Disclaimer":{"type":"object","properties":{"service":{"type":"string"},"disclaimer":{"type":"object"},"lastUpdated":{"type":"string"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"code":{"$ref":"#/components/schemas/ErrorCode"},"details":{"type":"object"},"success":{"type":"boolean","default":false}}},"RateLimitError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"resetAt":{"type":"string","format":"date-time"},"tier":{"type":"string","enum":["free","basic","pro"]}}},"EnergyMixInput":{"type":"object","required":["location","demand","sources"],"properties":{"location":{"$ref":"#/components/schemas/Location"},"demand":{"type":"object"},"sources":{"type":"object"}}},"EnergyMixResponse":{"type":"object","properties":{"success":{"type":"boolean"},"basic":{"type":"object"},"detailed":{"type":"object"},"tier":{"type":"string"}}},"ResidentialImpactInput":{"type":"object","required":["facility"],"properties":{"facility":{"type":"object"},"populationDensity":{"$ref":"#/components/schemas/PopulationDensity"},"coastalProximity":{"$ref":"#/components/schemas/CoastalProximity"}}},"ResidentialImpactResponse":{"type":"object","properties":{"success":{"type":"boolean"},"basic":{"type":"object"},"detailed":{"type":"object"},"tier":{"type":"string"}}},"SMRDatacenterInput":{"type":"object","required":["datacenter","smrSpecs","grid"],"properties":{"datacenter":{"type":"object"},"smrSpecs":{"type":"object"},"grid":{"type":"object"}}},"SMRDatacenterResponse":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"tier":{"type":"string"}}},"NuclearCogenerationInput":{"type":"object","required":["reactor","application","economics"],"properties":{"reactor":{"type":"object"},"application":{"$ref":"#/components/schemas/CogenerationApplication"},"economics":{"type":"object"}}},"NuclearCogenerationResponse":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"tier":{"type":"string"}}},"DecommissioningCostInput":{"type":"object","required":["reactor","strategy","siteConditions","wasteManagement","regulations","economics"],"properties":{"reactor":{"type":"object"},"strategy":{"$ref":"#/components/schemas/DecommissioningStrategy"},"siteConditions":{"type":"object"},"wasteManagement":{"type":"object"},"regulations":{"type":"object"},"economics":{"type":"object"}}},"DecommissioningCostResponse":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"tier":{"type":"string"}}},"LifecycleCarbonInput":{"type":"object","required":["reactor","fuel","construction","operation","endOfLife"],"properties":{"reactor":{"type":"object"},"fuel":{"type":"object"},"construction":{"type":"object"},"operation":{"type":"object"},"endOfLife":{"type":"object"}}},"LifecycleCarbonResponse":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"tier":{"type":"string"}}},"ReactorComparisonInput":{"type":"object","required":["comparisonSet","evaluationCriteria","applicationContext"],"properties":{"comparisonSet":{"type":"array","items":{"type":"object"}},"evaluationCriteria":{"type":"object"},"applicationContext":{"type":"object"}}},"ReactorComparisonResponse":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"tier":{"type":"string"}}},"ROIAnalysisInput":{"type":"object","required":["capacity","installationCost","maintenanceCostPerYear"],"properties":{"capacity":{"type":"number"},"installationCost":{"type":"number"},"maintenanceCostPerYear":{"type":"number"},"electricityPrice":{"type":"number"},"capacityFactor":{"type":"number"},"projectLifespan":{"type":"integer"}}},"ROIAnalysisResponse":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"roi":{"type":"number"},"paybackPeriod":{"type":"number"},"npv":{"type":"number"},"irr":{"type":"number"},"lcoe":{"type":"number"}}}}}}},"security":[{"ApiKeyAuth":[]}]}