for an african country
# LocaFinder — Mobile App Showcase
> Property search and visit management platform for Togo and the African diaspora.
---
## Problem
Finding housing in Togo is opaque and fragmented — especially for the diaspora abroad. No reliable platform exists to browse geolocated listings, book visits, and pay securely from abroad.
LocaFinder solves this: a mobile-first platform where tenants search properties on a live map, schedule visits, and manage payments from their phone.
---
## Architecture Overview
Three independent services, one shared database:
```
┌─────────────────────────────────────────────────────────────────┐
│ CLIENT LAYER │
│ Flutter Mobile App React/Refine Admin Panel │
│ GetX · Dio · flutter_map Ant Design · TypeScript │
└──────────┬─────────────────────────────┬───────────────────────┘
│ JWT (Bearer) │ Session + TOTP (2FA)
▼ ▼
┌──────────────────┐ ┌──────────────────────────────────┐
│ Main API │ │ Admin API nginx │
│ FastAPI :8000 │ │ FastAPI :8001 IP whitelist │
│ JWT Auth │ │ Redis sessions Rate limiting │
│ 4-layer arch │ │ TOTP (pyotp) │
└──────────┬───────┘ └──────────┬───────────────────────┘
│ │
└────────────┬───────────────┘
▼
┌──────────────────┐
│ PostgreSQL 16 │
│ + PostGIS 3.4 │
│ (geo queries) │
└──────────────────┘
```
→ Full architecture decisions: ARCHITECTURE.md
---
## Mobile App — Screenshots
### Home & Search
| Home | Map search | Advanced filters |
|:---:|:---:|:---:|
| | | |
| Property list with categories | Live map with price markers | Type, budget, rooms, surface |
### Navigation & Account
| Menu | Profile | Requests |
|:---:|:---:|:---:|
| | | |
| Settings & navigation | User info & stats | Rental request tracking | …