@seedgrid/ai-toolkit 0.0.0-stage → 0.3.0

package/seedgridKB/SeedGrid/Extensions/Indice.md

@@ -0,0 +1,63 @@
+---
+tags: [seedgrid, extension, indice]
+analisado-em: 2026-10-14
+---
+
+# Índice das extensions
+
+Extensions Quarkus, libraries Java e crates Rust equivalentes. Commits analisados: [[SeedGrid/Mapa-dos-repositorios|Mapa dos repositórios]]. Todas as propriedades em uma tabela: [[SeedGrid/Extensions/Catalogo-de-propriedades|Catálogo de propriedades]].
+
+Contagens de propriedades por extension e plataforma: [[SeedGrid/Extensions/Catalogo-de-propriedades|Catálogo de propriedades]]. Enums: [[SeedGrid/Extensions/Catalogo-de-enums|Catálogo de enums]].
+
+## Auth, identidade e tenancy
+
+| Extension | Para que serve | Java | Rust |
+|---|---|---|---|
+| security | JWT RS256, RBAC aditivo, token escopado por empresa, 2FA (TOTP/e-mail/WhatsApp), self-enter, gestão de usuários/roles/empresas. Base das demais. | [[SeedGrid/Extensions/security/Visao-geral\|Visão geral]] · [[SeedGrid/Extensions/security/Configuracao\|Config]] · [[SeedGrid/Extensions/security/Exemplos\|Exemplos]] · [[SeedGrid/Extensions/security/Enums|Enums]] | [[SeedGrid/Extensions/security/Rust\|Rust]] · [[SeedGrid/Extensions/security/Configuracao-Rust\|Config]] |
+| apikeys | API keys `sgkey_` com permissões derivadas da role (máquina-a-máquina). | [[SeedGrid/Extensions/apikeys/Visao-geral\|Visão geral]] · [[SeedGrid/Extensions/apikeys/Configuracao\|Config]] · [[SeedGrid/Extensions/apikeys/Exemplos\|Exemplos]] · [[SeedGrid/Extensions/apikeys/Enums|Enums]] | [[SeedGrid/Extensions/apikeys/Rust\|Rust]] · [[SeedGrid/Extensions/apikeys/Configuracao-Rust\|Config]] |
+| login-tenancy | Fundação single-database multi-empresa (POOLED): orquestra módulos, signup institucional, isolamento por company. | [[SeedGrid/Extensions/login-tenancy/Visao-geral\|Visão geral]] · [[SeedGrid/Extensions/login-tenancy/Configuracao\|Config]] · [[SeedGrid/Extensions/login-tenancy/Exemplos\|Exemplos]] · [[SeedGrid/Extensions/login-tenancy/Enums|Enums]] | [[SeedGrid/Extensions/login-tenancy/Rust\|Rust]] · [[SeedGrid/Extensions/login-tenancy/Configuracao-Rust\|Config]] |
+| subdomain-tenancy | Multitenancy por subdomínio com banco por tenant: resolução por host, provisionamento, migrations por tenant. | [[SeedGrid/Extensions/subdomain-tenancy/Visao-geral\|Visão geral]] · [[SeedGrid/Extensions/subdomain-tenancy/Configuracao\|Config]] · [[SeedGrid/Extensions/subdomain-tenancy/Exemplos\|Exemplos]] · [[SeedGrid/Extensions/subdomain-tenancy/Enums|Enums]] | [[SeedGrid/Extensions/subdomain-tenancy/Rust\|Rust]] · [[SeedGrid/Extensions/subdomain-tenancy/Configuracao-Rust\|Config]] |
+
+## Billing e preços
+
+| Extension | Para que serve | Java | Rust |
+|---|---|---|---|
+| billing | Assinaturas: planos, uso, checkout, portal, webhooks; provider Stripe. | [[SeedGrid/Extensions/billing/Visao-geral\|Visão geral]] · [[SeedGrid/Extensions/billing/Configuracao\|Config]] · [[SeedGrid/Extensions/billing/Exemplos\|Exemplos]] · [[SeedGrid/Extensions/billing/Enums|Enums]] | [[SeedGrid/Extensions/billing/Rust\|Rust]] · [[SeedGrid/Extensions/billing/Configuracao-Rust\|Config]] |
+| ai-pricing | Catálogo de modelos LLM e histórico de preços por 1M tokens; robô agendado propõe mudanças com aprovação humana (só Java). | [[SeedGrid/Extensions/ai-pricing/Visao-geral\|Visão geral]] · [[SeedGrid/Extensions/ai-pricing/Configuracao\|Config]] · [[SeedGrid/Extensions/ai-pricing/Exemplos\|Exemplos]] · [[SeedGrid/Extensions/ai-pricing/Enums|Enums]] | — |
+| exchange | Moedas e cotações diárias com histórico; fontes configuráveis por cadastro, retry; seed USD-BRL PTAX (só Java). | [[SeedGrid/Extensions/exchange/Visao-geral\|Visão geral]] · [[SeedGrid/Extensions/exchange/Configuracao\|Config]] · [[SeedGrid/Extensions/exchange/Exemplos\|Exemplos]] · [[SeedGrid/Extensions/exchange/Enums|Enums]] | — |
+
+## Dados, auditoria e compliance
+
+| Extension | Para que serve | Java | Rust |
+|---|---|---|---|
+| audit | Trilha de auditoria before/after com `@Audit`; stores PostgreSQL e MongoDB. | [[SeedGrid/Extensions/audit/Visao-geral\|Visão geral]] · [[SeedGrid/Extensions/audit/Configuracao\|Config]] · [[SeedGrid/Extensions/audit/Exemplos\|Exemplos]] · [[SeedGrid/Extensions/audit/Enums|Enums]] | [[SeedGrid/Extensions/audit/Rust\|Rust]] · [[SeedGrid/Extensions/audit/Configuracao-Rust\|Config]] |
+| backup | Export de dados por tenant/usuário (ZIP), jobs assíncronos, storage plugável, notificação por e-mail. | [[SeedGrid/Extensions/backup/Visao-geral\|Visão geral]] · [[SeedGrid/Extensions/backup/Configuracao\|Config]] · [[SeedGrid/Extensions/backup/Exemplos\|Exemplos]] · [[SeedGrid/Extensions/backup/Enums|Enums]] | [[SeedGrid/Extensions/backup/Rust\|Rust]] · [[SeedGrid/Extensions/backup/Configuracao-Rust\|Config]] |
+| privacy *(library)* | Criptografia de campo AES-256-GCM + hash de busca HMAC-SHA256 (LGPD). | [[SeedGrid/Extensions/privacy/Visao-geral\|Visão geral]] · [[SeedGrid/Extensions/privacy/Configuracao\|Config]] · [[SeedGrid/Extensions/privacy/Exemplos\|Exemplos]] · [[SeedGrid/Extensions/privacy/Enums|Enums]] | [[SeedGrid/Extensions/privacy/Rust\|Rust]] · [[SeedGrid/Extensions/privacy/Configuracao-Rust\|Config]] |
+
+## Comunicação e tempo real
+
+| Extension | Para que serve | Java | Rust |
+|---|---|---|---|
+| notification | Notificações administrativas por e-mail/WhatsApp com catálogo de eventos, outbox transacional e worker com retry; módulo `api` separado (só Java). | [[SeedGrid/Extensions/notification/Visao-geral\|Visão geral]] · [[SeedGrid/Extensions/notification/Configuracao\|Config]] · [[SeedGrid/Extensions/notification/Exemplos\|Exemplos]] · [[SeedGrid/Extensions/notification/Enums|Enums]] | — |
+| whatsapp | Envio de WhatsApp via Evolution API e Meta Cloud API; provider trocável. | [[SeedGrid/Extensions/whatsapp/Visao-geral\|Visão geral]] · [[SeedGrid/Extensions/whatsapp/Configuracao\|Config]] · [[SeedGrid/Extensions/whatsapp/Exemplos\|Exemplos]] · [[SeedGrid/Extensions/whatsapp/Enums|Enums]] | [[SeedGrid/Extensions/whatsapp/Rust\|Rust]] · [[SeedGrid/Extensions/whatsapp/Configuracao-Rust\|Config]] |
+| realtime | Avisos em tempo real ao usuário logado via SeedGrid Pulse (token de conexão + repasse de `SgUserEvent`). | [[SeedGrid/Extensions/realtime/Visao-geral\|Visão geral]] · [[SeedGrid/Extensions/realtime/Configuracao\|Config]] · [[SeedGrid/Extensions/realtime/Exemplos\|Exemplos]] | [[SeedGrid/Extensions/realtime/Rust\|Rust]] · [[SeedGrid/Extensions/realtime/Configuracao-Rust\|Config]] |
+| broker | Mensageria com SPI e backends memory/redis/nats/rabbitmq (só Rust). | — | [[SeedGrid/Extensions/broker/Visao-geral\|Visão geral]] · [[SeedGrid/Extensions/broker/Configuracao-Rust\|Config]] |
+
+## Infraestrutura
+
+| Extension | Para que serve | Java | Rust |
+|---|---|---|---|
+| resilience | Rate limiting e circuit breaker declarativos (`@SeedGridRateLimit`, `@SeedGridCircuitBreaker`), cache-backed. | [[SeedGrid/Extensions/resilience/Visao-geral\|Visão geral]] · [[SeedGrid/Extensions/resilience/Configuracao\|Config]] · [[SeedGrid/Extensions/resilience/Exemplos\|Exemplos]] · [[SeedGrid/Extensions/resilience/Enums|Enums]] | [[SeedGrid/Extensions/resilience/Rust\|Rust]] · [[SeedGrid/Extensions/resilience/Configuracao-Rust\|Config]] |
+| cache *(library)* | API única sobre Redis/Valkey/Dragonfly. | [[SeedGrid/Extensions/cache/Visao-geral\|Visão geral]] · [[SeedGrid/Extensions/cache/Configuracao\|Config]] · [[SeedGrid/Extensions/cache/Exemplos\|Exemplos]] · [[SeedGrid/Extensions/cache/Enums|Enums]] | [[SeedGrid/Extensions/cache/Rust\|Rust]] · [[SeedGrid/Extensions/cache/Configuracao-Rust\|Config]] |
+| filemanagement *(library)* | Storage de arquivos: filesystem, S3, MinIO, Azure Blob, GCS, Google Drive, OneDrive (config por mapa passado pelo chamador). | [[SeedGrid/Extensions/filemanagement/Visao-geral\|Visão geral]] · [[SeedGrid/Extensions/filemanagement/Configuracao\|Config]] · [[SeedGrid/Extensions/filemanagement/Exemplos\|Exemplos]] | [[SeedGrid/Extensions/filemanagement/Rust\|Rust]] · [[SeedGrid/Extensions/filemanagement/Configuracao-Rust\|Config]] |
+| commons *(library)* | Utilitários, validadores, entidades base, CORS, timezone de negócio. | [[SeedGrid/Extensions/commons/Visao-geral\|Visão geral]] · [[SeedGrid/Extensions/commons/Configuracao\|Config]] · [[SeedGrid/Extensions/commons/Exemplos\|Exemplos]] · [[SeedGrid/Extensions/commons/Enums|Enums]] | — |
+| runtime | `seedgrid-runtime` + `seedgrid-macros`: auto-wiring `#[startup]`/`#[scheduled]` (só Rust). | — | [[SeedGrid/Extensions/runtime/Visao-geral\|Visão geral]] · [[SeedGrid/Extensions/runtime/Configuracao-Rust\|Config]] |
+
+## Totais
+
+- 17 módulos Java documentados (13 extensions + 4 libraries) e 15 unidades Rust (13 crates de porte + broker + runtime/macros).
+- Contagens de propriedades e enums: ver [[SeedGrid/Extensions/Catalogo-de-propriedades|Catálogo de propriedades]] e [[SeedGrid/Extensions/Catalogo-de-enums|Catálogo de enums]].
+
+## Não documentados como extension
+
+`seedgrid-parent` (POM pai), `seedgrid-cli`, `seedgrid-components-mcp`, `seedgrid-test-multitenancy` e `java/examples/*`: ver [[SeedGrid/Mapa-dos-repositorios|Mapa dos repositórios]].

