# COMA Tool Manual
> Revision: 0.2, 2024-10-06

## Accessing the Tool

The COMA (Course Matching AI Assistant) tool is available at: [https://comatool.fly.dev/](https://comatool.fly.dev/)

To access the tool:
1. Enter the password: **comat00l**
2. After successful login, you can select either User or Admin mode from the sidebar menu.


## Admin Panel

To access the Admin Panel:
1. Select "Admin Panel" from the sidebar menu.
2. Enter the admin password: **admin**

### Importing Data from Google Spreadsheet

1. Prepare your data in a Google Spreadsheet with the following sheets:
- Roles
- Questions
- Answers
- Courses

Example spreadsheet: [COMA Data Template](https://docs.google.com/spreadsheets/d/1T8ywjYHj0SPLLI-upWFh162aP_icsKwAYx9hcEtYXok/edit?gid=192139613#gid=192139613)


2. Locate the spreadsheet ID in the URL:

3. In the Admin Panel, select "Import data from google spreadsheet".
4. Enter the spreadsheet ID:

5. Click "Import Data". The system will import roles, questions, answers, and courses.
6. Review the import log for confirmation:

### Managing Users

1. In the Admin Panel, select "Add User".
2. Fill in the user details:
- User Name
- User Email
- Select Role (based on imported roles)
3. Click "Create User" to add the new user to the database.


### Managing Data

The Admin Panel offers several data management options:
- View Data: Inspect Users, Roles, Courses, Tests, Reports, Questions, and Answers
- Delete All Data: Remove all data from the database (use with caution)
- Delete Records: Selectively remove Users, Courses, or Reports


## User Panel

1. Select "User Panel" from the sidebar menu.
2. Choose a user from the dropdown list.
3. Select or confirm your role.


### Taking a Test

1. If no test is in progress, click "Start New Test".
2. Answer each question by selecting from the provided options.
3. You can save your progress as a draft or submit the completed test.


### Generating Report and Recommendations

After submitting a test:
1. Click "Run AI and generate report and recommendations".
2. The system will generate a personalized report based on your answers.
3. Course recommendations will be provided based on the report content.


> Note: The current version uses basic prompts for report and course selection generation. This will be improved in future updates.

## Next Steps

- [ ] Update Google Spreadsheet with real data (Roni)
- [ ] Enhance prompts for more robust reporting and selection (Cezary)
- [ ] Provide feedback on application remarks (Roni)
- [ ] Evaluate if the prototype meets the requirements for integration into the original platform (Roni)
- [ ] Iterate and test with real data to verify recommendation and report quality (Team)