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.
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
| Area | Current prototype | Production requirement |
|---|---|---|
| Appointments | Sample booking rows, histories and mobile touch-service choices plus a date/availability grid and Already Scheduled list (open, booked, blocked, selected) with full-duration validation | Authoritative slot inventory, duration-aware appointment API, race-condition/hold protection, cancellation audit, notifications, time zones |
| Messages | Required acknowledgment gate on dashboard entry; fictional Received/Sent and multi-recipient compose, browser-local | Server-enforced post-login acknowledgment, message receipt records, inbox/delivery API, barber identity and permissions |
| Future bookings | Sample year-end list grouped by date; View All sheet | Date-range booking API, paging, authorization and real calendar data |
| Clients | Fictional name, email, phone + history | Customer lookup, access control, accurate identity data |
| Client blocking | Local-only search, confirmation, undo | Enforced block scope, owner oversight, audit trail |
| Scheduling | Editable weekly hours plus touch-selectable 30-minute date slots; booked slots disabled, blocked slots green, browser-local toggle | Authoritative live slot inventory, atomic block/unblock API, concurrent booking/hold protection, booking-search propagation |
| Services & photos | Preset services / descriptions and local barber portrait preview; no Shop Information section | Service CRUD, validated profile/contact API, account permission rules, secure barber photo upload; shop details and images owner/admin only |
| Financials + voucher | Sample totals, printable non-valid contractor statement and a non-redeemable 7-day free booth-rent voucher card | Reconciled ledger, authorized PDF issuance, voucher eligibility, issuance and redemption accounting |
| Identity & security | Client-side demo session gate | Server-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