DalScooter - Serverless Scooter Management System

A modern, serverless scooter management application built with React frontend and AWS Lambda backend services.

Table of Contents

• Overview
• Features
• Architecture
• Tech Stack
• Installation
• Usage
• Deployment
• Contributing

Overview

DalScooter is a comprehensive serverless application designed for managing electric scooter rentals and operations. The system provides real-time scooter tracking, user management, chatbot support, and analytics through a modern web interface powered by AWS serverless services.

Features

• User Authentication & Authorization

  • Secure user registration and login
  • Multi-factor authentication (MFA) support
  • Role-based access control

• Intelligent Chatbot Support

  • Amazon Lex integration for natural language processing
  • Real-time customer support
  • Automated issue resolution

• Real-time Notifications

  • SNS/SQS-based notification system
  • Email, SMS, and push notifications
  • Configurable notification preferences

• Messaging System

  • Publisher-subscriber pattern implementation
  • Real-time message processing
  • Event-driven architecture

• Sentiment Analysis

  • AWS Comprehend integration
  • User feedback analysis
  • Performance insights

• Analytics Dashboard

  • Real-time scooter status monitoring
  • Usage statistics and metrics
  • Performance analytics

Architecture

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   React Frontend│    │  AWS API Gateway│    │  AWS Lambda     │
│                 │◄──►│                 │◄──►│  Functions      │
└─────────────────┘    └─────────────────┘    └─────────────────┘
                                │                       │
                                ▼                       ▼
                       ┌─────────────────┐    ┌─────────────────┐
                       │  Amazon Cognito │    │  Amazon DynamoDB│
                       │  (Auth)         │    │  (Database)     │
                       └─────────────────┘    └─────────────────┘
                                │                       │
                                ▼                       ▼
                       ┌─────────────────┐    ┌─────────────────┐
                       │  Amazon SNS/SQS │    │  Amazon Lex     │
                       │  (Notifications)│    │  (Chatbot)      │
                       └─────────────────┘    └─────────────────┘

Tech Stack

Frontend

• React 18 - Modern UI framework
• React Router - Client-side routing
• AWS Amplify - AWS service integration
• Axios - HTTP client
• CSS3 - Styling and animations

Backend

• AWS Lambda - Serverless compute
• Node.js 18 - Runtime environment
• Serverless Framework - Infrastructure as code
• AWS SDK - AWS service integration

Database & Storage

• Amazon DynamoDB - NoSQL database
• Amazon S3 - File storage (future)

AWS Services

• Amazon Cognito - User authentication
• Amazon Lex - Chatbot functionality
• Amazon SNS/SQS - Messaging and notifications
• Amazon Comprehend - Sentiment analysis
• AWS API Gateway - REST API management

Installation

Prerequisites

• Node.js 18+
• npm or yarn
• AWS CLI configured
• Serverless Framework

Frontend Setup

# Navigate to frontend directory
cd frontend

# Install dependencies
npm install

# Start development server
npm start

Backend Setup

# Navigate to backend directory
cd backend

# Install dependencies
npm install

# Install serverless framework globally
npm install -g serverless

# Start local development server
npm run offline

Usage

Starting the Application

1. Start Backend Services:

   cd backend
   npm run offline

2. Start Frontend Application:

   cd frontend
   npm start

Key Features

• Dashboard: View scooter status and system metrics
• Authentication: Register and login with secure credentials
• Chatbot: Interact with AI-powered support assistant
• Analytics: Monitor usage patterns and performance

Testing

# Frontend tests
cd frontend
npm test

# Backend tests
cd backend
npm test

Deployment

Frontend Deployment

cd frontend
npm run build
# Deploy to AWS S3 + CloudFront or similar

Backend Deployment

cd backend
npm run deploy
# Deploys to AWS using Serverless Framework

Production Deployment

# Deploy to production
npm run deploy:prod

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

Built with love by DalScooter Team 17