-
Notifications
You must be signed in to change notification settings - Fork 4
Home
Welcome to the wiki for the Track Your Regions project! This platform aims to provide a web service that helps users keep track of regions they have visited and experiences they have had. For more details, you can read the main README.
We are continuously working on improving the project and its documentation. You can find various document drafts related to the project in the following shared Google Drive directory:
This project is based on the principles of Domain-Driven Design (DDD). DDD is a software development methodology that aims to align the software model with the business domain. You can read more about DDD on the following page: DDD Overview.
The domain model is a key component of the project. It defines the entities and relationships that make up the core of the application. You can read more about the domain model on the following page: Domain Model.
Understanding the user's perspective is crucial for the success of this project. We have compiled a list of user stories to better understand the needs and expectations of our users. You can read them on the following page:
- User Stories: General
- User Stories: Regions-Listing
- User Stories: Journey-Planning
- User Stories: Engagement-Level
- User Stories: Common-Experiences
- User Stories: Educational-Features
- User Stories: AI-Driven-Interview
The list of regions available in the "Track Your Regions" project is primarily based on data from GADM. GADM stands for "Global Administrative Areas," and it's a curated, academic project aimed at providing comprehensive geospatial data. However, we have encountered several issues with GADM, including:
- Data Errors: Some regions have inaccuracies (issue #20, issue #28).
- Grouping Ambiguity: The grouping of regions is sometimes unclear (issue #63).
- Overly Formal Data: Includes overly formal data, such as postal regions in Spain.
- Outdated Information: The data was expected to be updated in Fall 2023, but as of Summer 2024, it has not been updated.
Given these issues, we are considering alternatives such as:
- ESRI Administrative Boundaries (issue #219)
- Cosmogony for OSM (issue #206)
A page about mapping the GADM data to our model: GADM Mapping
We are on the process of designing the web UI for the project. You can find drafts of the UI in the following wiki pages:
Feel free to explore and contribute!
The content of this wiki is licensed under a Creative Commons Attribution-NonCommercial (CC BY-NC) License.