# Know Foolery

## Overview

Know Foolery is a quiz game inspired by the French game "Déconnaissance" (https://escaleajeux.fr/jeu/decon.0.1). It's a web-based quiz platform with plans for cross-platform expansion to mobile and desktop applications.

## Game Concept

### Core Gameplay
- **Objective**: Players answer randomly selected questions to score points
- **Question Format**: Each question belongs to a theme, displayed above the question
- **Scoring System**: 
  - 2 points for correct answer without hint
  - 1 point for correct answer with hint
  - 0 points for incorrect answer or timeout
- **Attempts**: Players have exactly 3 attempts per question
- **Time Limit**: Each game session is limited to 30 minutes maximum
- **Hints**: Players can request one hint per question, but this reduces their score

### Player Experience
- **Registration**: Players must enter their name before starting a game
- **Session Management**: Game tracks progress, attempts, and time remaining
- **Leaderboard**: Display top 10 scores accessible to all players
- **Themes**: Questions are categorized by themes (Geography, History, Science, etc.)

### Future Enhancements

#### Planned Features
1. **Question Categories**: Filter questions by subject
2. **Difficulty Progression**: Adaptive difficulty based on performance
3. **Multiplayer Mode**: Real-time competition between players
4. **Daily Challenges**: Special themed question sets
5. **Achievement System**: Badges and milestones
6. **Question Contributions**: Player-submitted questions

#### Scoring Enhancements
1. **Time Bonus**: Extra points for quick correct answers
2. **Streak Bonus**: Consecutive correct answers bonus
3. **Difficulty Multiplier**: Higher points for harder questions
4. **Perfect Game Bonus**: Bonus for 100% correct rate

## Success Metrics

### User Engagement
- **Daily Active Users**: Track player engagement
- **Session Duration**: Average time spent playing
- **Question Accuracy**: Player success rates by theme
- **Hint Usage**: Frequency and effectiveness of hints

### Technical Performance
- **Response Times**: API and database performance metrics
- **Error Rates**: Application stability and reliability
- **Uptime**: System availability and reliability
- **Security Events**: Monitoring for security incidents

### Business Metrics
- **Player Retention**: User return rates and engagement
- **Content Quality**: Question difficulty and engagement
- **Platform Usage**: Cross-platform adoption rates
- **Admin Efficiency**: Content management effectiveness

## Project Roadmap

### Phase 1: Core Platform (Weeks 1-6)
- Basic web application with core game mechanics
- Essential microservices and database setup
- Admin panel for question management

### Phase 2: Enhanced Features (Weeks 7-12)
- Complete security implementation
- Comprehensive observability and monitoring
- Production-ready deployment

### Phase 3: Mobile Expansion (Weeks 13-18)
- React Native mobile applications
- Cross-platform component optimization
- Mobile app store deployment

### Phase 4: Advanced Features (Weeks 19-24)
- Desktop applications
- Advanced analytics and reporting
- Enhanced security and compliance features