Author: blancberger
License: Apache License 2.0
A modern, full-stack web application designed for custom luthier guitar workshops. Features an interactive Custom Guitar Builder, product catalog with filtering and search, persistent shopping cart, order checkout, and a comprehensive Admin Management Panel.
Αυτή είναι η πιο απλή μέθοδος, καθώς το Docker αναλαμβάνει αυτόματα την εγκατάσταση της PostgreSQL 16, του FastAPI Backend και του Astro Frontend.
- Docker Desktop ή Docker Engine & Docker Compose.
-
Λήψη του έργου (Clone):
git clone https://github.com/blancberger/guitar-workshop.git cd guitar-workshop -
Εκκίνηση όλων των υπηρεσιών:
docker compose up --build
-
Πρόσβαση στις Εφαρμογές:
- Frontend App (Διεπαφή Χρήστη): 🌐 http://localhost:4321
- Backend API Docs (Swagger UI): 📜 http://localhost:8000/api/v1/docs
- PostgreSQL Database: 🗄️
localhost:5433(User:postgres, Password:postgres, DB:guitar_workshop)
-
Τερματισμός Εφαρμογής:
docker compose down
Αν θέλετε να εκτελέσετε την εφαρμογή τοπικά χωρίς Docker:
- Node.js (v18.0+)
- Python (v3.11+)
# 1. Πλοήγηση στον φάκελο backend
cd backend
# 2. Δημιουργία και ενεργοποίηση virtual environment
python3 -m venv venv
source venv/bin/activate # Σε Windows: venv\Scripts\activate
# 3. Εγκατάσταση εξαρτήσεων
pip install -r requirements.txt
# 4. Αρχικοποίηση & Seed της Βάσης Δεδομένων με αρχικά προϊόντα
python3 app/seed.py
# 5. Εκκίνηση του FastAPI Server
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reloadΑνοίξτε ένα νέο τερματικό:
# 1. Πλοήγηση στον φάκελο frontend
cd frontend
# 2. Εγκατάσταση Node dependencies
npm install
# 3. Εκκίνηση του Astro development server
npm run devΗ εφαρμογή θα είναι διαθέσιμη στο http://localhost:4321.
- Αναζητήστε κιθάρες και αξεσουάρ μέσω της μπάρας αναζήτησης.
- Φιλτράρετε ανά κατηγορία (Κλασικές Κιθάρες, Ακουστικές Κιθάρες, Αξεσουάρ & Φροντίδα).
- Προσθέστε προϊόντα στο καλάθι αγορών σας με ένα κλικ.
- Επιλέξτε τύπο κιθάρας (Κλασική ή Ακουστική).
- Διαμορφώστε βήμα-βήμα τα ξύλα (Spruce, Cedar, Rosewood, Ebony), το βερνίκι, τα κλειδιά χορδίσματος και τη θήκη.
- Δείτε τη ζωντανή προεπισκόπηση Vector SVG και τον υπολογισμό τιμής σε πραγματικό χρόνο.
- Υποβάλετε την προσαρμοσμένη παραγγελία σας στο εργαστήριο.
- Διαχειριστείτε την ποσότητα των προϊόντων στο καλάθι.
- Συμπληρώστε τα στοιχεία αποστολής και ολοκληρώστε την παραγγελία σας.
- Συνδεθείτε ως Διαχειριστής (
ADMIN). - Δείτε στατιστικά πωλήσεων, συνολικά έσοδα και εκκρεμείς custom παραγγελίες.
- Ενημερώστε την κατάσταση παραγγελιών (
PENDING➔CONFIRMED➔SHIPPED➔COMPLETED).
Η εφαρμογή διατίθεται υπό την άδεια Apache License 2.0 με δημιουργό (Author) τον blancberger.
cd backend
PYTHONPATH=. python3 -m pytest -v- Υπεραναλυτικό Τεχνικό Εγχειρίδιο:
docs/TECHNICAL_MANUAL.md - ERD Diagram:
docs/ERD/database_schema.md - Architecture Diagram:
docs/architecture/system_architecture.md - Postman Collection:
docs/postman/luthier_workshop.postman_collection.json - UI Screenshots:
docs/screenshots/README.md
I must thank CF9 and Google for this ... - blancberger @2026





