---
# System prepended metadata

title: Coma tool manual

---

# 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.

![Login Screen](https://hackmd.io/_uploads/HkNdSyeykl.png)

## 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)

   ![Spreadsheet Example](https://hackmd.io/_uploads/ByfprklJyx.png)

2. Locate the spreadsheet ID in the URL:
   ![Spreadsheet ID](https://hackmd.io/_uploads/rJSeUkxJke.png)

3. In the Admin Panel, select "Import data from google spreadsheet".
4. Enter the spreadsheet ID:
   ![Import Data](https://hackmd.io/_uploads/B1FIIJgJJx.png)

5. Click "Import Data". The system will import roles, questions, answers, and courses.
6. Review the import log for confirmation:
   ![Import Log](https://hackmd.io/_uploads/rynKIygJ1e.png)

### 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.

![Add User Form](https://hackmd.io/_uploads/ryyRUJlJkg.png)

### 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

![Admin Panel Options](https://hackmd.io/_uploads/B1PHDkg1ye.png)

## User Panel

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

![User Selection](https://hackmd.io/_uploads/SJSTPkxJyx.png)

### 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.

![Test in Progress](https://hackmd.io/_uploads/H1iWdye1Jl.png)

### 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.

![Report Generation](https://hackmd.io/_uploads/ByTXdJgkJe.png)
![Report and Recommendations](https://hackmd.io/_uploads/rkcHOye1yx.png)
![Course Recommendations](https://hackmd.io/_uploads/r1dUO1xy1g.png)

> 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)

