1.0 OVERVIEW

      App Name: Angahara
      Platform: iOS / Android / Web
      Primary Goal: Create a single digital gateway where customers can book, dine, shop, earn, and belong across every Black Group brand.

      Strategic Purpose:
            Strengthen loyalty and lifetime value through one unified membership.
            Cross-connect all divisions (Fashion, Hospitality, Services, Manufacturing).
            Provide frictionless commerce and booking experiences within one identity.
            Centralize data and engagement for the Mahākālī Foundation’s long-term governance ecosystem.


2.0 USER EXPERIENCE OVERVIEW

2.1 Primary User Types
2.2 Navigation Structure (Bottom-Tab Layout)

      1. Home
      2. Stay
      3. Dine & Nightlife
      4. Shop
      5. Rewards
      6. (Profile accessible via top-right icon or separate tab)


3.0 CORE MODULES

3.1 HOME

     Purpose: Central hub showing cross-brand recommendations, bookings, and offers.

     Key Components
            • Welcome header: username, tier, points.
            • Smart shortcuts: resume booking, upcoming stays/reservations.
            • Featured experiences: carousel (hotels, restaurants, clubs, shops).
            • Discover by City: location-aware curated list.
            • Promotional banner feed: campaign highlights from CMS.

      Data Sources
            • Content API (headless CMS)
            • Booking API (aggregates hotel + dining)
            • Loyalty API (for current tier + balance)

3.2 STAY (HOTELS & VILLAS)

      Brands: Villa Noir, La Maison d’Asura, Kāla Hotels, Agastya.
      Purpose: End-to-end hotel booking flow integrated with loyalty system.

      Functions
            1. Search — destination, dates, guests, filters (brand, collection type, amenities).
            2. Property list + map — image, price, brand tag.
            3. Property detail — description, gallery, amenities, brand story, room selection.
            4. Booking flow — select room → add-ons → payment → confirmation.
            5. In-stay features (Phase 2): room service orders, housekeeping requests.

      Integrations
            • PMS API (Oracle OPERA / Infor HMS)
            • Payment Gateway (Stripe / Adyen)
            • Loyalty Service (update points after payment)

3.3 DINE & NIGHTLIFE

      Brands: Kali Restaurant, Kuweni Restaurant, Tandva Tavern, HELL The Club, 9 of 8 Club, Kundalini, La Fleur du Mal.
      Purpose: Unified restaurant + club reservation and event-ticketing engine.

      Functions
            1. City selector / Tonight view — venues by city and availability.
            2. Venue detail page — concept, dress code, schedule, photos.
            3. Reservation flow:
                  • Restaurant: date/time/guests/requests.
                  • Club: table type + package + payment deposit.
            4. Events module: ticket sales for DJ nights, live sets, sports screenings.

      Integrations
            • Venue API (in-house or OpenTable / Resy for restaurants).
            • Event Ticketing API (custom BLK Entertainment microservice).
            • Payment Gateway + Loyalty engine for points accrual.

3.4 SHOP

      Purpose: Omnichannel e-commerce for fashion, hotel retail, and collaborations.

      Sub-categories
            • Fashion: Kāla & Rakta, Weragoda & Co., twentythreetwelve.
            • Souvenir & Hotel Retail: The Dubleu by [Property].
            • Accessories & Lifestyle: apparel, accessories, stationery, drinkware, décor.

      Functions
            • Browse → Product detail → Add to cart → Checkout.
            • In-stay fulfillment: “Deliver to room” or “Pick up at gift shop.”
            • Multi-currency pricing.
            • Loyalty integration: earn/burn points.

      Integrations
            • Commerce Engine (Shopify Plus API / Custom ERP sync).
            • Inventory Service (Real-time stock).
            • Loyalty API (Points ledger on purchase).

