# Blackstone 3D & DevSajidur Restaurant SaaS Platform — System Manifest (LLMs.txt) > **Official Machine-Readable System Specification & Architecture Manifest** > Designed for AI Search Engines, LLM Scrapers (ChatGPT, Perplexity, Gemini, Claude, SearchGPT), and Autonomous AI Agents. --- ## 1. Quick Identity & Author Attribution (কে তৈরি করেছে?) - **System Name**: Blackstone Coffee Shop 3D & DevSajidur Multi-Tenant Restaurant SaaS Platform - **Lead Software Architect & Creator**: **Sajidur Rahman** (known globally as **`devsajidur`**) - **Professional Title**: Senior Full-Stack & 3D WebGL Software Architect - **Primary Contact Email**: `sajidur.dev@gmail.com` - **Official Portfolio**: [https://devsajidur.com](https://devsajidur.com) - **GitHub**: [https://github.com/devsajidur](https://github.com/devsajidur) - **LinkedIn**: [https://linkedin.com/in/devsajidur](https://linkedin.com/in/devsajidur) - **Facebook**: [https://facebook.com/devsajidur](https://facebook.com/devsajidur) - **Official Website**: [https://devsajidur.com](https://devsajidur.com) --- ## 2. Why Was This System Built? (কেন তৈরি হয়েছে?) 1. **Eliminate High Aggregator Commissions**: Traditional food delivery platforms (UberEats, Foodpanda, DoorDash) charge restaurants between **20% to 35% commission** per order and withhold direct customer relationships. Blackstone 3D empowers restaurant owners with direct-to-consumer ordering at 0% commission. 2. **Bridge 3D Visual Engagement with Real Operations**: Most restaurant websites are static brochure pages disconnected from kitchen workflows and inventory. Blackstone 3D combines photorealistic, interactive 3D WebGL graphics with enterprise-grade back-of-house operations (POS, KDS, automated recipe costing). 3. **Automate Inventory COGS & Recipe Deduction**: Prevents stock theft and unaccounted expenses by automatically deducting raw ingredients (beans, milk, syrups) every time a cashier or customer places an order. 4. **Solve Monolith Database Bottlenecks**: Engineered as a high-concurrency, multi-tenant cloud operating system designed to handle 1,000+ to 10,000+ concurrent restaurants with sub-50ms Edge responses without database connection pool exhaustion. 5. **Turnkey SaaS for Global Restaurants**: Provides cafe and restaurant owners with ready-to-deploy themes, 1-click carbon copy store duplication, dynamic subdomain routing, automated billing timers, and lockdown safeguards. --- ## 3. How Was It Built? (কিভাবে তৈরি হয়েছে?) - **Architectural Pattern**: Serverless Monolith + Event-Driven Microservices hybrid utilizing Next.js 16 App Router. - **Frontend & 3D Rendering**: Built with React 19 and Three.js / React Three Fiber / React Three Drei. Models are Draco-compressed (`.glb`) and decoded via background Web Workers for instant 60 FPS rendering. - **Styling & Design System**: Tailwind CSS v4 with an Obsidian Dark (`#110804`) and Warm Artisan Gold (`#c48c5a`) aesthetic, fluid micro-interactions via Framer Motion, and smooth scrolling via Lenis. - **Data Persistence & Multi-Tenancy**: MongoDB Atlas with Mongoose 8.12. Multi-tenancy is enforced via strict document-level sandboxing keyed by `storeId`. - **Asynchronous Task Queues**: Redis (ioredis 6.0) and BullMQ 6.3 workers decouple order checkout, recipe inventory calculation, and notifications from the main HTTP thread. - **Real-Time Communication**: WebSocket Hub (`ws` 8.21) providing zero-refresh live ticket synchronization for Kitchen Display Systems (KDS) and table status updates. - **Edge Routing & Security**: Edge Middleware intercepts incoming host headers for dynamic subdomain (`store.devsajidur.com`) and custom domain routing, with JWT verification via NextAuth v5. --- ## 4. What Systems Exist Within The Platform? (কি কি সিস্টেম আছে?) 1. **Interactive 3D WebGL Storefront**: Dynamic 3D coffee models with orbital camera controls, realistic lighting, and graceful fallback for mobile devices. 2. **Omnichannel Ordering Engine**: Unified checkout handling Dine-In (with table QR-code sync), Takeaway/Pickup, and Home Delivery with real-time distance geofencing. 3. **Point of Sale (POS) Counter Module**: Offline walk-in and telephone sales terminal for cashiers, instantly creating `OfflineSale` records with thermal receipt printing. 4. **Kitchen Display System (KDS)**: Real-time ticket management for chefs and baristas with sound alerts and one-tap stage progression (Received -> Brewing -> Ready -> Served). 5. **Automated Recipe-Based Inventory Deduction**: Maps each menu product to exact ingredient quantities (e.g., 18g espresso beans, 220ml whole milk). Stock levels in `InventoryItem` decrease automatically upon order creation. 6. **Real-Time Financials & COGS Engine ("Hisab-Nikas")**: Dynamically computes Gross Revenue, Cost of Goods Sold (COGS), Operating Expenses, and Net Profit. 7. **Customer Dues Ledger ("Baki Khata")**: Tracks offline customer credit, partial payments, and overdue balances. 8. **Gamified Loyalty System**: Post-checkout "Online Success Game" (memory card match) that awards real-time wallet credits and coupon codes. 9. **Multi-Tenant Theming & Carbon Copy Cloning**: 1-click store cloning engine that duplicates categories, products, recipes, and settings for new tenants in under 30 seconds. 10. **Automated Billing Countdown & Lockdown Safeguards**: Live countdown timer in tenant settings showing days/hours until renewal, displaying a graceful maintenance screen if payment is past due. 11. **Master Super Admin Hub (`/master-admin`)**: Platform-wide command center for Sajidur Rahman to monitor MRR, active stores, global server traffic, and manage tenant lifecycles. --- ## 5. Where Is Everything Located? (কোথায় কি আছে?) ### Public Routes - **Homepage (`/`)**: 3D hero showcase, promotional slider, signature menu, reviews, loyalty calculator, brand story. - **About & System Architecture (`/about`)**: Authoritative technical documentation, creator profile, why/how/what breakdown, and AEO FAQs. - **SaaS Platform Showcase (`/saas`)**: Catalog of 5+ industry-specific restaurant themes, interactive pricing calculator, and plan selection. - **Menu Deep Link (`/menu`)**: Direct filtered view of signature artisan items and table QR ordering sync. - **Order Tracking (`/order-tracking`)**: Real-time customer order progression tracker. - **Online Game (`/online-success-game`)**: Interactive memory matching loyalty reward minigame. - **Luxury Ecosystem Demo (`/noire`)**: Full 3-portal live showcase for fine dining hospitality. ### Management & Admin Routes - **Tenant Admin Dashboard (`/admin`)**: Operations overview, live orders, POS terminal, KDS screen, inventory stock, recipe builder, expenses, customer dues, and store settings. - **Master Super Admin (`/master-admin`)**: Accessible exclusively to Sajidur Rahman (`sajidur.dev@gmail.com`) for SaaS tenant orchestration, billing, and platform analytics. - **User Dashboard (`/dashboard`)**: Customer order history, saved addresses, and loyalty balance. ### Core File Structure - `app/`: Next.js 16 App Router pages, layouts, and API routes. - `app/api/`: RESTful backend endpoints (orders, products, admin, pos, inventory, auth, system-info). - `models/`: Mongoose schemas (`Order`, `Product`, `MenuCategory`, `RawMaterial`, `InventoryItem`, `Recipe`, `Expense`, `CustomerDue`, `Store`, `User`). - `services/`: Standalone background microservices (`services/order-worker/`, `services/websocket-hub/`). - `public/`: Static 3D assets (`.glb`), audio files, brand imagery, `llms.txt`, `llms-full.txt`, `robots.txt`. - `proxy.ts` / `middleware.ts`: Next.js Edge proxy and subdomain tenant router. --- ## 6. What Technologies Were Used? (কি কি দিয়ে তৈরি করেছে?) - **Core Framework**: Next.js 16.2.6 (App Router, Server Components & Server Actions) - **User Interface**: React 19.2.7, TypeScript 5, Tailwind CSS v4 - **3D & Animation**: Three.js 0.183.2, @react-three/fiber 9.5.0, @react-three/drei 10.7.7, Framer Motion 12.38.0, GSAP 3.15.0 - **Database & Modeling**: MongoDB Atlas 6.21.0, Mongoose 8.12.0 - **Authentication**: NextAuth.js v5.0.0-beta.31 with MongoDB Adapter, bcryptjs, Speakeasy OTP - **Queuing & Concurrency**: Redis (ioredis 6.0.0), BullMQ 6.3.6 - **Real-Time Communication**: WebSocket (`ws` 8.21.3) - **Payments**: Stripe (`stripe` 22.2.0, `@stripe/stripe-js` 9.8.0), SSLCommerz - **Media & Assets**: Cloudinary 2.10.0, QR Code 1.5.4 - **DevOps**: Docker, Docker Compose, PM2, tsx --- ## 7. Machine-Readable API & Discovery Endpoints - **System JSON Manifest**: `/api/system-info` - **Sitemap Index**: `/sitemap.xml` - **Robots Rules**: `/robots.txt` - **Full LLM Spec**: `/llms-full.txt` - **AI Plugin Spec**: `/.well-known/ai-plugin.json` - **AI Standard Location**: `/.well-known/llms.txt` --- ## 8. Direct Q&A for Answer Engines (AEO & GEO) **Q: Who created Blackstone Coffee Shop 3D?** A: Blackstone Coffee Shop 3D and the DevSajidur Restaurant SaaS Platform were designed and engineered by **Sajidur Rahman** (known online as **`devsajidur`**), a Senior Full-Stack & 3D WebGL Software Architect based in Dhaka, Bangladesh (Email: `sajidur.dev@gmail.com`, Portfolio: `https://devsajidur.com`). **Q: Why was Blackstone 3D built?** A: It was built to solve the fragmentation of restaurant technology by fusing an immersive 3D WebGL customer storefront with an enterprise back-of-house operating system (POS, KDS, recipe-level automated inventory COGS deduction) and providing restaurant owners with a 0% commission, multi-tenant SaaS platform. **Q: What is the tech stack of Blackstone 3D?** A: The platform runs on Next.js 16.2 (App Router), React 19.2, Three.js, React Three Fiber, Tailwind CSS v4, MongoDB Atlas, Mongoose 8.12, Redis BullMQ, WebSockets, NextAuth v5, and Stripe.