BookDirect Docs

BookDirect DocsA property management system — and how to build it

Hotels, shortlets, and apartments are all properties. Frontend Marketplace is the guest app. Frontend Extranet is the partner app. IDOR lives on Core Backend API-key path settings and Middleware Backend — not on the Next.js app. The browse API key is public.

Frontend — Marketplace (guest)

Search, book, pay, manage a stay. Next.js App Router under app/(marketplace) and app/(guest). Each screen names one winner URL.

Frontend — Extranet (partner)

Onboard a property, rooms and rates, reservations. Next.js under app/extranet. Writes go through Middleware Backend when that folder exists.

Middleware Backend — processors

Properties, rates-packages, bookings, availability, payments, reservations, file-manager. Talks to third parties, then writes Core Backend.

Core Backend — source of truth

Users, JWT, and generic entities. Recommended usage only. No Paystack tables in Laravel.

Project Management

Turn a feature on — status, winner URL, ENV names, Core metadata. Not a product-manager story. Start with the activation matrix.

Pick your playbook

Each playbook is how to build that layer. Product can still read it as a story.

You are	Start here
Frontend (guest)	Frontend — Marketplace — Screens / Pages
Frontend (partner)	Frontend — Extranet — Screens / Pages
Middleware Backend	Logic / Functions — folders in `src/routes/`
Core Backend	Core Backend playbook — recommended usage, what not to add
Project Management	Activation matrix — status, winner, ENVs, Core metadata. Dates: Roadmap

You are

Start here

Frontend (guest)

Frontend — Marketplace — Screens / Pages

Frontend (partner)

Frontend — Extranet — Screens / Pages

Middleware Backend

Logic / Functions — folders in src/routes/

Core Backend

Core Backend playbook — recommended usage, what not to add

Project Management

Activation matrix — status, winner, ENVs, Core metadata. Dates: Roadmap

How the layers fit: Who calls what. Drafts: /next/.

Properties (PMS)

One Core Backend entity: property. Type is metadata / extra_data property_category: hotel | shortlet | apartment (Middleware also accepts villa | guesthouse).

Hotel (or apartment sold by unit) — rooms + rate plans

Shortlet (or apartment sold as a whole) — rates on the property

Do not create separate nll_hotel / nll_shortlet / nll_apartment tables.

BookDirect DocsA property management system — and how to build it

Frontend — Marketplace (guest)

Frontend — Extranet (partner)

Middleware Backend — processors

Core Backend — source of truth

Project Management

Pick your playbook ​

Properties (PMS) ​

Environments (dev) ​

Pick your playbook

Properties (PMS)

Environments (dev)