System Requirements Document (SRD)

Project Name: infini-lease

1. Introduction

The infini-lease project is a real estate lease abstraction system designed to streamline and enhance the management of critical lease dates. This document outlines the system requirements for the "Critical Dates Configuration Module," a key feature that allows users to configure notification behaviors for critical lease dates. The module ensures users receive timely notifications for events such as renewal notices, rent escalations, and termination notices, while providing flexibility to customize these notifications globally or per critical date type.

This SRD is tailored to meet the needs of users in Armenia (AM), with locale-specific considerations such as time zones (AMT) and currency (Armenian Dram, AMD).

2. System Overview

The Critical Dates Configuration Module is a core feature of the infini-lease platform. It provides users with an intuitive interface to manage notifications for critical lease dates. Key functionalities include:

• Enabling or disabling notifications globally or for specific critical date types.
• Customizing email titles and notification timing for each critical date.
• Validating user inputs to ensure error-free configurations.
• Supporting scalability for adding new critical date types in the future.

The system is designed to enhance user experience through clear hierarchy, responsive design, and educational tooltips, ensuring ease of use for both novice and experienced users.

3. Functional Requirements

• As a User, I should be able to enable or disable notifications globally for all critical dates.
• As a User, I should be able to enable or disable notifications for specific critical date types.
• As a User, I should be able to input a custom email title for notifications, which is required when notifications are enabled.
• As a User, I should be able to configure notification timing (e.g., 30 days before, 7 days before) for each critical date type.
• As a User, I should see inline error messages if required fields are left blank or invalid.
• As a User, I should see tooltips or help text for complex fields like notification timing.
• As a User, I should be able to add new critical date types dynamically.
• As a User, I should see a clear empty state when no critical dates are configured.
• As a User, I should see a responsive design that works seamlessly on both desktop and mobile devices.

4. User Personas

1. Admin

• Role: Manages global notification settings and oversees the configuration of critical dates for all users.
• Needs: A clear overview of all critical date types and the ability to enforce global notification policies.

2. User

• Role: Configures notifications for critical dates relevant to their leases.
• Needs: An intuitive interface to customize notifications for specific critical dates.

3. Guest (Future Scope)

• Role: Limited access to view critical date configurations without editing permissions.
• Needs: A read-only view of the configuration module.

5. Visuals Colors and Theme

The visual design of the infini-lease platform will use a unique, modern color palette that reflects professionalism and trustworthiness while maintaining a clean and user-friendly interface.

• Background: #F7F9FC (Soft Cloud White)
• Surface: #FFFFFF (Pure White)
• Text: #2C3E50 (Deep Charcoal)
• Accent: #3498DB (Armenian Blue)
• Muted: #BDC3C7 (Soft Gray)

This palette ensures readability and a professional appearance, with the accent color used sparingly to highlight actionable elements like buttons and toggles.

6. Signature Design Concept

Dynamic Floating Cards with Contextual Animations

The homepage of the Critical Dates Configuration Module will feature a dynamic floating card interface. Each critical date type will be represented as a card that "floats" slightly above the surface, casting a subtle shadow. When users hover over a card, it will gently lift and expand, creating a tactile and interactive feel.

Key Features:

1. Interactive Animations:

   • Cards will have a smooth hover effect, with a slight scale-up and shadow enhancement.
   • When a card is clicked, it will expand into a full-screen modal, allowing users to edit the critical date settings in detail.

2. Color Transitions:

   • The background color of the cards will subtly shift when toggles are turned ON or OFF (e.g., from Muted Gray to Accent Blue).

3. Micro-Interactions:

   • Tooltips will fade in and out when hovered over, providing additional information without cluttering the interface.
   • Save and Cancel buttons will have a ripple effect when clicked, providing immediate feedback.

4. Empty State Animation:

   • When no critical dates are configured, a playful animation of a calendar icon will appear, accompanied by a call-to-action to add a new critical date type.

This design concept ensures the module is not only functional but also visually engaging, leaving a lasting impression on users.

7. Non-Functional Requirements

• The system must load the configuration page within 2 seconds.
• The module must support responsive design for devices with screen widths ranging from 320px to 1920px.
• All user inputs must be validated in real-time to prevent errors.
• The system must support the addition of up to 100 critical date types without performance degradation.

8. Tech Stack

Frontend

• React for Web

Backend

• Python
• FastAPI

Database

• MySQL (with Alembic for migrations)

AI Tools

• Litellm for LLM Routing

Local Orchestration

• Docker
• docker-compose

9. Assumptions and Constraints

• Users will primarily access the system from desktop devices, but mobile compatibility is required.
• Notifications will be sent via email only; no SMS or push notifications are planned at this stage.
• The system will operate in the Armenian time zone (AMT) by default.

10. Glossary

• Critical Date: A significant date in a lease agreement, such as renewal notice or rent escalation.
• Notification Timing: The period before a critical date when a notification is sent (e.g., 30 days before).
• Empty State: A UI state displayed when no data is available.
• Tooltip: A small pop-up box that provides additional information when hovered over.