MMIT Computer Testing Suite

A cross-platform web application for testing computer hardware components in repair shops. Built with Vue 3 and Node.js for maximum compatibility across modern web browsers.

Features

• Webcam Test: Test camera functionality with live preview and snapshot capability
• Microphone Test: Test audio input with volume visualization and recording playback
• Speaker Test: Test audio output with stereo channel testing, frequency sweeps, and music playback
• Cross-Platform: Works on Windows, macOS, and Linux through modern web browsers
• Modern UI: Beautiful, responsive interface with step-by-step testing process

Tech Stack

• Frontend: Vue 3 + Vite
• Backend: Node.js + Express
• Styling: Pure CSS with modern design patterns

Prerequisites

• Node.js 16+ (recommended: Node.js 18+)
• npm or yarn package manager

Installation

1. Clone the repository

git clone <repository-url>
cd mmit-testing-app

2. Install all dependencies

npm run install:all

This will install dependencies for the root project, frontend, and backend.

Development

Run the web application (recommended for development)

npm run dev

This starts both the backend server (port 3000) and frontend development server (port 5173).

Run individual components

# Frontend only
npm run dev:frontend

# Backend only
npm run dev:backend

Building for Production

Build web application

npm run build

This creates optimized production files in the frontend/dist folder.

Project Structure

mmit-testing-app/
├── frontend/              # Vue 3 frontend application
│   ├── src/
│   │   ├── components/    # Test components
│   │   │   ├── WebcamTest.vue
│   │   │   ├── MicrophoneTest.vue
│   │   │   └── SpeakerTest.vue
│   │   ├── App.vue        # Main application component
│   │   └── main.js        # Vue app entry point
│   ├── index.html
│   ├── package.json
│   └── vite.config.js
├── backend/               # Node.js backend server
│   ├── src/
│   │   └── server.js      # Express server
│   └── package.json
├── package.json           # Root package.json
└── README.md

Usage

Web Browser

1. Start the development server: npm run dev
2. Open your browser to http://localhost:5173
3. Follow the step-by-step testing process

Testing Process

The application guides users through a 3-step testing process:

Step 1: Webcam Test

• Requests camera permissions
• Shows live camera preview
• Allows taking test photos
• Validates camera functionality

Step 2: Microphone Test

• Requests microphone permissions
• Shows real-time volume visualization
• Records and plays back test audio
• Validates microphone functionality

Step 3: Speaker Test

• Tests left and right audio channels individually
• Provides frequency sweep testing
• Includes music playback test
• Volume control testing
• User validation checklist

Browser Compatibility

• Chrome 88+ (recommended)
• Firefox 85+
• Safari 14+
• Edge 88+

Note: Camera and microphone testing requires HTTPS in production or localhost for development.

API Endpoints

The backend provides several API endpoints:

• GET /api/health - Health check
• POST /api/test-results - Save test results (future use)
• GET /api/system-info - Get system information

Configuration

Environment Variables

• NODE_ENV - Set to 'production' for production builds
• PORT - Backend server port (default: 3000)

Troubleshooting

Camera/Microphone Not Working

• Ensure browser permissions are granted
• Check if another application is using the devices
• Try refreshing the page

Audio Not Playing

• Check system volume settings
• Ensure speakers/headphones are connected
• Try different browsers if using web version

Build Issues

• Clear node_modules and reinstall: rm -rf node_modules && npm run install:all
• Ensure Node.js version is 16+
• Check for platform-specific build requirements

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly on multiple platforms
5. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For support and questions, please open an issue in the repository or contact the development team.