How boavizta/boaviztapi works
BoaviztAPI is a FastAPI service that estimates embedded and electricity-use environmental impacts for equipment and digital services. The main workflow accepts a request for a device, component, or cloud instance; maps supplied parameters into domain models; computes selected impact criteria; and returns results, optionally with verbose attribute detail. The README also describes equipment and service assessments as distinct layers. The graph preserves the documented IoT, peripheral, consumption-profile, and utility API branches; their implementation links are limited where source excerpts were not provided.
Main entry points: main.py FastAPI app · dto Request DTOs · impacts_computation.py Impact computation · server_router.py Server API
Components 21
API surface
- FastAPI app
boaviztapi/main.py - Server API
boaviztapi/routers/server_router.py - Cloud API
boaviztapi/routers/cloud_router.py - Component API
boaviztapi/routers/component_router.py - Terminal API
boaviztapi/routers/terminal_router.py - Peripheral API
boaviztapi/routers/peripheral_router.py - IoT API
boaviztapi/routers/iot_router.py - Consumption profiles
boaviztapi/routers/consumption_profile_router.py - Utility API
boaviztapi/routers/utils_router.py
Request and domain models
- Request DTOs
boaviztapi/dto - Usage mapping
boaviztapi/dto/usage/usage.py - Server model
boaviztapi/models/device/server.py - Cloud instance model
boaviztapi/models/services/cloud_instance.py - Component models
boaviztapi/models/component - Attribute state
boaviztapi/models/boattribute.py
Impact calculation
- Impact computation
boaviztapi/compute/impacts_computation.py - Impact results
boaviztapi/models/impact.py - Verbose output
boaviztapi/compute/verbose.py
Reference data
- Archetype lookup
boaviztapi/data/archetype.py - Impact factors
boaviztapi/data/factor_provider.py
Other components
- API client
Connections 31
- API client → FastAPI app: sends request
README.md - FastAPI app → Server API: registers routes
boaviztapi/main.py - FastAPI app → Cloud API: registers routes
boaviztapi/main.py - FastAPI app → Component API: registers routes
boaviztapi/main.py - FastAPI app → Terminal API: registers routes
boaviztapi/main.py - FastAPI app → Peripheral API: registers routes
boaviztapi/main.py - FastAPI app → IoT API: registers routes
boaviztapi/main.py - FastAPI app → Consumption profiles: registers routes
boaviztapi/main.py - FastAPI app → Utility API: registers routes
boaviztapi/main.py - Server API → Request DTOs: maps request
boaviztapi/routers/server_router.py - Cloud API → Request DTOs: maps request
boaviztapi/routers/cloud_router.py - Component API → Request DTOs: maps request
boaviztapi/routers/component_router.py - Terminal API → Request DTOs: maps request
boaviztapi/routers/terminal_router.py - Peripheral API → Request DTOs: maps request
boaviztapi/routers/peripheral_router.py - Request DTOs → Server model: builds device
boaviztapi/dto/device/device.py - Request DTOs → Cloud instance model: builds service
boaviztapi/dto/device/device.py - Request DTOs → Component models: builds components
boaviztapi/dto/component/gpu.py - Request DTOs → Usage mapping: maps usage
boaviztapi/dto/usage/usage.py - Usage mapping → Attribute state: sets inputs
boaviztapi/dto/usage/usage.py - Server model → Component models: assembles hardware
boaviztapi/models/device/server.py - Cloud instance model → Server model: models platform
boaviztapi/models/services/cloud_instance.py - Server API → Impact computation: computes impacts
boaviztapi/routers/server_router.py - Cloud API → Impact computation: computes impacts
boaviztapi/routers/cloud_router.py - Component API → Impact computation: computes impacts
boaviztapi/routers/component_router.py - Terminal API → Impact computation: computes impacts
boaviztapi/routers/terminal_router.py - Impact computation → Impact factors: reads factors
boaviztapi/compute/impacts_computation.py - Impact computation → Impact results: creates results
boaviztapi/compute/impacts_computation.py - Impact computation → Archetype lookup: loads archetypes
boaviztapi/compute/impacts_computation.py - Archetype lookup → Attribute state: supplies defaults
- Cloud API → Verbose output: formats detail
boaviztapi/routers/cloud_router.py - Server API → Verbose output: formats detail
boaviztapi/routers/server_router.py