Documentation

Technical Specifications

Comprehensive documentation of KTCHP's features and capabilities for end users, restaurant owners, and system administrators.

End User Features

User Registration & Authentication

Secure account creation and authentication system with multiple options:

  • Email/password registration with validation
  • Google OAuth 2.0 single sign-on integration
  • Secure session token management with 7-day expiration
  • Password hashing using SHA-256 encryption
  • Optional referral code entry during registration
  • Mailing list subscription opt-in

Restaurant Search & Discovery

Powerful search functionality to find kids eat free deals:

  • GPS-based location detection
  • ZIP code search with geocoding
  • Radius-based filtering (1-50 miles)
  • Text search across restaurant names, cuisines, and keywords
  • Google Places API integration for expanded coverage
  • Search result ranking by name relevance
  • Day-of-week filtering for deals

Quick Filters

One-tap filtering options for refined results:

  • "Today's Deals" - Shows active promotions for current day
  • Cuisine type filters (American, Italian, Mexican, etc.)
  • Distance-based sorting
  • Rating-based filtering
  • Kids-friendly amenity filters

Restaurant Details

Comprehensive restaurant information display:

  • Full address with map integration
  • Phone number with direct call capability
  • Operating hours by day
  • Kids eat free schedule and conditions
  • Food keywords and cuisine tags
  • Photo gallery
  • Direct navigation via Google/Apple Maps

Favorites Management

Personal list of preferred restaurants:

  • Unlimited favorites for premium users
  • 5 favorites limit for free users
  • Quick access from dedicated tab
  • One-tap add/remove functionality
  • Favorites sync across devices

Ratings & Reviews

Community-driven restaurant feedback system:

  • 5-star overall rating
  • Detailed category ratings (Food, Service, Value, Kid-friendliness)
  • Written review capability
  • Review editing for own reviews
  • Social sharing of reviews
  • Review timestamp tracking

Social Sharing & Referrals

Incentivized sharing system:

  • Unique referral code per user
  • Share to all major social platforms
  • First app share = 1 free month premium
  • Referral rewards when friends become premium
  • Review sharing rewards (5 reviews + shares = 1 free month)
  • Referral tracking dashboard

Premium Subscription

Enhanced user experience tier:

  • $2/month pricing
  • Ad-free experience
  • Unlimited favorites
  • Advanced filtering options
  • Exclusive deals access
  • Priority customer support
  • Stripe payment integration
  • Subscription management

Push Notifications

Real-time alerts and engagement:

  • Reward earned notifications
  • Referral success alerts
  • Subscription extension confirmations
  • New deal alerts for favorited restaurants
  • Customizable notification preferences

User Profile Management

Account settings and preferences:

  • Profile picture management
  • Name and email display
  • Subscription status indicator
  • Rewards dashboard access
  • Settings customization
  • Account logout functionality

Gamification & Social Features

KTCHP isn't just usefulβ€”it's fun! Our gamification system turns family dining into an engaging experience with rewards, achievements, and friendly competition.

πŸ† Achievements & Badges

Unlock special badges as you explore and engage:

  • First Timer - Complete your first restaurant visit
  • Review Rookie β†’ Review Master - Write 1, 10, 50, 100 reviews
  • Deal Hunter - Find 25 kids eat free deals
  • Social Butterfly - Connect with 10 friends
  • Cuisine Explorer - Try 10 different cuisine types
  • Local Legend - Review 20 restaurants in your area
  • Referral Champion - Refer 5 friends who sign up
  • Achievements displayed on profile with unlock dates

πŸ“Š Leaderboards

Compete with other families in your community:

  • Weekly Leaderboard - Top reviewers of the week
  • Monthly Champions - Most active families each month
  • Local Rankings - See how you rank in your city/region
  • Global Rankings - Compete with families nationwide
  • Points earned for reviews, check-ins, and referrals
  • Special badges for top 10 finishers
  • Reset periods to give everyone a fresh start

