# Help: Repositories

## What is a Repository?

A **Repository** is an organized collection of questions and answers about a specific topic. Repositories are the fundamental basis of Evalis, as they contain all the educational content that will be used to create tests.

## Repository Features

- **Name**: Unique identifier of the repository (required)

- **Description**: Brief explanation of the repository content

- **Categories**: Tags to classify the repository by knowledge area (e.g., Mathematics, History, Programming)

- **Tags**: Additional keywords to facilitate searching

- **Author**: Name of the repository creator

- **Language**: Main language of the content

- **Questions**: Set of questions that make up the repository

## Question Structure

Each question in a repository must meet the following requirements:

**Question Fields:**

- **Question text** (required): The question itself

- **Question type**:

 - MULTIPLE_CHOICE: Only one correct answer

 - MULTIPLE_ANSWER: There can be multiple correct answers

 - TRUE_FALSE: True or False

- **Difficulty**: Level from 1 to 5 (1 = very easy, 5 = very difficult)

- **Suggested time**: Recommended time in seconds to answer

- **Explanation**: Explanatory text shown after answering

- **Multimedia resources**: Images, audios, or videos associated with the question

**Answers (minimum 2 required):**

- **Answer text** (required)

- **Score**: Value between 0.0 and 1.0 (0.0 = incorrect, 1.0 = completely correct)

- **Feedback**: Explanatory message about why the answer is correct or incorrect

- **Multimedia resources**: Images, audios, or videos associated with the answer

> **IMPORTANT**: Each question must have a **minimum of 2 answers**. Without answers, the question is not valid.

## Main Menu Functions

**1. Sort List**

- **No order**: Shows repositories by modification date (most recent first)

- **Name A-Z**: Sorts alphabetically from A to Z by name

- **Name Z-A**: Sorts alphabetically from Z to A by name

**2. Search Repositories**

- Allows searching repositories by name, description, categories, or tags

- Search is real-time as you type

- Case-insensitive

**3. Create New Repository**

- Manual option: Create an empty repository and add questions manually

- AI option: Artificial intelligence automatically generates a complete repository based on a topic you specify

**4. Edit Repository**

- Modify basic repository data (name, description, etc.)

- Access question editing from the "Edit Questions" button

**5. Edit Questions**

- Manage repository questions

- Add new questions manually

- Generate questions with AI on a specific topic

- Edit or delete existing questions

- Add multimedia resources (images, audios) to questions and answers

**6. Delete Repository**

- Permanently deletes the repository and all its questions

- This action CANNOT be undone

- Export before deleting is recommended

**7. Export Repository**

- Creates a `.evalisRepo` file with all repository content

- The file includes all questions, answers, and multimedia resources

- You can share this file or use it as a backup

**8. Share Repository**

- Generates an export file and shares it using device applications

- Useful for sending repositories via email, messaging, etc.

**9. Import Repository**

- Imports previously exported `.evalisRepo` files

- You can also open `.evalisRepo` files directly from the file explorer

- Multimedia resources are imported automatically

## Multimedia Resource Management

Repositories can include multimedia resources in questions and answers:

**Supported resource types:**

- **Images**: PNG, JPG, JPEG (maximum 5 MB per image)

- **Audio**: MP3, WAV, AAC (maximum 10 MB per audio)

- **Video**: MP4, AVI (maximum 50 MB per video)

**Where they are stored:**

- Resources are saved in the app's internal storage

- They are organized by repository in separate folders

- When exporting a repository, resources are included in the file

**Best practices:**

- Use compressed images to save space

- Add audios for language or music questions

- Resources are previewed before adding them

## Creation with Artificial Intelligence

Evalis allows creating complete repositories using AI:

**Required configuration:**

1. Go to Settings → AI Configurations

2. Add at least one AI configuration (OpenAI, Gemini, DeepSeek, etc.)

3. Mark a configuration as default

**Create repository with AI:**

1. Press "Create with AI" from the repository list

2. Specify the topic (e.g., "Spanish History", "Basic JavaScript")

3. Select the language

4. Indicate the number of questions (recommended: 10-30)

5. Optionally choose a specific AI configuration

6. The AI will automatically generate:

  - Repository name and description

  - Questions of different difficulty levels

  - Correct and incorrect answers

  - Educational feedback for each answer

  - Detailed explanations

**Generate additional questions:**

- From an existing repository, use "Generate questions with AI"

- Specify a subtopic to add more questions

- New questions are added to existing ones

## Backup Recommendations

⚠️ **IMPORTANT**: Regular backups are recommended.

**Why backup?**

- Data could be lost when updating the app from the Store

- If you uninstall the app, you will lose all repositories

- If the device is damaged or reset, you will lose the content

**How to backup:**

1. Export each repository individually

2. Save the `.evalisRepo` files in a safe place:

  - Google Drive, Dropbox, or another cloud service

  - Personal computer

  - Email them to yourself

3. Export regularly after making important changes

**Restore from backup:**

- Simply import the saved `.evalisRepo` files

- All data, questions, and multimedia resources will be restored

## Limits and Considerations

- **Number of repositories**: Unlimited (limited by device space)

- **Number of questions per repository**: Unlimited

- **Total size of multimedia resources**: Limited by available space

- **Export**: Large files may take time to generate

- **Import**: Verify that the `.evalisRepo` file is not corrupted