CoolFace
Apppublic

CCraze/CCraze1

sourceHugging Faceupdated 1y agoView on Hugging Face
0likes
App README

Coffee Craze

A fully decentralized, production-ready SaaS platform designed exclusively for the coffee shop and restaurant industry. Coffee Craze offers a comprehensive suite of integrated tools to manage every aspect of your coffee business, from point-of-sale to customer loyalty.

Core Features

Smart POS System

  • —Table orders and takeaway management
  • —Kitchen display system with real-time updates
  • —Offline mode with automatic synchronization
  • —QR-based table scan ordering for customers
  • —Customizable menus with real-time item availability status

Smart Delivery System

  • —Internal delivery fleet management
  • —Third-party delivery service integration
  • —Live order tracking for customers and staff
  • —Advanced dispatch system for route optimization
  • —Customer-facing map view of delivery progress

Smart Subscription System

  • —Drink subscriptions with daily/weekly plans
  • —Coffee box subscriptions for physical product delivery
  • —Customizable intervals and flexible payment options
  • —Multiple payment gateway integrations

Smart Jobs System

  • —Freelance barista marketplace for temporary staffing
  • —Comprehensive job board with applicant tracking
  • —Training center with courses and certification tracking
  • —Rating and review system for workers and employers

Smart Service System

  • —Booking service for machine maintenance professionals
  • —Filter options by service type, rating, and location
  • —AI-powered recommendations for recurring service needs

Smart Community System

  • —Forum-style interface for business discussions
  • —Q&A section, announcements, and knowledge sharing
  • —Loyalty program discussion and event promotion
  • —Support network for cafés and roasters

Advanced Loyalty and Rewards System

  • —Points, tiers, and digital stamp cards
  • —AI-based personalized offers and recommendations
  • —Cross-café reward acceptance (decentralized)

Fully Integrated Marketplace

  • —Platform for selling coffee beans, machines, and tools
  • —Vendor dashboards for inventory and sales management
  • —Web3-token-enabled product listings

Café Admin Dashboard

  • —Staff scheduling and management
  • —Comprehensive financial reports and analytics
  • —Inventory management with automatic alerts
  • —Marketing campaign management and promotion tools

Customer Dashboard

  • —Order history and reordering capabilities
  • —Subscription management interface
  • —Saved preferences and favorite items
  • —Digital wallet and reward points tracking

Tech Stack

  • —Frontend: React with Next.js, Tailwind CSS
  • —Mobile: React Native
  • —Backend: Node.js with Express
  • —Database: PostgreSQL with Prisma ORM
  • —Authentication: Firebase Auth with 2FA
  • —Web3: Ethereum/Polygon integration with Solidity smart contracts
  • —Wallet: Built-in digital wallet with Web3 capabilities
  • —PWA: Full offline support with service workers
  • —Multilingual: Arabic (RTL) and English with dynamic language switching
  • —AI: Integrated AI models for personalization and analytics

Project Structure

/
├── apps/                      # Application modules
│   ├── web/                   # Next.js web application
│   ├── admin/                 # Admin dashboard
│   ├── mobile/                # React Native mobile app
│   └── api/                   # Backend API services
├── packages/                  # Shared packages
│   ├── ui/                    # Shared UI components
│   ├── config/                # Shared configuration
│   ├── utils/                 # Utility functions
│   └── types/                 # TypeScript type definitions
├── contracts/                 # Smart contracts
├── blockchain/                # Blockchain integration
├── wallet/                    # Digital wallet implementation
├── messaging/                 # Real-time messaging system
├── mesh/                      # Offline mesh networking
├── ai-marketing/              # AI marketing engine
└── infra/                     # Infrastructure and deployment

Getting Started

  1. 1.Install dependencies:
bash
   npm install
  1. 1.Set up environment variables:
bash
   cp .env.example .env
   # Edit .env with your configuration values
  1. 1.Deploy smart contracts (if using Web3 features):
bash
   npm run deploy:contracts
  1. 1.Start the development server:
bash
   # For web application
   npm run dev:web
   
   # For admin dashboard
   npm run dev:admin
   
   # For API server
   npm run dev:api

Mobile Application

To run the mobile application:

bash
npm run dev:mobile

Deployment

For production deployment instructions, see infra/README.md.

Contributing

Please see CONTRIBUTING.md for contribution guidelines.

License

Copyright 2025 Coffee Craze. All rights reserved.