package/seedgridKB/SeedGrid/Extensions/ai-pricing/Configuracao.md

@@ -0,0 +1,124 @@
+---
+tags: [seedgrid, extension, ai-pricing, quarkus, configuracao]
+fonte: java/seedgrid-quarkus-ext-ai-pricing
+branch: main
+commit: 0608ca66b5
+analisado-em: 2026-10-14
+---
+
+# AI Pricing (Quarkus): configuração
+
+Voltar para [[SeedGrid/Extensions/ai-pricing/Visao-geral|Visão geral do ai-pricing]] · [[SeedGrid/Extensions/ai-pricing/Exemplos|Exemplos]]
+
+## 1. Cabeçalho
+
+| Item | Valor |
+|---|---|
+| Prefixos | `seedgrid.ai-pricing.*` e `seedgrid.app.ai-pricing.*` (**dois prefixos**, por herança do produto de origem) |
+| Mecanismo | só `@ConfigProperty`. Não há `@ConfigMapping`, `@ConfigRoot` nem `microprofile-config.properties` no runtime. |
+| Classes | `AiPricingEntityManager`, `AiPricingScheduler`, `AiPricingCheckService` |
+| Fase | runtime (todas) |
+| Configuração em banco | `ai_pricing_config` (`enabled`, `cron`, `source_url`), editável em `PUT /admin/ai/price-approvals/config`. **Não são propriedades**: ver a seção 2.2. |
+
+Abreviação usada na coluna Origem: `rt/` = `java/seedgrid-quarkus-ext-ai-pricing/runtime/src/main/java/br/com/seedgrid/aipricing/`.
+
+Variáveis de ambiente pela regra MP, sem ambiguidade:
+- `seedgrid.ai-pricing.persistence-unit` → `SEEDGRID_AI_PRICING_PERSISTENCE_UNIT`
+- `seedgrid.app.ai-pricing.timezone` → `SEEDGRID_APP_AI_PRICING_TIMEZONE`
+- `seedgrid.app.ai-pricing.source-url` → `SEEDGRID_APP_AI_PRICING_SOURCE_URL`
+
+## 2. Propriedades próprias
+
+### 2.1 Propriedades
+
+| Propriedade | Tipo | Valores aceitos | Padrão | Obrigatória | Comportamento | Uso | Relações | Fase | Origem |
+|---|---|---|---|---|---|---|---|---|---|
+| `seedgrid.ai-pricing.persistence-unit` | Optional\<String\> | nome de PU; vazio ou `<default>` = PU default | — (PU default) | Não | Escolhe o `EntityManager` de todas as tabelas do ai-pricing (repositories). | `AiPricingEntityManager` → `Ai*Repository` | O subdomain-tenancy define `master` no microprofile-config dele (**Confirmado**). As entidades `br.com.seedgrid.aipricing.entities` devem estar mapeadas na mesma PU. | runtime | `rt/repositories/AiPricingEntityManager.java` (construtor) |
+| `seedgrid.app.ai-pricing.timezone` | String (ZoneId) | `ZoneId` válido | `America/Sao_Paulo` | Não | Fuso em que o cron do robô (vindo do banco) é interpretado. **Inferência:** um fuso inválido faz o `schedule()` lançar exceção. No startup isso vira WARN; no `PUT config`, vira erro ao admin ("Expressão de cron inválida", mensagem enganosa). | `AiPricingScheduler#applySchedule` | Trabalha com `ai_pricing_config.cron`. | runtime | `rt/schedulers/AiPricingScheduler.java` (campo `timeZone`) |
+| `seedgrid.app.ai-pricing.source-url` | String (URL) | URL HTTP(S) da página de preços | `https://developers.openai.com/api/docs/pricing` | Não | URL usada **só** quando `ai_pricing_config.source_url` está nula ou vazia. O banco é a fonte de verdade. | `AiPricingCheckService#resolveSourceUrl` | Sobreposta por `ai_pricing_config.source_url`. | runtime | `rt/services/AiPricingCheckService.java` (campo `defaultSourceUrl`) |
+
+### 2.2 Configuração em banco (`ai_pricing_config`, linha única)
+
+| Campo | Default na entidade | Seed V902 | Edição | Efeito |
+|---|---|---|---|---|
+| `enabled` | `false` (boolean Java) | `true` | `PUT /admin/ai/price-approvals/config` `{enabled}` | Com `false` (ou cron vazio), o job não é agendado. |
+| `cron` | `0 0 6 * * ?` | `0 0 6 * * ?` | `{cron}` | Cron Quartz do robô. Se for inválido, faz rollback e retorna erro ao admin. |
+| `source_url` | `https://openai.com/api/pricing` | `https://developers.openai.com/api/docs/pricing` | `{sourceUrl}` | Página lida pelo robô. |
+
+Origem: `rt/entities/AiPricingConfigEntity.java`, `runtime/src/main/resources/db/migration/ai-pricing/V902__seed_ai_models_and_pricing_config.sql`, `rt/controllers/AdminAiPriceApprovalResource#saveConfig`.
+
+### 2.3 Propriedades de outras extensions que governam o ai-pricing
+
+| Propriedade | Dona | Padrão | Efeito |
+|---|---|---|---|
+| `seedgrid.ai-pricing.migration.enabled` | login-tenancy (`LoginTenancyMigrationService`) e subdomain-tenancy (`flyway/MigrationService`) | `false` | Roda `classpath:db/migration/ai-pricing` com a tabela `flyway_schema_history_ai_pricing`. **Não** é lida por esta extension. |
+
+## 3. Propriedades de frameworks
+
+A extension não define nenhuma propriedade de framework: não há `microprofile-config.properties` no runtime. As recomendações abaixo saem do `integration-tests` e do README.
+
+| Propriedade | Recomendação |
+|---|---|
+| `quarkus.flyway.locations` | Incluir `db/migration/ai-pricing` no Flyway nativo, ou ligar `seedgrid.ai-pricing.migration.enabled` nos tenancies. |
+| `quarkus.flyway.table` | Os testes usam `flyway_schema_history_ai_pricing` (o mesmo nome do runner dos tenancies). |
+| `quarkus.hibernate-orm.physical-naming-strategy` | `org.hibernate.boot.model.naming.CamelCaseToUnderscoresNamingStrategy` (as entidades são camelCase e as colunas snake_case). |
+| `quarkus.hibernate-orm.<pu>.packages` | Mapear `br.com.seedgrid.aipricing.entities` na PU configurada. No subdomain-tenancy, só em master (README). |
+
+## 4. Propriedades usadas só em testes
+
+Arquivo `integration-tests/src/test/resources/application.properties`:
+- `quarkus.devservices.enabled=false`
+- `quarkus.flyway.migrate-at-start=true`
+- `quarkus.flyway.locations=db/migration/ai-pricing`
+- `quarkus.flyway.table=flyway_schema_history_ai_pricing`
+- `quarkus.flyway.baseline-on-migrate=true`
+- naming strategy
+- `quarkus.hibernate-orm.schema-management.strategy=none`
+- `quarkus.scheduler.enabled=false`
+- `quarkus.http.test-port=0`
+
+O `ModuloDesligadoTest` sobrescreve `quarkus.flyway.migrate-at-start=false` via `QuarkusTestProfile`.
+
+## 5. Aliases, obsoletas e renomeações
+Não encontradas. O prefixo duplo (`seedgrid.ai-pricing` contra `seedgrid.app.ai-pricing`) é uma inconsistência, não um alias.
+
+## 6. Configuração mínima
+Nenhuma propriedade é obrigatória. No login-tenancy:
+
+```properties
+seedgrid.ai-pricing.migration.enabled=true
+```
+
+O robô só funciona com um bean `AiPriceExtractor` do host (ver [[SeedGrid/Extensions/ai-pricing/Exemplos|Exemplos]]).
+
+## 7. Configuração completa comentada
+
+```properties
+# PU das tabelas do ai-pricing. Sem valor ou <default> = PU default. subdomain-tenancy: master.
+#seedgrid.ai-pricing.persistence-unit=master
+
+# Fuso do cron do robô (o cron vem de ai_pricing_config). Default America/Sao_Paulo.
+seedgrid.app.ai-pricing.timezone=America/Sao_Paulo
+
+# URL usada apenas se ai_pricing_config.source_url estiver vazia.
+# Default https://developers.openai.com/api/docs/pricing
+#seedgrid.app.ai-pricing.source-url=https://<pagina-de-precos>
+
+# (tenancies) aplicar as migrations V900-V903. Default false.
+seedgrid.ai-pricing.migration.enabled=true
+```
+
+## 8. Receitas
+
+| Caso | Como |
+|---|---|
+| Produto sem IA (padrão) | Nada a configurar. Sem migration, a app sobe com WARN, e o robô retorna `SKIPPED`. |
+| Ligar o robô | Aplicar as migrations, implementar `AiPriceExtractor` e deixar `enabled=true` em `ai_pricing_config` (o seed já liga). |
+| Mudar horário ou fonte | `PUT /admin/ai/price-approvals/config` com `{ "cron": "0 0 5 * * ?", "sourceUrl": "https://..." }`. Reagenda na hora. |
+| Fuso diferente | `seedgrid.app.ai-pricing.timezone=UTC` |
+| subdomain-tenancy | `seedgrid.ai-pricing.persistence-unit=master` (já default da extension de tenancy) |
+
+## 9. Dúvidas e lacunas
+- O default da URL de origem diverge: a entidade usa `https://openai.com/api/pricing`, enquanto a propriedade e o seed V902 usam `https://developers.openai.com/api/docs/pricing`. Uma linha criada via `PUT config` sem linha prévia herda o valor da entidade.
+- O default `enabled=false` da entidade, somado ao seed `true`, significa que, se a linha for criada pelo `PUT` antes do seed, o robô nasce desligado.
+- O fuso inválido gera uma mensagem de "cron inválido" (**Inferência**).

