Πίσω στο portfolio
FLAGSHIP PROJECT Έρχεται σύντομα

Eukairon

Multi-tenant SaaS πλατφόρμα κρατήσεων για μικρές επιχειρήσεις — κομμωτήρια, συνεργεία, κτηνιατρεία. Χτισμένη με Laravel, Inertia.js + React, MySQL, Redis & Docker.

LaravelReact.jsInertia.jsMySQLRedisDockerStripePestPlaywright
Eukairon — αρχική σελίδα

Επισκόπηση

Το Eukairon επιτρέπει σε μικρές επιχειρήσεις να δέχονται κρατήσεις 24/7 — χωρίς τηλέφωνα, χωρίς χαμένα ραντεβού. Κάθε επιχείρηση (workspace) έχει τους δικούς της επαγγελματίες, υπηρεσίες, ωράριο, πελάτες και κρατήσεις, με πλήρη απομόνωση δεδομένων μεταξύ tenants.

Οι πελάτες κλείνουν ραντεβού από τη δημόσια σελίδα κρατήσεων της επιχείρησης — χωρίς λογαριασμό — και λαμβάνουν SMS υπενθύμιση πριν το ραντεβού. Οι ιδιοκτήτες διαχειρίζονται τα πάντα από ένα dashboard: στατιστικά, live ημερολόγιο, υπηρεσίες, επαγγελματίες, ωράρια και εξαιρέσεις, καθώς και τη συνδρομή τους μέσω Stripe. Πλήρως δίγλωσσο (ελληνικά / αγγλικά), με τη ζώνη ώρας κάθε επιχείρησης και την αλλαγή ώρας να υπολογίζονται στον server.

Eukairon — Πλατφόρμα Κρατήσεων SaaS

Βασικά Χαρακτηριστικά

Multi-tenant & Role-based Access

Απομόνωση δεδομένων σε middleware, request authorization, route binding, και ρητό φίλτρο workspace σε κάθε query. Ρόλοι owner, admin, member και viewer ανά workspace.

Real-time Booking Engine

Οι πελάτες επιλέγουν υπηρεσία, επαγγελματία, ημερομηνία και ώρα από live διαθεσιμότητα. Conflict detection, άρνηση παρελθοντικών slots, και ενημέρωση ημερολογίου μέσω WebSockets (Reverb).

Αυτόματες Υπενθυμίσεις

SMS υπενθυμίσεις σε Redis queue, 24 ώρες και 2 ώρες πριν από κάθε ραντεβού, η καθεμία με link ακύρωσης ενός κλικ.

Stripe Billing

Πλάνα Solo / Pro / Business με σταθερή τιμή, 30 ημέρες δοκιμή στο Solo χωρίς κάρτα, ΦΠΑ στο checkout, και admin plan override για ειδικές περιπτώσεις.

REST API

Versioned API με scoped read/write keys, rate limiting ανά key και plan gating — η επιχείρηση στέλνει κρατήσεις από τα δικά της συστήματα.

Automated Tests

3.200+ Pest tests (feature + Playwright browser) και 1.100+ Vitest tests, που τρέχουν παράλληλα ως merge gate. Κάθε security fix αποδεικνύεται πρώτα ότι αποτυγχάνει στον χαλασμένο κώδικα.

Τεχνικές Προκλήσεις

01

Tenant isolation σε κάθε layer

Δεν αρκεί ένα where('workspace_id', ...) — η απομόνωση έπρεπε να ελεγχθεί σε middleware, FormRequest authorize(), controller writes, route model binding, και queue jobs. Ένα dangling pointer στο current_workspace_id (owner removed από workspace) άνοιγε access. Λύθηκε με defense-in-depth: scopeBindings(), role gates, plan gates, και feature flags — κάθε layer αρνείται ανεξάρτητα.

02

Refusal shape consistency (403 vs 404)

Κάποια endpoints απαντούσαν 403 για workspace στο οποίο ο χρήστης δεν ανήκει — επιβεβαιώνοντας ότι το workspace υπάρχει — ενώ τα siblings έδιναν 404. Αυτή η διαφορά είναι enumeration oracle. Ομαλοποιήθηκε σε 404 για κάθε ξένο workspace, με tests που pin-άρουν το shape route προς route.

