Enterprise Level QR-Based Room Service App for Luxury Hotels

TITLE: Full-Stack Developer Needed — Enterprise QR-Based Room Dining & Ordering Platform for Hospitality

---

OVERVIEW

We are building an enterprise-grade, QR code-driven room dining and ordering platform for deployment across luxury hotel properties in India. This is not a one-off project — it is the foundation of a scalable hospitality SaaS product that will grow in scope and capability over time. We are looking for a serious, experienced full-stack developer who can build this to production standards from the ground up.

The immediate use case: guests in a hotel room scan a QR code, which opens a web application showing the property's restaurant menu. They browse, select items, manage their cart, and place an order. The order is then dispatched to the hotel's POS system via API integration. The system must be architected so that it can integrate with any POS system through a standardised, open API layer — not hardcoded to any single vendor.

This project is being developed for deployment at a flagship luxury hotel property, so quality, reliability, and design polish are non-negotiable.

---

WHAT YOU WILL BUILD

1. Guest-Facing Web Application
- Mobile-first progressive web app (PWA) that opens via QR code scan
- QR codes are room-specific; the app must read the room number from the URL and carry it through the entire order flow
- Menu browsing by category, item detail view with description and pricing
- Cart management with quantity controls and special instructions field
- Checkout flow with order confirmation and estimated delivery time
- Support for multiple languages (English to start, architecture must support i18n)
- Must function on all modern mobile browsers with no app installation required

2. Admin Dashboard
- Secure, role-based web dashboard for hotel staff and management
- Menu management: add, edit, remove items and categories; toggle item availability in real time
- Order management: live view of incoming orders with status tracking (received, in preparation, dispatched, delivered)
- Room and QR code management: generate, assign, and download QR codes per room number
- Basic reporting: order volume, popular items, revenue summaries
- Multi-property support: the system must be architected to support multiple hotel properties under one platform from day one

3. Backend API & Database
- RESTful API built to production standards with proper versioning (e.g. /api/v1/)
- PostgreSQL database with a clean, normalised schema
- Authentication and authorisation: JWT-based, with role separation (super admin, property admin, staff)
- Full audit logging of all order and menu change events
- Webhook support so that external systems can subscribe to order events
- Rate limiting, input validation, and proper error handling throughout

4. POS Integration Layer (Critical Requirement)
- A standardised, open integration layer that can connect to any hotel POS system
- This must be built as an abstracted adapter/connector architecture — the core system must never be tightly coupled to any single POS vendor
- The integration layer must expose a clean internal interface that a new POS connector can implement with minimal effort
- First integration will be scoped and defined separately; the architecture must make future integrations straightforward
- Full API documentation for the integration layer must be delivered

5. QR Code Generation
- Bulk QR code generation per property and room
- QR codes must encode room-specific URLs
- Export as print-ready PDF and individual PNG files

---

TECHNICAL REQUIREMENTS

Stack (preferred, open to discussion):
- Frontend: Next.js (React) — guest app and admin dashboard
- Backend: Node.js with Express or a similar production-grade framework
- Database: PostgreSQL
- Hosting-ready for deployment on AWS, Google Cloud, or Azure
- Containerised with Docker for portability
- CI/CD pipeline setup (GitHub Actions or equivalent)

Code quality standards:
- All code must be committed to a private GitHub repository with clear commit history
- Codebase must be modular and well-documented — a new developer must be able to onboard without significant friction
- Environment variables for all secrets and configuration — no hardcoded credentials anywhere
- Unit and integration tests for all critical paths

Security requirements:
- HTTPS enforced across all endpoints
- OWASP Top 10 awareness and mitigations applied
- Secure handling of all API keys and third-party credentials
- No guest-facing endpoint should expose internal system identifiers

---

DELIVERABLES

- Fully functional guest web app, admin dashboard, and backend API
- POS integration adapter architecture with documentation
- Database schema with migration files
- API documentation (Swagger / OpenAPI spec)
- Deployment guide and environment setup instructions
- Source code in a private GitHub repository with full history
- A working staging environment for review and testing

---

WHO WE ARE LOOKING FOR

- Minimum 3 years of professional full-stack development experience
- Strong portfolio of production web applications — please share links or case studies
- Proven experience with REST API design and third-party API integrations
- Experience building multi-tenant SaaS products is a strong advantage
- Experience in the hospitality tech space (POS, PMS, or F&B systems) is a significant advantage but not required
- Clear, professional communication in English — you will be working closely with a non-technical founder and must be able to explain decisions simply
- Ability to deliver on agreed milestones with clear progress updates

---

PROJECT STRUCTURE

This is a serious, paid engagement. We are not looking for the cheapest bid — we are looking for the right developer. Budget proposals should be milestone-based. We expect the project to be scoped in phases, with Phase 1 covering the core guest app, admin panel, and backend API, and Phase 2 covering the POS integration layer.

Long-term relationship: developers who perform well on this project will be first in line for ongoing development work as the platform grows.

Please include the following in your proposal:
1. A brief summary of your relevant experience
2. Your proposed tech stack and any deviations from the preferred stack above, with reasoning
3. A rough milestone breakdown with timeline estimates
4. Your rate (hourly or fixed project price)
5. Links to 2-3 relevant past projects

Applications without a proposal structure will not be considered.