Initial upload of BB-Apartment 2026 website.
Adds the complete Next.js website including i18n routing, house and apartment pages, Beds24 v2 integration for live availability/pricing, Stripe checkout, contact forms, Docker setup and deployment docs. Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
This commit is contained in:
Markus
co-authored by
Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
parent
232770afe7
commit
2b24334bfa
@@ -1,36 +1,145 @@
|
||||
This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
|
||||
# BB-Apartment Website
|
||||
|
||||
## Getting Started
|
||||
Zweisprachige (DE/EN), buchungsfähige Website für BB-Apartment mit Next.js, Tailwind CSS, Beds24-Integration, Stripe-Zahlung und n8n-Automatisierung.
|
||||
|
||||
First, run the development server:
|
||||
## Technologie-Stack
|
||||
|
||||
```bash
|
||||
npm run dev
|
||||
# or
|
||||
yarn dev
|
||||
# or
|
||||
pnpm dev
|
||||
# or
|
||||
bun dev
|
||||
- **Framework:** Next.js 14 (App Router, TypeScript)
|
||||
- **Styling:** Tailwind CSS
|
||||
- **Internationalisierung:** next-intl (Deutsch/Englisch)
|
||||
- **Zahlungen:** Stripe Checkout (Anzahlung) + Stripe Billing (monatliche Rechnungen) + Stripe Customer Portal
|
||||
- **PMS:** Beds24 API
|
||||
- **Workflows:** n8n (Self-Hosted)
|
||||
- **Datenbank:** PostgreSQL (via Prisma)
|
||||
- **Deployment:** Docker Compose auf eigenem Server
|
||||
|
||||
## Projektstruktur
|
||||
|
||||
```
|
||||
app/[locale]/ # Öffentliche Seiten (i18n-Routing)
|
||||
app/api/ # API-Endpunkte (Beds24, Stripe, Portal)
|
||||
components/ # React-Komponenten
|
||||
messages/ # Übersetzungsdateien (de.json, en.json)
|
||||
prisma/ # Prisma Schema
|
||||
public/images/ # Bilder & Logo
|
||||
src/config/ # Apartment-Konfiguration & Preislogik
|
||||
src/lib/ # API-Clients (Beds24, Stripe, Prisma)
|
||||
```
|
||||
|
||||
Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
|
||||
## Lokal entwickeln
|
||||
|
||||
You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
|
||||
1. Abhängigkeiten installieren:
|
||||
```bash
|
||||
npm install
|
||||
```
|
||||
|
||||
This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
|
||||
2. Umgebungsvariablen kopieren und ausfüllen:
|
||||
```bash
|
||||
cp .env.local.example .env.local
|
||||
```
|
||||
|
||||
## Learn More
|
||||
3. Datenbank migrieren (lokale Postgres oder Docker):
|
||||
```bash
|
||||
npx prisma migrate dev
|
||||
```
|
||||
|
||||
To learn more about Next.js, take a look at the following resources:
|
||||
4. Dev-Server starten:
|
||||
```bash
|
||||
npm run dev
|
||||
```
|
||||
|
||||
- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
|
||||
- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
|
||||
Die Seite ist unter `http://localhost:3000/de` bzw. `http://localhost:3000/en` erreichbar.
|
||||
|
||||
You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
|
||||
## Produktiv-Deployment (Docker Compose)
|
||||
|
||||
## Deploy on Vercel
|
||||
1. `.env.local` auf dem Server mit echten Werten befüllen.
|
||||
|
||||
The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
|
||||
2. Container starten:
|
||||
```bash
|
||||
docker compose up -d --build
|
||||
```
|
||||
|
||||
Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
|
||||
Dies startet:
|
||||
- Next.js App auf Port 3000
|
||||
- PostgreSQL
|
||||
- n8n auf Port 5678
|
||||
|
||||
3. Erste Datenbank-Migration im Container ausführen:
|
||||
```bash
|
||||
docker compose exec nextjs npx prisma migrate deploy
|
||||
```
|
||||
|
||||
## Wichtige API-Endpunkte
|
||||
|
||||
- `GET /api/availability?apartmentSlug=...&start=YYYY-MM-DD&end=YYYY-MM-DD`
|
||||
Verfügbarkeit und Preis (inkl. Rabatt/Anzahlung)
|
||||
- `POST /api/checkout-session`
|
||||
Stripe Checkout für Anzahlung erstellen
|
||||
- `POST /api/portal-session`
|
||||
Stripe Customer Portal für Rechnungen/Adresse
|
||||
- `POST /api/webhooks/stripe`
|
||||
Stripe Webhook Empfänger
|
||||
- `GET /api/rooms`
|
||||
Apartment-Informationen aus Beds24
|
||||
|
||||
## Konfiguration
|
||||
|
||||
### Apartments
|
||||
|
||||
Die 8 Apartments mit Beds24 Property-/Room-IDs sind in `src/config/apartments.ts` hinterlegt:
|
||||
|
||||
- **Herdweg** (Property-ID `121184`): 4 Apartments
|
||||
- **Schönaicher Straße** (Property-ID `36159`): 4 Apartments
|
||||
|
||||
### Preise & Anzahlung
|
||||
|
||||
Rabattstaffel und Anzahlungshöhe sind in `src/config/apartments.ts` (`bookingConfig`) zentral konfigurierbar:
|
||||
|
||||
- Mindestaufenthalt: 20 Tage
|
||||
- Standard-Rabatte: 30 Nächte = 5%, 60 Nächte = 10%, 90 Nächte = 15%
|
||||
- Anzahlung: 20% der Gesamtkosten
|
||||
|
||||
### Stripe
|
||||
|
||||
Pro Haus wird ein separates Stripe-Konto verwendet. Die API-Keys und Webhook-Secrets müssen in `.env.local` hinterlegt werden.
|
||||
|
||||
### Beds24
|
||||
|
||||
Die Anbindung nutzt **Beds24 API v2** (Token-Auth), siehe Kommentare in `src/lib/beds24.ts`.
|
||||
|
||||
**Jedes Haus hat einen eigenen, separaten Beds24-Zugang** (eigener Login, nicht nur eine eigene Unterkunft innerhalb eines Accounts) — analog zu den pro Haus getrennten Stripe-Konten. Es werden daher zwei Invite-Codes/Refresh-Tokens benötigt:
|
||||
|
||||
1. In **jedem** der beiden Beds24-Konten: Settings → Account → Apps/API → "Generate invite code" (Scope `inventory`, später auch `bookings` für automatische Buchungsanlage).
|
||||
2. Jeden Code einmalig gegen einen Refresh-Token tauschen:
|
||||
```bash
|
||||
curl -H "code: <invite-code>" https://api.beds24.com/v2/authentication/setup
|
||||
```
|
||||
3. Die zurückgegebenen `refreshToken`-Werte als `BEDS24_REFRESH_TOKEN_HERDWEG` bzw. `BEDS24_REFRESH_TOKEN_SCHOENAICHER` in `.env.local` hinterlegen.
|
||||
|
||||
Jeder Refresh-Token bleibt gültig, solange er mindestens alle 30 Tage einmal genutzt wird (passiert automatisch bei jedem Seitenaufruf mit Verfügbarkeitsprüfung für das jeweilige Haus). Ohne konfigurierten Token liefert der jeweilige Endpunkt Mock-Daten für die Entwicklung.
|
||||
|
||||
**Wichtig:** Die genaue Feldstruktur der Antwort von `/inventory/rooms/offers` und `/properties` wurde anhand der offiziellen Beds24-Dokumentation modelliert, aber noch nicht gegen einen echten Account verifiziert. Nach Eintragen der echten Tokens unbedingt einmal `/api/rooms` aufrufen und mit der Swagger-UI (https://beds24.com/api/v2/#/) abgleichen, ob Feldnamen wie `maxPeople`/`minNights` exakt passen.
|
||||
|
||||
## Nächste Schritte / Offene Punkte
|
||||
|
||||
- Für beide Häuser je einen echten Beds24-Refresh-Token hinterlegen und Antwortstruktur gegen Swagger-UI verifizieren
|
||||
- Stripe API-Keys & Webhooks für beide Häuser konfigurieren
|
||||
- n8n-Workflows für Buchungsbestätigung, Beds24-Buchungsanlage und monatliche Rechnungen bauen
|
||||
- E-Mail-Vorlagen (Deutsch/Englisch) finalisieren
|
||||
- Haus-/Apartment-Adressen vervollständigen
|
||||
- Optional: 3D-Rundgänge (Insta360) und KI-Assistent (OpenRouter) nach Go-Live
|
||||
|
||||
### Geplant: Monatliche Zahlweise (zurückgestellt)
|
||||
|
||||
Entscheidung: **Option A – automatisch per Stripe Subscription Schedule**, Monatsrate = (Gesamtpreis − Anzahlung) ÷ Anzahl Monate, gleichmäßig verteilt.
|
||||
|
||||
Umsetzungsschritte, sobald wir weitermachen:
|
||||
1. Bei der Anzahlungs-Checkout-Session `payment_intent_data.setup_future_usage: "off_session"` setzen, um die Karte zu speichern (inkl. klarer Einwilligungs-Formulierung für den Gast).
|
||||
2. Nach erfolgreicher Anzahlung (Webhook `checkout.session.completed`) automatisch einen Stripe **Subscription Schedule** mit fester Phasenzahl (= Aufenthaltsmonate) und `end_behavior: "cancel"` anlegen.
|
||||
3. Prisma-Schema um `stripeSubscriptionScheduleId` / `stripeSubscriptionId` auf `Booking` erweitern.
|
||||
4. Webhook um `invoice.paid` / `invoice.payment_failed` erweitern (Status-Update + Benachrichtigung bei Fehlschlag).
|
||||
5. Optional später: SEPA-Lastschrift als zusätzliche Zahlmethode ergänzen.
|
||||
|
||||
## Lizenz
|
||||
|
||||
Privat – alle Rechte vorbehalten.
|
||||
|
||||
Reference in New Issue
Block a user