Welcome to AsseTrack

Complete Asset Management System Documentation

About AsseTrack

AsseTrack is a comprehensive asset management system designed to help organizations efficiently track, manage, and maintain their physical and digital assets. Built with modern web technologies, it provides a robust solution for asset lifecycle management.

The system features user authentication, role-based permissions, asset categorization, transaction tracking, and comprehensive reporting capabilities.

System Requirements

  • Node.js: Version 22 or higher
  • MySQL: Version 5.7 or higher
  • RAM: Minimum 4GB (8GB recommended)
  • Storage: At least 2GB free space
  • Operating System: Windows 10+, macOS 10.15+, or Linux (Ubuntu 18.04+)

Frontend

React.js with TypeScript

Tailwind CSS for styling

Vite for build tooling

Backend

Node.js with Express.js

JWT for authentication

Winston for logging

Database

MySQL database

Sequelize ORM

Database migrations

Features

Role-based permissions

File upload system

API documentation

Quick Start Guide

  1. Install Node.js 22+ and MySQL 5.7+ on your system
  2. Clone or download the AsseTrack project
  3. Navigate to the server directory and run npm install
  4. Create a .env file with your database configuration
  5. Run npm run db:migrate to set up the database
  6. Run npm run db:seed to add sample data
  7. Start the server with npm run dev
  8. Navigate to the client directory and run npm install
  9. Update the API configuration in src/config/config.ts
  10. Start the client with npm run dev
  11. Open your browser and go to http://localhost:5000
  12. Login with default credentials: admin@gmail.com / admin@123

Windows Setup

Complete installation guide for Windows 10/11 systems with step-by-step instructions

View Windows Guide

Linux Setup

Detailed setup instructions for Ubuntu, CentOS, and other Linux distributions

View Linux Guide

macOS Setup

Installation guide for macOS systems including Homebrew setup

View macOS Guide

Server Configuration

Production deployment, security, and server optimization guide

View Server Guide