Skip to content
Nikolay Martyanov edited this page Oct 15, 2023 · 22 revisions

Introduction

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.


Document Drafts

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:


Domain Model

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.


User Stories

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:


Additional Resources


Regions Data Source

The list of regions available in the "Track Your Regions" project is based on data from GADM. GADM stands for "Global Administrative Areas," and it's a curated, academic project aimed at providing comprehensive geospatial data. The data from GADM is highly reliable and is used for academic research and educational purposes.

Why do we use GADM?

  • Comprehensive Coverage: GADM provides data for all countries, down to subnational levels like states, provinces, and even smaller administrative units.
  • Academic Rigor: The data is collected and maintained with a high level of accuracy, making it a reliable source for our project.
  • Up-to-Date: GADM continuously updates its data sets to reflect changes in administrative or political boundaries.

For more information, you can visit the GADM about page.

A page about mapping the GADM data to our model: GADM Mapping


Web UI drafts

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!