Ciclo 4.1.0-SNAPSHOT

Framework integrador · Java enterprise

Menos integração.
Mais produto.

O Demoiselle reúne contratos, segurança e capacidades operacionais sobre padrões Jakarta EE para sua equipe concentrar energia no domínio — sem prender o produto a uma pilha proprietária.

Começar agora Explorar no GitHub

Java 21
Jakarta EE 10
CDI 4.0
Maven 3.9+

Seu produto Domínio regras que geram valor

Camada integradora

RESTCRUDSecurityMCP

Jakarta EEpadrões abertos

Seu runtimeescolha consciente

16módulos no reactor

247testes automatizados

6extensões de produção

LGPLsoftware livre

Valor para o produto

Da complexidade recorrente a uma base previsível

O framework não substitui o domínio nem esconde a plataforma. Ele resolve a integração repetitiva e oferece contratos comuns para que decisões importantes sejam explícitas, testáveis e reutilizáveis.

Produtividade sem colcha de retalhos

Problema: Equipes repetem escolhas, configuração e integração em cada serviço.
Solução Demoiselle: BOM único, módulos coesos e convenções CDI sobre Java e Jakarta EE.
Benefício: Menos boilerplate, onboarding mais rápido e versões alinhadas.

APIs que clientes entendem

Problema: Erros, paginação e evolução variam entre endpoints e produtos.
Solução Demoiselle: Suporte a Problem Details, Web Linking, OpenAPI e lifecycle HTTP.
Benefício: Contratos mais previsíveis, interoperáveis e fáceis de evoluir.

Segurança como contrato

Problema: JWT permissivo, rate limit isolado e proxies mal configurados ampliam riscos.
Solução Demoiselle: Perfis JWT, stores atômicos, headers seguros, HashCash e defaults fail-closed.
Benefício: Políticas consistentes e menor superfície para abuso, replay e spoofing.

Consistência em fluxos distribuídos

Problema: Retries duplicam comandos e dual writes perdem eventos após o commit.
Solução Demoiselle: Idempotência, Outbox, deduplicação e paginação por cursor assinado.
Benefício: Operações recuperáveis e integração confiável quando adapters de produção são usados.

Operação observável

Problema: Instrumentação manual acopla o domínio e dificulta diagnosticar incidentes.
Solução Demoiselle: Anotações para métricas e tracing, health checks e integrações opcionais.
Benefício: Sinais operacionais padronizados e menor tempo para localizar falhas.

Governança que acompanha o código

Problema: Dependências, artefatos e compatibilidade ficam difíceis de auditar.
Solução Demoiselle: SBOM, proveniência, checksums, inventário, gates e actions pinadas.
Benefício: Releases rastreáveis e decisões de supply chain verificáveis.

Capacidades conectadas

Uma base modular para o ciclo completo

Adote apenas os módulos necessários. O BOM mantém o conjunto compatível e os SPIs permitem trocar infraestrutura sem levar SDKs externos para o núcleo.

CRUD & JPA 3.1

Persistência expressiva, sem repetir infraestrutura

Specifications compostas, soft delete, auditoria, batch, EntityGraph, filtros tipados, cache e limites contra abuso.

Segurança

Identidade, autorização e proteção em camadas

JWT com perfis progressivos, seleção segura de kid, autorização declarativa, rate limit, brute force, anti-replay e HashCash.

Headers HTTPJWT & rolesRate limitReplay protection

Perfis avançados são opt-in; configuração inválida falha fechado.

REST & OpenAPI

Contratos HTTP evolutivos

Problem Details opt-in, paginação RFC 8288, cache tipado, documentação agregada e headers de depreciação.

Configuração & segredos

Ambientes sem segredos no código

Perfis, defaults tipados e resolução fail-closed por ambiente, propriedade ou arquivo, extensível para vaults corporativos.

Consistência

Primitivas para sistemas que recebem retries

@Idempotent preserva respostas, Outbox separa commit de publicação e cursores HMAC mantêm paginação estável.

Preparar adapters de produção

Observabilidade

Sinais operacionais declarativos

