Premium Flask-based Real Estate Management System for Makazi Mapya Tanzania — DIT capstone project (Jane Bernard Matinga). 11 modules, RBAC, Leaflet maps, analytics, 105/105 tests passing.
# 🏡 REMS — Real Estate Management System
**A premium, locally-run property management platform for Makazi Mapya Tanzania**
*Academic capstone project — Dar es Salaam Institute of Technology (DIT), Department of Computer Studies*
*Developed by **Jane Bernard Matinga** (Reg. No. 230222455368) · Supervisor: Mr. Daniel Maduhu · 2026*
---
## 📖 Overview
**REMS** is a full-stack web application that digitises the property sales, leasing and
client-management workflows of **Makazi Mapya Tanzania**, a real-estate agency in
Dar es Salaam. It replaces manual, paper-based record keeping with a secure, role-aware
system covering property listings, client inquiries, lease & payment tracking, an
interactive GPS estate map, in-app messaging, analytics dashboards, and full
administrative oversight — wrapped in a **premium navy-and-gold interface** designed to
feel like a professional SaaS product.
The system was fully specified in an accompanying **Software Requirements Specification**
(included in `docs/REMS_SRS_v1.0.docx`), then implemented to
satisfy **all 20 functional requirements** (FR-01 → FR-20) it defines — and verified by an
automated regression suite of **105 passing checks, written and run after every feature**.
It is **deliberately simply architected to run entirely on your own machine** — SQLite
database, no external services, no API keys, no cloud dependency.
---
## ✨ Features
| Req. | Capability | Who can use it |
|------|------------|----------------|
| FR-01 / FR-02 | Secure registration & login with **account lockout** (5 failed attempts → 15-min cool-down) | Everyone |
| — | **Role-Based Access Control** across 4 roles — Admin, Owner, Agent, Client | System-wide |
| FR-03 – FR-05 | Property catalogue — create / edit / delete, image + certificate upload, search, filter, sort, status workflow (Available → Leased / Sold / Under Review) | Admin, Owner, Agent |
| FR-06 | Client profiles — contact details, NIN, notes, full inquiry & lease history | Adm …