package/seedgridKB/SeedGrid/Extensions/ai-pricing/Enums.md

@@ -0,0 +1,40 @@
+---
+tags: [seedgrid, extension, ai-pricing, quarkus, enum]
+fonte: java/seedgrid-quarkus-ext-ai-pricing
+branch: main
+commit: 0608ca66b5
+analisado-em: 2026-10-14
+---
+
+# AI Pricing (Quarkus): enums
+
+Voltar para [[SeedGrid/Extensions/ai-pricing/Visao-geral|Visão geral]] · [[SeedGrid/Extensions/ai-pricing/Configuracao|Configuração]].
+
+A extension **não define nenhum `enum` Java**. Há dois conjuntos de valores fixos, ambos como `String`, documentados aqui porque fazem parte do contrato observável. Nenhum é tipo de propriedade de configuração.
+
+| Conjunto | Onde | Usado em |
+|---|---|---|
+| status da proposta | constantes `STATUS_*` em `runtime/src/main/java/br/com/seedgrid/aipricing/entities/AiModelPriceToApproveEntity.java` | coluna `ai_model_prices_to_approve.status varchar(16) default 'PENDING'` (V900), sem CHECK |
+| status do resultado da checagem | literais em `services/AiPricingCheckService.java` (`CheckOutcome`) | resposta de `POST /admin/ai/price-approvals/check` |
+
+## Status da proposta (`AiModelPriceToApproveEntity.STATUS_*`)
+Campo `String status`; nem a entidade nem o banco validam os valores.
+
+| Valor | Significado | Efeito / onde é tratado | Observações |
+|---|---|---|---|
+| `PENDING` | Proposta (ou erro) aguardando decisão. | Default da coluna e da entidade; criada por `AiPricingCheckService`. Enquanto existir uma `PENDING`, `runCheck` retorna `SKIPPED`. `AiPriceApprovalService` só aprova ou rejeita linhas `PENDING`. | Confirmado. |
+| `APPROVED` | Aprovada. | `AiPriceApprovalService#approve` aplica os preços e marca. | Confirmado. |
+| `REJECTED` | Recusada ou dispensada. | `AiPriceApprovalService#reject`. | Confirmado. |
+
+## Status do resultado da checagem (`CheckOutcome.status`)
+Não persistido; devolvido no campo `status` da resposta de `POST /admin/ai/price-approvals/check`.
+
+| Valor | Significado | Quando |
+|---|---|---|
+| `SKIPPED` | Nada foi feito. | Sem `AiPriceExtractor` configurado, ou já existe proposta/erro pendente. |
+| `ERROR` | Falhou. | Página inacessível, extração falhou ou nenhuma tabela reconhecível. Registra uma linha pendente e publica `ai-pricing.check-failed`. |
+| `NO_CHANGE` | Preços lidos, sem diferença com o catálogo. | Nenhuma proposta criada. |
+| `CHANGES` | Há mudanças de preço. | Cria a proposta `PENDING` e publica `ai-pricing.approval-pending`. |
+
+## Internos
+Nenhum.