🎯 Community Challenges

Join time-limited challenges with other KTCHP families:

  • Monthly Themes - "Mexican March", "Pizza Week"
  • Seasonal Events - Holiday dining challenges
  • Review Challenges - Write the most helpful reviews
  • Discovery Challenges - Find new restaurants first
  • Progress tracking with visual indicators
  • Rewards include free premium months and exclusive badges
  • Community goal tracking - achieve rewards together

🍽️ Eating Contests

Fun competitions with friends and family:

  • Create Private Contests - Challenge your friends
  • Cuisine-Focused Rounds - "Most sushi spots visited"
  • Monthly Tournaments - Join public eating contests
  • Team Challenges - Compete as a family unit
  • Real-time leaderboards within contests
  • Photo verification for check-ins
  • Winners receive premium rewards and bragging rights

πŸ‘₯ Friends & Social

Connect with other families for a social dining experience:

  • Friend System - Add and follow other families
  • Activity Feed - See friends' reviews and check-ins
  • Restaurant Suggestions - Send places to friends
  • Facebook Integration - Find friends from Facebook
  • Privacy controls for what you share
  • Direct messaging for planning meetups
  • See which friends have visited a restaurant

🎁 Rewards System

Earn real rewards for your engagement:

  • Points Economy - Earn points for every action
  • Review Points - 10 pts per review, bonus for photos
  • Referral Bonus - 100 pts when friends join
  • Check-in Rewards - Points for visiting restaurants
  • Streak Bonuses - Extra points for daily activity
  • Redeem points for free premium months
  • Special milestone rewards at 500, 1000, 5000 points
  • Leaderboard position affects point multipliers

πŸ“ Proximity Rewards

Get rewarded just for being nearby:

  • Nearby Deal Alerts - Notifications when near a deal
  • Check-in Bonuses - Extra points at partner restaurants
  • First Visitor Bonus - Points for trying new places
  • Happy Hour Alerts - Time-sensitive deal notifications
  • Geo-fenced promotional campaigns
  • Background location for passive discovery
  • Battery-efficient proximity monitoring

🌟 XP & Levels

Level up your family's dining profile:

  • Experience Points (XP) - Earned from all activities
  • Level System - Progress from Newbie to Elite Diner
  • Level Perks - Unlock features as you level up
  • Profile Flair - Show off your level with badges
  • Level 5: Unlock advanced filters
  • Level 10: Priority in contest matchmaking
  • Level 20: Exclusive access to beta features
  • Level 50: Join the KTCHP VIP program

Restaurant Owner Features

Owner Registration

Dedicated signup flow for restaurant owners:

  • Owner account type selection during registration
  • Business verification process
  • Restaurant owner tips mailing list subscription
  • Access to Owner Dashboard from profile

Restaurant Claiming

Process to claim existing or create new listings:

  • Google Places search integration
  • Auto-populate restaurant details from Google
  • Custom restaurant creation option
  • Ownership application submission
  • Admin approval workflow (pending/approved/rejected)
  • Verification document upload capability

Restaurant Management

Full control over restaurant listing:

  • Edit restaurant name, address, contact info
  • Update cuisine type and food keywords
  • Manage operating hours
  • Set kids eat free days and conditions
  • Add/remove photos
  • Update special offers and promotions

Owner Dashboard

Centralized management interface:

  • List of owned restaurants
  • Ownership application status tracking
  • Quick edit access for each restaurant
  • Performance overview
  • Add new restaurant button

Analytics & Insights

Business performance tracking:

  • Profile view counts
  • Favorites count tracking
  • View-to-action conversion metrics
  • Rating trend analysis
  • Peak interest time identification

Promotion Creation

Marketing tools for restaurant visibility:

  • Custom promotion title and description
  • Start and end date scheduling
  • Active/inactive status toggle
  • Special deal highlighting
  • Promotion analytics

