Barbershop Booking and Business Tracking

The booking, ticket, till and walk-in flows were tried with real records on a local installation and on the live demo and can be seen in the screens below; the time-off form and the customer-import preview were opened on the demo and are shown without saving anything. The no-overlap rule, the time-off and import logic, the reminder list and the panel roles are also covered by automated tests. Notifications are off in the demo, so they do not appear in the screens; their limits are written under “Limits”.

• Instant, free notification to the shop’s phone for a new booking and for a cancellation (Web Push): you hear when a customer books and when they cancel; the panel has to be added to the phone and notifications allowed. It is not an SMS or a WhatsApp message, so there is no message fee; notifications are off in the demo
• The booking link for customers: a ready message on WhatsApp in one tap, copy the link, a scannable code (show it big on the phone or send it as a picture) and an A4 poster; the customer books without an account, picks a barber or “Fark etmez” (doesn’t matter), sees the status on their own booking page and can cancel
• Calendar with a column per barber: bookings are cards in time order, tapping a card opens its actions, and one button says “Geldi · parayı aldım” (arrived · took the money; cash only on the plain screen, cash, card or transfer when it is off); the same barber cannot be booked twice for the same time, and bookings taken by phone are added from the calendar and moved to another time
• “İzin ekle” (time off, over several days): pick the barber, the first and the last day, then “all day” or a time range applied to every day (e.g. a lunch break). Days the shop is closed are skipped; a day that already has a booking or other time off is not closed, and the app tells you which days were skipped. The “Yaklaşan izin ve kapalı saatler” (upcoming time off) list sits on the staff page and on the calendar, each line with “Yanlış girdim, sil” (I made a mistake, delete)
• “Excel/CSV’den müşteri al” (import customers; manager): a file or a table pasted from Excel; the columns are guessed, the preview shows new, already-saved (same phone number) and faulty rows, nothing is saved before you confirm, no message is sent to anyone, and “Son içe aktarmayı geri al” (undo the last import) is there. An .xlsx file is read only when the server has the zip extension; the live demo’s hosting does not, and the page asks you to save as CSV
• Plain screen (Settings; on in a new installation): while on, campaigns, search, stock, packages, commission, panel users and card payment are hidden; switching it off brings all of it back, nothing is deleted
• Guided setup: a five-step setup wizard (Shop, Staff, Services, Hours, Share), a “Bu ekran ne işe yarar?” (what is this screen for?) box on every main screen, next-step buttons on empty screens, buttons that fix an error (e.g. “Boş saatleri göster”, show free times) and the first free time pre-filled in the quick-add form
• Walk-in queue: people are added in arrival order and you see how many minutes each has waited; when their turn comes you choose the barber as you take them in, and payment is taken on the ticket afterwards
• Customer card with a note for the usual cut (e.g. “beard: clipper guard 3, flat neckline”), appointment history, balance due, total paid and no-show count; the note stays on the card when the barber changes
• Quick ticket: a service (e.g. a beard trim) closes on one bill; selling a product (e.g. beard oil), each line with its barber and taking it off the stock come back when the plain screen is switched off
• Daily till: a cash-focused summary on the plain screen; cash, card, transfer, expenses and net when it is off; this month’s commission per barber, each with their own percentage (from service revenue only), also shows once the plain screen is off
• Booking approval is a setting: a booking is confirmed at once or waits for the shop to press “Onayla” (approve) or “Reddet” (decline); on the live demo it is confirmed at once
• A ready-made WhatsApp reminder message for tomorrow’s (or a chosen day’s) appointments; the shop sends it from its own WhatsApp
• Panel logins by role: the manager sees everything; reception works with bookings, customers and payments; a barber sees only their own calendar; a button, form or link a role may not use is never shown to it (e.g. no discount form and no customer-link box on the barber calendar; the server refuses them too). On the live demo there are password-free “… olarak gir” (sign in as …) buttons for manager, reception and staff
• Closing a problem customer to online booking: “Close online booking for this customer” on the customer card; a closed number cannot book on the booking page or through the API (the server checks it too) and is pointed to “call us / write on WhatsApp” buttons; you can still book them from the calendar (with a note). In Settings you choose how many hours before an appointment a customer can no longer cancel online, how many days ahead a booking may be made, and whether service prices are shown to customers
• Several services in one booking: on the booking page the customer picks “Aynı randevuya bir hizmet daha ekle” (add another service; up to three more); minutes and prices are added up, the times offered fit the total, and it is one booking (e.g. “Men’s haircut + Beard shave”). With “Fark etmez” (doesn’t matter) the free specialist with the fewest bookings that day is assigned
• Repeat a booking (weekly, every two weeks, monthly; up to 24 times): every date that could not be booked is named with its reason (already booked, time off, closed day) instead of being skipped silently; the series is removed with one tap, “Tüm seriyi iptal et (N)” (this booking and the scheduled ones after it; ones already marked arrived or missed stay)
• Review after a visit: the card of an appointment marked “Geldi” (arrived) has “Değerlendirme iste (WhatsApp)” with the message ready; the customer gives a 1–5 rating and an optional comment on a large, plain page without signing in (once per visit); the Reviews page shows the average, a “low ratings only (1–3)” filter and a ready message for an unhappy customer. Nothing is sent automatically; the salon sends the message
• Reports: busy hours, each service’s share of revenue (%), staff fill and kept rate, the customers who paid the most (VIP) and customers with no visit in 90 days (passive; a ready WhatsApp invitation on each row; someone with a booking ahead is not listed)
• Staff phone permission: on the panel logins in the Staff page (full screen) a “Müşteri telefonlarını görebilir” (can see customers’ phone numbers) box; when off, that staff member does not see the number, the call and WhatsApp buttons do not appear and a search by number finds nothing; the server checks it too (default: they see it)
• Warning note: a one-line “sensitivity note” (colour / allergy, sensitivity) on the customer card; a red “Uyarı” badge on the card and on that customer’s booking cards, visible to the staff member doing the job. It never goes into messages, exports or the customer’s own page (KVKK: it can be special-category data; keep it short and known to the customer)
• “Geleceğim” (I am coming) button: on their own booking page the customer says in one tap that they will come; the calendar card shows a green “✓ Geleceğim”. No message is sent, the cancel rule is unchanged, and moving the booking clears the mark
• “Takvime ekle” (add to calendar): on their own booking page the customer adds an approved appointment to their phone calendar, either with the “Add to Google Calendar” link (it opens filled in; press Save) or with a downloaded .ics file (with a reminder one hour before); no phone number or note is carried, nothing is sent to the salon and there is no SMS cost.
• Floating “WhatsApp’tan yaz” (write on WhatsApp) and “Ara” (call) buttons: two big buttons at the bottom of the showcase and the booking page (WhatsApp opens with the words ready and the customer sends it); drawn only when the salon has a phone number
• Approved reviews on the showcase: on the Reviews page each review has “Göster / Gizle” (show / hide; hidden by default; a 1–3 rating asks again); the showcase then has a “Müşterilerimiz ne diyor” (what our customers say) section with stars, the comment and only the first name plus the first letter of the surname, never a phone number or address; the average counts every review received, hidden ones included, and says how many
• Weekly days and hours per specialist: for each specialist day by day “shop hours”, “not working” or “own hours”; customers can book that specialist only at the hours they work (“Fark etmez” chooses only among those working), and the API refuses too; you can still book from the panel and are warned; without a record the specialist works the shop’s hours
• Activity log (manager): who did what and when with bookings, payments, settings and panel logins; filter by kind, person and date; no customer name, phone, e-mail or note is written; the source is a keyed hash of the address; lines older than 180 days are deleted; if a line cannot be written the action still goes through

