This application exposes a GraphQL API for backend operations.
GraphQL provides a flexible query language and a self‑documenting schema.
-
GraphiQL Interface (interactive docs):
http://localhost:8080/graphiqlGraphQL is self‑documenting via introspection.
-
Schema Files:
Located insrc/main/resources/graphql/schema.graphqls(root schema)- Feature‑specific schemas under
auth/,domain/,user/, etc.
-
Self‑Documentation:
The GraphQL schema is introspectable, meaning tools like GraphiQL, Apollo, or Postman can automatically generate documentation.
query GetDeviceById($id: UUID!) {
getDeviceById(id: $id) {
id
name
model
serialNumber
manufacturer
status
lastSeen
bms {
id
temperature
soc
voltage
soh
cycles
batteryChemistry
}
meter {
id
powerDispatched
energyConsumed
energyProduced
}
}
}