Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BJ's Wholesale Club

BJ's EquipTrack

Intelligent Equipment & Inventory Management

Docker Next.js TypeScript Status

A streamlined solution for tracking equipment anywhere.

Built to eliminate manual processes and reduce equipment loss.


🌐 Live Demo

Live Demo

Hosted on Google Cloud Run — explore the full application with sample data.


💡 The Problem

Managing shared equipment across a busy warehouse club floor is a daily challenge:

Pain Point Impact
Paper sign-out sheets get lost, damaged, or ignored No reliable record of who has what
No accountability when equipment is damaged or missing Increased replacement costs
Slow manual processes for checking equipment in and out Wasted labor hours every shift
No visibility into equipment status at a glance Supervisors can't make informed decisions

✅ The Solution

EquipTrack replaces manual tracking with a fast, intuitive digital system purpose-built for the warehouse floor.

🎯 Key Capabilities

⚡ Rapid Barcode Scanning

Equipment check-out and check-in in under 5 seconds using Code128 barcode scanning. Designed for speed — no training required.

📋 Multi-Equipment Tracking

Manages RF units, iPads, radios, cameras, banders, grinders and any other club equipment — all from one interface.

🔍 Full Accountability Trail

Every check-out and check-in is logged with who, what, and when. Instantly identify the last user of any piece of equipment.

📥 Bulk Data Import

Onboard hundreds of team members or inventory items in seconds via CSV upload — no manual data entry needed.

📊 Real-Time Dashboard

At-a-glance view of all equipment status — available, checked out, and by whom. Supervisors always know what's in the field.

📤 Export & Reporting

Download complete transaction history as CSV for auditing, compliance, or integration with existing reporting workflows.


📈 Business Impact

Metric Before EquipTrack With EquipTrack
Equipment check-out time 2–5 minutes (paper) < 5 seconds (scan)
Damage accountability Unknown 100% traceable
Shift-start equipment distribution Chaotic, inconsistent Streamlined, auditable
Equipment loss visibility Discovered weeks later Real-time awareness
Data entry for new hires/equipment Manual, one-by-one Bulk CSV import

🏗️ Technical Overview

For IT and operations stakeholders evaluating deployment.

Component Details
Architecture Full-stack monolith — single containerized application
Frontend Next.js 15 (React 19) with responsive, mobile-friendly UI
Database SQLite — embedded, zero-configuration, file-based
ORM Prisma 6 — type-safe data access with migration support
Containerization Docker — fully self-contained, runs on any machine with Docker installed
Port 9002
Data Persistence Docker volume mount ensures data survives container restarts

System Architecture

graph LR
    User([👤 Club Staff]) -->|Browser| App
    
    subgraph Docker["Docker Container"]
        App[Next.js Application] --> Actions[Server Actions]
        Actions --> Prisma[Prisma ORM]
        Prisma --> DB[(SQLite Database)]
    end
    
    Admin([👔 Manager]) -->|Export CSV| App
Loading

🚀 Getting Started

EquipTrack is delivered as a self-contained Docker image — no software installation, no database setup, no configuration needed.

Option 1: Docker Run (Recommended)

docker run -d \
  --name equiptrack \
  -p 9002:9002 \
  -v equiptrack_prisma:/app/prisma \
  -e DATABASE_URL="file:/app/prisma/dev.db" \
  -e NODE_ENV=production \
  -e TZ=America/New_York \
  --restart unless-stopped \
  teamturnersolutions/equiptrack:demov3

Option 2: Docker Compose

git clone https://github.com/teamturnersolutions/bjs-equiptrack-demo.git
cd bjs-equiptrack-demo
docker compose up -d

Then open your browser:

🌐 http://localhost:9002

Tip

The application comes pre-loaded with sample data so you can explore all features immediately.


🗺️ Roadmap

Planned enhancements to further streamline club operations:

Feature Description Status
NFC Integration Tap-and-go check-ins using NFC tags on equipment 🔜 Planned
AI Agent Intelligent assistant for proactive equipment issue resolution 🔜 Planned
Mobile App Dedicated Android application for handheld devices 📋 Backlog
Multi-Location Support for tracking across multiple club locations 📋 Backlog

Built by Team Turner Solutions

For support, feature requests, or deployment assistance — contact the development team.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages