code::core operations manual

Supermarket Management System User Manual

This guide explains how to run daily till operations, monitor owner metrics, and keep your Kampala branches synchronized. It is written for inherited teams that need immediate clarity and stable daily execution.

Version Local Manual v1.0
Audience Till Operators, Supervisors, Managers, Owners
Environment Local Demo + PostgreSQL Production Mode
Support Basis code::core Brand and UI Standards

1. System Overview

Foundation

This system runs day-to-day supermarket work for Kampala branches. Staff use it to sell items, track branch performance, and review daily totals.

Main Areas

  • Till Station for customer checkout
  • Owner Dashboard for branch performance
  • User Manual for standard operating procedures

Branch Coverage

  • Kisasi Branch
  • Naalya Branch
  • Bugolobi Branch

What Is Recorded

  • Every sale and payment method
  • Tax totals and final amount
  • Branch and register activity
Use this manual as the single operating standard for tills, supervisors, and owners.

2. Role Responsibilities

Access Control

Till Operator

  • Serve customers and complete sales accurately
  • Confirm amount paid and change before finishing
  • Escalate item or pricing issues to supervisor

Supervisor

  • Oversee till discipline and cashier support
  • Monitor unusual payment or total patterns
  • Handle escalation during peak hours

Manager

  • Ensure branch readiness before opening
  • Review day-end figures with supervisors
  • Coordinate inventory response on fast movers

Owner

  • Track daily sales and transaction counts
  • Compare branch contribution and trends
  • Use top-product insights for purchasing direction

3. Opening Shift Checklist

Operations
  1. Confirm you are on the correct branch and register.
  2. Verify float/opening cash with supervisor.
  3. Run a quick test item search to confirm till responsiveness.
  4. Keep payment devices and receipt process ready before customer rush.
Do not start serving customers until branch and register are correctly selected.

4. Till Station Workflow

Core Flow
  1. Search item by name, SKU, or barcode.
  2. Add all customer items to the cart.
  3. Confirm quantities with customer before payment.
  4. Review subtotal, tax, and final total out loud.
  5. Select payment method and enter amount paid.
  6. Complete sale and confirm change amount with customer.

Accepted Payment Methods

Cash, Card, Mobile Money, Check

Tax Handling

Tax is calculated automatically and included in final total.

After Sale

Visually confirm successful transaction before serving next customer.

5. Owner Dashboard Usage

Analytics

Use this dashboard for daily leadership review, branch follow-up, and performance direction.

  • Start with "All Branches" to see the full daily picture.
  • Switch branch filter to identify weak or strong locations.
  • Review hourly revenue to understand peak periods.
  • Check top products and trigger replenishment decisions early.
  • Use recent transactions to spot anomalies quickly.

6. Troubleshooting Playbook

Recovery
If any till action fails during customer service, pause and call a supervisor immediately.
  • If item is not found, retry with SKU or barcode.
  • If totals look wrong, clear cart and re-scan items carefully.
  • If payment cannot complete, switch to approved alternate payment method.
  • If dashboard appears empty, confirm branch filter is set correctly.
  • If issue persists, escalate to manager and record incident details.

7. FAQ

Reference

Q: Which page should cashiers use?
A: Cashiers should work from Till Station.

Q: Which page should owners and managers review daily?
A: Owner Dashboard.

Q: What should happen before first customer at opening?
A: Confirm branch/register and opening cash with supervisor.

Q: What if a sale fails while customer is waiting?
A: Escalate to supervisor immediately and continue using approved fallback process.