Skip to main content

Trackly - Complete Business Management System

Trackly is a comprehensive web application designed for modern organizations to manage their IT infrastructure, business processes, and operational workflows with enterprise-grade features.

Overview​

Trackly provides a unified platform for managing IT assets, software licenses, consumables, and business quotations. Built with modern web technologies and designed for scalability, it serves as the central hub for organizational resource management.

Key Features​

Asset Management​

  • Complete Asset Tracking: Track hardware assets with detailed specifications, purchase information, and lifecycle status
  • Smart Checkout System: Advanced checkout workflows with approval requests and email notifications
  • QR Code Integration: Generate, print, and scan QR codes for instant asset identification
  • Multi-Stock Support: Handle assets with quantities and partial checkouts
  • Asset Categories: Organize assets by type (Desktop, Laptop, Monitor, Phone, Tablet, etc.)
  • Status Tracking: Monitor asset conditions (Excellent, Good, Fair, Poor, Damaged, Lost)
  • Location Management: Track asset locations across different offices and departments
  • Checkout Requests: User-initiated checkout requests with admin approval workflow
  • Advanced Filtering: Filter by category, status, location, assignment, and more

License Management​

  • Software License Vault: Centralized storage for all software licenses and subscriptions
  • License Types: Support for Perpetual, Subscription, Site License, and Volume License
  • Expiration Tracking: Automated monitoring of license expiration dates with alerts
  • Assignment Tracking: Track license assignments to users and departments
  • Compliance Management: Ensure license compliance with usage tracking
  • Cost Analysis: Track licensing costs and renewal schedules
  • Quick Actions: Inline editing and management of license details

Quotation & Invoice System​

  • Professional PDF Generation: Create customer and business quotations with customizable templates
  • Service Management: Comprehensive service catalog with pricing and descriptions
  • Add-on Services: Flexible add-on system for additional services
  • Discount Management: Support for percentage and fixed amount discounts
  • Payment Terms: Configurable payment terms and VAT calculations
  • Auto-numbering: Automatic quote and invoice numbering system
  • Template System: Multiple PDF templates for different business needs
  • Real-time Statistics: Quotation analytics and performance tracking

Consumables Management​

  • Inventory Tracking: Monitor consumable items like cables, adapters, batteries
  • Stock Levels: Track current stock with low-stock alerts
  • Cost Tracking: Monitor per-unit costs and total inventory value
  • Usage Analytics: Monitor consumption patterns and reorder points
  • Category Organization: Organize consumables by type and purpose

User Management & Security​

  • Role-Based Access Control: Admin and regular user roles with appropriate permissions
  • Department Management: Complete department structure with managers and locations
  • Secure Authentication: Firebase-based authentication with email/password
  • Checkout Request System: User-initiated requests with admin approval workflow
  • Activity Logging: Detailed audit trails for all system activities
  • Session Management: Automatic logout with inactivity warnings

Advanced Admin Features​

  • Comprehensive Dashboard: Real-time statistics and system overview
  • User Checkout Tracking: Monitor all user checkouts with duration tracking
  • Request Management: Approve or reject checkout requests with reason tracking
  • Department Administration: Full CRUD operations for organizational structure
  • System Analytics: Detailed insights into asset utilization and system usage
  • Bulk Operations: Perform actions on multiple items simultaneously

Auto-Update System​

Trackly includes a comprehensive auto-update system that ensures users always have the latest features and security updates:

Features​

  • Automatic Checking: Checks for updates every 6 hours automatically
  • Manual Updates: Users can manually check for updates in Settings
  • Background Downloads: Updates are downloaded in the background using service workers
  • Smart Notifications: Non-intrusive update notifications with release notes
  • Rollback Protection: Validates updates before installation
  • Offline Support: Works offline with cached versions

How It Works​

  1. Version Monitoring: Automatically checks GitHub releases for new versions
  2. User Notification: Displays update availability with detailed release notes
  3. Background Download: Downloads updates using service worker technology
  4. Seamless Installation: Applies updates with minimal user disruption
  5. Fallback Handling: Graceful degradation if update fails

Technology Stack​

Frontend​

  • React 18: Modern React with hooks and functional components
  • TypeScript: Full type safety and enhanced developer experience
  • Vite: Fast build tool and development server
  • Tailwind CSS: Utility-first CSS framework for rapid styling
  • shadcn/ui: High-quality, accessible UI components
  • React Router: Client-side routing for single-page application
  • React Hook Form: Efficient form handling with validation
  • Zod: TypeScript-first schema validation
  • Service Workers: Background sync and caching for offline support

Backend & Services​

  • Firebase Authentication: Secure user authentication and authorization
  • Firebase Firestore: NoSQL document database for data storage
  • Firebase Storage: File storage for asset images and documents
  • Python Flask Backend: RESTful API for PDF generation and advanced processing
  • PyMuPDF (fitz): Professional PDF generation and manipulation
  • Email Service: Automated email notifications for checkout requests and approvals

Development Tools​

  • ESLint: Code linting for consistent code quality
  • Prettier: Code formatting for consistent style
  • Husky: Git hooks for pre-commit validation
  • TypeScript: Static type checking
  • Vite: Build optimization and hot module replacement