Installation requirements

• Requirements as written in the documents: PHP 8.1 or newer, the pdo_mysql and mbstring extensions, MariaDB 10.4 or newer. MariaDB 10.4 was tried on a DirectAdmin shared hosting account; these have not been tried on a customer’s own hosting.

Support and updates

• Support and update terms have not been set yet; support hours and response time have not been decided either.

Release notes

• Summarised from the package’s version history; no version has been delivered to a client. The live demo runs version 1.1.19; 1.1.19 is still a “candidate” and is not in the delivery folder.
• 1.1.19 (28 October 2026): in the demo only, the “Enter as manager / reception / staff” buttons on this site’s product page open that role’s calendar screen directly, with no sign-in screen and no password; on a real installation it is off (404). No new permission, data or schema change.
• 1.1.18 (28 October 2026): next to the calendar file, the customer’s appointment page also has an “Add to Google Calendar” link (it opens with the appointment filled in; the customer presses Save); the file button stays, labelled “Dosya olarak indir (.ics)”. No new permission, data or schema change.
• 1.1.17 (27 October 2026): an “Add to calendar” (“Takvime ekle”) button on the customer’s own booking page; it saves an approved appointment that is still ahead to the phone calendar with a reminder one hour before, the file carries no phone number or note, and nothing is sent to the salon. No new permission, data or schema change.
• 1.1.16 (26 October 2026): on a real installation whose setup wizard is not finished, reception and staff land on the calendar after signing in instead of a setup page they may not open (the demo is not affected).
• 1.1.15 (26 October 2026): a staff login is no longer shown a “Daha fazla” (more) menu that opened empty (it is drawn only when the role may use a page in it); on the demo the setup page’s “Yazdırılabilir afişi aç” (open the printable poster) link opens the printable booking poster instead of a 404. No new permission, data or schema change.
• 1.1.14 (26 October 2026): a role is no longer shown a button, form or link it may not use (the server still refuses an address typed by hand). The staff member’s calendar no longer has the “İndirim yap” (give a discount) form or the “Müşteriye randevu bağlantısı gönder” box, which put every customer’s name and WhatsApp number into the page; reception no longer sees the demo bar’s “Kurulumu sıfırdan dene” (start again from scratch) link or the data-deletion / Excel sentence in the Customers help. On an empty installation the “Hizmet ekle”, “Çalışan ekle” and Stock links are replaced by “…yönetici ekler.” (the manager adds them) sentences (that last part was tried by automated tests only; the demo has no empty screen). No new permission, data or schema change.
• 1.1.8–1.1.13 (25 October 2026): a warning note on the customer card with a red “Uyarı” badge, a “Geleceğim” (I am coming) button on the customer’s own page (no message is sent), floating “WhatsApp’tan yaz” and “Ara” buttons on the showcase and booking page, approved reviews on the showcase (first name + first letter of the surname, low ratings hidden by default), weekly days and hours per specialist (the booking page and API refuse, the panel books with a warning), an activity (audit) log for the manager (no personal data written, 180 days).
• 1.1.7 (25 October 2026): closing a problem customer to online booking (checked on the booking page and in the API, on the server; call / WhatsApp pointers), call / WhatsApp buttons when the cancel window says no, a furthest-day limit in the API, a “show service prices to customers” setting; in Reports busy hours, service share, staff fill and kept rate, the customers who paid the most (VIP) and customers with no visit in 90 days; a review after a visit (a page without sign-in, a ready WhatsApp message, a low-rating filter; no automatic message); the reasons for dates that could not be booked when a booking is repeated and “Tüm seriyi iptal et” (cancel the whole series); up to three extra services in one booking (minutes and prices added up); a “can see customers’ phone numbers” permission for a staff login (checked on the server). An upgrade bug that created indexes before the columns they need was fixed.
• 1.1.6 (20 October 2026): “İzin ekle” (add time off) over several days (first and last day, all day or a time range; a day with a booking is skipped), the “Yaklaşan izin ve kapalı saatler” (upcoming time off) list, customer import from Excel/CSV (preview, duplicate phone numbers, undo; no message is sent; .xlsx only when the server has the zip extension).
• 1.1.5 (20 October 2026): a plain-screen report note fixed in the hair salon product; barbershop behaviour is the same.
• 1.1.4 (20 October 2026): guided screens and the plain screen added to the hair salon product; barbershop behaviour is the same, only the version number changed.
• 1.1.3 (19 October 2026): the trial is 15 days by default; a different length is given only for one installation through a setting (trial_days).
• 1.1.2 (19 October 2026): on the plain screen the staff table in Raporlar (reports) no longer shows the commission column.
• 1.1.1 (19 October 2026): in the demo a booking is confirmed at once (matching its help text); on the plain screen the Card and Transfer tiles in Kasa (till) show only when there is money in them, and the customer list has no campaign badge and the staff help text no longer explains commission.
• 1.1.0 (19 October 2026): a “Sade ekran” (plain screen) setting (on in a new installation), guided screens (setup steps, “what is this screen for?” boxes, a next-step button on empty screens, buttons that fix an error), the booking link for customers (WhatsApp, scannable code, A4 poster), one button for “Geldi · parayı aldım” (arrived · took the money), password-free role sign-in in the demo and “Boş siteyle yeniden başla” / “Örnek veriyi geri yükle” on the setup page.
• 1.0.2 (5 October 2026): product and format marker on backups, rejection of another product’s backup, a package timestamp that stops old code from running after an update, touch targets on narrow screens.
• 1.0.1 (28 September 2026): the reminder list no longer shows a request that is still waiting for approval.
• 1.0.0 (28 September 2026): first version; walk-in waiting list and product-specific sample data.

Decisions not made yet

• Rights to use, modify, transfer and receive the source code: to be set in a written agreement; not decided yet.
• Support hours and response time have not been decided yet.
• Whose name the hosting and domain are opened in, and where the software is installed, have not been decided yet.