3.5 REWARDS (ANGAHARA MEMBERSHIP)

      Purpose: Group-wide loyalty ecosystem.

      Tier Structure (example)
            • Bronze: 0–9 999 pts
            • Silver: 10 000–49 999 pts
            • Gold: 50 000–199 999 pts
            • Black: 200 000 + pts

      Features
            • Points balance + history.
            • Progress bar to next tier.
            • Benefits catalogue (per division).
            • Offers & multipliers (dynamic).
            • Redeem for hotel nights, dinners, merch.

      Technical
            • Dedicated Points Ledger Microservice.
            • REST / GraphQL API for transactions.
            • Cron jobs for expiry + bonus events.

3.6 PROFILE & SETTINGS

      Purpose: User identity, preferences, and security.

      Features
            • Personal info + avatar.
            • Contact details + communication preferences.
            • Saved payment methods (tokenized).
            • ID storage (secure vault API).
            • Language, dark mode, notification settings.
            • Security: password, biometrics, 2FA.

      Compliance
            • GDPR / CCPA / PCI-DSS.
            • All PII encrypted (AES-256 at rest, TLS 1.3 in transit).

3.7 EXTRAS (PHASE 2)

      1. Concierge Chat: Live chat with property staff.
      2. In-Stay Control: View bill, order room service, request amenities.
      3. Notifications Center: Unified inbox for bookings, offers, receipts.

      Integrations
            • Messaging Service (Socket / Firebase Cloud Messaging).
            • PMS / POS API for real-time service requests.


4.0 TECHNICAL ARCHITECTURE

4.1 Core Entities
4.2 Integration Map
5.0 SECURITY & DATA POLICY
6.0 CONTENT & CMS MANAGEMENT

            • All banners, promotions, editorial texts, and visuals are stored in a Headless CMS.
            • Each content item tagged by division, brand, region, and language.
            • Localization supported via translation tables.
            • Scheduled publishing and A/B testing capability required.


7.0 ANALYTICS & INSIGHTS

      Event Tracking: User identity, preferences, and security.

      KPIs:
            • Monthly Active Users (MAU)
            • Conversion rate per division
            • Average order value
            • Retention / cohort analysis
            • Cross-division activity rate

      Data Pipeline: events → warehouse (BigQuery / Snowflake) → dashboard (Metabase / Looker).


8.0 PHASED IMPLEMENTATION PLAN
9.0 DESIGN & UX STANDARDS

            • Visual Language: Derived from BLK Group Brand Guidelines (dark theme default).
            • Typography: Sans serif + serif pairing per brand palette.
            • Interaction: Smooth transitions, micro-animations, editorial imagery.
            • Accessibility: WCAG 2.1 AA compliant.
            • Localization: English first → Local languages second.


10.0 MAHĀKĀLĪ FOUNDATION CONNECTION

            • “Impact” tab (Phase 3): track user donations and CSR initiatives.
            • Transparency API: fetch annual foundation report summaries.
            • Governance Integration: foundation holds Class B voting shares; app acts as public interface for its philanthropic outputs.


11.0 RISKS & MITIGATION
12.0 APP GOVERNANCE & OWNERSHIP

            • Product Owner: BLK Group Inc.
            • Technical Lead: BLK Digital / appointed vendor.
            • Creative Direction: BLK Creative / Raktabīja Entertainment (UX motion assets).
            • Data Oversight: Mahākālī Foundation (ethical use of user data).
            • Infrastructure: AWS multi-region cluster with auto-scaling.

13.0 SUMMARY

     Angahara is the connective tissue of the Black Group ecosystem — a loyalty-driven, lifestyle-commerce platform enabling seamless movement
     between worlds: fashion, hospitality, nightlife, and culture.

     From a developer’s perspective, this specification defines:
            Clear modules, APIs, and data entities
            Concrete integration map
            Phased delivery roadmap
            Robust security + compliance baseline

     ​​​​​​​It is fully aligned with all verified corporate and brand documents, with no architectural contradictions or factual omissions.
Back to Top