Installation​

Prerequisites​

  • Node.js 18.0 or higher
  • npm or yarn package manager
  • Python 3.8+ (for PDF generation backend)
  • Firebase project with Firestore and Authentication enabled

Setup Instructions​

  1. Clone the repository

    git clone https://github.com/LunarBit-dev/Trackly.git
    cd Trackly

  2. Install frontend dependencies

    npm install

  3. Setup Python backend

    cd backend
    pip install -r requirements.txt
    cd ..

  4. Firebase Configuration

    • Create a Firebase project at Firebase Console
    • Enable Authentication with Email/Password provider
    • Create a Firestore database
    • Enable Storage
    • Copy your Firebase config and create src/lib/firebase.ts

  5. Environment Setup

    # Copy environment template
    cp .env.example .env

    # Add your Firebase configuration to .env
    VITE_FIREBASE_API_KEY=your_api_key
    VITE_FIREBASE_AUTH_DOMAIN=your_auth_domain
    VITE_FIREBASE_PROJECT_ID=your_project_id
    VITE_FIREBASE_STORAGE_BUCKET=your_storage_bucket
    VITE_FIREBASE_MESSAGING_SENDER_ID=your_sender_id
    VITE_FIREBASE_APP_ID=your_app_id

  6. Start the backend server

    cd backend
    python app.py
    # Backend runs on http://localhost:5000
    cd ..

  7. Start development server

    npm run dev
    # Frontend runs on http://localhost:5173

  8. Build for production

    npm run build

Deployment​

Firebase Hosting​

# Install Firebase CLI
npm install -g firebase-tools

# Login to Firebase
firebase login

# Initialize hosting
firebase init hosting

# Build and deploy
npm run build
firebase deploy

Production Deployment with Backend​

# Build frontend
npm run build

# Deploy backend (example with Docker)
cd backend
docker build -t trackly-backend .
docker run -p 5000:5000 trackly-backend

# Deploy frontend to your preferred hosting service
# Upload the dist/ folder to your web server

Use Cases​

IT Departments​

  • Manage hardware inventory across multiple locations
  • Track software license compliance and renewals
  • Monitor equipment checkout and returns
  • Generate reports on asset utilization

Small to Medium Businesses​

  • Create professional quotations for clients
  • Track office equipment and supplies
  • Manage department resources and approvals
  • Maintain comprehensive asset records

Educational Institutions​

  • Track laptops, tablets, and classroom equipment
  • Manage software licenses for educational use
  • Handle equipment loans to students and staff
  • Monitor consumable supplies and reordering

Service Companies​

  • Generate professional client quotations
  • Track service equipment and tools
  • Manage project-based asset allocation
  • Monitor consumable inventory and costs

Security Features​

  • Authentication Required: All features require user authentication
  • Role-Based Access: Admin users have additional privileges including:
    • User management and department administration
    • Checkout request approval/rejection system
    • System statistics and analytics access
    • Quotation and invoice management
  • Secure PDF Generation: Server-side PDF processing with template validation
  • Checkout Approval Workflow: Multi-step approval process for asset checkouts
  • Email Notifications: Secure email notifications for important events
  • Data Validation: Client and server-side validation for all inputs
  • Secure File Upload: Controlled file uploads with type restrictions
  • Session Management: Automatic logout on inactivity
  • Audit Logging: All actions are logged with user attribution and timestamps

Contributing​

We welcome contributions to Trackly! Here's how you can get involved:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/your-feature-name
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin feature/your-feature-name
  5. Submit a pull request

Development Guidelines​

  • Follow TypeScript best practices
  • Write descriptive commit messages
  • Add tests for new features
  • Update documentation as needed
  • Follow the existing code style

Roadmap​

Planned Features​

  • Mobile App: Native iOS and Android applications
  • API Integration: RESTful API for third-party integrations
  • Advanced Reporting: Custom report builder with charts and dashboards
  • Automated Workflows: Enhanced approval workflows for various business processes
  • Integration Hub: Connect with existing ERP and accounting systems
  • Multi-tenant Support: Support for multiple organizations with data isolation
  • Advanced Analytics: AI-powered insights and predictive analytics
  • Barcode Scanning: Enhanced barcode scanning capabilities
  • Maintenance Scheduling: Automated maintenance reminders and scheduling
  • Project Management: Enhanced project tracking and resource allocation

Recent Updates (v2.0.0)​

  • 🆕 Quotation System: Complete business quotation and invoice generation
  • 🆕 PDF Generation Backend: Professional PDF templates with Python Flask
  • 🆕 Checkout Requests: User-initiated checkout requests with admin approval
  • 🆕 Department Management: Full organizational structure management
  • 🆕 Email Notifications: Automated email alerts for business processes
  • 🆕 Multi-Stock Assets: Support for assets with quantities and partial checkouts
  • 🆕 QR Code System: Enhanced QR code generation, printing, and scanning
  • 🆕 Advanced Admin Dashboard: Comprehensive admin interface with real-time statistics

Support​

For support and questions:

  • Create an issue on GitHub
  • Check the documentation
  • Contact the development team

License​

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

Trackly - Streamlining IT asset management for modern organizations.