ugarit-artifacts / geography
ISO countries, governorates/states, cities, districts, addresses and geospatial coordinates
Requires
- php: ^8.3
- ugarit/framework: ^1.00.00
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
- dev-main
- v2.00.04
- v2.00.03
- v2.00.02
- v2.00.01
- v2.00.00
- 1.x-dev
- v1.32.00
- v1.31.00
- v1.30.00
- v1.29.00
- v1.28.00
- v1.27.00
- v1.26.00
- v1.25.00
- v1.24.00
- v1.23.00
- v1.22.00
- v1.21.00
- v1.20.00
- v1.19.00
- v1.18.00
- v1.17.00
- v1.16.00
- v1.15.00
- v1.14.00
- v1.13.00
- v1.12.00
- v1.11.00
- v1.10.00
- v1.09.00
- v1.08.00
- v1.07.00
- v1.06.00
- v1.05.00
- v1.04.00
- v1.03.00
- v1.02.00
- v1.01.00
- v1.00.00
- dev-develop
This package is not auto-updated.
Last update: 2026-11-14 13:02:25 UTC
README
"Artifacts provide capabilities. Features define behavior."
The Geography Artifact is the territorial registry of the Ugarit ecosystem. It stores countries, governorates, cities, districts, and locations, with translated names, and exposes them as capabilities other artifacts can require.
It runs inside a host Ugarit application. It is not a standalone framework.
Documentation
- Overview
- Architecture
- Database schema
- Installation
- Roadmap
- Changelog
- Contributing
- Security
- Code of Conduct
- Contact
- License
Role in the ecosystem
| Layer | Package | Responsibility |
|---|---|---|
| Kernel | ugarit/framework |
Container, schema builder, capability and feature pipeline |
| Artifact | ugarit-artifacts/i18n |
Locales. Translation rows store locale_id |
| Artifact | ugarit-artifacts/geography |
Territorial hierarchy and geospatial points |
art.php requires the capability i18n.translations before this artifact boots.
Capabilities
Declared in art.php:
| Slug | What the tables store today |
|---|---|
countries |
Unique country code, native name, translated name, active flag |
governorates |
First-level division of a country: slug, optional code, translated name |
cities |
Municipality under a governorate: slug, optional postal code, translated name |
districts |
Subdivision of a city: slug, optional code and postal code, translated name |
locations |
Point and address, optionally under a city and a district |
The structural diagram, columns, keys, and delete rules are in SCHEMA.md.
Routes
Registered from routes/web.php under panel/artifact/geography, with web and auth middleware.
| Kind | Path | Purpose |
|---|---|---|
| GET | /panel/artifact/geography |
Artifact summary |
| RESOURCE | …/country, governorate, city, district, location |
Capability CRUD |
| RESOURCE | …/{entity}-feature (store, update) |
Save the record and its translations in one transaction |
| RESOURCE | …/{record}/{entity}-translation (store, update, destroy) |
One locale at a time |
Quick start
composer require "ugarit-artifacts/geography:^2.00.00"
php scribe migrate
See Installation.
License
MIT. See LICENSE.md. Maintained by Muath R Abu Ouda.