TBG Network LLC / CTO handoffOwner approved

Barber Admin Dashboard
Chop It Up Barbershops

A mobile-first redesign of the legacy administration panel, refined with real-time feedback from owner Mervis. This document separates implemented UX from simulated data and outlines the work to connect it to Barbergame.

Approved: November 7, 2026Checkpoint: v0.3Frontend: standalone HTML/CSS/JSEnvironment: GitHub Pages demo
Open working demoDownload feature specification (.md)

Working in the demo

  • One scrolling page; four-item fixed mobile navigation; slide-up editors.
  • Eight sample bookings, clickable KPI, future appointments through year-end, client-contact details and required-reason cancellation.
  • Past appointment history, status filters and detail views.
  • Searchable clients, contact preview and an on-demand Blocked Clients sheet with View Details and Unblock; no permanent blocked-client card on the page.
  • Weekly hours and new appointments with 15-minute arrow controls; individual tappable 30-minute availability blocks with color states; preset services dropdown with custom descriptions and larger arrow steppers.
  • Barber profile editor with identity/contact details (location read-only), social links, bio and experience, plus separate browser-local portrait editing; responsive UI. Shop Information has been removed entirely from the barber dashboard; it belongs to owner/admin workflows.
  • Barber Messages at the bottom: Received/Sent history and simulated compose to all barbers, shops, or individual barbers. Required read-and-confirm screen appears after fresh demo login when announcements are pending, and on dashboard entry (after v0.3 checkpoint).

Not connected to production

  • No live booking, customer, shop, service or availability API/database.
  • No live appointment creation, cancellation, availability block enforcement or server persistence.
  • Barber photo, blocked-client flags, inbox and time blocks are browser-local; other edits reset on refresh.
  • Earnings and dashboard totals are illustrative, not ledger-derived. The 7-day free booth-rent voucher is a non-redeemable demo concept. The printable income statement is conspicuously SAMPLE / not valid proof of income.
  • No production authentication/authorization, notifications, audit logging or payment processing.
  • No messaging API, real recipient directory or delivery; the required acknowledgment gate is browser-local, not server-enforced post-login, and produces no real per-user read receipt.

Implementation map

AreaCurrent prototypeProduction requirement
AppointmentsSample booking rows, histories and mobile touch-service choices plus a date/availability grid and Already Scheduled list (open, booked, blocked, selected) with full-duration validationAuthoritative slot inventory, duration-aware appointment API, race-condition/hold protection, cancellation audit, notifications, time zones
MessagesRequired acknowledgment gate on dashboard entry; fictional Received/Sent and multi-recipient compose, browser-localServer-enforced post-login acknowledgment, message receipt records, inbox/delivery API, barber identity and permissions
Future bookingsSample year-end list grouped by date; View All sheetDate-range booking API, paging, authorization and real calendar data
ClientsFictional name, email, phone + historyCustomer lookup, access control, accurate identity data
Client blockingLocal-only search, confirmation, undoEnforced block scope, owner oversight, audit trail
SchedulingEditable weekly hours plus touch-selectable 30-minute date slots; booked slots disabled, blocked slots green, browser-local toggleAuthoritative live slot inventory, atomic block/unblock API, concurrent booking/hold protection, booking-search propagation
Services & photosPreset services / descriptions and local barber portrait preview; no Shop Information sectionService CRUD, validated profile/contact API, account permission rules, secure barber photo upload; shop details and images owner/admin only
Financials + voucherSample totals, printable non-valid contractor statement and a non-redeemable 7-day free booth-rent voucher cardReconciled ledger, authorized PDF issuance, voucher eligibility, issuance and redemption accounting
Identity & securityClient-side demo session gateServer-enforced authentication and role-based permission checks
Important: This is a public-repository, sample-data prototype. The demo login relies on browser-side checks and is not a security boundary. Do not publish real customer contact information, secrets, payment records or production credentials in these pages.

Recommended development sequence

01 / Contracts + security

Confirm existing Barbergame APIs, canonical records and roles; establish production authentication and permissions.

02 / Operational workflows

Connect appointments, client lookup, services, availability and time off. Derive KPIs from the same data.

03 / Persistence + QA

Add secure photos, financial summaries, edge cases, error states and real-device/accessibility tests.

Open decisions: block rules and scope, owner oversight, minimum required client details, shop vs barber permissions. These were intentionally deferred. · Approved source checkpoint · Back to Barbergame demos