Agile-Compliance System Requirements Document

1. Introduction

The Agile-Compliance project aims to develop a Fire & Life-Safety Inspection Compliance Tracking system. This system is designed to assist property managers in maintaining compliance with fire safety regulations by ensuring timely inspections and providing proof of compliance to auditors. The target audience includes property management firms, multifamily owners, and facilities teams managing 50–500 units/buildings.

2. System Overview

2a. Product Interpretation and Delivery Boundary

The Agile-Compliance system is a compliance management tool focused on fire and life-safety inspection tracking. It provides a document management vault for storing and retrieving inspection documents, ensuring timely inspections and documentation for fire safety equipment. The system will include the following custom pages:

• Building/device registry: For tracking compliance.
• Inspector upload portal: For uploading inspection documents.
• Expiry dashboard: For monitoring inspection schedules.
• Document vault: For storing compliance documents.
• Compliance report workspace: For generating and retrieving compliance reports.
• Landing: A public entry surface to orient and acquire independent property managers.
• Authentication: For account sign-up, login, and session access.

Access is application-owned, and the system requires authentication for privileged workflow access. The system will not include generic CRM features or e-commerce transactions.

2b. Source Content Inventory

No explicit content sources were provided; therefore, this section is not applicable.

2c. Page Content and Component Coverage

• Building/device registry: Allows property managers to register buildings and devices, updating the registry with durable state changes.
• Inspector upload portal: Enables inspectors to upload inspection documents, updating the document vault.
• Expiry dashboard: Displays inspection schedules and sends auto-reminders to inspection vendors.
• Document vault: Stores compliance documents securely.
• Compliance report workspace: Allows property managers to generate and retrieve audit-ready compliance reports.
• Landing: Provides an entry point for new users to understand the system's offerings.
• Authentication: Manages user sign-up, login, and session access.

3. Functional Requirements as Story Points

• As a Property Manager, I should be able to register a building or device to track compliance. explicit
• As an Inspector, I should be able to upload inspection documents to the portal. required_inference
• As a Property Manager, I should be able to generate a compliance report for audit purposes. explicit
• As a Property Manager, I should receive auto-reminders for upcoming inspections to ensure timely compliance. explicit
• As a Property Manager, I should be able to access a document vault to store and retrieve compliance documents. explicit
• As a new user, I should be able to sign up and log in to access the system. required_inference
• As a Property Manager, I should be able to view an expiry dashboard to monitor inspection schedules. explicit

4. User Personas

• Property Manager: Responsible for managing compliance, registering buildings/devices, and generating compliance reports.
• Inspector: Uploads inspection documents and interacts with the portal.

5. Core User Flows

Property Manager Flow

1. Access the Landing page.
2. Sign up or log in via the Authentication page.
3. Register a building or device in the Building/device registry.
4. Monitor inspection schedules on the Expiry dashboard.
5. Receive auto-reminders for upcoming inspections.
6. Generate a compliance report in the Compliance report workspace.
7. Store and retrieve documents from the Document vault.

Inspector Flow

1. Access the Inspector upload portal.
2. Upload inspection documents to the portal.

6. Visuals Colors and Theme

• Primary: #007BFF (blue)
• Primary Light: #66B2FF
• Secondary: #6C757D (gray)
• Accent: #28A745 (green)
• Highlight: #FFC107 (yellow)
• Background: #F8F9FA (light gray)
• Surface: #FFFFFF (white)
• Text: #212529 (dark gray)
• Text Muted: #6C757D (gray)
• Border: #DEE2E6 (light gray)

7. Signature Design Concept

The design concept for the Agile-Compliance system focuses on clarity and ease of use. The Landing page will feature a clean, modern design with a prominent call-to-action for new users to sign up. The Building/device registry will have a structured layout with clear labels and input fields for easy data entry. The Expiry dashboard will use color-coded indicators to highlight upcoming inspections. The Document vault will provide a simple interface for document retrieval, with search and filter options for quick access.

8. Interaction Model & Motion Direction

The interaction model for the Agile-Compliance system will be primarily static, focusing on layout clarity and minimal motion. The Landing page will feature moderate scroll-triggered reveals to guide users through the sign-up process. Internal pages, such as the Building/device registry and Document vault, will prioritize data density and task completion.

9. Non-Functional Requirements

• The system must ensure data durability and integrity for all compliance records. required_inference
• The system must provide secure access control to protect sensitive compliance data. required_inference

10. Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MySQL or MariaDB, using Alembic for migrations
• AI Tools: OCR for inspection tags, jurisdiction-specific compliance checklist generation

11. Assumptions and Constraints

• The system will not include generic CRM features or e-commerce transactions.
• The system will focus on compliance management and document management for fire and life-safety inspections.

12. Glossary

• OCR: Optical Character Recognition, used for reading inspection tags.
• MVP: Minimum Viable Product, the initial version of the product with core features.
• Compliance Report: A document detailing the compliance status of fire safety equipment.
• Document Vault: A secure storage area for compliance documents.