🚕 Taxi Fleet Tracker
Εφαρμογή για στόλο ταξί: καταχώρηση βαρδιών από το κινητό, αυτόματος υπολογισμός ΦΠΑ,
καθαρό ταμείο, στατιστικά απόδοσης, εξαγωγή σε Excel και ενημέρωση οδηγών μέσω WhatsApp.
Βοηθητικό εργαλείο: δείχνει στον οδηγό πώς αποδίδει η δουλειά του και κρατά όλα τα οικονομικά του ταξί
σε ένα μέρος. Τα ποσά είναι ενδεικτικά και δεν αντικαθιστούν τη δουλειά του λογιστή (lib/disclaimer.ts:
το ίδιο κείμενο στην εφαρμογή).
- Next.js 16 (App Router, TypeScript) — mobile-first: στο κινητό η φόρμα είναι πάνω από τα στατιστικά.
- Supabase — Authentication (email/κωδικός) και PostgreSQL με Row Level Security.
- Χωριστοί στόλοι: όποιος κάνει εγγραφή και πατήσει «Έχω δικό μου ταξί» φτιάχνει τον δικό του
στόλο και γίνεται ο ιδιοκτήτης του. Κανείς δεν βλέπει τα στοιχεία άλλου στόλου.
- Δύο ρόλοι μέσα σε κάθε στόλο:
| Admin (ιδιοκτήτης) | Οδηγός |
|---|
| Βάρδιες | όλων των οδηγών του στόλου του | μόνο τις δικές του |
| Καταχώρηση βάρδιας | για οποιονδήποτε οδηγό του στόλου του | μόνο για τον εαυτό του |
| Διόρθωση/διαγραφή βάρδιας | πάντα | μόνο δικές του, μέσα σε 24 ώρες |
| Στατιστικά / ΦΠΑ / Ταμείο | συνολικά & ανά οδηγό | μόνο των δικών του βαρδιών |
| Υποδομή Στόλου, WhatsApp | ✔ | ✘ |
| Εξαγωγή Excel (CSV) | ✔ (τα φιλτραρισμένα) | ✔ (μόνο τα δικά του) |
| Άλλοι στόλοι | ✘ | ✘ |
Η απομόνωση των δεδομένων γίνεται μέσα στη βάση (RLS): ισχύει ακόμη κι αν κάποιος καλέσει
απευθείας το API του Supabase με το δικό του λογαριασμό.
Λογιστικοί κανόνες
Οι ίδιοι τύποι υπάρχουν στον κώδικα (lib/accounting.ts, για τη ζωντανή προεπισκόπηση της φόρμας)
και μέσα στη βάση ως υπολογιζόμενες στήλες των πινάκων shifts, vehicle_expenses και
platform_statements — η βάση είναι η πηγή της αλήθειας και ο ΦΠΑ δεν μπορεί να γραφτεί χειροκίνητα.
| Μέγεθος | Τύπος |
|---|
| ΦΠΑ εσόδων 13% | round(Καθαρά × 0.129933, 2) — π.χ. 160,39 € → 20,84 € |
| Ταμείο (τζίρος) | Καθαρά + ΦΠΑ 13% + Φιλοδωρήματα/Άλλα έσοδα (χωρίς ΦΠΑ): ό,τι εισέπραξε το αυτοκίνητο, χωρίς καμία αφαίρεση |
| Σύνολο εξόδων | Καύσιμα των βαρδιών + Επισκευές / Συντήρηση (έξοδα οχήματος) + Κρατήσεις εφαρμογών του μήνα (τελικά ποσά)· τα «Άλλα έξοδα» όχι |
| ΦΠΑ εξόδων 24% (εμπεριεχόμενος) | round(ποσό / 1.24 × 0.24, 2) για καύσιμα, όλα τα έξοδα οχήματος (και τα «Άλλα έξοδα») και κρατήσεις με ΦΠΑ (π.χ. FreeNow)· οι κρατήσεις χωρίς ΦΠΑ (Uber, ενδοκοινοτικά) δεν συμψηφίζονται |
| Κράτηση εβδομάδας | Αυτόματα: ποσοστό × «Συνολικά έσοδα», + ΦΠΑ 24% όπου υπάρχει (π.χ. FreeNow 12% + ΦΠΑ, 99 € → 14,73 €)· ή η «Προμήθεια» του εγγράφου, αν γράφει άλλη. Ο ΦΠΑ 24% μέσα της βγαίνει αυτόματα — π.χ. 85,14 € → 16,48 € |
| Κράτηση εφαρμογής (μήνα) | Το μηνιαίο τιμολόγιο όταν έχει καταχωρηθεί, αλλιώς το άθροισμα των εβδομάδων |
| Προς απόδοση ΦΠΑ | ΦΠΑ 13% − ΦΠΑ εξόδων 24% → θετικό = Χρεωστικό, αρνητικό = Πιστωτικό |
| Καθαρό κέρδος | Ταμείο − ΦΠΑ 13% − καθαρή αξία εξόδων (χωρίς ΦΠΑ)· ο ΦΠΑ των εξόδων συμψηφίζεται χωριστά με τον ΦΠΑ 13% (προς απόδοση). Τα «Άλλα έξοδα» δεν αφαιρούνται· ο ΦΠΑ τους μπαίνει στον συμψηφισμό και προστίθεται στο κέρδος. Π.χ. Ζ 912: 204,85 − 23,56 − 19,35 = 161,94 €, ΦΠΑ 23,56 − 4,65 = 18,91 € προς απόδοση (στη βάση, net_cash = ταμείο − έξοδα, χωρίς τον ΦΠΑ) |
| Διαδρομές από τον δρόμο | Διαδρομές των Ζ − Διαδρομές των εφαρμογών |
| Συνολικά χλμ | Μισθωμένα + Ελεύθερα |
| Αξιοποίηση % | Μισθωμένα χλμ / Συνολικά χλμ × 100 |
| Απόδοση ανά χλμ | Καθαρά έσοδα / Συνολικά χλμ: μέσος όρος της περιόδου, στον μετρητή αξιοποίησης και στο Excel |
| Καύσιμα ανά χλμ | Καύσιμα των βαρδιών / Συνολικά χλμ: μέσο κόστος καυσίμου ανά χλμ σε € (και τα 100 χλμ στο Excel), ίδιες θέσεις |
| Μ.Ο. βάρδιας | Ταμείο / Βάρδιες (μπαλονάκι στα στατιστικά, όπως ο «Μ.Ο. ανά βάρδια» των «Αναλυτικών») |
| Μ.Ο. διαδρομής | (Καθαρά + ΦΠΑ 13%) / Διαδρομές, χωρίς φιλοδωρήματα (όπως η «Μέση αξία διαδρομής») |
| Επίπεδο αξιοποίησης | Βενζίνη, πετρέλαιο, αέριο: κάτω από 65% χαμηλή, 65–70% ικανοποιητική, από 70% πολύ ικανοποιητική· υβριδικό, ηλεκτρικό: 55% / 60%. Όλος ο στόλος: όρια ανάλογα με τα χλμ κάθε αυτοκινήτου () |
- Η φόρμα δεν έχει ημερομηνία: κάθε βάρδια ανήκει σε Μήνα / Έτος (dropdown). Η επιλογή
έτους/μήνα θυμάται σε κάθε συσκευή. Αν καταχωρείτε σε μήνα διαφορετικό από τον τρέχοντα,
εμφανίζεται προειδοποίηση.
- Ο Αριθμός Ζ είναι υποχρεωτικός· αν ξαναδοθεί ίδιος Ζ για τον ίδιο οδηγό, η εφαρμογή ρωτάει.
- Τα αριθμητικά πεδία δέχονται ελληνικό κόμμα (
80,5) ή τελεία (80.5).
- Τα ποσά υπολογίζονται σε ακέραια λεπτά — χωρίς σφάλματα δεκαδικών.
- Διόρθωση βάρδιας: «Επεξεργασία» στο ιστορικό ανοίγει τη βάρδια στη φόρμα (π.χ. για ξεχασμένα
καύσιμα)· ο ΦΠΑ και το ταμείο ξαναϋπολογίζονται από τη βάση.
- Βάρδιες (καρτέλα των «Καταχωρήσεων»): με τη σειρά των Ζ ανά μήνα και αυτοκίνητο, το νεότερο πάνω (όχι με τη σειρά που
γράφτηκαν: το 911 είναι πάντα ανάμεσα στο 910 και στο 912). Κάθε βάρδια δείχνει την πράξη:
Καθαρά (χωρίς ΦΠΑ) + ΦΠΑ 13% + Φιλοδωρήματα = Ταμείο (με ΦΠΑ)· − ΦΠΑ 13% − Καύσιμα χωρίς ΦΠΑ = Καθαρό
κέρδος· και χωριστά ο συμψηφισμός: ΦΠΑ 13% − ΦΠΑ καυσίμων = ΦΠΑ προς απόδοση.
- Στη βάρδια μπαίνουν μόνο τα καύσιμα. Επισκευές / συντήρηση και άλλα έξοδα του αυτοκινήτου είναι
«Έξοδο οχήματος» (διακόπτης «Βάρδια | Έξοδο οχήματος» πάνω στη φόρμα): Μήνας/Έτος, αυτοκίνητο,
είδος («Επισκευές / Συντήρηση» ή «Άλλα έξοδα»), ποσό με ΦΠΑ 24%, περιγραφή. Ένα συνεργείο
800 € δεν «χαλάει» το ταμείο μιας βάρδιας· μετράει στα έξοδα, στον ΦΠΑ (154,84 € συμψηφίζονται) και στο κέρδος του μήνα και του αυτοκινήτου.
Από τα «Άλλα έξοδα» μετράει μόνο ο ΦΠΑ (συμψηφίζεται): το ποσό τους δεν μπαίνει στα «Συνολικά Έξοδα» και
δεν αφαιρείται από το κέρδος (π.χ. 180 € → μόνο ο ΦΠΑ 34,84 €). Η φόρμα το γράφει κάτω από το είδος, η λίστα
έχει σήμανση «μόνο ΦΠΑ» και χωριστό σύνολο, η «Ανάλυση ΦΠΑ» μια σημείωση και το Excel χωριστή γραμμή
«Άλλα Έξοδα — μόνο ΦΠΑ» (στη βάση: στήλη
vat_only_expenses της monthly_summary).
Καταχωρούν ο ιδιοκτήτης (για κάθε αυτοκίνητο) και ο οδηγός (μόνο για το δικό του)· ο οδηγός
διορθώνει/διαγράφει δικά του έξοδα μέσα σε 24 ώρες. Φαίνονται στην καρτέλα «Έξοδα» των «Καταχωρήσεων»,
στα «Συνολικά Έξοδα» («Καύσιμα · Επισκευές · Εφαρμογές», μόνο όσα υπάρχουν) και σε δική τους ενότητα στο Excel.
- Εφαρμογές (Uber / FreeNow / Bolt): τρίτη επιλογή του διακόπτη, «Εφαρμογή». Κάθε εβδομάδα ο
οδηγός αντιγράφει το έγγραφο που στέλνει η εφαρμογή (FreeNow: «Σύνολο Διαδρομών», «Συνολικά
Έσοδα», «Προμήθεια προς Freenow» χωρίς το μείον, «Λοιπές Επιστροφές / Επιβραβεύσεις» στα
Φιλοδωρήματα / Quest)· στο τέλος του μήνα και το τιμολόγιο των κρατήσεων (με προαιρετικό αριθμό).
Επιπλέον
-
Η σελίδα, απλή: πάνω η φόρμα («+ Νέα καταχώρηση»), μετά τα ποσά (Ταμείο, Συνολικά Έξοδα, Καθαρό
Κέρδος) και από κάτω μπαλονάκια που φαίνονται χωρίς να ανοίξει τίποτα: Βάρδιες, Μ.Ο. βάρδιας,
Διαδρομές, Μ.Ο. διαδρομής, Χλμ, Καθαρά χωρίς ΦΠΑ, Φιλοδωρήματα (όταν υπάρχουν). Για τον ιδιοκτήτη, με
«Όλοι οι οδηγοί», και «Κέρδος ανά οδηγό»: ένα μπαλονάκι για κάθε οδηγό με το κέρδος του (ο καθένας χωριστά,
με τα δικά του φορολογικά στοιχεία)· πάτημα → μόνο αυτός στο φίλτρο. Ακολουθούν ο μετρητής
αξιοποίησης (με την απόδοση και τα καύσιμα ανά χλμ) και ο ΦΠΑ. Πάνελ που ανοίγουν/κλείνουν είναι
πέντε (ο οδηγός έχει τα δύο πρώτα): Αναλυτικά (με τον πίνακα «Ανά οδηγό» στο τέλος), Καταχωρήσεις
με καρτέλες Βάρδιες | Έξοδα | Εφαρμογές (με το πλήθος τους· η καρτέλα μένει στη συσκευή και αλλάζει
μόνη της σε ό,τι μόλις καταχωρήθηκε), Υποδομή Στόλου, Πάγια έξοδα και Αντίγραφο ασφαλείας. Κλειστές, οι
«Καταχωρήσεις» γράφουν «Βάρδιες 7 · Έξοδα 2 · Εφαρμογές 1» και τις σημάνσεις «λείπει 1 Ζ» / «λείπουν 2 εβδ.».
-
Εικονίδιο στο κινητό: «Εγκατάσταση» (Android: κουμπί στην κεντρική σελίδα και στο «Καλώς ήρθατε»·
iPhone: «Κοινοποίηση» → «Προσθήκη στην οθόνη Αφετηρίας»). Ανοίγει σε πλήρη οθόνη χωρίς τη γραμμή του
browser. Αν ανοίξει χωρίς σήμα, δείχνει τη σελίδα «Χωρίς σύνδεση» (service worker, χωρίς να κρατά
στοιχεία). Τα PNG των εικονιδίων βγαίνουν από τα SVG με node scripts/icons.mjs.
-
Κίνηση ανοίγματος: μία φορά σε κάθε άνοιγμα της εφαρμογής, όσο φορτώνουν τα στοιχεία· ένα πάτημα
την κλείνει. Την πρώτη φορά μόνο το λογότυπο (μετά έρχεται το «Καλώς ήρθατε»)· από εκεί και πέρα κάθε
άνοιγμα δείχνει άλλη διαδρομή στον χάρτη και μία άλλη δυνατότητα της εφαρμογής, πρώτο τον ΦΠΑ του
μήνα (components/intro/scenes.ts).
-
«Καλώς ήρθατε»: πέντε κάρτες με κινούμενα σχέδια: για τον οδηγό (ό,τι φαίνεται αμέσως από το Ζ),
αξιοποίηση χιλιομέτρων, ΦΠΑ στο τέλος του μήνα (από Ζ, έξοδα και τιμολόγια εφαρμογών), γιατί
φτιάχτηκε. Το ταμείο δεν «υπόσχεται» να φαίνεται αμέσως: βγαίνει σωστό όταν μπουν και τα τιμολόγια
των εφαρμογών. Βγαίνει μόνη της την πρώτη φορά σε κάθε συσκευή και ξανά από το
«Τι κάνει η εφαρμογή» (σύνδεση και κάτω κάτω στην κεντρική). Με «μείωση κίνησης» στο κινητό όλα μένουν
ακίνητα.
-
Αναλυτικά (Πίνακας / Γράφημα): κάτω από τα στατιστικά (για τον ιδιοκτήτη, με «Όλοι οι οδηγοί», και ο
πίνακας «Ανά οδηγό» στο τέλος: καθαρά, ΦΠΑ, κέρδος· πάτημα σε όνομα φιλτράρει). Ανοίγει ως πίνακας με Τζίρο
(μικτή είσπραξη), Διαδρομές και ((καθαρά + ΦΠΑ 13%) ÷ διαδρομές, χωρίς
φιλοδωρήματα), με σύνολο και μέσο όρο.
Εγκατάσταση βήμα-βήμα
1. Supabase project
- Στο supabase.com → New project. Προτείνεται νέο, καθαρό project
(region: Central EU (Frankfurt)).
- Κρατήστε τον κωδικό της βάσης κάπου ασφαλές (δεν χρειάζεται στην εφαρμογή).
Αν θέλετε να κρατήσετε το παλιό project, δείτε πρώτα την ενότητα Παλιό Supabase project.
2. Βάση δεδομένων
- Supabase → SQL Editor → New query.
- Επικολλήστε ολόκληρο κάθε αρχείο του φακέλου
supabase/migrations, με τη σειρά, και πατήστε
Run για το καθένα (πρέπει να δείτε «Success. No rows returned»):
20260927120000_taxi_fleet.sql — πίνακες, κανόνες ασφαλείας20260927160000_shift_editing.sql — διόρθωση βαρδιών20260928090000_vehicle_expenses.sql — έξοδα οχήματος20260928140000_platform_statements.sql — εφαρμογές (Uber / FreeNow / Bolt)20260929090000_fleets.sql — χωριστοί στόλοι, προσκλήσεις οδηγών
(τα στοιχεία που υπάρχουν ήδη γίνονται ο στόλος του υπάρχοντος Admin)
Δημιουργούνται οι πίνακες profiles, fleets, drivers, shifts, vehicle_expenses, platform_rates, platform_statements,
η αναφορά monthly_summary (σύνολα ανά αυτοκίνητο/μήνα, μαζί με τα έξοδα οχήματος, τις κρατήσεις
και τις διαδρομές δρόμου / εφαρμογών, για χρήση και από το Table Editor) και όλοι οι κανόνες ασφαλείας.
Εναλλακτικά με το CLI: npx supabase login, npx supabase link --project-ref <ref>, npx supabase db push.
3. Ρυθμίσεις Authentication
Authentication → URL Configuration
- Site URL: η διεύθυνση της εφαρμογής, π.χ.
https://taxi-fleet.vercel.app
(για δοκιμές στον υπολογιστή: http://localhost:3000).
- Redirect URLs: προσθέστε
https://taxi-fleet.vercel.app/**http://localhost:3000/**
Email (σημαντικό): η δωρεάν υπηρεσία email του Supabase στέλνει email μόνο στα μέλη της
ομάδας του project και ελάχιστα την ώρα. Για να κάνουν οι οδηγοί μόνοι τους εγγραφή, ρυθμίστε δικό
σας SMTP στο Authentication → Emails → SMTP Settings (π.χ. Resend, Brevo ή Gmail με App Password).
Αν δεν θέλετε SMTP, δείτε την «Επιλογή Β» στο βήμα 7.
Μην απενεργοποιήσετε το Confirm email: η επιβεβαίωση αποδεικνύει ότι το email ανήκει
πράγματι στον οδηγό πριν δει τα στοιχεία του.
4. Σύνδεση της εφαρμογής με το Supabase
Το URL και το publishable key του project βρίσκονται ήδη μέσα στον κώδικα
(lib/supabase/config.ts): είναι δημόσιες τιμές (τις λαμβάνει ο browser
κάθε επισκέπτη) και την ασφάλεια την κάνουν οι κανόνες RLS της βάσης. Άρα δεν χρειάζονται
μεταβλητές περιβάλλοντος ούτε .env.local.
Για άλλο Supabase project (ή τοπικό Supabase), αλλάξτε τις δύο τιμές στο αρχείο αυτό ή ορίστε
και τις δύο μεταβλητές (έχουν προτεραιότητα· δείτε το .env.example):
NEXT_PUBLIC_SUPABASE_URL=https://xxxxxxxxxxxxxxxxxxxx.supabase.co
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=sb_publishable_...
Τιμές-παράδειγμα με xxxx… αγνοούνται. Σε παλαιότερα projects, αντί για publishable key μπορείτε να
βάλετε το anon key στη μεταβλητή NEXT_PUBLIC_SUPABASE_ANON_KEY. Ποτέ το secret /
service_role key — η εφαρμογή το αναγνωρίζει και αρνείται να ξεκινήσει.
5. Εκτέλεση στον υπολογιστή
Χρειάζεται Node.js 20.9+ (προτείνεται 22).
npm install
npm run dev
Ανοίξτε το http://localhost:3000. Αν κάτι λείπει (μεταβλητές, SQL), η εφαρμογή δείχνει οδηγίες
αντί για σφάλμα.
6. Πρώτη σύνδεση — Ιδιοκτήτης (Admin)
- Δημιουργία λογαριασμού με το email σας → επιβεβαίωση από το email → σύνδεση.
- Πατήστε «Έχω δικό μου ταξί», γράψτε το όνομά σας και την πινακίδα και πατήστε «Δημιουργία».
Φτιάχνεται ο στόλος σας με το ταξί σας (συνδεδεμένο με τον λογαριασμό σας) και γίνεστε ο Admin του.
Το ίδιο κάνει κάθε φίλος με δικό του ταξί: ο καθένας έχει τον δικό του στόλο και βλέπει μόνο αυτόν.
- Στην Υποδομή Στόλου (κάτω) προσθέστε οδηγούς: Όνομα, Πινακίδα (π.χ.
ΤΑΕ-1234),
Κινητό (69XXXXXXXX) και προαιρετικά Email σύνδεσης.
7. Πρόσβαση οδηγών από το κινητό τους
Ο οδηγός κάνει εγγραφή με το email που δηλώσατε ως «Email σύνδεσης» και, αφού το επιβεβαιώσει, βλέπει
την πρόσκληση (ποιος στόλος, ποιο αυτοκίνητο). Μπαίνει στον στόλο μόνο όταν πατήσει «Αποδοχή»:
κανένας στόλος δεν «τραβάει» λογαριασμό χωρίς τη συγκατάθεσή του. Κάθε λογαριασμός ανήκει σε έναν στόλο.
- Επιλογή Α — ο οδηγός κάνει εγγραφή μόνος του (χρειάζεται SMTP, βήμα 3): δηλώστε το email του
στην Υποδομή Στόλου και στείλτε του τον σύνδεσμο με το κουμπί «Πρόσκληση» (WhatsApp). Ο οδηγός
ανοίγει
…/register, επιβεβαιώνει το email, πατά «Αποδοχή» και βλέπει τις δικές του βάρδιες.
- Επιλογή Β — δημιουργείτε εσείς τον λογαριασμό (χωρίς SMTP): Supabase → Authentication →
Users → Add user → Create new user, βάλτε email και κωδικό και τσεκάρετε Auto Confirm User.
Δώστε στον οδηγό το email/κωδικό του· με την πρώτη σύνδεση πατά «Αποδοχή».
Ο ιδιοκτήτης δεν βλέπει ποιοι έκαναν εγγραφή στην εφαρμογή (μπορεί να είναι άλλων στόλων). Αν κάποιος
οδηγός γραφτεί με διαφορετικό email, γράψτε αυτό το email στην Επεξεργασία του οδηγού και ο οδηγός
πατά «Ανανέωση» και «Αποδοχή». Για να κόψετε την πρόσβαση ενός οδηγού: σβήστε το email του ή πατήστε
Απενεργοποίηση (κρατά το ιστορικό του).
Στο κινητό: άνοιγμα της σελίδας → μενού browser → «Προσθήκη στην αρχική οθόνη» για να ανοίγει σαν εφαρμογή.
8. Δημοσίευση στο Vercel
- Συνδέστε το GitHub repository στο vercel.com → Add New… → Project.
- Deploy — δεν χρειάζονται Environment Variables (βήμα 4). Κάθε νέο push στο GitHub κάνει
αυτόματα νέο deploy.
- Βάλτε τη διεύθυνση του Vercel στο Site URL / Redirect URLs (βήμα 3).
- Αν ορίσετε μεταβλητές
NEXT_PUBLIC_…, διαλέξτε τύπο Config (όχι Secret) και κάντε Redeploy:
ενσωματώνονται στο build.
9. Δεδομένα από την παλιά τοπική (offline) έκδοση
Η παλιά έκδοση αποθήκευε τα πάντα στον browser (localStorage). Ανοίξτε τη νέα εφαρμογή στον ίδιο
browser και στην ίδια διεύθυνση (π.χ. http://localhost:3000), συνδεθείτε ως Admin και πατήστε
«Μεταφορά στο Supabase». Οι οδηγοί αντιστοιχίζονται με το όνομα (οι νέοι δημιουργούνται
αυτόματα), ο ΦΠΑ υπολογίζεται ξανά από τη βάση και ένα αντίγραφο των παλιών δεδομένων μένει
στη συσκευή. Η μεταφορά μπορεί να ξανατρέξει χωρίς διπλοεγγραφές.
Συχνά προβλήματα
| Μήνυμα / πρόβλημα | Λύση |
|---|
| «Χρειάζεται σύνδεση με το Supabase» | Λάθος τιμή στις μεταβλητές ή στο lib/supabase/config.ts (βήμα 4). Μετά την αλλαγή: restart (npm run dev) ή Redeploy. |
| «Η βάση δεδομένων δεν έχει ρυθμιστεί» | Δεν έχει εκτελεστεί το SQL του βήματος 2. |
| «Δεν υπάρχει επικοινωνία με το Supabase» | Internet, λάθος URL ή παύση project: τα δωρεάν projects παγώνουν μετά από μέρες αδράνειας → supabase.com → Restore project. |
| Δεν έρχεται email επιβεβαίωσης | Ελέγξτε τα ανεπιθύμητα· χωρίς δικό σας SMTP το Supabase στέλνει μόνο σε μέλη της ομάδας (βήμα 3) — ή χρησιμοποιήστε την Επιλογή Β. |
| Ο σύνδεσμος του email οδηγεί σε σφάλμα | Ελέγξτε Site URL / Redirect URLs (βήμα 3). Αν ο σύνδεσμος άνοιξε σε άλλον browser, το email έχει επιβεβαιωθεί: απλώς συνδεθείτε. |
| Ο οδηγός δεν βλέπει πρόσκληση | Το email του δεν ταιριάζει με το «Email σύνδεσης» ή δεν το έχει επιβεβαιώσει. Διορθώστε το email στην «Επεξεργασία» και ο οδηγός να πατήσει «Ανανέωση». |
| «Ο λογαριασμός σας είναι ήδη οδηγός σε στόλο» | Κάθε λογαριασμός ανήκει σε έναν στόλο. Για άλλον στόλο χρειάζεται άλλο email (ή ο πρώτος ιδιοκτήτης σβήνει το email του οδηγού). |
| Ο οδηγός δεν μπορεί να διορθώσει ή να διαγράψει βάρδια | Οι οδηγοί διορθώνουν/διαγράφουν μόνο δικές τους καταχωρήσεις μέσα σε 24 ώρες· μετά μόνο ο admin. |
| Δύο ιδιοκτήτες στον ίδιο στόλο | Δεν υποστηρίζεται ακόμη: ένας ιδιοκτήτης (Admin) ανά στόλο. |
Παλιό Supabase project
Το SQL σταματά με μήνυμα αν βρει ήδη πίνακες profiles, drivers ή shifts. Αν θέλετε να κρατήσετε
το παλιό project χωρίς να χαθεί τίποτα, μετακινήστε πρώτα τους παλιούς πίνακες σε ξεχωριστό schema
(μαζί με τα ευρετήριά τους, εκτός API) και μετά τρέξτε το SQL:
create schema if not exists old_backup;
revoke all on schema old_backup from public, anon, authenticated;
alter table if exists public.profiles set schema old_backup;
alter table if exists public.drivers set schema old_backup;
alter table if exists public.shifts set schema old_backup;
Μια απλή μετονομασία (rename) δεν αρκεί: τα ευρετήρια κρατούν τα παλιά ονόματα (π.χ. profiles_pkey)
και συγκρούονται με τα νέα.
Ελέγξτε επίσης για παλιά triggers στους λογαριασμούς (που μπορεί να γράφουν στους παλιούς πίνακες):
select tgname from pg_trigger where tgrelid = 'auth.users'::regclass and not tgisinternal;
Όσα δεν είναι on_auth_user_created / on_auth_user_updated διαγράψτε τα με
drop trigger <όνομα> on auth.users;. Οι υπάρχοντες λογαριασμοί διατηρούνται και ο ιδιοκτήτης
γίνεται Admin με το κουμπί του βήματος 6.
Για developers
app/ σελίδες (App Router): /, /login, /register, /forgot-password,
/update-password, /auth/callback, /welcome· manifest, εικονίδια, intro.css
components/dashboard/ Dashboard, φόρμα βάρδιας, στατιστικά, ιστορικό, στόλος, ουρά αποστολής
components/intro/ κίνηση ανοίγματος, «Καλώς ήρθατε», εγκατάσταση στο κινητό, service worker
public/sw.js, offline.html service worker και η σελίδα «Χωρίς σύνδεση»
scripts/icons.mjs PNG εικονίδια (Android, iPhone) από τα SVG
lib/accounting.ts λογιστικοί υπολογισμοί (σε λεπτά) — ίδιοι με τη βάση
lib/chart.ts, table.ts δεδομένα γραφήματος και πίνακα «Αναλυτικά» (ανά βάρδια / μήνα / οδηγό)
lib/expenses.ts έξοδα οχήματος (είδη, φόρμα)
lib/fixed-costs.ts πάγια έξοδα ανά αυτοκίνητο (μηνιαία ποσά, μόνο πληροφοριακά)
lib/platforms.ts εφαρμογές (ποσοστό, αυτόματη προμήθεια και έλεγχος, εβδομάδες του μήνα, τιμολόγιο ή εβδομάδες, φόρμα)
lib/csv.ts, whatsapp.ts εξαγωγή Excel και μήνυμα WhatsApp
lib/backup.ts, xlsx.ts αντίγραφο ασφαλείας (Excel με όλους τους πίνακες, χωρίς βιβλιοθήκη· υπενθύμιση 30 ημερών)
lib/zgaps.ts «Λείπει Ζ»: κενά στα Ζ κάθε οδηγού
lib/supabase/ clients (browser/server) και ανανέωση συνεδρίας για τον proxy
proxy.ts ανανέωση συνεδρίας & ανακατεύθυνση στο /login (Next.js 16: πρώην middleware)
supabase/migrations/ σχήμα βάσης, υπολογιζόμενες στήλες, triggers, RLS
supabase/tests/ tests ασφαλείας/λογιστικής της βάσης (pgTAP)
e2e/ πλήρης αυτόματος έλεγχος στον browser (Playwright): run.sh, run.mjs
| Εντολή | |
|---|
npm run dev | εκτέλεση για ανάπτυξη |
npm test | unit tests (λογιστική, έξοδα οχήματος, πίνακας/γράφημα, CSV, WhatsApp, φόρμα, μεταφορά δεδομένων) |
npm run lint / npm run typecheck | έλεγχοι κώδικα |
npm run build | production build |
npm run db:start | τοπικό Supabase (χρειάζεται Docker) |
npm run db:reset | επαναδημιουργία τοπικής βάσης από τα migrations |
npm run db:test | tests της βάσης: ποιος βλέπει τι, ΦΠΑ, triggers |
npm run db:types | TypeScript τύποι από την τοπική βάση (lib/database.types.ts) |
bash e2e/run.sh | πλήρης αυτόματος έλεγχος στον browser (ιδιοκτήτης/οδηγοί, κινητό/υπολογιστής) σε τοπική βάση δοκιμών — χρειάζεται Docker |
Για τοπικό Supabase: npm run db:start, και στο .env.local βάλτε το API_URL και το
PUBLISHABLE_KEY που εμφανίζει η εντολή. Τα email επιβεβαίωσης φαίνονται στο Mailpit
(http://127.0.0.1:54324).
