> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wavecentric.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Locations & Zones

> Geographical and operational clustering

## 1. Overview

The **Locations** registry defines the geographic coordinates and operational boundaries of the network. It translates physical world addresses into logical entities used for routing, tracking, and reporting.

## 2. Technical Field Mapping

### UN/LOCODEs (Località)

The system uses the United Nations Code for Trade and Transport Locations as the primary geographic identifier.

<Frame caption="Ricerca locode: Search and manage UN/LOCODE references.">
  <img src="https://mintcdn.com/wavecentric/7MnGTR3yrAzUjE81/images/magemo/locode.png?fit=max&auto=format&n=7MnGTR3yrAzUjE81&q=85&s=7e6b1978d65b4fcc651a93d98552408d" alt="Ricerca locode dashboard" width="1024" height="322" data-path="images/magemo/locode.png" />
</Frame>

| Field        | Source           | HTML Name     | Description                                     |
| :----------- | :--------------- | :------------ | :---------------------------------------------- |
| **Località** | `MAGEMO_LOCODES` | `descrizione` | Full name of the city or logistics point.       |
| **Codice**   | `MAGEMO_LOCODES` | `codice`      | 5-character LOCODE (e.g., ITVRN).               |
| **Paese**    | `MAGEMO_LOCODES` | `paese`       | 2-character ISO country code.                   |
| **Status**   | `MAGEMO_LOCODES` | `status`      | Active status in the UN database (AI, RL, etc). |

### Zones (Zone)

Zones are logical clusters of **Nodes** used for reporting, security visibility, and operational grouping.

| Field              | Source         | HTML Name        | Description                                           |
| :----------------- | :------------- | :--------------- | :---------------------------------------------------- |
| **Descrizione**    | `MAGEMO_ZONES` | `descrizione`    | The name of the cluster (e.g., Northern Corridor).    |
| **Note Operative** | `MAGEMO_ZONES` | `note_operative` | Specific instructions for movements within this zone. |
| **Attivo**         | `MAGEMO_ZONES` | `attivo`         | Binary toggle (1/0) for system visibility.            |

## 3. Data Flow & Connectivity

```mermaid theme={null}
graph TD
    LOC[UN/LOCODEs] --> N[Nodes Registry]
    ZON[Zones] --> N
    N --> SRV[Design: Services]
    N --> BOOK[Planning: Booking]
```

### Integration Logic

* **Routing Hierarchy**: A **Node** (e.g., Verona Quadrante Europa) is linked to a **Location** (e.g., Verona ITVRN) which belongs to a **Zone** (e.g., Corridor A).
* **Filtering**: Search bars throughout the system allow filtering by "Zona" to quickly narrow down a set of terminals or bookings.