System Administrator Features

Admin Authentication

Secure administrative access:

  • Dedicated admin login portal
  • Separate admin session management
  • Role-based access control
  • Admin credential validation
  • Secure logout functionality

Dashboard Statistics

Platform-wide metrics at a glance:

  • Total registered users count
  • Total restaurants in database
  • Total ratings submitted
  • Favorites count across platform
  • Mailing list subscriber count
  • Recent signups (7-day trend)

Restaurant Management

Full control over all restaurant listings:

  • View all restaurants with details
  • Edit any restaurant information
  • Update kids eat free schedules
  • Modify cuisine types and keywords
  • Manage restaurant photos
  • Pending restaurant approval queue
  • Approve/reject new submissions

Review Moderation

Content quality management:

  • View all reviews across platform
  • See reviewer information
  • Associated restaurant details
  • Rating breakdown view
  • Delete inappropriate reviews
  • Review timestamp tracking

Owner Application Management

Restaurant ownership verification:

  • View all pending applications
  • Applicant details and contact info
  • Restaurant claim information
  • Verification document review
  • Approve/reject applications
  • Application status history

Promotion Management

Platform-wide promotion oversight:

  • View all active/inactive promotions
  • Create system-wide promotions
  • Edit promotion details
  • Delete promotions
  • Promotion scheduling
  • Featured promotion highlighting

Referral Analytics

Comprehensive referral program tracking:

  • Total referred users count
  • App shares statistics
  • Free months granted tracking
  • Review rewards claimed count
  • Reward type breakdown (App share/Review/Referral)
  • Top referrers leaderboard
  • Recent reward activity log
  • 7-day reward trend analysis

Admin User Management

Administrative user control:

  • View all system administrators
  • Invite new admins by email
  • Remove admin access
  • Admin activity tracking

Technical Architecture

Frontend Technology

Mobile application stack:

  • React Native with Expo framework
  • TypeScript for type safety
  • Expo Router for file-based navigation
  • React Context for state management
  • AsyncStorage for local persistence
  • Cross-platform (iOS, Android, Web)

Backend Technology

Server-side implementation:

  • Python FastAPI framework
  • RESTful API architecture
  • Pydantic for data validation
  • Async/await for performance
  • CORS middleware for security
  • Environment-based configuration

Database

Data storage solution:

  • MongoDB document database
  • Motor async driver
  • GeoJSON for location data
  • Text indexing for search
  • Aggregation pipelines for analytics

Third-Party Integrations

External service connections:

  • Google Places API - Restaurant search & details
  • Google Geocoding API - Location services
  • Google OAuth 2.0 - User authentication
  • Facebook OAuth - Social login & friend discovery
  • Stripe - Payment processing (Live)
  • Google AdMob - Mobile advertising
  • Gmail OAuth - Transactional emails
  • Expo Notifications - Push notifications
  • Expo Location - Proximity alerts
  • CJ Affiliate Network - Partner integrations

Security Features

Application security measures:

  • HTTPS/TLS encryption
  • Secure session token management
  • bcrypt password hashing
  • Input validation and sanitization
  • API rate limiting protection
  • CORS protection
  • OAuth 2.0 secure authentication
  • PCI-compliant payment handling via Stripe

Email System

Transactional email capabilities:

  • Gmail OAuth 2.0 integration
  • HTML formatted emails
  • Critical bug report notifications
  • Admin alert system
  • User notification emails
  • Automatic token refresh

Admin Trial Management

Premium access control for administrators:

  • Grant free trials by email (7-90 days)
  • Support for Google OAuth accounts
  • Trial history tracking
  • Extend existing trials
  • Revoke trials with audit log
  • User search functionality

Performance Optimizations

Speed and efficiency features:

  • Skeleton loading states
  • Lazy loading for images
  • Search result caching
  • Paginated API responses
  • Optimized database queries
  • CDN asset delivery