Economic Group
A grouping of franchise units under one economic owner, used for reporting and statistics. Optional on a franchise; soft-deleted rather than removed. Travels on the Franchise Kafka topic under its own key.
Overview
Economic groups aggregate several FranchiseFranchiseEntityv1.0.0A franchise unit (school) of the CNA network as managed in Nexus - registration and tax data, lifecycle statuses, catego...Ownercna-platformView docs units under the same owner. Nexus keeps counters per group (units, franchisees, active groups) in a Redis cache keyed by the latest updatedAt across groups, franchises and partners; the partner events on this topic exist mostly to bump that timestamp. There is no delete event: a soft delete is announced as Economic Group UpdatedEconomic Group UpdatedEventv1.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 so that consumers see the group leave the active set.
| Name | Type | Required | Description | Reference |
|---|---|---|---|---|
id | string | Required | Internal id (UUID) in franchise.economic_groups. Kafka message key of the economic group events and the id cna-one mirrors the group under. | |
name | string | Required | Group name, unique among non-deleted groups. | |
isActive | boolean | Required | Whether the group is active. Set to false on soft delete. | |
deletedAt | string | Optional | Soft-delete mark; null while the group exists. A deletion is published as EconomicGroupUpdated with isActive false and deletedAt set. |
Custom properties
| Property | Value |
|---|---|
| Kafka Topicx-kafka-topic | Franchise |
| Routing Keyx-routing-key | id |