About this project

MCQ Entertainments — Hire Website is a Node 20 application that provides a public customer website and hire backend for MCQ Entertainments Ltd. It includes a mobile-responsive hire catalogue, availability checks, a hire enquiry flow, and automatic draft quote generation when a real inventory item is selected. Existing deposit and booking rules are preserved. The project also offers a live supplier directory with direct links to Farnell, CPC, Canford Audio, Thomann UK, and Gear4music. When a Farnell API key is configured, the application can call the official element14 Product Search API for the UK Farnell catalogue; otherwise it falls back to a live Farnell product-search link. Administrative operations are protected by a bearer token, covering equipment, payment-confirmation, and booking mutations. The current persistence layer is a JSON file store, suitable for local or single-server use, with a production note recommending migration to PostgreSQL before multi-instance deployment. A Docker image is provided for AWS or container deployment. The repository includes tests for core hire rules, and the README documents the current truth status of coded, tested, and not-yet-deployed components.