Salonfrontdesk is a salon front desk tool for salon front desk staff. It gives the front desk one clear workspace for the day: a place to open, sign in to, and continue front desk work under time pressure. The product intent is calm control with a friendly tone — fast reading, tidy structure, and a warm, legible interface rather than a dense enterprise console.
The audience is the salon front desk staff role (the user names this role "Salonfrontdesk"). Staff self-enroll before first use, verify their identity to return, and then work from a single Front Desk workspace.
This document is the System Requirements Document requested by David for the Salonfrontdesk project.
Salonfrontdesk is delivered as a first-party web application with application-owned identity. It consists of a React frontend, a shared FastAPI backend process serving application APIs and domain modules, and a MariaDB database for application-owned persistent data. Durable state is required: enrollment identity and the returning staff member's session continuity must persist.
Current actors:
Current delivery surfaces (closed page contract):
Narrow exclusions: no booking engine, no client-facing portal, no payments, no inventory, no staff scheduling, no reporting suite, and no differentiated permission roles are established by the source. The Front Desk workspace is the staff member's own working context; the source does not establish shared multi-user state or role-based visibility.
Removed from scope
Salonfrontdesk is a first-party application. The public Landing page explains the salon front desk tool and its user role and offers the entry action. Because the Front Desk workspace must remain bound to the correct staff member across visits, identity is application-owned: staff establish identity once through self-service enrollment, and returning staff verify identity on the Login page before the Front Desk workspace becomes available. The Login page is anonymously reachable; the Front Desk page is not.
All current behavior is delivered now. No future-horizon capabilities are accepted in this document. Provider-owned and external destinations are not used for any accepted behavior; the backend and database support the first-party pages but do not own any human interaction.
FR-1 — Public entry explains the product and role As a salon front desk staff member, I should see a public Landing page that explains the salon front desk tool and its user role, so that I understand what the product does before signing in.
FR-2 — Self-service enrollment before first use As a salon front desk staff member, I should complete self-service enrollment before first use, so that my identity is established and I can reach the Front Desk workspace.
FR-3 — Returning identity verification As a salon front desk staff member, I should verify my identity to return to the front desk workspace, so that I can resume my front desk work.
FR-4 — Protected Front Desk workspace As a salon front desk staff member, I should open the Front Desk workspace and continue my front desk work, so that I have one clear place for the day.
FR-5 — Day list selection As a salon front desk staff member, I should select an entry in the day list, so that the client card shows the entry I am working on.
FR-6 — Action bar for the active client card As a salon front desk staff member, I should use the action bar for the active client card, so that I can act on the entry I am working on.
Creative direction: Charming clarity from Susan Kare — clear small symbols, tidy grids, calm control with a friendly tone.
Palette (light mode):
| Role | Hex |
|---|---|
| Background | #F4F1EA |
| Surface | #FFFFFF |
| Text | #1E1E1E |
| Primary | #D9552B |
| Accent | #2F7D6E |
| Muted | #8A8578 |
Warm paper ground #F4F1EA with white tiles. Ink text #1E1E1E and one hot terracotta #D9552B for actions. Teal #2F7D6E marks status only.
Typography:
clamp(40px, 9vw, 112px).Shape language: Square tiles with 2px ink borders and 6px radii. Chunky outline cards and pixel icon blocks. No soft blobs.
Layout: A 12-column grid of tidy tiles. The hero uses a wide pixel-wordmark block on the left and a stack of icon tiles on the right. The Front Desk page uses a three-panel workspace: day list, client card, action bar.
Imagery: Pixel icons and simple pictograms for scissors, chair, clock, and calendar. No photography. The interface itself is the image.
Avoid: Gradient blobs or glass panels; soft rounded pill buttons with drop shadows; stock photography of people; blue or indigo accents on white.
Readability constraint: Headlines, wordmarks, labels, numbers, cards' text and controls stay entirely inside the viewport and their container at 375px, 768px, and 1280px, wrapping or scaling (for example font-size: clamp(...) with its mobile size) to fit, with no other element covering any part of them. Imagery, decoration, and motion may be cropped, bled, rotated, overlapped, or cut as the direction asks, as long as they cover no readable text or control. With prefers-reduced-motion, provide a usable static arrangement.
The public entry is a bold hero on warm paper #F4F1EA. A huge VT323 wordmark "Salonfrontdesk" spans the left 8 columns at up to 112px, with the terracotta "Open the desk" CTA sitting beneath it. A 3x2 grid of chunky pixel icon tiles sits at the right, each with a 2px ink border, showing scissors, chair, clock, and calendar pictograms. The interface itself is the image: no photography, no gradient blobs, no glass panels. The wordmark and CTA stay whole at every viewport; the icon grid may reflow below the wordmark on narrow screens.
Interaction Model: Animated Motion Tempo: restrained Hero Dimensionality: flat
Landing Hero Motion Brief
On the Front Desk page, a blinking cursor block marks the active field, and status chips in terracotta and teal carry a pixel corner notch. Icons blink once on state change.
prefers-reduced-motion, provide a usable static arrangement. Provenance: explicit (creative direction).frontend, backend, and database services. The backend is reused for all feature APIs; no additional services are required for the accepted workflows.
For salon front desk staff
The salon front desk, made simple
Salonfrontdesk gives your front desk staff one clear workspace for the day.
Purpose
One clear workspace for the day.
Salonfrontdesk gives your front desk staff one clear workspace for the day, so the day’s work reads at a glance under time pressure.

For salon front desk staff
The salon front desk, made simple
Salonfrontdesk gives your front desk staff one clear workspace for the day.
Purpose
One clear workspace for the day.
Salonfrontdesk gives your front desk staff one clear workspace for the day, so the day’s work reads at a glance under time pressure.
No comments yet. Be the first!