====== Street naming application ======

The Naming application is designed to facilitate the creation and management of street names for the national addressing system in the Sultanate of Oman. It enables users to collect, approve, allocate, reassign, and remove street names efficiently while managing user roles to ensure secure and appropriate access to the system's functionalities.

===== Technical requirements =====

  * Data Collection Interface: Facilitate the collection of street name proposals, including user submissions with required fields for name details.
  * Approval Workflow: Implement an approval process to review and approve proposed street names by authorized personnel.
  * Name Allocation System: Develop a system for allocating approved street names to specific streets within the addressing system.
  * Name Reassignment Feature: Enable the reassignment of existing street names to different streets when necessary.
  * Name Removal Process: Provide a mechanism to remove street names from streets while maintaining historical records.
  * User Role Management: Incorporate a system for managing user roles and permissions to ensure secure access and operations within the application.

===== Functional requirements =====

  * Collect Names: Enable users to submit proposed street names through a user-friendly interface.
  * Approve Names: Provide tools for authorized personnel to review and approve or reject submitted names.
  * Allocate Approved Names to Streets: Allow users to assign approved names to specific streets accurately and efficiently.
  * Reassign Names to Streets: Facilitate the reassignment of street names to different streets as required by urban planning changes.
  * Remove Street Names from Streets: Implement functionality to remove street names and manage related changes in the addressing system.
  * Manage User Roles: Offer capabilities to assign and manage user roles to control access rights and ensure data security within the application.

===== Status =====

A street naming application has been developed and deployed. It is presently in use in all governorates and wilayat for the purpose of collecting, approving and allocating street names to streets.

==== Todo ====

  * Apply shared authentication with other addressing apps
  * Describe/clarify interaction with address data model