Skip to content

Amey-Thakur/ATVM-INTERFACE

Repository files navigation

ATVM Interface

License: MIT Status Technology Developed by Amey Thakur and Mega Satish

A simulation of the Automatic Ticket Vending Machine (ATVM) interface found at railway stations, designed with Human-Machine Interaction (HMI) principles.

Source Code  ·  Technical Specification  ·  Live Demo


Authors  ·  Overview  ·  Features  ·  Structure  ·  Results  ·  Quick Start  ·  Usage Guidelines  ·  License  ·  About  ·  Acknowledgments


Authors

Terna Engineering College | Computer Engineering | Batch of 2022

Amey Thakur
Amey Thakur

ORCID
Mega Satish
Mega Satish

ORCID

Important

🤝🏻 Special Acknowledgement

Special thanks to Mega Satish for her meaningful contributions, guidance, and support that helped shape this work.


Overview

The ATVM (Automatic Ticket Vending Machine) Interface is a user-centric digital simulation designed to optimize the commuter ticketing experience. The system streamlines the workflow for public transport access, reducing transaction time and cognitive friction through a clean, linear interface design.

HMI Principles

The development of this interface was guided by core Human-Machine Interaction paradigms:

  • Direct Manipulation: Users interact directly with visual representations of travel zones and ticket types, reducing the abstraction gap between intent and action.
  • Feedback: The system provides immediate visual responsiveness (color changes, summary updates) to every user input, ensuring the user is always aware of the system state.

Tip

Fitts's Law in Action

The interface layout strategically sizes and places interactive buttons (like 'Book Ticket' and Map Zones) to minimize cursor travel time and maximize target acquisition accuracy. This adherence to Fitts's Law ensures that high-frequency actions become motor reflexes for the user, significantly speeding up the transaction process in high-volume public transport scenarios.


Features

Feature Description
Semantic Layout Structured using HTML5 semantic tags for accessibility and clarity.
State Management Uses AngularJS to handle data flow and view transitions without page reloads.
Master-Grade Export Industrial-Grade Download (v6.0) using Base64 streams for local file compatibility.
Universal Native Share Integrated high-compatibility Native Share API for social sharing across all devices.
Expanded Station UI 1.8x Scaled Station Signs and optimized layout for superior visual hierarchy.
Interactive UX Smooth transitions, instant fare calculation, and simulated printing workflow.
System Map Overlay LED-themed interactive transit map for network-wide orientation.
Data Handling Client-side management of station data and ticket details.

Note

Hidden Easter Egg: Authentic Audio System

We have integrated a specialized immersive layer into the interface. By interacting with the Station Speakers or the Analog Clock, users can trigger high-fidelity Mumbai Suburban Railway announcements. This feature was designed to recreate an authentic transit atmosphere, providing a realistic auditory experience that grounds the simulation in its real-world context. Complementing this immersion, the system also includes a high-fidelity ticket export feature, with each digital reproduction digitally signed by Amey & Mega.

Tech Stack

  • Languages: HTML5, CSS3, JavaScript (ES6+)
  • Logic: AngularJS (1.x), Vanilla JS (Advanced DOM & Web Audio API)
  • Imaging: html2canvas (Custom high-fidelity capture engine)
  • UI System: Bootstrap 3 (Customized), Font Awesome 6
  • Deployment: GitHub Actions (Staging & Continuous Delivery Workflow)
  • Hosting: GitHub Pages

Project Structure

ATVM-INTERFACE/
│
├── .github/                         # GitHub Actions & Automation
│   └── workflows/
│       └── deploy.yml               # Automated Staging & Deployment Flow
│
├── screenshots/                     # Application Screenshots
│   ├── interface_simulation.png     # Interface Simulation
│   ├── atvm_interface_expanded.png  # Expanded Interface Simulation
│   ├── ticket_preview.png           # Ticket Preview Modal
│   ├── downloaded_ticket.png        # Generated Digital Ticket
│   └── map_view.png                 # Interactive System Map
│
├── docs/                            # Technical Documentation
│   └── SPECIFICATION.md             # Architecture & Design Specification
│
├── Mega/                            # Archival Attribution Assets
│   ├── Filly.jpg                    # Companion (Filly)
│   └── Mega.png                     # Author Profile Image (Mega Satish)
│
├── Source Code/                     # Primary Application Layer
│   ├── css/                         # Design System & Stylesheets
│   ├── js/                          # Application Logic (AngularJS)
│   ├── images/                      # Visual Assets
│   └── index.html                   # Application Gateway
│
├── .gitattributes                   # Git configuration
├── CITATION.cff                     # Scholarly Citation Metadata
├── codemeta.json                    # Machine-Readable Project Metadata
├── LICENSE                          # MIT License Terms
├── README.md                        # Comprehensive Archival Entrance
└── SECURITY.md                      # Security Policy & Protocol

