🛵 Unlimited Inventory

Een geavanceerd voorraadbeheersysteem voor Unlimited Scooter Service, gebouwd met een moderne tech-stack voor snelheid, betrouwbaarheid en een premium gebruikerservaring.

🚀 Overzicht

Unlimited Inventory is een agentic-first webapplicatie ontworpen om de dagelijkse operaties van een scooter garage te stroomlijnen. Het systeem combineert krachtig voorraadbeheer met AI-ondersteuning, leveranciersbeheer en real-time statistieken.

---

✨ Belangrijkste Functies

📦 Voorraadbeheer

• Volledige CRUD: Beheer scooters en onderdelen met gedetailleerde metadata (serienummers, artikelnummers, notities).
• Geavanceerde Filters: Filter op type, status, prijsbereik en voorraadniveau.
• Merk-specifieke Zoekopdrachten: Filter onderdelen direct op scooter merk (bijv. Vespa, Piaggio, Honda).
• Live Quick-Search: Open direct een zoekvenster door te typen op elk scherm.

🤖 AI Assistentie

• Stockbot AI: Een intelligente assistent die vragen beantwoordt over de voorraad en helpt bij het schrijven van productteksten.
• Troubleshoot Assistent: Een gespecialiseerde AI voor het diagnosticeren van technische scooterproblemen.
• Berichtbeheer: Mogelijkheid om belangrijke AI-antwoorden te kopiëren of op te slaan als bladwijzer.

📊 Statistieken & Beveiliging

• Real-time Dashboard: Direct inzicht in totale voorraadwaarde, aantal items en unieke producten.
• Code Beveiliging: De financiële statistieken zijn beveiligd met een 4-cijferige pincode (instelbaar via instellingen).
• Privacy Mode: Statistieken zijn standaard ingeklapt voor extra privacy op de werkvloer.

🏢 Leveranciersbeheer

• Centraal beheer van contactgegevens voor alle onderdelenleveranciers.
• Directe koppeling tussen producten en hun leveranciers.

🛵 Scooter Verkoop Module

• Volledige Scooter Administratie: Beheer de scooters die te koop staan met inkoop-, vraag- en verkoopprijzen.
• Status Tracking: Volg scooters door hun hele lifecycle (Beschikbaar, Verkocht, In Reparatie, etc.).
• Winstmarge Dashboard: Real-time inzicht in totale winst, beschikbare voorraad en gemiddelde marges.
• Kleur & Kenteken: Uitgebreide metadata per scooter (merk, model, kleur, bouwjaar, kenteken).

📱 QR Scanner (Mobiel)

• Razendsnel Scannen: Open de camera-overlay en scan QR-codes voor instant voorraad updates.
• Quick Update Kaart: Mobile-first bottom sheet voor +1/-1 voorraadbeheer met haptic feedback.
• Direct Voorraad: Mutaties worden direct doorgevoerd in de Firestore database.

📄 Geavanceerde Facturatie

• Reparatie Import: Automatische import van gebruikte onderdelen en arbeid vanuit de reparatieplanner.
• BTW Breakdown: Duidelijke opsplitsing van 21% en 9% BTW tarieven per factuur.
• Voorraadbeheer Sync: Bij het opslaan van een factuur wordt de voorraad automatisch bijgewerkt.
• Markeer als Betaald: Snelle actie om facturen en gekoppelde reparaties op 'Betaald' te zetten.
• Premium PDF Export: Professionele, printklare facturen met geforceerde lichte modus.

🗓️ Reparatie Planner

• Volledig geïntegreerde kalender voor reparatie-afspraken.
• Koppeling naar factuurmodule met automatische doorvoer van gebruikte onderdelen.
• Status tracking (Gepland → Voltooid → INVOICED → Betaald).

⚙️ Module Zichtbaarheid

• Configureerbaar: Toon of verberg modules (Dashboard, Planner, Facturen, Verkoop, Scanner) via instellingen.
• Dynamische Navigatie: Het menu past zich automatisch aan aan je zichtbaarheidsinstellingen.

---

🛠 Tech Stack

Frontend

• Framework: React 18 + TypeScript + Vite
• Styling: Tailwind CSS (Premium Glassmorphism)
• Animaties: Framer Motion
• Icons: Lucide React
• QR Scanner: html5-qrcode
• PDF Generatie: jsPDF + html2canvas
• Recharts: Analytics visualisatie

Backend (FastAPI)

• Framework: FastAPI (Python 3.11+)
• Async I/O: anyio voor non-blocking Firestore operaties
• Database: Google Cloud Firestore (NoSQL)
• AI Engine: OpenAI API (GPT-4o)
• Environment: python-dotenv

---

⚙️ Installatie & Setup

1. Repository Clonen

git clone https://github.com/parvenuprompting/unlimited-inventory.git
cd unlimited-inventaris-beta-II

2. Afhankelijkheden Installeren

npm install

3. Omgevingsvariabelen

Frontend (.env in root)

Maak een .env bestand in de root met de volgende gegevens:

VITE_API_URL=http://localhost:8000
VITE_OPENAI_API_KEY=jouw_openai_sleutel
VITE_FIREBASE_API_KEY=jouw_firebase_key
VITE_FIREBASE_AUTH_DOMAIN=...
VITE_FIREBASE_PROJECT_ID=...
VITE_FIREBASE_STORAGE_BUCKET=...
VITE_FIREBASE_MESSAGING_SENDER_ID=...
VITE_FIREBASE_APP_ID=...
VITE_FIREBASE_MEASUREMENT_ID=...

Backend (.env in /backend)

Maak een .env bestand in de backend/ map:

FIREBASE_SERVICE_ACCOUNT=pad/naar/service-account.json
OPENAI_API_KEY=jouw_openai_sleutel

4. Backend Setup

cd backend
python3 -m venv venv
source venv/bin/activate  # Op Windows: venv\Scripts\activate
pip install -r requirements.txt

5. Development Servers Starten

Frontend (Terminal 1)

npm run dev

Backend (Terminal 2)

cd backend
source venv/bin/activate
python main.py
# Of met uvicorn:
# uvicorn main:app --reload --port 8000

De frontend draait op http://localhost:5173 en de backend op http://localhost:8000.

---

🎨 Design Filosofie

De interface maakt gebruik van een Premium Glassmorphism esthetiek met:

• Geanimeerde achtergrondpatronen (scooter-lijnillustraties).
• Een dieprode navigatiebalk die past bij de branding van Unlimited.
• Vloeiende micro-interacties voor een moderne "Vibe Coding" ervaring.

---

📝 Licentie

© 2026 Unlimited Scooter Service. Alle rechten voorbehouden.