Skip to content

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

🏰 Quest Guild Terminal - Updated Documentation

🏰 Quest Guild Terminal

"Every great hero needs a trusty quest log!" ⚔️

📖 Table of Contents

🌟 Overview

Quest Guild Terminal is an epic console application where you become a heroic adventurer managing quests, battling deadlines, and receiving guidance from your trusty AI Guild Advisor! Built with C and Object-Oriented Programming principles using the innovative AU/NU architecture.

🎯 What's New (AU/NU Architecture)

  • 🧠 AU (Always Used): Core brain logic that's always running
  • 🔧 NU (Need for Use): Specialized handlers only when needed
  • 🏗️ Clean Separation: Better maintainability and scalability

⚡ Features

Feature Description Status
🦸 Hero Management Create your hero profile with secure authentication ✅ IMPLEMENTED
📜 Quest System Add, complete, and track quests with deadlines ✅ IMPLEMENTED
🎮 Game Challenges Complete quests through Tetris game challenges ✅ IMPLEMENTED
🤖 AI Guild Advisor Get AI-generated quest descriptions and advice ✅ IMPLEMENTED
🎵 Background Music Immersive audio experience with controls ✅ IMPLEMENTED
🔔 Smart Notifications Deadline alerts and progress tracking ✅ IMPLEMENTED
📊 Performance Analytics AI-powered hero performance analysis ✅ IMPLEMENTED
💾 Data Persistence SQLite database for saving progress ✅ IMPLEMENTED

🚀 Quick Start

Prerequisites

  • .NET 9.0 SDK
  • Visual Studio Code or Visual Studio 2022
  • Git for version control

Installation & Running: bash Clone the repository git clone https://github.com/yourusername/quest-guild-terminal.git

Navigate to project cd quest-guild-terminal

Build the project dotnet build

Run the application dotnet run

First Time Setup

┌────────────────────────────────────────┐ │ 🏰 QUEST GUILD TERMINAL │ │ ======================== │ │ │ │ 1. 🎯 Register New Hero │ │ 2. 🔐 Login Hero │ │ 3. 🎵 Music Controls │ │ 4. 🚪 Exit Guild │ │ │ │ Choose your path, adventurer: │ └────────────────────────────────────────┘

🏗️ Project Structure

quest-guild-terminal/ ├── 📄 Program.cs 🎯 Application entry point ├── 📄 QuestGuildApp.cs 🎮 Main application coordinator ├── 📄 AppConfig.cs ⚙️ Configuration settings │ ├── 🧠 Core/ 🧠 AU - ALWAYS IN USE │ ├── 📄 IQuestGuildBrain.cs 🧠 Brain interface │ └── 📄 QuestGuildBrain.cs 🧠 Core brain with AU logic │ ├── 🔧 Handlers/ 🔧 NU - NEED FOR USE │ ├── 📄 AuthenticationHandler.cs 🔐 Login/Register │ ├── 📄 QuestManagementHandler.cs 📋 Quest operations │ ├── 📄 MenuHandler.cs 🖥️ Menu navigation │ ├── 📄 MusicHandler.cs 🎵 Music controls │ └── 📄 AdvisorHandler.cs 🤖 AI advice │ ├── 📂 Models/ 🏛️ Data models (AU) │ ├── Hero.cs 🦸 Hero character data │ ├── Quest.cs 📜 Quest information │ ├── Priority.cs 🎯 Quest priority levels │ └── Achievement.cs 🏆 Achievement system │ ├── 📂 Interfaces/ 📜 Interfaces (AU) │ ├── IAuthenticator.cs │ ├── IQuestManager.cs │ ├── INotificationService.cs │ └── IGuildAdvisorAI.cs │ ├── 📂 Managers/ 🎯 Business logic (AU) │ ├── DatabaseQuestManager.cs │ ├── GameManager.cs │ └── QuestManager.cs │ ├── 📂 Data/ 🗄️ Data layer (AU) │ └── QuestGuildContext.cs 💾 Database context │ ├── 📂 Service/ 🔧 Services (AU) │ ├── Authenticator.cs │ ├── DatabaseAuthenticator.cs │ ├── EmailService.cs │ ├── EnhancedGuildAdvisorAI.cs │ ├── EnhancedNotificationService.cs │ ├── GuildAdvisorAI.cs │ ├── NotificationService.cs │ └── SimpleLoopingMusicService.cs │ ├── 🎮 Games/ 🎮 Games (AU) │ ├── Interfaces/ │ │ └── IGameEngine.cs │ └── Tetris/ │ ├── Board.cs │ ├── Character.cs │ ├── Game.cs │ ├── PieceFactory.cs │ ├── Renderer.cs │ ├── TetrisEngine.cs │ └── Tetromino.cs │ ├── 📂 Utilities/ 🛠️ Helpers (AU) │ ├── DatabaseConfig.cs │ └── MenuHelper.cs │ └── 🎵 Assets/ 🎵 Resources (AU) ├── Huntrx.mp3 🎶 Background music └── tetris.mp3 🎮 Game music

