Build Progress
The roadmap from v0.01 to v1.0, and what's actually built today. Last updated 20 Nov 2026.
Overall Progress — v0.01 to v1.0
Currently on v0.06
63%
Recent Updates
Fixed: changes in New Outlets wouldn't save
20 Nov 2026Once the New Outlets data grew past a few KB, the storage started sending its version tag in a different format, and every save was wrongly treated as a clash with someone else ('Couldn't save just now'). Saves work again for change plan, checklist, quotations, team, approvals and photos · The same problem had stopped the month's sales record (used by Budget & Goals) from updating since this morning; it catches up on its own when the Budget page is next opened
Login page: removed a wrong password hint
20 Nov 2026The sign-in page said every account's password was 'demo1234', but the live site has used a private password for the last two months — so anyone following the hint was told 'Invalid email or password'. The hint now says to ask the admin for the password; the password itself is unchanged
New Outlets: photos, quotations, project team and Boss approval
20 Nov 2026Photos: 'Take photo' opens the phone camera straight away (or pick from the gallery). Use it on a shop survey (shop front, inside, street, parking), on an opening project (renovation progress) and on quotations. Photos are shrunk on the phone before sending, and can only be opened by people signed in to the OS · Quotations: key in who quoted, what it's for, the amount and how long it's valid, then take a photo of it or attach the PDF. Quotes for the same thing sit side by side with the lowest marked, against the budget for that line. 'Choose this one' sends it to the Boss (or is approved straight away when the Boss chooses) · Team: add the Boss, the project manager, team members, designer, contractor, suppliers and the landlord — with one-tap call and WhatsApp · Boss approval: ask the Boss to approve the setup budget, a quotation, or anything else (signing the lease, the renovation design, hiring the manager…). The Boss approves or says no with a comment; everything is recorded with who and when. The budget shows '✓ Approved', or a warning if it changed after approval. Everything waiting is listed at the top of New Outlets · Opening playbook: HQ can set Hairstory's own budget split and checklist steps for each stage — every new project starts from it · Approving uses the existing approval rights (Group Owner, Director, HQ Admin)
New Outlets: survey shops and track each new outlet to opening day
20 Nov 2026New 'New Outlets' page in the menu, for growing the group · Shop survey: fill it in while standing at the shop — name, address, rent, size, deposit, landlord's contact, and tap 1–5 stars for foot traffic, visibility, parking, access, neighbours, competition and rent value. The pin can come from a Google Maps / Waze link, the address, or a tap on the map · Each shop gets worked out for you: an overall score, rent per sq ft, the deposit to pay, and how far it is from the nearest Hairstory outlet — with a warning when it's under 2 km and might just take customers from that outlet · All surveyed shops sit on one map next to our existing outlets, coloured by status (surveyed, shortlisted, talking to landlord, signed, not suitable), and in a list ranked by score · 'Open an outlet here' starts an opening project: a 7-stage checklist — find the shop, sign the lease, design & permits, renovation, equipment & stock, team, open — with Malaysian steps like the council business licence and signboard permit. Teams can add their own steps · Each project has a setup budget (type the total and it splits it: renovation ~35%, equipment ~18%, deposit ~10%…, all editable), a spending log, a countdown to opening day, and a payback estimate from expected monthly sales and costs · Uses the existing Stores permission: who can see Stores can see this, who can edit Stores can change it
Budget & Goals: plan each outlet's month and track it with smiley faces
20 Nov 2026New 'Budget & Goals' page in the menu. The group view shows sales against goal, spending against budget, and a row per outlet with a face: 🙂 on track, 😐 watch this, 🙁 needs help — the outlets that need help are listed first · Each outlet gets a two-step plan: 1) how much to sell this month, 2) how much it can spend on each thing — Team (salaries, commission, EPF/SOCSO/EIS, training, hiring), Stock & sourcing, Shop (rent, utilities, repairs), Marketing and Running costs. One button fills in a typical salon split from the sales goal; 'Copy last month' reuses the previous plan · 'Add spending' takes two taps and a number: pick what it was for, type the amount (read back in full so a slip is easy to spot), save. Wrong entries can be deleted · Money in comes straight from the POS — real sales for the calendar month, with a line on the bar showing where the outlet should be by today · Goals: short checklists for things like hiring a stylist, finding a better colour supplier or cutting the electricity bill — seven ready-made ones to start from. Tick steps as they're done; everyone sees who ticked what · Uses the existing Finance permission: people who can see Finance can see budgets, people who can edit Finance can change them
Saving switched on: store details and budgets are now kept on the live site
20 Nov 2026What the team enters in the OS is now saved in private storage on Vercel — it can't be opened by link, only by the app itself · If two people save at the same moment, neither change is lost: the second save re-reads the latest version and applies on top
Store details form: the team can enter each store's address, contacts, hours and map pin
20 Nov 2026Every store page has an 'Edit details' button (stores with no location yet show 'Add details'). The form takes the branch name, full address, phone, WhatsApp, email, opening hours for each day, and directions & notes · Placing the map pin: paste a Google Maps or Waze share link, look the address up on the map, or just click the map and drag the pin onto the shop · Once saved, the team's version replaces the hairstory.com.my listing everywhere — the store page, the header under the store name, and the pin on the Stores map — with 'Updated by … · date' shown · Stores not on the map yet are listed under the map with an 'Add' button straight into the form · Who can edit follows the existing Stores 'edit' permission
Store map: every branch marked on a map
20 Nov 2026Stores now opens with a map of the branches, split into Penang and Klang Valley. Each pin shows the branch's address, phone, today's sales, and links to open the store or get directions in Google Maps / Waze · The branch list beside the map highlights its pin when you hover, and flies the map to it when you click · Each store's own page has a Location card with its map and Google Maps / Waze buttons, and its address and phone now show under the store name · Locations, addresses and phone numbers come from the branch list on hairstory.com.my (the POS has no address field). 19 of the 24 POS outlets are matched; Capital, AIB, Maritime, QB15 and SP aren't on the website under a clear name yet, so they're listed under the map as 'not on the map yet' rather than given a guessed pin · Prominence and Queensbay pins mark the right neighbourhood rather than the exact shop (the website gives no map point for them); All Seasons Place uses the building's location because the website's own link for it is broken
Your own menu: keep what you use on show, hide the rest
20 Nov 2026New 'Customize menu' at the bottom of the side menu (and in the phone menu): choose which pages stay on show and put them in your own order — drag them, or use the up/down arrows · Pages you hide fold away under a 'More' section at the bottom of the menu, so they're never lost — one click opens it, and it opens by itself when you're on one of those pages · Each person's menu is their own and is remembered on that device; 'Reset to standard' brings back the normal menu. It only changes how the menu looks — what each person is allowed to open is unchanged
Home is now a one-glance summary with charts
20 Nov 2026Home shows just four headline numbers for today (revenue, sales, customers, average bill), a 7-day revenue chart and a ranking of the top outlets — the full outlet list, staff, customers and finance detail stay on their own pages, linked from here instead of repeated · Before outlets open (or on a quiet day) the outlet ranking shows the last 7 days, so the panel is never empty in the morning · Outlets show by their branch name (Solaria, Aroma, QB15…) instead of the long company name; hover for the full name · The 7-day chart and the outlet ranking use the same seven calendar days, so an outlet's figure on Home matches its own page · 'Not connected' cards (appointments, rebooking, satisfaction, targets) and the always-empty activity feed were removed from Home; a single 'Needs attention' strip lists only what someone should act on
Smoother, tidier look across the whole OS
20 Nov 2026Stat cards line up: every value now sits at the same height, and 'Not connected' / 'Not set' show as a quiet tag instead of big text that outshouted the real numbers · Numbers count up when a page opens and glide to the new figure when live sales refresh; progress bars fill in from the left · While live POS data loads you now see the page's shape shimmering instead of a blank screen with a spinner, and each page eases in · Softer rounded cards with a gentle shadow, buttons that press in, a highlighted menu item with a bronze marker, a frosted top bar, a green 'live' dot next to the data time, and row highlight on tables · Phones and tablets: buttons and fields are at least thumb-sized, and typing in a box no longer zooms the page on iPhone. Anyone who has 'reduce motion' turned on gets everything still
POS refusing access (payment overdue): the OS now says so, and stops loading slowly
1 Nov 2026On 1 Nov the POS began answering every request with 'Exceed Payment Date' (HTTP 402) — the client's Aoikumo subscription lapsed (the POS itself had warned 'licence expiring, 3 days left' on 29 Oct). With nothing coming back, the OS showed 'Not connected' with no explanation, and took a long time because it asked the POS for all 24 outlets one after another and got 24 identical refusals · Now, when the POS refuses for account reasons (402, or a rejected key), the OS remembers it for a minute and fails the rest instantly, so pages open quickly · Every page shows a red notice at the top explaining what happened and that sales and staff return by themselves once the POS account is renewed. It disappears on its own when the POS is healthy again
Stores: real sales now show on the store list and every store page (was 'Not connected')
29 Oct 2026Stores list: the revenue column is now 'Revenue (Today)' with a 'Sales Today' count per outlet, pulled live from the POS and sortable. If the POS can't be reached it says 'Not connected' instead of showing a number · Store page: Revenue Today, Revenue (7 days), Customers Today and Average Sale are live from the POS, with an 'as of' time and auto-refresh. 'Revenue vs Target' shows the live 7-day figure and notes that no monthly target is set yet · Still 'Not connected', because the POS API doesn't provide them: appointments, customer ratings and the customer base count · Checked against the POS Sales Summary report for all outlets, today: RM 51,095.04 Gross vs RM 51,095.00 in the OS — the RM 0.04 gap is the POS's 5-sen rounding
Fixed: the OS could show old POS numbers while labelling them 'as of now' (why it looked out of sync)
29 Oct 2026Found why the client saw the OS and the POS disagree side by side: after any quiet spell, the app's cache handed back the last numbers it had stored first, and only refreshed them in the background. In a local test that cached data was 21 days old, and the page still said 'as of' the current time — so it looked live but wasn't · Now every POS response is checked against the gateway's own timestamp. If cached data is older than the cache window (1 minute during opening hours), it's thrown away and fetched fresh before the page is shown. After the fix, a local test showed Revenue Today RM 18,467 — exactly what the live POS API reported at the same minute · The 'as of' time now means when the data was actually pulled from the POS (not when the page was built), the age keeps counting on screen (amber if over 3 minutes), the page re-checks by itself every 30 seconds while open, and there's a Refresh button to force an immediate check · During opening hours, POS data is now re-checked every minute (was every 2 minutes)
Switching to a different shop is now fast (1-3 seconds instead of 12-25)
20 Oct 2026Picking a single shop on Home, Command Centre or Finance used to load that shop's entire sales history from the POS (up to 30 slow, deliberately paced calls) even though those pages only needed recent numbers — so a shop nobody had opened recently took 12-25 seconds · Home and Command Centre for one shop now load just its last 7 days (labelled 'Revenue (7 days)'), and Finance for one shop opens on 7 Days by default. 'Revenue Today' is unchanged. You can still pick 'All' on Finance for the long history, which remains slow the first time · Still slower by nature: the very first load of the all-shops view after a deploy (about 10 seconds), because the POS only allows a few calls per second. Repeat views are fast
Finance now shows sales day by day — pick 7 Days or 30 Days
19 Oct 2026Under 7 Days and 30 Days, Finance (the whole group, or any single outlet) now lists each day separately: number of sales and amount collected, with a bar so the best and slowest days stand out. It answers 'how did Saturday compare to Tuesday' without adding anything up by hand · Days are Malaysia calendar days. The daily figures for the group match the totals checked against the POS's own report (e.g. 6 Oct: 220 sales, RM 37.5k; 3 Oct: 375 sales, RM 90.4k). Today is still in progress, and the oldest day can be partial because the range counts back from the current moment
Checked against the client's POS reports: yesterday and last week match
18 Oct 2026Ran the POS's own Sales Summary report (read-only) and compared it with the app: yesterday (6 Oct, all outlets) is RM 37,503.50 / 220 sales in both, to the cent. Last week (27 Sep – 3 Oct) is RM 449,683.34 'Gross' in the POS, and the sales sub-totals pulled for the app add up to exactly the same RM 449,683.34 (1,900 sales, 5 cancelled ones excluded on both sides) · The app's 'Collected' figure is what was actually paid after the POS rounds each bill to the nearest 5 sen, so it can sit a few ringgit below the POS 'Gross' over a long range (RM 3.09 on RM 450k last week). Finance now says so on the page
Fixed: busy outlets' sales were being counted many times over — checked against the client's own POS screen
17 Oct 2026Compared the app to the client's real POS screen (read-only): today's total matched exactly (RM 2,970.00 across all outlets), a single outlet's total matched (Waterfall RM 325.00), and individual sales matched. Yesterday's sale count also matched (220 on both) · That comparison exposed a real bug in how we paged through the POS sales list: the POS treats the page number as a row offset, so asking for page 2 returns almost the same 100 sales as page 1. Our app walked pages 1, 2, 3... and counted the same sales up to 30 times. Anywhere a busy outlet's full history was shown (single-outlet Finance 'All', Command Centre outlet view), the figures were inflated — they showed 3,000 sales when the real number loaded was a fraction of that. Paging now steps through the list correctly (rows 1-100, 101-200, ...), so every sale is counted once · Today / Yesterday / group-wide numbers were not affected (they only read the first page). Outlet 12 now shows 125 sales for the last 7 days, and 2,990 real sales in its latest 3,000 · Group-wide views now load each outlet back to the start of the range you picked (at least today) instead of a flat 100 sales, so a busy day can't be cut short · All dates and times in the app now display in Malaysia time (the 'as of' time was showing server time, 8 hours behind)
POS calls are now paced to the gateway's real limit — the vendor's advice, measured
16 Oct 2026The vendor's answer to our rate-limit problem: no special API needed, just don't send everything at once. We measured the live gateway to find out what that means in numbers: calls spaced ~100ms apart (about 2.6 per second) all succeed, while anything near 3.5 per second or faster starts getting blocked after the first 4-5 calls · Every POS call now goes through a single paced lane that keeps to 2.5 calls per second, instead of bursting. Calls answered from cache skip the wait, so repeat views stay instant. The earlier batching experiments (5 at a time) are gone — they were the cause of the blocking · Finance 'Today', 'Yesterday', '7 Days' and '30 Days' for a single outlet now stop loading history as soon as they've reached far enough back, since sales come back newest-first — Today for a busy outlet went from walking 30 pages to loading in about half a second · During opening hours (10:30am–9pm) data is re-checked every 2 minutes (was 5); hourly overnight. Trade-off to know about: a cold load of a very busy outlet's full history, or of all 24 outlets together, now takes ~10s because the pacing is deliberate — it only happens once per cache window
Added two-factor authentication (authenticator app) and a real password-reset flow
15 Oct 2026Every account can now turn on 2FA from Account Security (top-right menu) — scan a QR code with Google Authenticator, Authy, 1Password, etc., confirm with a 6-digit code, and save the one-time recovery codes shown. From then on, signing in asks for that code (or a recovery code) after the password · Added "Forgot password?" on the sign-in page — real per-account passwords now exist (accounts that haven't set one yet still fall back to the shared demo password, so nothing breaks for existing test logins), and a reset link is emailed via Resend, expiring in 30 minutes · Password-reset email isn't live yet — it needs a Resend API key (RESEND_API_KEY) added to the environment. Until then, Admin → System Settings shows it as "Not connected" and the forgot-password page tells whoever's testing it to contact an admin instead of pretending to have sent something · Deliberately did NOT show a working reset link on-screen when email isn't configured, even for testing convenience — that would hand out a live account-takeover link to anyone who types in an email address, and would leak which emails are real staff accounts. That link is only ever written to the server's own logs, and only outside production
Loaded 50% more sales history per outlet, tuned carefully around the gateway's real rate limit
14 Oct 2026Per-outlet sales history was capped at 2,000 records (20 sequential page calls to the POS, one at a time). Pages are now fetched in small concurrent batches of 2 instead of strictly one at a time, and the cap raised to 3,000 records (30 pages) — first tried batches of 5 and a cap of 6,000, which measurably tripped the gateway's rate limit in production testing, so this shipped the safer, verified setting instead of the riskier one · Confirmed empirically that the existing cache actually works for these fetches: a cold load of a busy outlet's Finance page is slower (multiple seconds), but reloading immediately after is much faster — so that slower cold fetch only happens once per cache window (5 min in business hours, 1 hour overnight), never on every page view · Also surfaced a real limitation worth knowing about: the in-memory "last known good" fallback cache doesn't reliably survive between requests on Vercel's serverless hosting, since different requests can land on different server instances that don't share memory — so "showing cached data instead of nothing" doesn't always trigger even moments after a successful fetch. Fixing that properly would mean moving that fallback cache to shared storage (e.g. Vercel KV) instead of an in-memory Map — not done yet, flagged for later
Stopped polling the POS gateway overnight — outlets are only open 10:30am–9pm
13 Oct 2026Live data was refreshing every 5 minutes around the clock even though the outlets are closed and no new sales happen outside 10:30am–9pm Malaysia time. Outside that window the app now only re-checks the POS once an hour instead of every 5 minutes — same numbers either way since nothing changes overnight, but far fewer requests against the client's rate-limited gateway · During business hours (10:30am–9pm), nothing changes — still refreshes every 5 minutes as before
Added date-range filtering to Finance — Today, Yesterday, 7 Days, 30 Days or All
12 Oct 2026Finance (both the group view and any individual outlet) now has a date-range picker, so you can actually check yesterday's or last week's numbers instead of only ever seeing a rolling "recent sales" figure · Ranges are computed in Malaysia time (UTC+8) rather than the server's own clock, so "Today"/"Yesterday" line up with the business's actual day — this also fixed a latent bug where "Revenue Today" everywhere else in the app could be off by several hours depending on which timezone the server happened to be running in · Honesty check built in: each outlet's sales are only loaded up to 2,000 records (or ~100 for the group-wide summary), so a very busy outlet's older history might not be loaded at all — if the range you pick reaches further back than what's actually loaded, a warning says so instead of silently showing an undercount as if it were complete · Also fixed: the PMS period selector was dropping the outlet filter every time you changed periods, undoing the outlet scoping added a day earlier — it now keeps every existing filter when you switch periods
Command Centre now shows the outlet you picked, not the group total — and every remaining page acknowledges the switcher
11 Oct 2026Command Centre previously always showed group-wide numbers with a banner explaining why. Picking an outlet there now shows that outlet's own real revenue, transactions, average sale and live staff headcount instead — region rollups and cross-outlet ranking are dropped from that view since they don't apply to a single outlet, replaced with quick links to that outlet's Finance, Stores and People pages · Customers, Tasks, Meetings, PMS and Inventory now filter by the selected outlet wherever the underlying data supports it (customers by preferred outlet, tasks and meetings by outlet, PMS records by outlet, inventory/purchase orders by outlet) — so the switcher is never a silent no-op, even on pages that currently have zero real records in them
Every live page now shows exactly when its data was last pulled — and one number that was quietly wrong is now fixed
10 Oct 2026Added a small "as of HH:MM (X minutes ago)" indicator next to the Live badge on Home, Finance, Command Centre, People and Stores, so it's always clear how fresh the numbers on screen are (data is cached for up to 5 minutes to protect against the POS gateway's rate limits) · Found and fixed a real accuracy bug while checking this: outlet staff counts labeled "(live)" on Home, Stores and Command Centre were actually a frozen snapshot taken when the outlets were first set up, not a live number — an outlet could show 49 staff there while People (which does fetch live) correctly showed 52. All of those now pull the same live count People already used, so they agree with each other and actually update as the client's real headcount changes
Audited every page against the fixed switcher — 2 more silent gaps closed
9 Oct 2026People was showing all 415 staff no matter which outlet you picked, even though the underlying data (each real employee's real outlet) was already there to filter by — it now shows just that outlet's real people, with a count like "52 of 415 staff at this outlet" · Stores didn't respond to the switcher at all — picking an outlet there now takes you straight to that outlet's page, matching what clicking its row already did. Switching to a different outlet while already viewing one now also works (previously the second switch was a silent no-op) · Known remaining gap, lower impact: choosing "All Outlets · Group" while on a specific outlet's Stores page doesn't return you to the Stores list — it's a no-op rather than wrong data, but still worth fixing
Fixed: Command Centre silently ignored the outlet switcher
8 Oct 2026Once the switcher itself was fixed to show your real selection, this became visible: picking an outlet on Command Centre updated the switcher button but the page never filtered — it always shows the whole group, because rankings, region rollups and cross-outlet comparisons don't make sense scoped to one outlet · Rather than leave that silent (which reads as "broken"), Command Centre now shows a clear note when an outlet is selected, with direct links to that outlet's real numbers on Home, Finance and Stores
Fixed: outlet switcher wasn't showing your selection
7 Oct 2026Picking an outlet from the switcher was correctly filtering the page (real revenue, real staff) the whole time, but the switcher button itself kept showing "All Outlets · Group" no matter what you picked — so it looked like nothing happened, even though it had · Cause: the button's label came from your login's fixed home outlet, not from what's actually selected on the page. Since the demo login isn't tied to a specific outlet, it never updated · Now the switcher reads the real selection off the page itself, updates immediately when you pick an outlet, and highlights the current choice in the dropdown
Group-wide real revenue — Home, Command Centre, Finance
6 Oct 2026Home, Command Centre and Finance now show real revenue aggregated live across all 24 outlets, not just one at a time — a direct request after group-wide numbers still weren't showing · Built as up to 3 outlets fetched at once (not all 24 at once) with each outlet capped to its most recent ~100 sales, which is gentle enough on the client's rate-limited gateway to reliably get all 24 outlets through in one page load · If a few outlets do get rate-limited on a given load, the page still shows the rest with a clear "X/24 outlets included" note, rather than failing the whole page over a handful of outlets · Outlet Ranking and Outlet Performance now rank and total by this real revenue instead of showing "not connected" for every live outlet · Fixed an inconsistency this uncovered: an earlier version strictly filtered to the current calendar month, which could legitimately show RM 0 for an outlet whose recent sales happened to fall just outside the month boundary — now it matches the same "recent sales" total Finance already showed, so the same outlet reads the same number everywhere
Numbers stay visible during rate limiting
5 Oct 2026Fixed a real gap: the POS gateway rate-limits fairly often, and until now that meant People, Finance and Service Categories would just show a "rate limited" error and no data — even though the numbers had loaded fine moments earlier · Now each of those pages remembers its last successful pull and keeps showing it (clearly labelled "Showing cached data", with how long ago it's from) instead of going blank when a refresh gets throttled · It only falls back to a hard error when there's truly never been a successful pull for that outlet yet — a brand-new outlet hit during a rate-limit window will still show the honest "try again shortly" message · This is in-memory only (not a database), so it resets on deploys and doesn't survive server restarts — it smooths over short throttling windows, not long outages
Live service catalogue per outlet
4 Oct 2026Admin → Service Categories now shows each outlet's real service catalogue and pricing, pulled live from POS the moment you pick an outlet from the switcher · Replaces the old static/fictional 4-category demo catalogue (Cut & Style, Colour, Treatment, Beauty & Spa) entirely
Live People directory and per-outlet Finance
3 Oct 2026People now shows the client's real 400-person staff directory — names, positions, outlets, phone and email — pulled live from POS on every visit (cached briefly so it doesn't hammer their rate limit) · Finance now shows real sales the moment you pick a specific outlet from the switcher: collected, outstanding, transaction count and a recent-sales table with real customer names and the staff member who processed each sale · Group-wide Finance and revenue stay "not connected" on purpose — aggregating live sales across all 24 outlets on every page load would mean 24x the API calls per visit, which isn't something to do to the client's production gateway without asking first · Removed the remaining simulated data across the app: fake customers, tasks, meetings, notifications, marketing campaigns and demo approval examples are all gone. These are native app features (not POS-sourced), so they now start genuinely empty and fill up as the team actually uses the app, instead of showing invented activity · Fixed a real bug this surfaced: the POS's sale date field is DD/MM/YYYY, not ISO — was crashing the page. Now reads the reliable epoch field instead
Real outlets everywhere — demo outlets retired
2 Oct 2026The 8 fictional demo outlets are gone. Every page — Home, Stores, Command Centre, PMS, Finance, Inventory, Tasks, Meetings, SOP — now runs on the client's real 24 outlets and their live staff headcount from POS · Nothing is fabricated under the client's real name: revenue, appointments, PMS scores, ratings, inventory and individual staff profiles all show clearly as "not connected yet" rather than invented numbers, until each module is synced to real data · Customers (200), the course catalogue, SOP documents and marketing campaigns stay as a generic, unattributed demo pool — not claimed as real, not tied to any specific real outlet · Demo login now only lists the Group Owner account — the Outlet Manager / Senior Stylist demo logins are retired along with the fictional outlets they belonged to · This is a live snapshot of the client's outlet roster (captured 1 Oct 2026), not a real-time read on every page load — re-pull from POS if the client opens or closes outlets
POS outlets, derived
1 Oct 2026Admin → Integrations now shows the client's real outlets, worked out from each employee's site info since the POS API has no outlet-listing endpoint of its own · Flagged the limitation plainly: an outlet with no staff in the employee listing won't show up here — a real outlets endpoint would be more reliable · Employees and sales previews now cap at 10 rows so the page stays readable once the live key is off cooldown (was rendering all ~400 employees at once)
HR — Attendance & Leave
30 Sept 2026Attendance log per employee (last 30 days) with clock-in/out times, hours worked and an attendance rate · Leave balance (14 days annual entitlement) and a full leave request history, broken down by taken vs. pending · Staff can request leave from their own profile; requests go through the same Approvals queue as purchase orders and discounts — approving one automatically updates the leave balance · Payroll processing isn't in scope — this covers attendance and leave only
Marketing & Campaigns
29 Sept 2026Campaign performance tracking: audience, channel, open/click rates and redemptions for win-back, rebooking, birthday and promo sends · Lead pipeline from first contact through to converted or lost, assigned to outlet reception and tracked per source (walk-in, referral, social, Google, event) · Sending itself isn't wired to a real WhatsApp/email provider yet — that's the v0.06 integrations phase
Academy — v0.04 complete
28 Sept 2026Course catalogue across Technical, Customer Service, Compliance, Leadership and Product Knowledge, with per-course enrollment and completion tracking · Certifications per stylist with issue and expiry dates; Academy flags certifications expiring soon or already expired · Training completion is now real enrollment data, not a random number — and it's what the PMS Development score reads · Home page title now shows the outlet name (or "Hairstory" group-wide) instead of a generic welcome message
POS integration goes live
27 Sept 2026Connected to the client's real POS API with working credentials — employees, services, sales and attendance now flow through · Response formats were corrected to match the live API (some fields differed from the reference docs) · Admin → Integrations now shows a live connection instead of sample data
Approval Workflows
27 Sept 2026Purchase orders of RM 400 or more now need sign-off instead of being placed instantly · Admin → Approvals: review pending requests, approve (which raises the purchase order automatically) or reject with a note · Inventory now shows "Awaiting approval" on items with a request pending, so staff don't submit duplicates
SOP library
26 Sept 2026Create and edit procedures in the app; every content change saves a new version with a change note and history · Staff read and acknowledge each version; editing a procedure asks everyone to re-acknowledge · Six clearly labelled sample SOPs are included so the client can replace them with their own
Inventory & Procurement
25 Sept 2026Stock levels for 21 products across all 8 outlets, with low-stock and out-of-stock alerts and stock value · One-click reorder raises a purchase order to the item's supplier; marking it received adds the stock back · Create and receive actions are permission-gated; everyone with access can view
Customer Beauty Records — v0.03 complete
24 Sept 2026Beauty Records tab: allergies, colour formulas (linked to the visit and stylist), preferences and scalp notes · A red allergy alert now shows at the top of any customer profile with an allergy on file · Staff with edit permission can add records; everyone else sees them read-only
Membership & Packages
23 Sept 2026Membership tier is now earned from lifetime points (Silver 1,000 / Gold 5,000 / Platinum 12,000), consistent across every screen · Loyalty tab shows progress to the next tier · Packages tab: prepaid session packages with sessions used/left, expiry and status
Loyalty & Points
22 Sept 2026Customer 360 Loyalty tab: points balance, earned, redeemed and a full activity ledger · Points accrue on every paid invoice (1 per RM1) with a welcome bonus and voucher redemptions · Built behind a data layer so it can switch to the POS's own loyalty balances once credentials arrive
POS integration groundwork
21 Sept 2026Server-side client for the client's POS API: employees, services, sales and attendance (read-only) · Runs on sample data until credentials arrive; the API key stays in environment variables, never in code · Admin → Integrations shows status, endpoint coverage and open questions for the client
Finance Intelligence (v0.03 begins)
20 Sept 2026Finance page: collected vs outstanding, collection rate, average invoice, collections by outlet and payment-method mix · Searchable, sortable invoice ledger; invoices are generated automatically from every completed appointment · Customer 360 Invoices tab now shows each customer's real invoices
PMS scoring formula finalized
20 Sept 2026Customer, Productivity, Quality, Commitment, Contribution and Development scores are now computed from real appointment, revenue, employment and training data — not randomized · Non-stylist roles (managers, receptionists) score on their outlet's aggregate performance since they're accountable for outlet results · v0.02 is now fully complete except connecting a live Supabase project
Full permission enforcement + custom domain connected
19 Sept 2026Every page and mutating action now checks the role permission matrix server-side, not just sidebar visibility · Admin → Users additionally requires the manage_users grant specifically · os.hairstory.com.my A record verified, HTTPS certificate issued — the subdomain is fully live · Build progress tracker published with the full v0.01 → v1.0 roadmap
Live deployment
18 Sept 2026Deployed to Vercel at hairstory-os.vercel.app · Production auth secret and demo password configured · Group Owner account set to Derick
v0.01 Foundation release
17 Sept 2026Home, Command Centre, Stores, Customers, People, PMS, Meetings, Tasks and Admin modules built · Full Postgres schema (23 core + 14 future-ready tables) and demo session auth · Realistic seed data: 8 outlets, 57 users, 200 customers, ~6,000 appointments
Roadmap · v0.01 → v1.0
v0.01 · Foundation
Architecture, navigation and data model every future module plugs into.
v0.02 · Access Control & Live Infrastructure
Lock down who can do what, and put the app on real infrastructure.
v0.03 · Money & Customer Growth
Turn appointments into revenue tracking and reward repeat customers.
v0.04 · Operations Depth
Round out day-to-day outlet operations.
v0.05 · Marketing & Engagement
Reach customers proactively instead of only tracking visits.
v0.06 · External Integrations
Connect Hairstory OS to the systems it needs to replace manual work.
v0.07 · Customer App
Give customers self-service booking on the same data the group runs on.
v1.0 · General Availability
Every module stable, integrated and production-hardened.
Module Detail
Core Platform
Group / Region / Outlet Hierarchy
24 real outlets from the client's POS, live staff headcount per outlet; individual staff and appointment data not yet connected
Roles & Permissions
17 roles, role→resource→action matrix, enforced on every route and action
Employees / People
Live staff directory pulled straight from POS — 400 real names, positions, outlets and contact details. No PMS/training/hire-date history, since POS doesn't have that data
Customers / CRM
The client's POS has no customer-listing endpoint (lookup-by-ID only), so there's no real customer list to show yet — this is empty rather than simulated
Appointments & Services
Data model exists but holds no data — POS appointment sync is still planned, and there's no other booking source yet
Operations
PMS / Performance
Formula is built and ready, but has nothing to compute from until real staff profiles and appointment history exist
Meetings
Create, agenda, live action items — native app feature, starts empty and fills up as the team actually uses it
Tasks
Kanban + List, permission-gated create/edit — native app feature, starts empty and fills up as the team actually uses it
SOP
Versioned library with acknowledgement tracking. Currently holds sample content the client replaces
Approval Workflows
Purchase orders RM 400+ and leave requests need sign-off; the queue is ready but has nothing in it until inventory and staff data exist
Academy
Course catalogue is ready; enrollments and certifications need real staff profiles to attach to
Customer Growth
Loyalty & Points
Built and ready; has nothing to track until real customers and paid invoices exist
Membership & Packages
Built and ready; has nothing to track until real customers exist
Customer Beauty Records
Built and ready; has nothing to track until real customers exist
Marketing & Campaigns
Campaign tracking and lead pipeline — native app feature, starts empty and fills up as the team runs real campaigns
Customer App
Shares the same customer database when built
Back Office
Inventory & Procurement
Built and ready; has nothing to track until real stock levels are connected — no fabricated levels for the client's real outlets
Finance Intelligence
Live and group-wide: real sales pulled from POS, both per-outlet and aggregated across all 24 outlets on Home, Command Centre and Finance
Outlet Budgeting & Goals
Monthly plan per outlet (sales goal + spending limits across team, stock & sourcing, shop, marketing, running costs), spending log, real sales from the POS counted daily, and checklist goals for HR, sourcing and savings. Saved privately on the live site
New Outlets (Expansion)
Shop survey with star scorecard, rent per sq ft and distance to the nearest outlet on a map; opening projects with a 7-stage checklist (lease → permits → renovation → equipment → team → opening), setup budget with spending log, and a payback estimate
HR — Attendance & Leave
Built and ready; has nothing to track until real staff profiles exist. Payroll isn't in scope
Accounting Integration
Integrations
POS Integration
Live and feeding real data into three modules now (People, Finance-per-outlet, Service Categories-per-outlet). Appointments and attendance sync are still ahead
Payment Gateway
AI Management Intelligence
Infrastructure
Live Deployment
Hosted on Vercel
Custom Domain
os.hairstory.com.my — DNS + HTTPS live
Saved Data Storage
Private Vercel Blob storage for what the team enters in the OS (store details, budgets, goals). Not public — readable only by the app
Live Database (Supabase)
Currently running on seeded demo data; schema is migration-ready