WGprime
Student Housing Platform for Germany
A full-stack housing platform built for international students arriving in Germany — multilingual AI-guided apartment search, bed-level Stripe booking, and the cleanest onboarding path to German student life.
Three barriers every international student hits on day one
Moving to Germany for university means hitting three compounding problems at once: the system gap (WG, Kaution, Anmeldung, SCHUFA — concepts invisible to anyone arriving from outside Europe), the accessibility gap (rental listings, contracts, and landlord communication designed entirely for local residents), and the trust problem (how do you pay a deposit securely from abroad, to someone you've never met, for an apartment you've never seen?). The market wasn't built for this journey — international arrivals spent weeks searching with no context and no support.
- Rental platforms German-only — international tenants can't filter or negotiate effectively
- No guidance on the German rental process: Kaution, Anmeldung, WG rules, SCHUFA
- Zero trust layer — paying deposits internationally to unknown landlords is high-risk
- Shared apartments listed as single units — no visibility into individual bed availability
- Client managing all listings and tenant communication via email and spreadsheets
Built to solve what the market hadn't addressed
Germany's student housing market has grown significantly, but no platform was purpose-built for the international arrival experience. The gap was clear: international arrivals needed a platform built around their journey — guiding them through the German rental system, handling payments securely, and providing AI-assisted search — all in one place. WGprime was built to fill exactly that gap.
A guided housing platform built for the international student journey
WGprime is a full-stack housing platform purpose-built for international students arriving in Germany. It combines multilingual apartment search (English + German), an AI chatbot with zero hallucinations for apartment guidance and German rental Q&A, a 3-level bed booking system with individual bed photos and per-bed pricing, Stripe payments with fraud prevention, and a complete admin panel for the client to manage listings and tenants.
Agentic RAG Chatbot
Llama 3.3 70B via Groq API with 3 specialized tools — SQL filters, semantic search, and apartment detail lookup. Zero hallucinations by design: the AI can only respond with tool-verified data. No guessing.
Bed-Level Booking System
3-level hierarchy: Apartment → Bedroom → Bed. Tenants select individual beds with photos and per-bed pricing. PostgreSQL exclusion constraints prevent double-booking at the database level — no application-level race conditions.
Stripe Payments
15-minute booking hold with auto-expiry. Stripe webhook validation, fraud prevention (bed-belongs-to-bedroom check), refund support, and booking confirmation emails via Resend.
Multilingual (EN + DE)
Full next-intl internationalization — 300+ translation keys across English and German. Every UI string, error message, and admin label translated. No raw keys visible to users.
Admin Panel
Complete management system: apartment CRUD, bedroom and bed management, booking management with refunds, tenant and waitlist management, RBAC (ADMIN + SUPER_ADMIN), unsaved changes protection on all forms.
Germany Onboarding Intelligence
The AI chatbot guides international tenants through the German rental process — explaining Kaution, Anmeldung, WG rules, and what to expect — removing the knowledge gap for every arrival.
Tech Stack
A live platform with real tenants and real apartments
Discovery & Student Journey Mapping
Mapped the full international student arrival experience in Germany — from first Google search to moving in. Identified the three critical barriers (language, system complexity, trust) and defined the product scope: multilingual AI chatbot + bed-level booking + Stripe + admin panel. Chose the free-tier infrastructure stack to minimize operational cost for the client from day one.
Architecture & Tech Stack Design
Designed the full-stack architecture: Next.js 15 App Router with locale-based routing (next-intl) for multilingual support, FastAPI backend for the AI/RAG system, PostgreSQL via Neon with Prisma ORM for type-safe queries, and FAISS for vector search. Key decision: Groq API (Llama 3.3 70B) for the chatbot — free tier, tool calling support, and zero-hallucination design via Agentic RAG.
Agentic RAG Chatbot Build
Built the zero-hallucination chatbot using an Agentic RAG architecture with 3 specialized tools: SQL filter tool for exact requirements (price, city, type), semantic search tool for descriptive queries (FAISS + sentence-transformers), and apartment detail lookup tool. The LLM can only respond with data returned by tools — no guessing. SSE streaming for real-time chat responses. Validated against edge cases: wrong city, unavailable dates, vague queries.
Bed-Level Booking & Stripe Integration
Built the 3-level booking hierarchy: Apartment → Bedroom → Bed. Each bed has its own Cloudinary-hosted photo, per-bed pricing, and availability calendar. PostgreSQL exclusion constraints prevent double-booking at the database level. Stripe integration with 15-minute hold, auto-expiry, webhook validation, fraud prevention (bed-belongs-to-bedroom check), refund support, and booking confirmation emails via Resend.
Admin Panel & Role-Based Management
Built a complete admin panel: apartment CRUD with full bedroom and bed management, booking management with refund capability, tenant and waitlist management, RBAC (ADMIN and SUPER_ADMIN roles), unsaved changes protection on all forms with custom confirmation dialogs, and manual tenant creation with auto-generated passwords and instant email notification. German-language UI throughout per client requirements.
Launch, Localization & Live Onboarding
Final localization pass across all English and German translation files — 300+ translation keys, zero raw keys visible to users. Deployed frontend to Vercel, backend to VPS, database to Neon. Client onboarded 20+ live apartment listings. Platform now handling daily tenant traffic with healthy booking activity. AI chatbot actively guiding international students through apartment search and the German rental process.
How an international student goes from search to signed — entirely in their language.
Discovery
- Multilingual Landing Page
- City & University Filters
- Price Range Filtering
- Interactive Maps (Leaflet)
AI Guidance
- Agentic RAG Chatbot
- SQL + Semantic Search
- Germany Rental Q&A
- Zero Hallucination Design
Bed Selection
- Apartment → Bedroom → Bed
- Individual Bed Photos
- Availability Calendar
- Per-Bed Pricing
Secure Payment
- Stripe Checkout
- 15-min Booking Hold
- Fraud Prevention
- Webhook Validation
Onboarding
- Booking Confirmation Email
- Tenant Profile Setup
- Germany Arrival Support
- Admin-Managed Handoff
Work With Us
Have a similar challenge?
Whether it's a data platform, an AI-powered product, or a full build from scratch — we turn complex problems into clean, working software.