Base de localisation (hiérarchie Pays → Région → Préfecture → Commune / Ville → Quartier, avec les données Togo en seed).
# togo-locations
Référentiel géographique **Togo** pour les applications LIKSOFT / PayHub : pays, régions, préfectures, communes, villes et quartiers.
## Installation
```bash
npm install @liksoft/togo-locations
# ou depuis GitHub
npm install github:liksoft/togo-locations
```
## Données initiales
Le fichier `data/togo.json` contient l’arbre complet :
- 5 régions
- 40 préfectures
- 116 communes
- 113 villes
- 7 568 quartiers
## Usage (TypeScript / Node)
```typescript
import {
togoLocationRepository,
emptyAddressSelection,
formatAddressLabel,
isAddressComplete,
} from "@liksoft/togo-locations";
const regions = togoLocationRepository.listRegions();
const prefectures = togoLocationRepository.listPrefectures(regions[0].id);
const districts = togoLocationRepository.listDistricts({ municipalityId: 45 });
const selection = emptyAddressSelection();
// … remplir regionId, prefectureId, municipalityId, districtId
if (isAddressComplete(selection)) {
console.log(formatAddressLabel(selection));
}
```
## Données brutes (Python, Odoo, etc.)
```text
node_modules/@liksoft/togo-locations/data/togo.json
```
## Scripts
```bash
npm run build # compile dist/
npm test # tests smoke
```
## Licence
Usage interne LIKSOFT — voir `package.json`.