HandyCafe Docs
owner

Pricing Schedule Settings

The Pricing Schedule lets you apply different pricing multipliers to different hours of the week. Use it to charge premium rates during peak hours and offer discounts during off-peak times.

Enable / Disable

A master toggle at the top of the page enables or disables the entire pricing schedule. When disabled, all sessions use the flat hourly rate defined in Pricing Settings regardless of time of day. When enabled, the active color slot's multiplier is applied to any session time that falls within its painted hours.

What the Schedule Covers

The schedule applies to guest PC sessions only. Member sessions bill from the member's own rate and console sessions bill from the console rate. Neither reads the schedule, which means a peak-hour multiplier does not reach them.

The Weekly Time Grid

The schedule is displayed as a color-coded grid:

  • Columns -- The 7 days of the week, always starting on Monday. This grid does not follow the week-start preference in General Settings.
  • Rows -- 24 hours of each day (00:00 through 23:00).
  • Cells -- Each cell represents one hour of the week (168 total cells).

Painting Time Blocks

  1. Select a color slot from the slot list (see below).
  2. Click or click-and-drag on the grid to paint cells with that color.
  3. Painted cells adopt the multiplier of the selected color slot.
  4. To clear a cell, paint over it with a different color or deselect all colors and click the cell.

The grid provides a visual overview of your entire weekly pricing structure at a glance.

Color Slots

There are 8 color slots available, each represented by a distinct color:

Slot Color Default Use
1 Blue Standard rate
2 Orange Moderate premium
3 Red Peak / high demand
4 Green Discount / off-peak
5 Teal Special promotion
6 Gray Minimal rate
7 Cyan Custom
8 Emerald Custom

Slot Configuration

Each color slot has the following settings:

  • Enabled toggle -- Turn the slot on or off. A disabled slot can still be painted onto the grid. The pricing engine skips it, which means the hours it covers fall back to the base rate. Those hours are drawn faded with a diagonal hatch so the grid does not imply a multiplier that is not being applied.
  • Name -- A descriptive label (e.g., "Peak Hours", "Night Owl Discount", "Weekend Special"). The name appears in this list only. It is not shown on session cards or in reports.
  • Multiplier -- A decimal multiplier applied to the base hourly rate. Examples:
    • 1.0 -- Standard rate (no change).
    • 0.5 -- Half price.
    • 0.7 -- 30% discount.
    • 1.5 -- 50% premium.
    • 2.0 -- Double rate.
  • Net price -- The hourly rate this slot produces (the base PC hourly rate multiplied by the slot multiplier). The field works both ways: typing a net price back-derives the multiplier. It is always calculated against the global base rate, not against a pricing group.
  • Schedule data -- An internal representation indicating which of the 168 weekly hours are assigned to this slot. This value is managed automatically as you paint the grid. You do not need to edit it manually.

A Show Labels toggle above the slot list controls whether slot names are displayed alongside the colors.

Color Selector

A color selector component is provided for choosing the currently active paint color. Click a color in the selector to make it the active brush, then paint cells in the grid.

Example Workflow

  1. Enable the pricing schedule with the master toggle.
  2. Click color slot 3 (Red) and configure it:
    • Name: "Peak Hours"
    • Multiplier: 1.5
  3. Paint the evening hours (18:00 through 23:00) for every day of the week with the red color.
  4. Click color slot 4 (Green) and configure it:
    • Name: "Off-Peak"
    • Multiplier: 0.7
  5. Paint the morning hours (06:00 through 12:00) on weekdays with the green color.
  6. Save the settings.

Now, a session running from 19:00 to 21:00 would be charged at 1.5 times the base rate, while a session from 08:00 to 10:00 on a weekday would be charged at 0.7 times the base rate.

How Schedule Changes Affect Active Sessions

When a session spans multiple pricing schedule slots, HandyCafe creates new pricing segments at each slot boundary. For example, if a session starts at 17:00 (standard rate) and continues into 18:00 (peak rate), the session's billing is split into two segments:

  • Segment 1: 17:00 to 18:00 at the standard multiplier.
  • Segment 2: 18:00 onward at the peak multiplier.

This ensures accurate billing without interrupting the customer's session.