Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/giangartun/Tis-GOAT-Frontend/llms.txt

Use this file to discover all available pages before exploring further.

Projects are the central content of your portfolio. Each project entry supports rich metadata — cover images, technology tags, repository links, date ranges, and attached PDF evidence files. All projects are retrieved and managed through the /mis-proyectos page and the projects service API.

​
Project Fields

FieldRequiredDescription
nombre✅ YesProject name displayed on the card and in the portfolio.
descripcionNoText description of what the project does.
url_proyectoNoGitHub or repository URL. Displayed as a clickable link.
imagen_urlNoCover image URL. Shown as the project card’s thumbnail.
fecha_ini✅ YesStart date in YYYY-MM-DD format (e.g. 2024-01-15).
fecha_finNoEnd date in YYYY-MM-DD format. Leave empty for ongoing projects.
tecnologiasNoArray of technology IDs. IDs are sourced from /api/proyecto/gestion-proyectos/tecnologias/lista.
Technology IDs are ULIDs returned by GET /api/proyecto/gestion-proyectos/tecnologias/lista. The endpoint is called automatically when the project form opens — you do not need to look up IDs manually. The form renders a multi-select dropdown populated with all available technologies and their names.

​
Creating a Project

1

Navigate to My Projects

Go to /mis-proyectos. The page shows all your existing projects and a search bar.
2

Open the New Project form

Click the New Project button in the top-right corner. The project modal opens with empty fields.
3

Fill in the project details

Enter the project name (required) and optionally add a description, GitHub URL, cover image URL, start date, end date, and select one or more technologies from the dropdown.
4

Attach a PDF evidence file (optional)

Use the file picker in the form to attach a PDF. The file is uploaded separately after the project record is saved (see Uploading Evidence below).
5

Save the project

Click Save. This sends a POST request to create the project record:
POST /api/proyecto/gestion-proyectos
Authorization: Bearer <token>
Content-Type: application/json

{
  "id_portafolio": "<your_portfolio_id>",
  "nombre": "My Awesome App",
  "descripcion": "A web app that does awesome things.",
  "url_proyecto": "https://github.com/youruser/awesome-app",
  "imagen_url": "https://example.com/cover.png",
  "fecha_ini": "2024-01-15",
  "fecha_fin": "2024-06-30",
  "tecnologias": ["<tech_id_1>", "<tech_id_2>"]
}
If a PDF was attached, a second request uploads it immediately after the project is created (see below).

​
Editing a Project

Click the Edit button on any project card in /mis-proyectos. The project form re-opens pre-filled with all existing values — name, description, URL, image, dates, and selected technologies. After making changes, click Save. The update is sent via: 
PUT /api/proyecto/gestion-proyectos/:id_proyecto
Authorization: Bearer <token>
Content-Type: application/json
The request body uses the same structure as project creation. The project list refreshes automatically after a successful save.

​
Deleting a Project

Click the Delete button on a project card. A confirmation modal appears asking you to confirm the deletion. Once confirmed, the following request is made: 
DELETE /api/proyecto/gestion-proyectos/:id_proyecto
Authorization: Bearer <token>
The project is removed from the list immediately on success. The operation cannot be undone.

​
Uploading Evidence (PDF)

You can attach a PDF document as evidence for any project — for example, a technical report, academic submission, or project specification. Attach the file through the file picker when creating or editing a project. Internally, after the project is saved, the client sends: 
POST /api/proyecto/evidencias/subir
Authorization: Bearer <token>
Content-Type: multipart/form-data

id_proyecto=<project_id>
archivo=<the_pdf_file>
Once uploaded, the PDF appears as a downloadable blue chip badge in the Attached PDFs section of the project card. You can attach one PDF per save action; to attach additional files, re-open the edit form.
Keep PDF evidence files small — under 5 MB is recommended — to ensure fast uploads. Very large PDFs may time out depending on your network connection.

​
Searching Projects

The /mis-proyectos page includes a search bar at the top. Type any part of a project name to filter the list in real time (with a 300 ms debounce). The search sends a GET request with the buscar query parameter: 
GET /api/proyecto/gestion-proyectos/:id_portafolio?buscar=awesome
Authorization: Bearer <token>
Clearing the search bar reloads the full project list. If no projects match the search term, an empty state message is shown.

Build docs developers (and LLMs) love

Get started for freeTalk to us