🚕 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%. Όλος ο στόλος: όρια ανάλογα με τα χλμ κάθε αυτοκινήτου ()

This is the beginning of the README. Read the rest at the original. Read the full README ↗