Mom&Pop Navigator

A web-based dashboard for managing product locations in a store. This system captures barcode IDs (SKUid) and their XYZ coordinates with centimeter accuracy, and displays this data in a user-friendly dashboard.

Features

• Product Management: View, add, edit, and delete products with their coordinates
• User Management: Manager and Associate roles with different access levels
• Barcode Lookup: Auto-populate product information from barcode IDs
• CSV/Excel Import: Bulk import products from spreadsheets
• Change Tracking: Log all changes to products (who, what, when)
• Responsive Design: Works on desktop and mobile devices

Tech Stack

• Frontend: Next.js (React), Tailwind CSS
• Backend: Node.js, Express
• Database: JSON file-based storage
• Authentication: JWT (JSON Web Tokens)

Getting Started

Prerequisites

• Node.js (v14 or higher)
• npm (v6 or higher)

Installation

1. Clone the repository

git clone https://github.com/yourusername/mom-pop-navigator.git
cd mom-pop-navigator

2. Install backend dependencies

cd backend
npm install

3. Install frontend dependencies

cd ../frontend
npm install

Configuration

1. Create a .env file in the backend directory with the following variables:

PORT=5000
JWT_SECRET=your_secret_key
JWT_EXPIRES_IN=30d
NODE_ENV=development
BARCODE_API_KEY=your_barcode_api_key

Running the Application

1. Generate mock data (optional)

cd backend
npm run generate-mock-data

2. Start the backend server

npm run dev

3. In a new terminal, start the frontend development server

cd frontend
npm run dev

4. Open your browser and navigate to http://localhost:3000

Default Users

• Manager

  • Username: manager
  • Password: manager123

• Associate

  • Username: associate
  • Password: associate123

API Endpoints

Authentication

• POST /api/auth/register - Register a new user
• POST /api/auth/login - Login user
• GET /api/auth/profile - Get current user profile

Products

• GET /api/products - Get all products
• GET /api/products/:id - Get product by ID
• POST /api/products - Create a new product
• PUT /api/products/:id - Update a product
• DELETE /api/products/:id - Delete a product
• POST /api/products/import - Import products from CSV/Excel
• GET /api/products/barcode/:barcodeId - Lookup product info by barcode

Users

• GET /api/users - Get all users
• GET /api/users/:id - Get user by ID
• POST /api/users - Create a new user
• PUT /api/users/:id - Update a user
• DELETE /api/users/:id - Delete a user
• PUT /api/users/:id/assign-products - Assign products to user

License

This project is licensed under the ISC License.