@Counted, @Traced, liveness e readiness com adapters opcionais e degradação noop.

MCP

Produtos preparados para clientes de IA

Tools, resources e prompts CDI com JSON Schema, SSE ou stdio. Ao ativar segurança HTTP, sessões e POST operam fail-closed.

Supply chain

Build com evidência

CycloneDX 1.6, checksums, proveniência, reprodutibilidade normalizada, JaCoCo e inventário dinâmico.

Arquitetura aberta

Integra onde agrega. Abstrai onde protege.

O produto continua baseado em APIs conhecidas. Demoiselle organiza preocupações transversais e expõe SPIs nos pontos em que infraestrutura e contexto operacional realmente variam.

Camada 01Seu domínio e suas APIs

Entidades, casos de uso, regras e contratos que diferenciam o produto.

Camada 02Demoiselle Framework

coreconfigurationcrudrestsecurityjwtobservabilityopenapimcpscript

Camada 03Padrões Jakarta EE

CDI, JAX-RS, JPA e APIs MicroProfile opcionais.

ExtensõesInfraestrutura do produto

Redis, Vault, JWKS, banco, broker e runtime escolhidos por adapters.

Do framework ao ambiente real

Local para começar. Extensível para escalar.

Backends locais deixam desenvolvimento e testes autocontidos. Para clusters e releases críticas, o produto conecta estado distribuído, segredos gerenciados, outbox persistente, certificação de runtime, baseline OpenAPI e builds herméticos.

Conhecer as 6 extensões

01Estado distribuído
02Chaves e segredos
03Outbox e broker
04Matriz de runtimes
05Baseline OpenAPI
06Build hermético

Início rápido

Uma base alinhada em poucos minutos

Importe o BOM, escolha os módulos necessários e mantenha a plataforma Jakarta EE no runtime. A versão atual é um snapshot e requer o repositório Sonatype OSS.

1
Use Java 21 e Maven 3.9+O Enforcer verifica o baseline durante o build.
2
Importe o BOMTodos os módulos permanecem na mesma versão.
3
Adicione por capacidadeComece com core, REST e CRUD; evolua conforme o produto.

Abrir guia completo

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.demoiselle.jee</groupId>
      <artifactId>demoiselle-parent-bom</artifactId>
      <version>4.1.0-SNAPSHOT</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependency>
  <groupId>org.demoiselle.jee</groupId>
  <artifactId>demoiselle-rest</artifactId>
</dependency>

Explore

Documentação para cada decisão

Comece pela visão técnica, avalie impactos de migração e avance para os adapters exigidos pelo ambiente do produto.

Guia técnico

Funcionalidades, configuração e exemplos dos módulos.

Migração 4.1

Compatibilidade, defaults e contratos alterados.

Extensões de produção

Benefícios e critérios para os seis adapters operacionais.

Roadmap entregue

Auditoria, implementação e invariantes do ciclo.

Ecossistema Demoiselle

Uma história aberta, com produtos para diferentes necessidades

O novo GitHub Pages dá continuidade ao portal institucional. Ele separa o framework atual dos componentes independentes e preserva caminhos para documentação de gerações anteriores.

Ciclo atual

Framework

Demoiselle Framework 4

Base integradora Java 21 e Jakarta EE 10 deste repositório, com módulos de configuração, CRUD, REST, segurança, observabilidade, OpenAPI e MCP.

Explorar documentação

Projeto independente

Certificação digital

Demoiselle Signer

Componente para geração e validação de assinaturas digitais e manipulação de certificados nos padrões da ICP-Brasil.

Ver projeto Signer

Legado / referência

Testes funcionais

dbehave

Ferramenta open source de automação funcional baseada em BDD, preservada como referência da trajetória e do ecossistema Demoiselle.

Consultar repositório

Gerações anteriores

Precisa manter ou consultar um produto legado?

Portal Demoiselle V3 Documentação legada Portal institucional

Software livre desde 2009

Construa sobre padrões.
Entregue o que torna seu produto único.

Adicionar ao projeto Conversar com a comunidade