Page 1 of 7
System Requirements Document (SRD) for sky-platform
1. Introduction
The sky-platform is an AI-enabled service operations platform developed by Ethical Edge Solutions for Gas Electrical Powerzone operations. Designed to streamline workflows, it automates job ingestion from emails and PDFs into ServiceM8, manages inventory across warehouses and vans, and facilitates smart quote follow-ups and supplier communications. The platform provides full operational visibility through real-time dashboards, year-over-year analytics, and technician performance tracking — all in one connected system.
This document outlines the system requirements for the sky-platform, including functional and non-functional requirements, user personas, visual design elements, and technical specifications. The platform is tailored for users in India (IN), with locale-specific considerations such as time zones and currency formats.
Page 2 of 7
2. System Overview
The sky-platform is a centralized solution for managing service operations in the Gas Electrical Powerzone industry. Key features include:
- Automated job ingestion from emails and PDFs into ServiceM8.
- Inventory management across warehouses and service vans.
- Smart quote follow-ups and supplier communications.
- Real-time dashboards for operational visibility.
- Year-over-year analytics and technician performance tracking.
The platform is designed to enhance efficiency, reduce manual effort, and provide actionable insights for administrators, technicians, and other stakeholders.
3. Functional Requirements
- As a User, I should be able to view a real-time dashboard with key performance indicators (KPIs).
- As a User, I should be able to track job pipelines across multiple stages.
- As a User, I should be able to view recent job details in a tabular format.
- As a User, I should be able to manage alerts and actions from a dedicated panel.
- As an Admin, I should be able to monitor technician performance and operational analytics.
- As an Admin, I should be able to manage inventory across warehouses and vans.
- As a User, I should be able to follow up on quotes and supplier communications.
- As a User, I should be able to search for jobs, customers, and parts using a search bar.
4. User Personas
Page 3 of 7
4.1 Administrator
- Role: Oversees the entire platform, manages inventory, and monitors analytics.
- Responsibilities:
- Configure system settings.
- Monitor technician performance.
- Generate reports and analytics.
- Needs: High-level operational visibility and control.
4.2 Technician
- Role: Executes service jobs and updates job statuses.
- Responsibilities:
- Access job details and update progress.
- Manage parts and inventory for assigned jobs.
- Needs: Easy access to job pipelines and inventory details.
4.3 Customer Support Representative
- Role: Handles customer inquiries and follows up on quotes.
- Responsibilities:
- Communicate with customers and suppliers.
- Track quote statuses and follow-ups.
- Needs: Tools for efficient communication and tracking.
5. Visuals Colors and Theme
Page 4 of 7
Light Mode Color Palette
| Element | Hex Code |
|---|
| Page background | #F9FAFB |
| Card / panel background | #FFFFFF |
| Card border | #E5E7EB |
| Row hover | #F3F4F6 |
| Text primary | #111827 |
| Text secondary / labels | #6B7280 |
| Text muted | #9CA3AF |
| Positive delta (↑) | #16A34A |
| Negative delta (↓) | #DC2626 |
| Job number links | #2563EB |
| "View All →" link | #2563EB |
6. Signature Design Concept
Interactive Job Pipeline Visualization
The homepage will feature an interactive job pipeline strip as its centerpiece. This strip will visually represent the 8 stages of job progress, with each stage displayed as a dynamic pill. Users can hover over each pill to reveal a tooltip with detailed statistics, such as the number of jobs in that stage and their statuses.
Page 5 of 7
Key Features:
- Dynamic Animations: Pills will expand slightly on hover, with a smooth transition effect.
- Color-Coded Stages: Each stage will have a unique accent color for quick identification.
- Progressive Updates: The pipeline will update in real-time as jobs move between stages.
- Interactive Filters: Clicking on a stage will filter the dashboard to show only jobs in that stage.
This design will make the job pipeline both functional and visually engaging, offering users an intuitive way to track job progress.
7. Non-Functional Requirements
- The platform must support a minimum of 1,000 concurrent users.
- The system should load the dashboard within 3 seconds under normal conditions.
- Data updates (e.g., job status changes) should reflect in real-time with a maximum delay of 2 seconds.
- The platform must comply with data protection regulations applicable in India.
- The system should support integration with ServiceM8 and other third-party tools.
8. Tech Stack
Frontend
Backend
Page 6 of 7
Database
- MySQL (with Alembic for migrations)
AI Models
- GPT 5.4 for user-friendly responses
- Claude 4.6 Opas for academic or coding work
AI Tools
- Langchain
- Litellm for LLM Routing
Orchestration
9. Assumptions and Constraints
Assumptions
- The platform will be deployed in the Indian region and will adhere to local regulations.
- Users will access the platform primarily through desktop browsers.
- All users will operate in light mode.
Page 7 of 7
Constraints
- The system must integrate seamlessly with ServiceM8.
- The platform must support real-time data updates without significant latency.
- The design must adhere to the specified light mode color palette.
10. Glossary
- KPI: Key Performance Indicator, a measurable value that indicates how effectively a user is achieving objectives.
- ServiceM8: A job management software used for scheduling, quoting, and invoicing.
- Pipeline: A visual representation of job progress across various stages.
- Delta: The change in a metric compared to a previous time period.
- P&A: Parts and Accessories, referring to items required to complete a job.
- RDBMS: Relational Database Management System, such as MySQL or MariaDB.
This updated SRD reflects the light mode design for the Dashboard page and ensures alignment with Priyank's detailed specifications.
No comments yet. Be the first!