maamora/PMapping

Providers Mapping & Rating — Morocco # PMapping - Delivery Providers Mapping & Rating (Morocco) A branch-by-branch rating database for Moroccan delivery and logistics providers (Amana, Ozon Express, Cathedis, Sendit, and others), built from real business-listing data rather than sponsored directories or scattered social reviews. ## Overview In Moroccan e-commerce, the delivery leg is where a customer experiences the seller's promise directly - through the courier, the delay, and how cash-on-delivery is handled. Quality varies significantly **branch to branch within the same provider**, and existing rankings are often biased, sponsored, or based on unverifiable word of mouth. PMapping addresses this by structuring raw business-listing data into a normalized database of **provider → branch → rating**, so ratings can be produced, filtered, and compared at the branch level rather than the company level. **Intended audience:** Moroccan e-merchants choosing a delivery partner based on objective, branch-level data instead of word-of-mouth. **Current stage:** the full pipeline is implemented - all six stages, the shared database layer, the dependency manifest, the CLI entry point, an automated test suite, and a CI workflow are all in place. What remains is project documentation, written reports, an environment-variable template, and a license. See Current Status for the exact breakdown. ## Architecture The project is a linear, file- and SQLite-based batch ETL pipeline, not a running service. Each stage reads the previous stage's output and writes its own: ``` config/*.json data/raw/bing .csv (x13) │ │ ▼ ▼ scope stage collect stage (build search list) (consolidate + tag city) │ │ └───────────────┬────────────────┘ ▼ clean stage (flag delivery listings, match provider names, load to SQLite) │ ▼ enrich stage (fill rating/coord/website gaps via Google Places API or Playwrig …