Page 1 of 5
omega-citizens System Requirements Document
Introduction
The "omega-citizens" project is a civic-tech initiative aimed at enhancing transparency and accountability in road infrastructure management. This platform empowers citizens to report road issues, track public spending, and engage with government authorities, while also providing government officials with tools to manage and monitor road repair projects effectively.
System Overview
The omega-citizens platform consists of three main portals: Citizen, Admin, and a unified Engineer/Contractor portal. Each portal is designed to cater to the specific needs of its users, ensuring seamless interaction and efficient management of road infrastructure projects.
Citizen Portal
- Allows citizens to report road issues, track complaint statuses, and view public spending on road repairs.
Admin Portal
- Enables government officials to verify complaints, assign tasks to engineers and contractors, and manage budgets and project progress.
Engineer/Contractor Portal
- Provides engineers and contractors with tools to manage their tasks, update project progress, and communicate with other stakeholders.
Page 2 of 5
Functional Requirements
- As a Citizen, I should be able to report road issues with photos and GPS location.
- As a Citizen, I should be able to track the status of my complaints.
- As a Citizen, I should be able to view public spending on road repairs.
- As an Admin, I should be able to verify and approve reported issues.
- As an Admin, I should be able to assign tasks to engineers and contractors.
- As an Admin, I should be able to manage budgets and track project progress.
- As an Engineer/Contractor, I should be able to view assigned tasks and update their status.
- As an Engineer/Contractor, I should be able to log work hours and manage resources.
- As an Engineer/Contractor, I should be able to communicate with admins and other stakeholders.
User Personas
- Citizen: Individuals using the platform to report road issues and track public spending.
- Admin: Government officials responsible for managing and monitoring road repair projects.
- Engineer/Contractor: Professionals tasked with executing road repair projects and updating progress.
Page 3 of 5
Visuals Colors and Theme
- primary: #2A9D8F (Teal)
- primary_light: #A8DADC (Light Teal)
- secondary: #E63946 (Crimson)
- accent: #F4A261 (Orange)
- highlight: #FFD166 (Amber)
- bg: #F1FAEE (Off-white)
- surface: rgba(42, 157, 143, 0.8)
- text: #1D3557 (Dark Blue)
- text_muted: #457B9D (Muted Blue)
- border: rgba(69, 123, 157, 0.2)
Signature Design Concept
Interactive Road Map Experience
The homepage will feature an interactive road map that allows users to explore road conditions in their area. Using @react-three/fiber and @react-three/drei, the map will display roads in 3D, with color-coded conditions (green, yellow, red) that change dynamically based on real-time data. Users can click on roads to view detailed information, such as recent repairs, contractor details, and budget allocations. Hovering over roads will reveal a pop-up with a condition score and last repair date. This immersive experience will engage users and provide a vivid representation of road infrastructure.
Page 4 of 5
Interaction Model & Motion Direction
- Interaction Model: Parallax
- Motion Direction: The landing page will feature layered depth via scroll, with decorative elements like atmospheric blobs and distant shapes translating at different speeds. Real content will scroll naturally, providing a visually rich first impression. Internal pages will maintain a static layout for clarity and readability.
Non-Functional Requirements
- The system must support high concurrency to handle multiple users accessing the platform simultaneously.
- Data must be encrypted to ensure security and privacy.
- The platform should be accessible on both mobile and web platforms, ensuring a responsive design.
Tech Stack
- Frontend: React for Web, React Native for mobile app
- Backend: Python, FastAPI
- Database: MySQL or MariaDB, using Alembic for migrations
- Maps Integration: Mapbox
- Cloud: AWS
- Notifications: Firebase Cloud Messaging
Assumptions and Constraints
- The platform will primarily serve users in India, considering local infrastructure and regulations.
- The system will integrate with existing government databases for authentication and data validation.
- Budget constraints may limit the initial scope of AI and IoT integrations.
Page 5 of 5
Glossary
- GIS: Geographic Information System
- OTP: One-Time Password
- MVP: Minimum Viable Product
- UI: User Interface
- UX: User Experience
This document outlines the foundational requirements and design concepts for the omega-citizens project, ensuring a comprehensive approach to enhancing road infrastructure transparency and management.
No comments yet. Be the first!