System Requirements Document (SRD)

Project Name: mercy-tent

1. Introduction

The mercy-tent project is a mobile-first platform designed to streamline property management for tenants, property managers, and owners. This application aims to simplify complex processes such as rent collection, lease agreements, gate pass management, and billing, ensuring transparency and efficiency for all stakeholders.

This document outlines the system requirements for the mercy-tent project, tailored for GM in India (IN), with locale-specific considerations such as currency (INR), timezone (IST), and user preferences.

2. System Overview

The mercy-tent platform is a comprehensive property management solution built as a mobile application. It caters to three primary user roles: tenants, property managers, and owners. The system provides functionalities such as lease agreement management, rent collection, reminders, billing, gate pass issuance, and property analytics.

The platform will be developed using cutting-edge technologies to ensure scalability, security, and ease of use. It will initially focus on mobile accessibility, enabling users to manage their property-related tasks conveniently from their smartphones.

3. Functional Requirements

Tenant Features:

• As a Tenant, I should be able to view my lease agreements.
• As a Tenant, I should be able to make rent payments securely.
• As a Tenant, I should be able to request and manage gate passes.
• As a Tenant, I should be able to receive reminders for rent due dates.
• As a Tenant, I should be able to view notices and updates from property managers.

Property Manager Features:

• As a Property Manager, I should be able to manage lease agreements for multiple tenants.
• As a Property Manager, I should be able to issue gate passes for tenants.
• As a Property Manager, I should be able to send notices and updates to tenants.
• As a Property Manager, I should be able to track rent collection status for all properties.

Owner Features:

• As an Owner, I should be able to view property analytics and reports.
• As an Owner, I should be able to manage rent collection and billing.
• As an Owner, I should be able to set reminders for rent collection.
• As an Owner, I should be able to view lease agreements for my properties.

4. User Personas

Tenant

• Primary user of the platform.
• Requires functionalities for rent payment, lease agreement management, gate pass requests, and reminders.

Property Manager

• Responsible for managing tenants and properties.
• Requires tools for lease agreement management, gate pass issuance, notices, and rent tracking.

Owner

• Oversees property performance and financials.
• Requires analytics, billing, rent collection, and lease agreement visibility.

5. Visuals Colors and Theme

The mercy-tent platform will feature a clean and professional design with the following color palette:

• Primary Color: Deep Blue (#003366) – Represents trust and professionalism.
• Secondary Color: Emerald Green (#50C878) – Symbolizes growth and prosperity.
• Accent Color: Warm Yellow (#FFD700) – Adds vibrancy and highlights important actions.
• Background Color: Light Gray (#F5F5F5) – Ensures readability and a modern aesthetic.

The theme will focus on simplicity and clarity, with intuitive navigation and visually distinct sections for each user role.

6. Signature Design Concept

Interactive Property Map Homepage

The homepage will feature an interactive map of properties, designed to provide a vivid and engaging experience. Users will see a dynamic map with pins representing their properties.

Key Features:

• Hover Animations: Pins will expand and display property details when hovered over.
• Zoom and Pan: Users can zoom into specific areas and pan across the map for a seamless exploration experience.
• Color-coded Pins: Different colors for tenant properties, managed properties, and owned properties.
• Micro-interactions: Clicking on a pin will open a detailed view with lease agreements, rent status, and analytics.
• Day/Night Mode: The map background will subtly shift between day and night themes based on the user's local time.

This design will make the homepage unforgettable, combining functionality with a visually striking interface.

7. Non-Functional Requirements

• The system must ensure data security and privacy, adhering to GDPR and Indian data protection laws.
• The mobile app must be optimized for both Android and iOS platforms.
• The platform must support high scalability to accommodate growing user bases.
• The system must provide a seamless user experience with minimal latency (<200ms response time).
• The app must support multi-language functionality, starting with English and Hindi.

8. Tech Stack

Frontend

• React Native for mobile app development.

Backend

• Python with FastAPI for API development.

Database

• MySQL for relational data management (e.g., lease agreements, rent records).
• MongoDB for NoSQL data storage (e.g., notifications, gate pass requests).

AI Models

• GPT 5.2 for user-friendly responses and reminders.
• Claude 4.5 Opas for lease agreement analysis and coding support.

AI Tools

• Langchain for AI workflow orchestration.
• Litellm for LLM routing.

Local Orchestration

• Docker and docker-compose for containerization.

Server-side Orchestration

• Kubernetes for deployment and scaling.

9. Assumptions and Constraints

• The platform will initially focus on mobile accessibility, with a web version planned for future development.
• The app will support INR as the default currency for all financial transactions.
• The system will operate within the IST timezone.
• Deployment will be cloud-based, leveraging Kubernetes for scalability.

10. Glossary

• Tenant: A user renting a property.
• Property Manager: A user managing properties and tenants on behalf of owners.
• Owner: A user owning properties listed on the platform.
• Lease Agreement: A legal document outlining the terms of property rental.
• Gate Pass: A digital pass allowing tenants access to gated properties.
• Rent Collection: The process of collecting rental payments from tenants.

This document provides a comprehensive overview of the mercy-tent project, ensuring clarity and alignment with GM's vision. Let me know if there are additional features or adjustments you'd like to include!