Results

Interface Simulation

ATVM Interface

Expanded Interface Simulation

Expanded Interface Simulation

Ticket Preview Modal

Ticket Preview

Generated Digital Ticket

Downloaded Ticket

Interactive System Map

Interactive System Map

Quick Start

1. Prerequisites

  • Browser: Any modern standards-compliant web browser (Chrome, Firefox, Edge, Safari).
  • Environment: No server-side runtime is required; this is a static client-side application.

Warning

Local Execution

While the project can be executed by opening index.html directly, certain features may require an active internet connection to resolve external libraries correctly.

2. Setup & Deployment

  1. Clone the Repository:
    git clone https://github.com/Amey-Thakur/ATVM-INTERFACE.git
    cd ATVM-INTERFACE
  2. Launch: Open Source Code/index.html in your preferred browser.

Tip

Railway ATVM Human-Machine Interaction Simulation

Experience a high-fidelity web reconstruction of the Mumbai Suburban Railway's Automatic Ticket Vending Machine interface, engineered with HMI principles and Fitts's Law optimization to minimize cognitive friction and maximize transaction speed in high-volume transit environments.

Launch Live Demo


Usage Guidelines

This repository is openly shared to support learning and knowledge exchange across the academic community.

For Students
Use this project as reference material for understanding interactive system design, web development patterns, and Human Machine Interaction principles. The source code is available for study to facilitate self-paced learning and exploration of user-centric design patterns.

For Educators
This project may serve as a practical lab example or supplementary teaching resource for Human Machine Interaction and Human Machine Interaction Laboratory courses (CSC801 & CSL801). Attribution is appreciated when utilizing content.

For Researchers
The documentation and design approach may provide insights into academic project structuring and interactive web application development.


License

This repository and all its creative and technical assets are made available under the MIT License. See the LICENSE file for complete terms.

Note

Summary: You are free to share and adapt this content for any purpose, even commercially, as long as you provide appropriate attribution to the original authors.

Copyright © 2022 Amey Thakur & Mega Satish


About This Repository

Created & Maintained by: Amey Thakur & Mega Satish
Academic Journey: Bachelor of Engineering in Computer Engineering (2018-2022)
Institution: Terna Engineering College, Navi Mumbai
University: University of Mumbai

This project features the ATVM Interface, developed as a Human Machine Interaction project during the 8th Semester Computer Engineering curriculum. It showcases the use of web technologies to build interactive, simulation-based digital experiences.

Connect: GitHub  ·  LinkedIn  ·  ORCID

Acknowledgments

Grateful acknowledgment to Mega Satish for her exceptional collaboration and scholarly partnership during the development of this interface simulation. Her constant support, technical clarity, and dedication to software quality were instrumental in achieving the system's functional objectives. Learning alongside her was a transformative experience; her thoughtful approach to problem-solving and steady encouragement turned complex requirements into meaningful learning moments. This work reflects the growth and insights gained from our side-by-side academic journey. Thank you, Mega, for everything you shared and taught along the way.

Grateful acknowledgment to the faculty members of the Department of Computer Engineering at Terna Engineering College for their guidance and instruction in Human Machine Interaction. Their expertise and support helped develop a strong understanding of interactive system design.

Special thanks to the mentors and peers whose encouragement, discussions, and support contributed meaningfully to this learning experience.


↑ Back to Top

Authors  ·  Overview  ·  Features  ·  Structure  ·  Results  ·  Quick Start  ·  Usage Guidelines  ·  License  ·  About  ·  Acknowledgments


🔬 Human Machine Interaction Laboratory   ·   🎫 ATVM-INTERFACE


Computer Engineering (B.E.) - University of Mumbai

Semester-wise curriculum, laboratories, projects, and academic notes.