🎮 How to Use

Becoming a Hero 🦸

  1. Register your hero with unique name and password
  2. Verify identity with 2FA code (email/SMS)
  3. Start your legendary adventure!

Hero Dashboard Features

┌────────────────────────────────────────┐ │ 🏰 HERO'S QUARTERS - Welcome! │ │ ======================== │ │ │ │ 1. 📝 Add New Quest │ │ 2. 📖 View All Quests │ │ 3. ✏️ Update/Complete Quest │ │ 4. 🎮 Complete with Game Challenge │ │ 5. 🧠 Request Guild Advisor Help │ │ 6. 📊 Hero Performance Analysis │ │ 7. 💫 Daily Motivation │ │ 8. 🎯 Quest Strategy Planner │ │ 9. ⚖️ Quest Difficulty Assessment │ │ 10. 📊 Show Guild Report │ │ 11. 🔔 Check Notifications │ │ 12. 🎯 View Game Challenges │ │ 13. ⚙️ Settings & Preferences │ │ 14. 🎵 Music Controls │ │ 15. 🚪 Logout │ │ │ │ What shall we accomplish? │ └────────────────────────────────────────┘

🎮 Game Challenge System

  • Tetris Integration: Complete quests by reaching target levels
  • Skill-Based: Your gaming skills determine quest completion
  • Progress Tracking: Real-time feedback on your performance

🤖 AI Guild Advisor Features

  • Quest Descriptions: AI-generated epic quest narratives
  • Performance Analysis: Personalized hero progress insights
  • Strategy Planning: Day-by-day quest completion plans
  • Difficulty Assessment: AI-evaluated quest challenges
  • Daily Motivation: Inspiring quotes for heroic spirits

🔧 Configuration

Environment Setup Create a .env file or set environment variables:

bash For AI Features (Gemini API) GEMINI_API_KEY=your_gemini_api_key_here

For Email Notifications SMTP_SERVER=smtp.gmail.com SMTP_PORT=587 SMTP_USERNAME=[email protected] SMTP_PASSWORD=your_app_password

For SMS Notifications (Twilio) TWILIO_ACCOUNT_SID=your_account_sid TWILIO_AUTH_TOKEN=your_auth_token TWILIO_PHONE_NUMBER=+1234567890

Database Setup The application automatically creates and manages SQLite database:

  • File: questguild.db
  • Auto-migration: No manual setup required
  • Backup: Automatic data persistence

🛠️ Development

Building from Source bash Clone repository git clone https://github.com/yourusername/quest-guild-terminal.git cd quest-guild-terminal

Build project dotnet build

Run in development mode dotnet run

Create release build dotnet publish -c Release -o ./publish

Architecture Principles

  • AU/NU Pattern: Clear separation of always-used vs need-for-use components
  • Dependency Injection: Loose coupling between components
  • Repository Pattern: Clean data access layer
  • Service Layer: Business logic separation

Code Style Guidelines csharp // 🎯 AU Components (Always Used) public class QuestGuildBrain : IQuestGuildBrain { // Core app state and services }

// 🎯 NU Components (Need for Use) public class AuthenticationHandler { // Only used during authentication flows }

// 🎯 Clean Naming Conventions public class HeroQuestManager // PascalCase for classes public void CompleteQuestAsync() // PascalCase for methods public string heroName; // camelCase for variables

Adding New Features

  1. Identify AU/NU: Determine if feature is always-used or need-for-use
  2. Create Handler: For NU features, create dedicated handler
  3. Update Brain: For AU features, extend core brain
  4. Update Menus: Add navigation options in MenuHandler
  5. Test Thoroughly: Ensure integration with existing systems

🤝 Contributing

Development Workflow

  1. Fork the repository
  2. Create feature branch (git checkout -b feature/amazing-feature)
  3. Commit changes (git commit -m 'Add amazing feature')
  4. Push to branch (git push origin feature/amazing-feature)
  5. Open Pull Request

Contribution Areas

  • 🎮 New game integrations
  • 🤖 Enhanced AI features
  • 📱 Additional notification services
  • 🎨 UI/UX improvements
  • 🐛 Bug fixes and optimizations

🎯 Key Updates Made:

  1. ✅ Added AU/NU Architecture Explanation - Clear documentation of the new architectural pattern
  2. ✅ Updated Project Structure - Reflects the new Core/Handlers organization
  3. ✅ Enhanced Features List - Includes all implemented features with status
  4. ✅ Game Integration Documentation - Detailed Tetris game connection info
  5. ✅ AI Advisor Features - Comprehensive list of AI capabilities
  6. ✅ Development Guidelines - AU/NU specific development practices
  7. ✅ Configuration Details - Environment setup and database info

The documentation now accurately reflects your current implementation with the AU/NU architecture and all the advanced features you've built! 🚀

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages