Skip to main content

Entities

An entity is the domain object that an AXAG-annotated operation acts upon. Entities are declared via the axag-entity attribute.

Naming Conventions

  • Entity names MUST be lowercase, singular nouns: product, order, ticket, campaign
  • Compound entities use underscore separation: shopping_cart, user_profile, tenant_settings
  • Entity names SHOULD match the domain model used by the application's backend

Common Entities by Domain

DomainEntities
E-Commerceproduct, cart, order, payment, shipment, return
CRMlead, contact, opportunity, account, pipeline
Marketingcampaign, audience, experiment, template
Supportticket, agent, knowledge_article, escalation
Travelflight, hotel, booking, itinerary, reservation
Analyticsreport, dashboard, dataset, metric, alert
Jobsjob, application, candidate, interview

Entity Relationships

When operations span multiple entities, use the primary entity in axag-entity and declare related entities in parameters or side effects.