package/seedgridKB/SeedGrid/Extensions/ai-pricing/Exemplos.md

@@ -0,0 +1,97 @@
+---
+tags: [seedgrid, extension, ai-pricing, quarkus, exemplos]
+fonte: java/seedgrid-quarkus-ext-ai-pricing
+branch: main
+commit: 0608ca66b5
+analisado-em: 2026-10-14
+---
+
+# AI Pricing (Quarkus): exemplos
+
+Ver [[SeedGrid/Extensions/ai-pricing/Visao-geral|Visão geral]] e [[SeedGrid/Extensions/ai-pricing/Configuracao|Configuração]].
+
+## 1. Dependência
+
+Fonte: README.
+
+```xml
+<dependency>
+    <groupId>br.com.seedgrid</groupId>
+    <artifactId>seedgrid-ai-pricing</artifactId>
+    <version>2026.10.14</version>
+</dependency>
+```
+
+Security e audit-core vêm do host.
+
+## 2. Ligar o robô: implementar `AiPriceExtractor`
+
+O contrato vem do javadoc de `runtime/.../spi/AiPriceExtractor.java`, e a forma da implementação segue o `ExtratorFalso` de `AiPricingRobotTest`. O cliente de LLM (`MeuClienteLlm`) é do host e meramente ilustrativo: a extension não fornece cliente.
+
+```java
+@ApplicationScoped
+public class LlmAiPriceExtractor implements AiPriceExtractor {
+
+    @Inject
+    MeuClienteLlm llm; // do host
+
+    @Override
+    public String extract(String pricingPageContent) throws Exception {
+        String prompt;
+        try (InputStream in = getClass().getResourceAsStream("/ai-pricing/prompts/pricing-extract.md")) {
+            prompt = new String(in.readAllBytes(), StandardCharsets.UTF_8);
+        }
+        // Deve devolver um array JSON: [{"model":..., "inputPricePerMillion":..., 
+        //   "cachedInputPricePerMillion":..., "outputPricePerMillion":...}] ou "[]".
+        // Não engula exceções de rede/timeout: o robô faz retry com backoff.
+        return llm.complete(prompt, pricingPageContent);
+    }
+
+    @Override
+    public boolean isConfigured() {
+        return true;
+    }
+}
+```
+
+O bean do host vence o `NoOpAiPriceExtractor` (`@DefaultBean`) sem configuração extra.
+
+## 3. Configurar o robô pelo admin (REST)
+
+Fonte: `AdminAiPriceApprovalResource`. Requer `AI_PRICE_APPROVE`.
+
+```http
+PUT /admin/ai/price-approvals/config
+Content-Type: application/json
+
+{ "enabled": true, "cron": "0 0 6 * * ?", "sourceUrl": "https://developers.openai.com/api/docs/pricing" }
+```
+
+```http
+POST /admin/ai/price-approvals/check          # roda agora; devolve status/extractedCount/changedCount/message
+POST /admin/ai/price-approvals/{id}/approve
+POST /admin/ai/price-approvals/{id}/reject
+```
+
+## 4. Lançar preço manual de um modelo
+
+Fonte: `AdminModelResource.LaunchPriceRequest`. Requer `AI_MODEL_PRICE_CREATE`. Valores por 1M de tokens.
+
+```http
+POST /admin/ai/models/{publicId}/prices
+Content-Type: application/json
+
+{ "inputPricePerMillion": 0.25, "cachedInputPricePerMillion": 0.03,
+  "outputPricePerMillion": 2.00, "sourceUrl": "https://developers.openai.com/api/docs/pricing" }
+```
+
+Para cadastrar um modelo, `POST /admin/ai/models` recebe `{ "provider": "openai", "model": "gpt-5.1", "label": "GPT-5.1", "currency": "USD", "active": true }` (`ModelRequest`). Esse corpo não leva preço.
+
+## 5. Configuração por tenancy
+
+```properties
+# login-tenancy / subdomain-tenancy: aplicar V900–V903
+seedgrid.ai-pricing.migration.enabled=true
+# subdomain-tenancy já define:
+# seedgrid.ai-pricing.persistence-unit=master
+```

