Laborie Co-operative Credit Union - Service Queue System

A multi-branch service queue management system for Laborie Co-operative Credit Union. Established in 1976, Laborie Credit Union is a member-owned financial co-operative serving the communities of Laborie, Vieux Fort, and Castries, Saint Lucia.

"We Are Not A Bank, We Are Better!"

This system manages customer/member queues with real-time updates across all three branches, with comprehensive analytics and role-based access.

View your app in AI Studio: https://ai.studio/apps/drive/1Wcg4cKe3DGIRE8QT2opa_SuM786KO252

Setup

Prerequisites

• Node.js 18+ installed
• Git installed
• GitHub account
• Supabase account (sign up at https://supabase.com)

Local Development

1. Install dependencies:

   npm install

2. Set up environment variables:

   cp env.example.txt .env

   Edit .env and add your credentials:

   • VITE_SUPABASE_URL: Your Supabase project URL (from Dashboard > Settings > API)
   • VITE_SUPABASE_ANON_KEY: Your Supabase anonymous key (from Dashboard > Settings > API)
   • GEMINI_API_KEY: Your Gemini API key

3. Set up Supabase database:

   • Create a new project at https://app.supabase.com
   • Run the SQL schema from supabase-schema.sql in the SQL Editor
   • Configure Row Level Security (RLS) policies as needed

4. Run the app:

   npm run dev

Deployment

This app automatically deploys to GitHub Pages on push to main branch.

GitHub Setup

1. Create a GitHub repository (if not already created)

2. Add GitHub Secrets (Settings → Secrets and variables → Actions):

   • VITE_SUPABASE_URL: Your Supabase project URL
   • VITE_SUPABASE_ANON_KEY: Your Supabase anonymous key
   • GEMINI_API_KEY: Your Gemini API key (if needed for build)

3. Enable GitHub Pages:

   • Go to Settings → Pages
   • Source: GitHub Actions
   • Save

4. Push to main branch:

   git add .
   git commit -m "Initial commit"
   git push origin main

The app will be automatically deployed and available at: https://YOUR_USERNAME.github.io/YOUR_REPO_NAME/

Features

• Multi-Branch Support: Manage queues across multiple branch locations
• Customer/Member Queue Management: QR join → name + service category → ticket number → live position + ETA
• Real-Time Updates: SMS or WhatsApp notifications with threshold reminders
• Teller Interface: Call next, start/finish transaction, pause queue, flag no-show
• Reception Dashboard: Handle exceptions, add audit notes, manage arrivals
• Manager Analytics: Exportable metrics (wait time, no-shows, peak hours, service breakdown)
• Role-Based Access: Customer, Reception, Teller, and Manager views
• Configurable Grace Periods: Customizable arrival countdown per branch
• Service-Time Learning: Automatic ETA calculation based on historical data
• Supabase Integration: Cloud database with localStorage fallback