Address¶
value-object customer
Structured postal address used for shipping, billing, and customer identification.
Business Purpose: Provide a validated, structured address for fulfillment routing, tax calculation, and customer identity.
Aliases: postal-address · shipping-address · delivery-address · billing-address
Attributes¶
| Attribute | Description |
|---|---|
address-type Address Type |
Role of the address — shipping, billing, store-pickup. |
street Street |
Street name and number. |
city City |
City or locality. |
postal-code Postal Code |
ZIP or postal code. |
country-code Country Code |
ISO 3166-1 alpha-2 country code. |
coordinates Geo Coordinates |
Optional latitude/longitude for geo-routing. |
Relationships¶
| Type | Target |
|---|---|
belongs-to |
customer customer |
references |
shipment shipment |
references |
order order |
Events¶
| Event | Classification | Terminal |
|---|---|---|
AddressAdded |
created | — |
AddressUpdated |
updated | — |
AddressValidated |
transitioned | — |
Used by Capabilities¶
- customer-profile Customer Profile
- fulfillment-execution Fulfillment Execution
Used by Processes¶
Used by Applications¶
- CRM
crm - eCommerce Platform
ecommerce-platform - OMS
oms
Semantic Constraints¶
| Constraint | Type | Rule |
|---|---|---|
shipment-references-address |
association |
A Shipment must have exactly one delivery Address. Fulfillment without… |
Note
Address is a value object — its identity is defined by its postal values, not a surrogate ID.