Add materials, exam images, storage quota, and API guide

Upload documents for AI context, exam images for Moodle questions, per-template storage limits, embedded images in XML export, and GUIA_API_Y_FLUJO.md with full endpoint documentation.

backend/app/schemas/exam.py

@@ -65,6 +65,10 @@ class QuestionCreate(BaseModel):
     correct_answers: list[str] = Field(min_length=1, max_length=20)
     wrong_answers: list[str] = Field(default_factory=list, max_length=20)
     matching_pairs: list[MatchingPair] = Field(default_factory=list, max_length=50)
+    image_id: uuid.UUID | None = Field(
+        default=None,
+        description="ID de imagen de la plantilla que debe mostrarse con la pregunta.",
+    )
     difficulty: Difficulty = Difficulty.MEDIUM
     score: float = Field(default=1.0, ge=0.0, le=100.0)
     penalty: float = Field(default=0.0, ge=0.0, le=100.0)
@@ -91,6 +95,7 @@ class QuestionCreate(BaseModel):
 class QuestionRead(QuestionCreate):
     id: uuid.UUID
     template_id: uuid.UUID
+    image_url: str | None = None
     created_at: datetime
 
     model_config = ConfigDict(from_attributes=True)
@@ -104,11 +109,19 @@ class PromptResponse(BaseModel):
 
 class BuildPromptRequest(BaseModel):
     topic_prompt: str = Field(min_length=5, max_length=4_000)
+    material_ids: list[uuid.UUID] | None = Field(
+        default=None,
+        description="IDs de materiales a incluir. Si no se indica, se usan todos los procesados.",
+    )
 
 
 class GenerateExamRequest(BaseModel):
     template_id: uuid.UUID
     topic_prompt: str = Field(min_length=5, max_length=4_000)
+    material_ids: list[uuid.UUID] | None = Field(
+        default=None,
+        description="IDs de materiales a incluir. Si no se indica, se usan todos los procesados.",
+    )
 
 
 class ParseRequest(BaseModel):

backend/app/schemas/image.py

@@ -0,0 +1,30 @@
+import uuid
+from datetime import datetime
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ExamImageRead(BaseModel):
+    id: uuid.UUID
+    template_id: uuid.UUID
+    original_filename: str
+    stored_filename: str
+    mime_type: str
+    size_bytes: int
+    caption: str | None
+    content_url: str
+    created_at: datetime
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class ExamImageUploadResponse(BaseModel):
+    image: ExamImageRead
+    message: str = "Image uploaded successfully"
+
+
+class QuestionImageAttach(BaseModel):
+    image_id: uuid.UUID | None = Field(
+        default=None,
+        description="ID de imagen de la plantilla. null para desvincular.",
+    )

backend/app/schemas/material.py

@@ -0,0 +1,32 @@
+import uuid
+from datetime import datetime
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from app.models.exam import MaterialStatus
+
+
+class ExamMaterialRead(BaseModel):
+    id: uuid.UUID
+    template_id: uuid.UUID
+    original_filename: str
+    mime_type: str
+    size_bytes: int
+    status: MaterialStatus
+    error_message: str | None
+    text_preview: str | None = None
+    created_at: datetime
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class ExamMaterialUploadResponse(BaseModel):
+    material: ExamMaterialRead
+    message: str = "File uploaded and processed successfully"
+
+
+class MaterialIdsFilter(BaseModel):
+    material_ids: list[uuid.UUID] | None = Field(
+        default=None,
+        description="Si se indica, solo se usan estos materiales como contexto.",
+    )

backend/app/schemas/storage.py

@@ -0,0 +1,14 @@
+import uuid
+
+from pydantic import BaseModel
+
+
+class TemplateStorageUsage(BaseModel):
+    template_id: uuid.UUID
+    used_bytes: int
+    limit_bytes: int
+    remaining_bytes: int
+    materials_bytes: int
+    images_bytes: int
+    used_mb: float
+    limit_mb: float