Quem pode fazer o quê

Existem quatro camadas de permissão na aplicação:

Papéis no Gateway

O Gateway valida o JWT emitido pelo Keycloak e extrai o sub, preferred_username, email e papéis efetivos.

Papel	O que faz na prática
Usuário autenticado	Consulta perfil, sensores permitidos, medições, ofertas, ordens, trades, eventos e pedidos de depósito
Administrador de sistema	Papel configurado em `SYSTEM_ADMIN_ROLES`, por padrão `ADMIN`; acessa todos os sensores e rotas administrativas
Operador de sensor	Papel configurado em `SENSOR_OPERATOR_ROLES`, por padrão `SENSOR_ADMIN`; pode criar sensores pelo Gateway
Sensor admin	Vínculo persistido no Auth Service para um par `sensor_id` e `keycloak_user_id`

O papel global SENSOR_ADMIN permite criar sensores. Para operar um sensor específico, o usuário também precisa do vínculo sensor_admin, a menos que seja administrador de sistema.

Vínculo por sensor

O Auth Service guarda a relação:

Campo	Uso
`sensor_id`	UUID do sensor no Meters Service
`keycloak_user_id`	Claim `sub` do usuário no Keycloak
`role`	Valor atual: `sensor_admin`

Quando o Gateway precisa consultar ou alterar um sensor, ele pergunta ao Auth Service se o usuário tem vínculo ativo. A criação do sensor também cria o vínculo do criador e dos admins adicionais enviados no corpo da requisição.

Device e assinatura

O smart meter não usa JWT. Ele se autentica por dois elementos:

Elemento	Onde aparece
`X-Sensor-Id`	Header das medições, pode ser UUID do sensor ou `deviceId`
`X-Sensor-Signature`	HMAC SHA-256 do payload JSON canônico
`public_key`	Segredo HMAC gerado no boot e guardado no Meters Service
Carteira Besu	Endereço usado para pagamentos com `EuroToken` e registo do sensor on-chain

O segredo HMAC só é devolvido no primeiro boot. Se o mesmo deviceId voltar com a mesma carteira, o servidor responde already_registered: true e não reemite o segredo.

Token interno

Rotas service-to-service usam X-Internal-Token. O mesmo segredo é usado como metadata x-internal-token nas chamadas gRPC.

Serviço	Uso interno
Gateway -> Auth	Criar e verificar vínculo `sensor_admin`
Gateway -> Meters	Criar, listar, atualizar sensor e gravar medição
Gateway -> Market	Política de preço, ofertas, ordens e trades
Gateway -> Transactions	Registo on-chain, pagamentos pendentes e recibos
Gateway -> Oracle	Pedidos de depósito via bridge
Gateway -> Indexer	Eventos indexados e eventos por transação
Market -> Transactions	Preparar pagamento com `EuroToken`
Transactions -> Market	Confirmar pagamento ou marcar erro

Tabela rápida

Eu quero	Quem pode
Entrar na aplicação	Usuário com login Keycloak válido
Criar sensor	Usuário com papel global de operador de sensor
Listar meus sensores	Usuário autenticado, filtrado por vínculo
Ver qualquer sensor	Administrador de sistema
Alterar sensor ou política	Administrador de sistema ou sensor admin daquele sensor
Enviar medição	Device com HMAC válido e sensor ativo
Assinar pagamento	Carteira Besu local do device comprador
Confirmar depósito via bridge	Dono do pedido autenticado
Chamar rotas internas	Serviço com `X-Internal-Token` válido

Papéis on-chain dos contratos atuais

Os papéis on-chain em uso são:

Contrato	Papel	Uso
`EuroToken`	`MINTER_ROLE`	Permite mint do token privado após bridge aprovado
`SensorRegistry`	`REGISTRAR_ROLE`	Registra, habilita e desabilita sensores
`EnergyMarket`	`OPERATOR_ROLE`	Cria, cancela e compra ofertas on-chain
`EnergySettlement`	`OPERATOR_ROLE`	Registra liquidações

Cadastro e equipe

Como entrar na aplicação e cadastrar sensores

BrightCity Chain

Contratos

Plataforma energética

Papéis no Gateway

Vínculo por sensor

Device e assinatura

Token interno

Tabela rápida

Papéis on-chain dos contratos atuais

Cadastro e equipe

​Papéis no Gateway

​Vínculo por sensor

​Device e assinatura

​Token interno

​Tabela rápida

​Papéis on-chain dos contratos atuais

Cadastro e equipe

Papéis no Gateway

Vínculo por sensor

Device e assinatura

Token interno

Tabela rápida

Papéis on-chain dos contratos atuais