Page 1 of 5
YMS Trip System Requirements Document
1. Introduction
The YMS Trip project aims to develop a web-based dashboard that automates the management of Yellow Mellow Squad trips by integrating Google Forms, Google Sheets, WhatsApp messaging, payment tracking, and participant management. This document outlines the system requirements for the YMS Trip project, ensuring a streamlined process for trip management and reducing manual work by 90%.
2. System Overview
The YMS Trip dashboard will serve as an operational control center, pulling data from Google Forms and providing a comprehensive view of trip management. It will automate various processes, including registration, payment tracking, document management, and communication through WhatsApp.
2a. Source Content Inventory
- Google Forms: Used for registration.
- Google Sheets: Stores registration data.
- WhatsApp Business API: For automated messaging.
- Supabase: Database and authentication.
- Vercel: Hosting platform.
Page 2 of 5
3. Functional Requirements as Story Points
- As an Admin, I should be able to create, edit, and delete trips.
- As an Admin, I should be able to send messages and update payments.
- As an Admin, I should be able to export reports.
- As a Parent, I should be able to register through Google Forms without logging in.
- As an Admin, I should be able to view total registrations, available and filled seats, and payment statuses.
- As an Admin, I should be able to manage trip details such as name, destination, dates, and capacity.
- As an Admin, I should be able to sync registrations from Google Sheets automatically.
- As an Admin, I should be able to manage registration details, including kid and parent information.
- As an Admin, I should be able to track payments and generate payment reports.
- As an Admin, I should be able to manage pickup points and calculate the number of kids and parents per location.
- As an Admin, I should be able to track document statuses for each participant.
- As an Admin, I should be able to automate WhatsApp messages for various reminders and notifications.
- As an Admin, I should be able to manage attendance on travel days.
- As an Admin, I should be able to generate various reports and export them in multiple formats.
- As an Admin, I should be able to maintain a history of each participant's trips.
- As an Admin, I should be able to upload and organize trip photos and videos.
- As an Admin, I should be able to manage a birthday calendar with automatic reminders.
- As an Admin, I should be able to track expenses and calculate profit.
- As an Admin, I should be able to collect and display feedback from participants.
- As an Admin, I should be able to search and filter data by various criteria.
- As an Admin, I should be able to view analytics and charts for registrations, growth, and revenue.
- As an Admin, I should be able to automate birthday wishes, payment reminders, and other notifications.
Page 3 of 5
4. User Personas
- Admin: Manages trips, communications, and data analysis.
- Parent: Registers children for trips and receives notifications via WhatsApp.
5. Core User Flows
- Parent registers child via Google Forms -> Data syncs to dashboard -> Admin views and manages trip details.
- Admin sends automated WhatsApp reminders -> Parents receive notifications.
- Admin tracks payments and documents -> Generates reports -> Exports data.
6. Visuals Colors and Theme
- primary: #FFCC00 (Yellow)
- primary_light: #FFE066 (Light Yellow)
- secondary: #0066CC (Blue)
- accent: #FF6600 (Orange)
- highlight: #00CC66 (Green)
- bg: #FFFFFF (White)
- surface: #F2F2F2 (Light Grey)
- text: #333333 (Dark Grey)
- text_muted: #777777 (Grey)
- border: #DDDDDD (Light Grey)
7. Signature Design Concept
Page 4 of 5
Interactive Trip Map
The homepage will feature an interactive map that displays all upcoming and current trips. Users can click on a trip location to view details such as trip status, number of participants, and available seats. The map will be animated using motion/react to provide a dynamic experience, with smooth transitions and hover effects that highlight trip details.
Landing Hero Motion Brief
The landing page will showcase a dynamic illustration of a bus journeying through various destinations. As users scroll, the bus will move along a path, stopping at different locations where trip details pop up. This animation will loop every 10 seconds, providing a continuous narrative of the trip journey. The animation will be built using CSS and motion/react, ensuring a seamless experience across devices.
8. Interaction Model & Motion Direction
- Interaction Model: Animated
- Motion Direction: The landing page will feature moderate scroll-triggered reveals and hover transitions, providing a polished and engaging user experience.
9. Non-Functional Requirements
- The system must be secure, with encrypted databases and Google Authentication.
- The dashboard must be mobile-responsive, functioning seamlessly on desktops, tablets, and mobile devices.
- The system should support high availability and scalability to handle peak registration periods.
Page 5 of 5
10. Tech Stack
- Frontend: Next.js + Tailwind CSS
- Backend: Next.js API Routes
- Database: Supabase (PostgreSQL)
- Authentication: Supabase Auth (Google Login)
- Storage: Supabase Storage
- Registration Source: Google Forms + Google Sheets
- WhatsApp: WhatsApp Business Cloud API
- Charts: Recharts
- Hosting: Vercel
- Version Control: GitHub
11. Assumptions and Constraints
- The system will rely on Google Forms and Sheets for registration and data storage.
- WhatsApp Business API will be used for communication, requiring internet connectivity.
- The dashboard will be hosted on Vercel, with Supabase providing backend services.
12. Glossary
- Admin: User role responsible for managing trips and dashboard operations.
- Parent: User role interacting with the system through Google Forms and WhatsApp.
- Dashboard: The web-based interface for managing trip operations.
- Supabase: A backend service providing database and authentication solutions.
- Vercel: A platform for hosting web applications.
This document provides a comprehensive overview of the YMS Trip project requirements, ensuring a clear and structured approach to development.
No comments yet. Be the first!