Overview

Fact: an Economic GroupEconomic GroupEntity•v1.0.0A grouping of franchise units under one economic owner, used for reporting and statistics. Optional on a franchise; soft...Ownercna-platformView docs now exists in Nexus. The payload is the group row.

When it is published. CNA NexusCNA NexusService•v1.0.0Franchise network back-office (franchises, economic groups, partners, contracts and amendments, document storage, AI doc...PublishesInviteUser, ContractActivationRequested +13SubscribesContractActivationRequested, AmendmentApplyRequested +4Ownercna-platformMapRepoView docs, in createEconomicGroup, right after the insert. Published after the write, without afterCommit.

What the consumer does. CNA OneCNA OneService•v1.0.0Franchise operating system (franchises and employees, pricing, products and learning books, school operations). Publishe...PublishesGrantApplicationAccess, EmployeeCreated +6SubscribesInviteUser, FranchiseCreated +9Ownercna-platformMapRepoView docs (franchiseConsumer, handler syncEconomicGroup, shared with Economic Group UpdatedEconomic Group UpdatedEvent•v1.0.0An economic group changed in CNA Nexus - renamed, toggled active or soft-deleted (there is no delete event). cna-one mir...Ownercna-platformSchemaMapView docs): upserts the group by id with name, isActive and deletedAt, storing them as they arrive without validation. createdAt and updatedAt are ignored. The mirrored group is what a later Franchise CreatedFranchise CreatedEvent•v1.2.0A franchise unit was created in CNA Nexus by activating an opening contract. Full snapshot of the unit; cna-one mirrors ...Ownercna-platformSchemaMapView docs needs to resolve economicGroup.id; a franchise arriving before its group fails to mirror.

Failures are logged and reported to Sentry, never rethrown.

Kafka

Payload schema

Source of truth

export type EconomicGroupPayload = {
  id: string;
  name: string;
  isActive: boolean;
  createdAt: string;
  updatedAt: string;
  deletedAt: string | null;
};

export class EconomicGroupCreated extends Event<EconomicGroupPayload> {
  static readonly owner = 'NEXUS';
  static readonly aggregateRoot = 'Franchise';
  static readonly routingKey = 'id';
}

Known drift

cna-one api/app/events/nexus/economicGroup/EconomicGroupCreated.ts has no createdAt or updatedAt, and is stored under a different folder than the canonical copy.