Page 1 of 6
System Requirements Document for Project: fierce-elder
Introduction
The project "fierce-elder" aims to develop a B2B SaaS MVP named "CareBridge" for the Indian home-care industry. This platform is designed to facilitate care management by connecting home-care agencies, caregivers, and the families of elderly clients. The primary goal is to provide a trustworthy, calm, and simple interface for non-technical users, including caregivers and family members.
System Overview
Page 2 of 6
Product Interpretation and Delivery Boundary
Page 3 of 6
Functional Requirements as Story Points
- As an Agency Admin, I should be able to add a caregiver by name/phone and generate login credentials for them.
- As an Agency Admin, I should be able to add an elder client and assign a caregiver to them.
- As an Agency Admin, I should be able to build a weekly schedule assigning caregivers to clients.
- As an Agency Admin, I should be able to invite family members via a link/code with role selection.
- As a Caregiver, I should be able to log in, see my daily/weekly schedule, and check in/out of visits.
- As a Caregiver, I should be able to log medicines given, food/hydration, and daily notes during visits.
- As a Family Member, I should be able to join via an invite link and view the elder's profile, visit history, and notifications.
- As a Family Member, I should be able to receive notifications about visit completions, notes, and escalations.
- As a Caregiver or Family Member, I should be able to trigger an escalation alert from any screen.
User Personas
- Agency Admin: Manages caregiver roster, assigns clients to caregivers, builds visit schedules, monitors compliance, and handles billing.
- Caregiver: Sees their own daily/weekly schedule of assigned visits, checks in/out of visits, logs medicines given, food/hydration, daily notes, and flags issues.
- Family Member: Views elder's profile, medicine schedule, visit history, daily notes, expenses, documents; receives notifications; has role-based access if multiple relatives are involved.
Core User Flows
Agency Admin Flow
- Log in to the system.
- Add a caregiver and generate login credentials.
- Add an elder client and assign a caregiver.
- Build a weekly schedule for caregivers and clients.
- Invite family members via a link/code.
Page 4 of 6
Caregiver Flow
- Log in to the system.
- View daily/weekly schedule.
- Check in to a visit.
- Log medicines given, food/hydration, and daily notes.
- Check out of the visit.
Family Member Flow
- Join via an invite link.
- View elder's profile and visit history.
- Receive and view notifications.
- Trigger an escalation alert if necessary.
Visuals Colors and Theme
- Design Tone: Clinical-calm with generous white space and high-contrast text.
- Color Palette:
- Primary: #4A90E2 (Blue)
- Primary Light: #B3D4FC
- Secondary: #50E3C2 (Green)
- Accent: #F5A623 (Orange)
- Highlight: #F8E71C (Yellow)
- Background: #FFFFFF (White)
- Surface: #F7F7F7 (Light Grey)
- Text: #333333 (Dark Grey)
- Text Muted: #9B9B9B (Muted Grey)
- Border: #E1E1E1 (Light Grey)
Page 5 of 6
Signature Design Concept
The design concept for "fierce-elder" emphasizes a clinical-grade interface with a calm and trustworthy aesthetic. The layout will feature generous white space and high-contrast text to ensure readability for older family members. The color palette will consist of blues, greens, and neutrals to convey trust and calmness. The interface will be devoid of playful or gamified elements, focusing instead on clarity and ease of use.
Interaction Model & Motion Direction
- Interaction Model: Animated with moderate scroll-triggered reveals and hover transitions.
- Motion Direction: Focus on clarity and ease of use with restrained CSS transitions. The escalation alert feature will be accessible with a single tap from any screen.
Non-Functional Requirements
- Design Tone: Clinical-calm, closer to a hospital patient-portal than a consumer wellness app.
- Roles: Every screen must be clearly scoped to one of the three roles (agency admin / caregiver / family member).
- Language: UI copy in English for MVP, structured as translatable strings/labels.
- Data Sensitivity: Never display an elder's full medical history on a screen accessible without login.
- Mock Integrations: Mock WhatsApp, SMS, payment gateway, and lab/pharmacy API calls in the UI.
Page 6 of 6
Tech Stack
- Frontend: React for Web
- Backend: Python with FastAPI
- Database: MySQL or MariaDB, using Alembic for migrations
- Local Orchestration: Docker and docker-compose
- Server-Side Orchestration: Kubernetes
Assumptions and Constraints
- The MVP will be built for a single agency's admin view.
- No real-time WhatsApp integration will be implemented in the MVP.
- The system will not support multi-agency switching in the MVP.
- Regional language support is planned for future iterations.
Glossary
- MVP: Minimum Viable Product
- B2B: Business-to-Business
- SaaS: Software as a Service
- UI/UX: User Interface/User Experience
- API: Application Programming Interface
- PIN: Personal Identification Number
This document outlines the requirements and design considerations for the "fierce-elder" project, ensuring a clear understanding of the system's scope and functionality.
No comments yet. Be the first!