Skip to content

About

full-stack web application (MVP) designed for custom luthier guitar workshops

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

25 Commits

Folders and files

Repository files navigation

🎸 Luthier Workshop Management System

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.


📸 Στιγμιότυπα Εφαρμογής (Screenshots)

Landing Page Κατάλογος Προϊόντων
Custom Guitar Builder Σελίδα Σύνδεσης
Admin Dashboard Διαχείριση Παραγγελιών

📖 Εγχειρίδιο Οδηγιών Χρήσης & Εκτέλεσης (Step-by-Step User Manual)


🚀 Μέθοδος 1: Εκτέλεση μέσω Docker Compose (Συνιστάται)

Αυτή είναι η πιο απλή μέθοδος, καθώς το Docker αναλαμβάνει αυτόματα την εγκατάσταση της PostgreSQL 16, του FastAPI Backend και του Astro Frontend.

📋 Προαπαιτούμενα:

🛠️ Βήματα Εκτέλεσης:

  1. Λήψη του έργου (Clone):

    git clone https://github.com/blancberger/guitar-workshop.git
    cd guitar-workshop
  2. Εκκίνηση όλων των υπηρεσιών:

    docker compose up --build
  3. Πρόσβαση στις Εφαρμογές:

  4. Τερματισμός Εφαρμογής:

    docker compose down

💻 Μέθοδος 2: Τοπική Εκτέλεση (Local Development without Docker)

Αν θέλετε να εκτελέσετε την εφαρμογή τοπικά χωρίς Docker:

📋 Προαπαιτούμενα:

  • Node.js (v18.0+)
  • Python (v3.11+)

🛠️ Βήμα 1: Εκκίνηση Backend Server

# 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

🛠️ Βήμα 2: Εκκίνηση Frontend Application

Ανοίξτε ένα νέο τερματικό:

# 1. Πλοήγηση στον φάκελο frontend
cd frontend

# 2. Εγκατάσταση Node dependencies
npm install

# 3. Εκκίνηση του Astro development server
npm run dev

Η εφαρμογή θα είναι διαθέσιμη στο http://localhost:4321.


👤 Οδηγός Χρήσης Εφαρμογής (How to Use)

1. 🛍️ Περιήγηση στον Κατάλογο Προϊόντων (/products)

  • Αναζητήστε κιθάρες και αξεσουάρ μέσω της μπάρας αναζήτησης.
  • Φιλτράρετε ανά κατηγορία (Κλασικές Κιθάρες, Ακουστικές Κιθάρες, Αξεσουάρ & Φροντίδα).
  • Προσθέστε προϊόντα στο καλάθι αγορών σας με ένα κλικ.

2. 🎨 Διαδραστικός Custom Guitar Builder (/custom-builder)

  • Επιλέξτε τύπο κιθάρας (Κλασική ή Ακουστική).
  • Διαμορφώστε βήμα-βήμα τα ξύλα (Spruce, Cedar, Rosewood, Ebony), το βερνίκι, τα κλειδιά χορδίσματος και τη θήκη.
  • Δείτε τη ζωντανή προεπισκόπηση Vector SVG και τον υπολογισμό τιμής σε πραγματικό χρόνο.
  • Υποβάλετε την προσαρμοσμένη παραγγελία σας στο εργαστήριο.

3. 🛒 Καλάθι & Checkout (/cart, /checkout)

  • Διαχειριστείτε την ποσότητα των προϊόντων στο καλάθι.
  • Συμπληρώστε τα στοιχεία αποστολής και ολοκληρώστε την παραγγελία σας.

4. ⚙️ Διαχείριση Admin Panel (/admin)

  • Συνδεθείτε ως Διαχειριστής (ADMIN).
  • Δείτε στατιστικά πωλήσεων, συνολικά έσοδα και εκκρεμείς custom παραγγελίες.
  • Ενημερώστε την κατάσταση παραγγελιών (PENDING ➔ CONFIRMED ➔ SHIPPED ➔ COMPLETED).

📜 Άδεια Χρήσης & Εμπορική Εκμετάλλευση (License & Commercial Rights)

Η εφαρμογή διατίθεται υπό την άδεια Apache License 2.0 με δημιουργό (Author) τον blancberger.


🧪 Εκτέλεση Automated Tests

cd backend
PYTHONPATH=. python3 -m pytest -v

📁 Τεκμηρίωση & Αρχιτεκτονική


I must thank CF9 and Google for this ... - blancberger @2026

About

full-stack web application (MVP) designed for custom luthier guitar workshops

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages