Bot Competition Evaluation Criteria

This document outlines the criteria that judges will use to evaluate submissions in the bot development competition. It is publicly available for participants to understand how their work will be assessed.

1. Formal Requirements (Binary criteria: 0 or 1)

• ✅ The participant agrees with the competition rules (0-1)
• ✅ Telegram participant nickname (0-1)
• ✅ Valid GitHub repository with bot code (0-1)
• ✅ Corresponds to the theme of the competition (0-1)

2. Documentation & Description (Strict binary scores to ensure quality)

• ✅ High-quality README (0-10, subjective, can be evaluated by AI)
• ✅ README contains bot screenshots (0, 5) → 0 = no, 5 = yes
• ✅ README includes the main bot screen for BB Store (0-10)

3. Functionality & Testing (Strict binary scores to avoid partial implementations)

• ✅ Has a working demo bot (0, 5) → 0 = no, 5 = yes
• ✅ Demo bot runs without errors (0-5) → 0 = does not work, 5 = works without errors
• ✅ Good for admin testing (0-5) → 0 = difficult to test, 5 = easy to test

4. Code & Architecture (Code is important, but BB Store readiness takes priority)

• ✅ Good code quality (structured and readable) (0-10)
• ✅ Bot has a proper folder structure for commands (0-5)
• ✅ No obvious vulnerabilities were found (0, 5) → 0 = yes, 5 = no
• ✅ No issues and no well-known issues like #wholeUsers issue (0, 5) → 0 = yes, 5 = no

5. Readiness for BB Store (The most important criteria)

• ✅ Can be used as a demo bot in BB Store (0-20) → 0 = cannot be used, 20 = fully ready
• ✅ Can be used in BB Store immediately (without modifications) (0-20) → 0 = requires modifications, 20 = fully ready

6. Creativity & Complexity (Originality is important but secondary to functionality)

• ✅ Creativity and originality of the idea (0-10)
• ✅ Work volume (small, medium, large) (0-5) → 0 = small, 3 = medium, 5 = large

Total Score Calculation

Each bot will receive a total score based on the sum of all categories.

Additional Notes

• Judges will ensure fairness and consistency when scoring.
• This document serves as a guideline for both judges and participants to maintain transparency in the evaluation process.

Good luck to all participants!