package/seedgridKB/SeedGrid/Extensions/ai-pricing/Visao-geral.md

@@ -0,0 +1,114 @@
+---
+tags: [seedgrid, extension, ai-pricing, quarkus]
+fonte: java/seedgrid-quarkus-ext-ai-pricing
+branch: main
+commit: 0608ca66b5
+analisado-em: 2026-10-14
+---
+
+# AI Pricing (Quarkus): visão geral
+
+Mantém o catálogo de modelos de LLM e o histórico de preços por 1M de tokens (input, cached input e output). Um robô agendado lê a página de preços do provedor e propõe mudanças. As mudanças só entram em vigor depois de **aprovação humana**. Não há crate Rust equivalente.
+
+- Configuração: [[SeedGrid/Extensions/ai-pricing/Configuracao|Configuração do ai-pricing]]
+- Exemplos: [[SeedGrid/Extensions/ai-pricing/Exemplos|Exemplos do ai-pricing]]
+- Enums: [[SeedGrid/Extensions/ai-pricing/Enums|Enums do ai-pricing]]
+
+## Módulos e coordenadas
+
+| Módulo | Artefato |
+|---|---|
+| parent | `br.com.seedgrid:seedgrid-ai-pricing-parent:2026.10.14` (parent `seedgrid-parent:2026.07.02`) |
+| runtime | `br.com.seedgrid:seedgrid-ai-pricing` |
+| deployment | `br.com.seedgrid:seedgrid-ai-pricing-deployment` |
+| integration-tests | não publicado |
+
+A feature Quarkus é `seedgrid-ai-pricing` (`SeedgridAiPricingProcessor`). O processor registra como *unremovable* os services, o scheduler, os resources e os SPIs default.
+
+> Usa Java 21 e Quarkus **3.30.6**: o `pom.xml` do módulo sobrescreve `quarkus.platform.version` (o `seedgrid-parent` usa 3.30.8). O `runtime/src/main/resources/META-INF/quarkus-extension.properties` declara `deployment-artifact=...:1.0.0-SNAPSHOT`, valor fixo e não `${project.version}`. **Confirmado** nos arquivos; o impacto do valor fixo não foi verificado.
+
+### Dependências
+- SeedGrid: `seedgrid-commons` 2026.10.08 (`BaseEntity`, `BusinessException`), `seedgrid-security` 2026.10.08 (`@PermissionsAllowed`, `@MonoCompany`), `seedgrid-audit-core` 2026.09.25 (`@Audit`) e `seedgrid-notification-api`.
+- Quarkus: `arc`, `rest-jackson`, `hibernate-orm` (JPA puro, sem Panache), `scheduler`, `security` e `hibernate-validator`.
+- O motor `seedgrid-notification` é opcional no runtime e só entra como dependência de teste.
+
+## Arquitetura
+
+```mermaid
+flowchart LR
+    SCH[AiPricingScheduler<br/>cron vindo do banco] --> CHK[AiPricingCheckService.runCheck]
+    ADM[POST /admin/ai/price-approvals/check] --> CHK
+    CHK -->|HttpClient GET| PAGE((página de preços))
+    CHK -->|regex determinística, senão| EXT{{AiPriceExtractor SPI}}
+    CHK --> PEND[(ai_model_prices_to_approve)]
+    CHK -. ai-pricing.approval-pending / check-failed .-> NOTIF[notification-api]
+    APR[approve/reject] --> PRICES[(ai_model_prices)]
+```
+
+- `AiPricingScheduler` agenda o job `ai-pricing-daily-check` pela API programática do `Scheduler`. Usa `enabled` e `cron` da tabela `ai_pricing_config` e o fuso de `seedgrid.app.ai-pricing.timezone`. Reagenda ao salvar a config, sem restart. Se a tabela não existir no startup, registra um WARN e não derruba o boot (`ModuloDesligadoTest`).
+- `AiPricingCheckService#runCheck`:
+  - Sem extrator configurado, retorna `SKIPPED`.
+  - Com proposta pendente, também retorna `SKIPPED`.
+  - Caso contrário, baixa a página (connect timeout de 20s, request de 30s) e tenta uma extração determinística por regex. Para página não estruturada, delega ao `AiPriceExtractor` com retry (backoff de 1,5s e 3s).
+  - Compara só os modelos **ativos** do catálogo e cria a proposta pendente.
+  - Erros também viram uma linha pendente, e o evento é publicado.
+- O prompt do extrator está no classpath em `/ai-pricing/prompts/pricing-extract.md`.
+
+## APIs públicas
+
+### SPIs
+| SPI | Default | Assinatura |
+|---|---|---|
+| `AiPriceExtractor` | `NoOpAiPriceExtractor` (`@DefaultBean`, `isConfigured()=false`) | `String extract(String pricingPageContent) throws Exception`; `boolean isConfigured()` |
+| `AiPricingAuditSink` | `NoOpAiPricingAuditSink` | `record(String actionType, String targetType, String targetId, String summary, Map<String,Object> details)`. O README o chama de legado: a auditoria é feita via `@Audit`. |
+
+### Endpoints REST (`RestControllerPath`)
+Todos os resources são `@MonoCompany`.
+
+| Método | Caminho | Permissão |
+|---|---|---|
+| GET | `/admin/ai/models` | `AI_MODEL_READ` |
+| POST | `/admin/ai/models` | `AI_MODEL_CREATE` |
+| PUT/DELETE | `/admin/ai/models/{publicId}` | `AI_MODEL_UPDATE` / `AI_MODEL_DELETE` |
+| GET | `/admin/ai/models/{publicId}/prices` | `AI_MODEL_READ` |
+| POST | `/admin/ai/models/{publicId}/prices` | `AI_MODEL_PRICE_CREATE` |
+| GET | `/admin/ai/price-approvals` | `AI_PRICE_APPROVE` |
+| GET/PUT | `/admin/ai/price-approvals/config` | `AI_PRICE_APPROVE` |
+| POST | `/admin/ai/price-approvals/{id}/approve`, `/{id}/reject` | `AI_PRICE_APPROVE` |
+| POST | `/admin/ai/price-approvals/check` | `AI_PRICE_APPROVE` |
+
+**Confirmado** (`AdminModelResource`, `AdminAiPriceApprovalResource`). As respostas de `/admin/ai/models` incluem `currentPriceValidFrom` (README).
+
+### Eventos de notificação
+Declarados em `AiPricingNotificationCatalog`:
+- `ai-pricing.approval-pending`, com variáveis `proposalId` e `quantity`.
+- `ai-pricing.check-failed`, com variáveis `proposalId` e `failureKind`.
+
+## Migrations
+`db/migration/ai-pricing`, de **V900 a V903**. Histórico em `flyway_schema_history_ai_pricing`.
+
+| Versão | Conteúdo |
+|---|---|
+| V900 | tabelas `ai_models`, `ai_model_prices`, `ai_model_prices_to_approve`, `ai_pricing_config` |
+| V901 | permissões `AI_MODEL_READ/CREATE/UPDATE/DELETE`, `AI_MODEL_PRICE_CREATE` e `AI_PRICE_APPROVE` (audience `platform`, vinculadas a `ADMIN`) |
+| V902 | seed de modelos OpenAI (`gpt-4.1-nano`, `gpt-4.1-mini`, `gpt-5.1`) e da config do robô (ligado, cron `0 0 6 * * ?`, `source_url` = página de preços da OpenAI) |
+| V903 | coluna `active` |
+
+Nos tenancies, o runner aplica essa location só quando `seedgrid.ai-pricing.migration.enabled=true` (default `false`, declarado em login-tenancy e subdomain-tenancy). Ver [[SeedGrid/Extensions/ai-pricing/Configuracao|Configuração]].
+
+## Testes (não executados)
+- `runtime/src/test`:
+  - `AiPricingRobotTest`: robô com extrator falso.
+  - `AiPricingRulesTest`.
+  - `AiPricingAuditContractTest`.
+  - `AiPricingNotificationCatalogTest`.
+- `integration-tests` (PostgreSQL via Testcontainers):
+  - `AiPricingNotificationTest`.
+  - `AiPricingPermissionMigrationTest`.
+  - `ModuloDesligadoTest`: app sobe sem as tabelas.
+  - `PersistedChangesTest`.
+  - `PriceApprovalGateTest`.
+
+## Limitações
+- Sem um bean `AiPriceExtractor`, o robô fica inerte e só retorna `SKIPPED`. Esse é o estado normal de um produto sem IA.
+- Com proposta ou erro pendente, novas checagens são puladas até o admin agir.

package/seedgridKB/SeedGrid/Extensions/apikeys/Configuracao-Rust.md

@@ -0,0 +1,69 @@
+---
+tags: [seedgrid, extension, apikeys, rust, configuracao]
+fonte: rust/seedgrid-rust-crate-apikeys
+branch: main
+commit: be738a2d1e
+analisado-em: 2026-10-14
+---
+
+# Configuração Rust — `seedgrid-rust-crate-apikeys`
+
+Volta para: [[SeedGrid/Extensions/apikeys/Rust|Porte Rust do apikeys]] · Java: [[SeedGrid/Extensions/apikeys/Configuracao|Configuração do apikeys (Quarkus)]]
+
+## 1. Cabeçalho
+
+| Item | Valor |
+|---|---|
+| Struct | `ApiKeysConfig` (`src/config.rs`), com `impl Default` |
+| Prefixo lógico | `seedgrid.apikeys` (porte do `@ConfigMapping(prefix = "seedgrid.apikeys")` de `ApiKeysConfig.java`) |
+| Mecanismo | `ApiKeysConfig::from_env()` lê 2 env vars com `std::env::var` (helper `env_usize`); valor ausente ou não-numérico → default |
+| Leitura | no boot, quando o host chama `from_env()` e passa o resultado a `ApiKeyState::builder(pool, config)` |
+| Features Cargo | nenhuma |
+| Outras fontes | nenhuma leitura de env fora de `src/config.rs` (Confirmado por grep em `src/` e `tests/`) |
+
+## 2. Propriedades do crate
+
+| Propriedade | Tipo | Valores aceitos | Padrão | Obrigatória | Comportamento | Uso | Relações | Leitura | Origem |
+|---|---|---|---|---|---|---|---|---|---|
+| `SEEDGRID_APIKEYS_PREFIX_LENGTH` → `prefix_length` | `usize` | inteiro ≥ 0 (aparado) | `8` | Não | nº de caracteres da parte aleatória persistidos como prefixo (sem `sgkey_`); `extract_prefix` exige ao menos esse tamanho | `src/generator.rs` (`ApiKeyGenerator::generate`, `extract_prefix`) | Java: `seedgrid.apikeys.prefix-length` (`ApiKeysConfig#prefixLength`), mesma env e default (Confirmado no código) | boot (`from_env`) ou struct | `src/config.rs` → `ApiKeysConfig::from_env` / `env_usize`; consumo `src/generator.rs` |
+| `SEEDGRID_APIKEYS_KEY_BYTES` → `key_bytes` | `usize` | inteiro ≥ 0 | `32` | Não | nº de bytes aleatórios (OsRng) codificados em Base64 URL-safe sem padding | `src/generator.rs:67` | Java: `seedgrid.apikeys.key-bytes` (`ApiKeysConfig#keyBytes`) | boot ou struct | idem |
+
+Policy de ativação (não é config, é SPI): `ApiKeyActivationPolicy` (`src/spi.rs`) com `is_api_key_auth_enabled()` e `is_api_key_management_enabled()`; default `DefaultApiKeyActivationPolicy` = ambos `true`. Troca via `ApiKeyState::builder(...).policy(Arc<dyn ApiKeyActivationPolicy>)`.
+
+Constantes fixas (não configuráveis, `src/constants.rs`): header `x-api-key`, prefixo literal `sgkey_`.
+
+## 3. Propriedades de frameworks/bibliotecas
+
+Nenhuma lida pelo crate. Depende do `seedgrid-security` (bcrypt e schema `users`/`roles`/`permissions`); a config do security é independente — ver [[SeedGrid/Extensions/security/Configuracao-Rust|Configuração Rust do security]].
+
+## 4. Propriedades usadas só em testes e exemplos
+
+- `rust/examples/seedgrid-security-apikeys-example/.env.example` lista `SEEDGRID_APIKEYS_PREFIX_LENGTH` e `SEEDGRID_APIKEYS_KEY_BYTES` comentadas, além de `DATABASE_URL`/`BIND_ADDR` (lidas pelo `main.rs` do exemplo) e envs do security.
+- README: `DOCKER_HOST` para os testes `#[ignore]` com Testcontainers/Podman.
+
+## 5. Aliases, obsoletas, renomeações
+
+Nenhum alias. Nomes de env idênticos ao Java.
+
+## 6. Configuração mínima
+
+Nenhuma variável é obrigatória (defaults 8/32).
+
+## 7. Configuração completa comentada
+
+```dotenv
+# Tamanho do prefixo persistido (sem "sgkey_"). Default 8.
+SEEDGRID_APIKEYS_PREFIX_LENGTH=8
+# Bytes aleatórios da chave (Base64 URL-safe sem padding). Default 32.
+SEEDGRID_APIKEYS_KEY_BYTES=32
+```
+
+## 8. Receitas
+
+- **Chave mais longa:** `SEEDGRID_APIKEYS_KEY_BYTES=48`. Chaves já emitidas continuam válidas (o hash cobre a chave crua completa).
+- **Desligar gestão REST mantendo autenticação:** implementar `ApiKeyActivationPolicy` com `is_api_key_management_enabled() = false` (endpoints de gestão → 404 `Api key management is disabled`; `GET /apikeys/me` continua).
+
+## 9. Dúvidas e lacunas
+
+- Mudar `prefix_length` depois de emitir chaves altera o prefixo extraído na autenticação; chaves antigas com prefixo de outro tamanho deixariam de ser encontradas — **Inferência** (o lookup é por prefixo de `prefix_length` chars, `src/generator.rs` + `services/auth.rs`).
+- Valores `0` não são validados (ex.: `KEY_BYTES=0` gera parte aleatória vazia) — **Inferência** pela ausência de validação em `from_env`.

