Package org.praxisplatform.uischema.annotation

Annotation Interface ResourceIntent

@Target(METHOD)
@Retention(RUNTIME)
public @interface ResourceIntent

Marca uma operacao resource-oriented tipada que representa uma intencao semantica de escrita parcial sobre o mesmo recurso.

Esta anotacao nao cria endpoints dinamicos nem substitui o contrato canonico do metodo. O endpoint continua sendo definido por uma operacao HTTP real, como @PatchMapping, com DTO proprio e documentacao OpenAPI normal. @ResourceIntent apenas adiciona uma camada semantica explicita para intents como profile, bank-details ou preferences.

Ela e a base para a fase de escrita parcial por intencao do starter: multiplos formularios da mesma entidade continuam resource-oriented, com operacoes reais e tipadas, sem transformar surface em contrato de escrita.

Required Element Summary

Required Elements

Modifier and Type	Required Element	Description
String	id	Identificador estavel da intencao dentro do recurso.
String	title	Titulo humano da intencao.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element	Description
String	description	Descricao opcional da finalidade do endpoint.
int	order	Ordem sugerida para catalogos/documentacao futuros.

Element Details

id

String id

Identificador estavel da intencao dentro do recurso.

title

String title

Titulo humano da intencao.

description

String description

Descricao opcional da finalidade do endpoint.

Default:

""

order

int order

Ordem sugerida para catalogos/documentacao futuros.

Default:

0