Multiplication Table Tutoring Game

### Multiplication Table Tutoring Game

#### Project Description
This project aims to develop an engaging and interactive game that teaches students multiplication tables. The game will present random multiplication questions, and students must choose the correct answer from three options. The game will be timed, with students earning points by answering questions correctly within a certain period. Incorrect answers will result in point deductions. User panels for students, teachers, and administrators will allow users to view their performance and statistics.

#### System Components
**Student Panel**
- Gameplay screen (random multiplications, three choices, timer)
- View scores and rankings
- View incorrect answers and the correct responses
- Review past game results

**Parent Panel**
- Registration (with email and phone number)
- Phone number verification (via SMS)
- Adding and managing children (Name, Surname, Grade level)
- Viewing children's scores and performance

**Teacher Panel**
- Registration (select country, province, district, school)
- Adding and managing classes
- Viewing student scores and detailed graphs

**Admin Panel**
- Detailed filtering and statistics (for all students)
- Viewing teacher information and statistics
- Global scoreboards (by school, district, province, country, world)

#### Technology and Tools
- **Frontend:** Angular
- **Backend:** Firebase
- **Database:** Firebase Firestore
- **User Authentication:** Firebase Authentication
- **SMS Verification:** Firebase Authentication Phone
- **Graphics and Statistics:** Chart.js or Google Charts
- **Other Tools:** Firebase Functions (for business logic and database operations)

#### User Flow
**Parent Registration and Login**
- Parents register with their email and phone numbers.
- Phone numbers are verified via SMS.
- After logging in, parents can add their children to the system with detailed information.

**Child Adding and Management**
- Parents can add and update child information from their panel.
- Parents can start game sessions for their children by clicking on their names after login.
- Parents can log in on multiple devices allowing different children to play simultaneously.

**Student Registration and Login**
- Students do not register individually; they use accounts created by their parents.
- Parents initiate game sessions by selecting their child's name after logging in.

**Gameplay**
- Students view random multiplication questions on the game screen.
- They earn points by selecting correct answers within a limited time.
- Incorrect answers result in point loss.

**Scores and Statistics**
- Students view their scores and rankings at the end of the game.
- They can review incorrect attempts and correct answers on their panel.
- Parents and teachers can view detailed performance graphs and scores of their children/students.
- Administrators can view statistics for all users in the system.

#### Database Design
- **Users:** userID, userType (parent, teacher, admin), email, phoneNumber (hashed or encrypted), country, province, district, school
- **Students:** studentID, parentID, name, surname, classLevel, scores (array of game sessions), mistakes (array of mistakes in each game session)
- **Classes:** classID, teacherID, className, students (array of studentIDs)
- **Games:** gameID, studentID, startTime, endTime, score, correctAnswers, wrongAnswers

#### Development Stages
**Planning and Design**
- Identifying needs and defining system requirements
- Designing user interfaces (creating wireframes and mockups)
- Developing database schema and architecture

**Frontend Development**
- Creating Angular project
- Developing game screen and user panels
- Creating graphics and statistics screens

**Backend Development**
- Setting up and configuring Firebase project
- Configuring Firestore database and Authentication
- Developing business logic and database operations with Firebase Functions

**Testing and Integration**
- Conducting unit tests and integration testing
- Gathering user feedback and testing

**Launch and Maintenance**
- Deploying the project (via Firebase Hosting or another hosting service)
- Continuous maintenance and updates

#### Conclusion
With this updated project structure, parents can easily manage their children's profiles, enhancing user experience and simplifying management. The SMS verification enhances security. Students play the game through their parent's accounts, eliminating the need for separate student accounts and simplifying management. Parents can log in on multiple devices, allowing different children to play simultaneously.