package/seedgridKB/SeedGrid/Extensions/apikeys/Configuracao.md

@@ -0,0 +1,88 @@
+---
+tags: [seedgrid, extension, apikeys, configuracao]
+fonte: java/seedgrid-quarkus-ext-apikeys
+branch: main
+commit: bfc9c25877
+analisado-em: 2026-10-14
+---
+
+# API Keys (Quarkus) — configuração
+
+Voltar: [[SeedGrid/Extensions/apikeys/Visao-geral|Visão geral do apikeys]] · [[SeedGrid/Extensions/apikeys/Exemplos|Exemplos]] · [[SeedGrid/Extensions/apikeys/Rust|Porte Rust]]
+
+## 1. Cabeçalho
+
+| Item | Valor |
+|---|---|
+| Prefixo | `seedgrid.apikeys` |
+| Classe de config | `java/seedgrid-quarkus-ext-apikeys/runtime/src/main/java/br/com/seedgrid/apikeys/configs/ApiKeysConfig.java` → `ApiKeysConfig` |
+| Mecanismo | SmallRye `@ConfigMapping(prefix = "seedgrid.apikeys")` + `@StaticInitSafe`; registrado em `SeedgridApikeysProcessor#config()` (`ConfigMappingBuildItem`) |
+| Fase | Runtime |
+| Outras fontes | Nenhum `@ConfigProperty`, `ConfigProvider` ou `microprofile-config.properties` no runtime (verificado por busca). |
+
+Ligar/desligar autenticação e gestão **não** é por propriedade: é pelo bean SPI `ApiKeyActivationPolicy` (ver [[SeedGrid/Extensions/apikeys/Visao-geral|Visão geral]]).
+
+## 2. Propriedades da extension
+
+### Geração da chave
+
+| Propriedade | Tipo | Valores aceitos | Padrão | Obrigatória | Comportamento | Uso | Relações | Fase | Origem |
+|---|---|---|---|---|---|---|---|---|---|
+| `seedgrid.apikeys.prefix-length` (env `SEEDGRID_APIKEYS_PREFIX_LENGTH`) | `int` | inteiro positivo (sem validação explícita) | `8` | Não | Nº de caracteres da parte aleatória guardados como `prefix` (busca no banco e máscara `prefix...`). Na autenticação, a chave cuja parte após `sgkey_` for menor que isso é rejeitada. | Localizar a chave pelo prefixo antes de comparar o hash | **Mudar com chaves já emitidas quebra a autenticação delas**: o prefixo extraído na autenticação usa o valor atual, e as chaves antigas foram gravadas com o anterior (Inferência a partir de `ApiKeyGeneratorService#extractPrefix` + `ApiKeyRepository#findByPrefix`). Deve ser ≤ comprimento da parte aleatória (gerado a partir de `key-bytes`). | Runtime | Decl.: `ApiKeysConfig#prefixLength()`. Consumo: `ApiKeyGeneratorService#extractPrefix`, `#extractPrefixFromRandomPart` |
+| `seedgrid.apikeys.key-bytes` (env `SEEDGRID_APIKEYS_KEY_BYTES`) | `int` | inteiro positivo (sem validação explícita) | `32` | Não | Bytes aleatórios (`SecureRandom`) codificados em Base64 URL-safe sem padding para formar a chave `sgkey_<...>`. | Entropia da chave | Com 32 bytes a parte aleatória tem 43 caracteres; se ficar menor que `prefix-length`, o prefixo vira a parte inteira (Confirmado em `extractPrefixFromRandomPart`). Afeta só chaves novas. | Runtime | Decl.: `ApiKeysConfig#keyBytes()`. Consumo: `ApiKeyGeneratorService#generateRandomPart` |
+
+Total: **2 propriedades públicas**.
+
+## 3. Propriedades de frameworks/bibliotecas
+
+A extension não registra defaults de `quarkus.*`. Ela depende, na prática, da configuração do `seedgrid-security` e do Quarkus (datasource, JWT) no host. O comentário do `integration-tests/src/main/resources/application.properties` registra que o security fixa `quarkus.http.auth.proactive=true` e que, por isso, o smallrye-jwt precisa de chave pública configurada mesmo em requests por API key (senão 500 `SRJWT02002`). (Confirmado como comentário; comportamento do security não verificado aqui.)
+
+## 4. Propriedades usadas só em testes
+
+`integration-tests/src/main/resources/application.properties` (fica em `src/main` porque o `@QuarkusIntegrationTest` roda o JAR empacotado):
+
+| Propriedade | Observação |
+|---|---|
+| `quarkus.http.test-port`, `quarkus.http.test-ssl-port` | `0` |
+| `quarkus.hibernate-orm.database.generation` | `drop-and-create` (schema pelo Hibernate nos testes) |
+| `quarkus.flyway.migrate-at-start` | `false` |
+| `quarkus.datasource.devservices.image-name` | `postgres:16-alpine` |
+| `seedgrid.audit.persistence.strategy` | `JPA` (exigido pelo security transitivo) |
+| `seedgrid.security.default-company.cnpj` / `.corporate-name` / `.trade-name` | dados fictícios |
+| 🔒 `seedgrid.security.encryption.key` | `<SEGREDO:security-encryption-key>` (valor de teste não copiado) |
+| `quarkus.arc.exclude-types` | exclui `FirstAdminBootstrapService` |
+
+Nenhuma propriedade `seedgrid.apikeys.*` é definida nos testes (usam os padrões).
+
+## 5. Aliases, obsoletas, renomeações
+
+- Nenhum alias. O header (`x-api-key`) e o prefixo das chaves (`sgkey_`) são constantes em `ApiKeyConstants`, não propriedades.
+
+## 6. Configuração mínima
+
+Nenhuma propriedade própria é obrigatória. O host precisa da configuração do [[SeedGrid/Extensions/security/Configuracao|security]] (JWT, datasource etc.) e de executar as migrations `classpath:db/migration/apikeys`.
+
+```properties
+# nada obrigatório em seedgrid.apikeys.*
+```
+
+## 7. Configuração completa comentada
+
+```properties
+# Caracteres da parte aleatória usados como prefixo de busca (padrão 8).
+# Não altere com chaves já emitidas.
+seedgrid.apikeys.prefix-length=8
+# Bytes aleatórios do corpo da chave (padrão 32 → 43 caracteres Base64 URL-safe).
+seedgrid.apikeys.key-bytes=32
+```
+
+## 8. Receitas
+
+- **Chaves mais longas**: aumente `seedgrid.apikeys.key-bytes` (afeta só chaves novas; o prefixo continua com `prefix-length` caracteres).
+- **Desligar a gestão de chaves mas manter a autenticação**: forneça um bean `ApiKeyActivationPolicy` com `isApiKeyManagementEnabled()=false` (não há propriedade). Ver [[SeedGrid/Extensions/apikeys/Exemplos|Exemplos]].
+- **Desligar a autenticação por API key**: o mesmo bean com `isApiKeyAuthEnabled()=false`.
+
+## 9. Dúvidas e lacunas
+
+- Não há validação de faixa para `prefix-length`/`key-bytes` (valores ≤ 0 não tratados) — Não confirmado o comportamento.
+- Mudança de `prefix-length` com chaves existentes: Inferência de quebra (ver tabela), não testado.

package/seedgridKB/SeedGrid/Extensions/apikeys/Enums.md

@@ -0,0 +1,33 @@
+---
+tags: [seedgrid, extension, apikeys, enum]
+fonte: java/seedgrid-quarkus-ext-apikeys
+branch: main
+commit: bfc9c25877
+analisado-em: 2026-10-14
+---
+
+# API Keys (Quarkus) — enums
+
+Voltar: [[SeedGrid/Extensions/apikeys/Visao-geral|Visão geral do apikeys]] · [[SeedGrid/Extensions/apikeys/Configuracao|Configuração]]
+
+## Índice
+
+| Enum | Pacote/arquivo | Usado em | Público? |
+|---|---|---|---|
+| [[#ApiKeyAuthType]] | `br.com.seedgrid.apikeys.utils` — `runtime/src/main/java/br/com/seedgrid/apikeys/utils/ApiKeyAuthType.java` | `ApiKeyPrincipal#getAuthType()`, atributo `apikey.authType` da `SecurityIdentity` | Sim (tipo de retorno público) |
+
+## ApiKeyAuthType
+
+FQN: `br.com.seedgrid.apikeys.utils.ApiKeyAuthType`.
+
+| Valor | Significado | Efeito / onde é tratado | Observações |
+|---|---|---|---|
+| `API_KEY` | Identidade autenticada por API key (única constante) | Atribuída fixamente no construtor de `ApiKeyPrincipal`; gravada pelo `ApiKeyIdentityProvider` como atributo `apikey.authType` = `"API_KEY"`; o `RbacSecurityIdentityAugmentor` do security compara esse atributo com a string `"API_KEY"` para **pular** a resolução RBAC (as permissões já vêm como `StringPermission`) | Confirmado |
+
+- Não tem campos nem métodos. O enum tem um único valor e é sempre o mesmo: serve de marcador de tipo de credencial.
+- **Serialização**: o atributo da identidade guarda `name()` (string `API_KEY`); não aparece em JSON de endpoint nem é persistido. O contrato com o security é a **string** `"API_KEY"` (sem dependência de classe): renomear a constante quebraria a detecção.
+- Usado em: `ApiKeyPrincipal`, `ApiKeyIdentityProvider`; sem relação com propriedades de [[SeedGrid/Extensions/apikeys/Configuracao|Configuração]].
+
+## Internos
+
+Nenhum.