03

Stripe integration με plan override

Πέρα από τα standard Stripe subscriptions, υπάρχει admin plan_override feature για δωρεάν Pro/Business. Ο plan gate διαβάζει από μία authoritative πηγή (config/billing.php) — όχι hardcoded strings. Η πρόσβαση στο API ελέγχεται πάνω στο ίδιο το credential, άρα τα keys ενός downgraded workspace σταματούν να δουλεύουν τη στιγμή που αλλάζει το plan.

04

Ώρες κρατήσεων σε ζώνες ώρας

Η εφαρμογή τρέχει σε UTC, ενώ κάθε κράτηση είναι τοπική ώρα στη ζώνη ώρας της επιχείρησης. Το booking engine (laraveljutsu/zap) σύγκρινε date strings, οπότε ένα slot της χθεσινής μέρας της επιχείρησης περνούσε για περίπου τρεις ώρες τη μέρα, και ένα timestamp με offset που αποθηκευόταν χωρίς ->utc() κατέληγε ώρες λάθος. Λύθηκε με σύγκριση instants, άρνηση παρελθοντικής ώρας σε κάθε write path (admin, API, public), υποχρεωτικό offset στο API, και φιλτράρισμα της λίστας slots σε ένα σημείο, ώστε καμία οθόνη να μην προσφέρει slot που μια άλλη αρνείται.

05

Queue observability & data leaks

Τα notifications ήταν sync — κάθε email έμπαινε inline στο request. Μετακίνηση σε queue βελτίωσε latency αλλά δημιούργησε νέο πρόβλημα: αν ο worker πέσει, τα delivery logs δεν γράφονται, και historical rows με comment content διέρρεαν μέσω notification read paths μετά από feature retirement. Λύθηκε με centralized visibility (User::visibleNotifications()) που καλείται από όλα τα read paths + export job.

06

Test infrastructure robustness

phpunit.xml <env> entries ήταν inert — container .env υπερίσχυε, άρα tests push-άραν real jobs στο dev Redis (271K failed_jobs). Baseline drift 4 φορές από manual bumps. Λύθηκε με executable baseline (baseline.json, ανοχή ±5) που ελέγχεται σε κάθε merge, locks ανά βάση ώστε παράλληλα sessions να μη μοιράζονται ποτέ test DB, και parallel gate 4 processes που τρέχει όλη τη σουίτα σε περίπου ένα λεπτό.

Dashboard Ιδιοκτήτη

Eukairon — dashboard ιδιοκτήτη
Eukairon — σελίδα στατιστικών

Ό,τι χρειάζεται ο ιδιοκτήτης με μια ματιά: έσοδα, κρατήσεις μήνα, πληρότητα και ποσοστό μη εμφανίσεων σε σχέση με τον προηγούμενο μήνα, το σημερινό και το επόμενο πρόγραμμα, κορυφαίοι πελάτες, και έσοδα ανά ημέρα. Μια ξεχωριστή σελίδα στατιστικών καλύπτει τον τρέχοντα μήνα, τους τελευταίους 3 ή τους τελευταίους 12 μήνες: έσοδα, ποσοστό online κρατήσεων, ακυρώσεις και μη εμφανίσεις, νέοι και επαναλαμβανόμενοι πελάτες, πληρότητα ανά επαγγελματία, υπηρεσίες, πηγές κρατήσεων και ώρες αιχμής. Κάθε workspace βλέπει μόνο τα δικά του δεδομένα.

  • KPIs σε σύγκριση με τον προηγούμενο μήνα
  • Σημερινό & επόμενο πρόγραμμα
  • Κορυφαίοι πελάτες & έσοδα ανά ημέρα
  • Στατιστικά για 1, 3 ή 12 μήνες

Χρειάζεστε κάτι παρόμοιο;

Χτίζω multi-tenant SaaS πλατφόρμες, REST APIs, και πολύπλοκες ενσωματώσεις από το μηδέν. Ας μιλήσουμε για το project σας.

Επικοινωνία