Kasuletrevor/landten

LandTen - A property management platform for landlords and tenants in East Africa. Features payment tracking, receipt uploads, automated scheduling, and tenant portal access. Built with FastAPI + Next.js. # LandTen - Landlord-Tenant Management Platform A full-stack property management system for landlords to manage properties, rooms, tenants, and payment tracking. Includes a tenant portal for tenants to view their payment history and upload proof of payment receipts. ## Table of Contents - Overview - Architecture - Features - Tech Stack - Project Structure - Getting Started - API Documentation - Payment Flow - Database Schema - Environment Variables - Development Notes --- ## Overview LandTen is designed for landlords who manage rental properties and need to: 1. Track properties and rooms 2. Manage tenant information and lease periods 3. Automate payment schedule generation 4. Track payment statuses (upcoming, pending, overdue, paid) 5. Receive notifications for payment events 6. Allow tenants to upload proof of payment for manual verification The system explicitly does NOT integrate with payment gateways (e.g., Stripe). Instead, it follows a manual verification workflow where tenants upload bank transfer receipts and landlords approve payments. --- ## Architecture ``` landten/ ├── backend/ # FastAPI + SQLModel + SQLite │ ├── app/ │ │ ├── core/ # Config, database, security │ │ ├── models/ # SQLModel database models │ │ ├── routers/ # API endpoints │ │ ├── schemas/ # Pydantic request/response schemas │ │ └── services/ # Business logic (payments, notifications) │ ├── alembic/ # Database migrations │ └── tests/ # Pytest test suite │ └── frontend/ # Next.js 14 (App Router) └── src/ ├── app/ # Pages and layouts │ ├── dashboard/ # Landlord dashboard │ └── tenant/ # Tenant portal ├── components/ # Shared UI components └── lib/ # API client, auth context ``` --- ## Features ### Landlord Dashboard - **Properties**: Create, update, delete properties with address information - **Rooms**: Manage rooms within properties, set rent amounts - **Tenants**: Add tenants to …