Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/LucPinheiro/gestor-tarea-django/llms.txt

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

The main task hub lives at /tareas/ and offers two distinct ways to visualise your work. The Kanban view arranges tasks in status columns so you can see workflow progress at a glance, while the list view gives you a compact table with checkboxes for bulk actions, CSV export, and pagination. Both views share the same search and filter controls, and you can switch between them at any time without losing your current filter state.

​
Switching Views

The vista query parameter tells the server which layout to render. There is no user-preference cookie — the choice is made explicitly through the URL on every request.
vista valueLayout renderedURL example
kanbanKanban board with four columns (default)http://127.0.0.1:8000/tareas/?vista=kanban
listaPaginated table with checkboxeshttp://127.0.0.1:8000/tareas/?vista=lista
When vista is absent from the URL the server defaults to kanban. The two toggle buttons in the top-right corner of the toolbar (▦ for Kanban, ☰ for List) append the appropriate ?vista= parameter when clicked.

​
Kanban View

The Kanban board is the default layout. It divides all tasks into four fixed columns, one for each possible estado value, so you can track where work stands across your whole project at a glance.

Borrador

Tasks that are drafted but not yet ready to be worked on. Corresponds to estado = 'Borrador'.

Pendiente

Tasks that are queued and waiting to start. Corresponds to estado = 'Pendiente'.

En proceso

Tasks that are actively being worked on. Corresponds to estado = 'En proceso'.

Completada

Tasks that have been finished. Corresponds to estado = 'Completada'.
Each card inside a column displays:
  • Task title — the titulo field.
  • Priority stars — one to three stars (★) reflecting the prioridad value (1 = ★☆☆, 2 = ★★☆, 3 = ★★★).
Clicking any card navigates to the full detail page at /detalle/<id>/, preserving the ?vista=kanban context parameter so the back-navigation returns you to the Kanban board.
The Kanban columns are populated server-side from four separate querysets (tareas_borrador, tareas_pendientes, tareas_proceso, tareas_completadas). Active search and status filters apply to the paginated list context but not to the Kanban column data — the columns always show all matching tasks rather than a paged subset. Switch to the list view when you need pagination alongside filtering.

​
List View

The list view renders a paginated table with one task per row. It is optimised for scanning large datasets and performing bulk operations. 
http://127.0.0.1:8000/tareas/?vista=lista

​
Table columns

ColumnSource fieldNotes
Checkbox—Select individual tasks for bulk actions
Títulotarea.tituloClickable; opens /detalle/<id>/
Descripcióntarea.descripcionTruncated to 80 characters
Fechatarea.fecha_creadaFormatted as dd/mm/YYYY
Estadotarea.estadoColour-coded badge

​
Bulk actions

Select one or more tasks using the row checkboxes, then open the ⚙ Acciones dropdown:
  • 🗑 Eliminar — opens a confirmation modal and then POSTs selected IDs to /eliminar-seleccionadas/.
  • ⬆ Exportar CSV — submits the same selection form to /exportar/, triggering a file download of tareas.csv containing only the selected rows.
To select every visible task at once, tick the Select All checkbox in the table header (<input type="checkbox" id="checkTodos">).

​
Pagination

The list view displays 10 tasks per page, controlled by the Django Paginator class. Navigate between pages with the ?page=N query parameter or by clicking the ‹ and › buttons in the toolbar. 
http://127.0.0.1:8000/tareas/?vista=lista&page=2
The position counter next to the pagination buttons (e.g. 11 / 45) shows the index of the first task on the current page relative to the total filtered count.

​
Search and Filter

The toolbar exposes a search box and a status dropdown. Both controls submit via GET, adding their values as query parameters so filtered URLs are bookmarkable and shareable.

​
Available query parameters

ParameterTypeEffect
vistakanban | listaSelects the view layout
estadostringFilters tasks to a single workflow state
buscarstringCase-insensitive title search (icontains)
pageintegerSelects a page in the list view

​
Filter by status (estado)

Pass one of the four valid state values to show only tasks in that state: 
http://127.0.0.1:8000/tareas/?estado=Pendiente
http://127.0.0.1:8000/tareas/?estado=Borrador
http://127.0.0.1:8000/tareas/?estado=En proceso
http://127.0.0.1:8000/tareas/?estado=Completada
Omit the estado parameter (or select Todos in the dropdown) to show all states.

​
Search by title (buscar)

The buscar parameter performs a case-insensitive substring match against Tarea.titulo: 
http://127.0.0.1:8000/tareas/?buscar=informe
This is equivalent to the ORM filter: 
Tarea.objects.filter(titulo__icontains='informe')

​
Combining parameters

All query parameters can be combined freely. For example, to find tasks with “informe” in the title that are currently Pendiente, and to view them in list layout on page 1: 
http://127.0.0.1:8000/tareas/?vista=lista&estado=Pendiente&buscar=informe&page=1
The server applies filters in order — first estado, then buscar — before sorting results by estado then id and handing them to the paginator.
Combine ?vista=lista with ?estado=Completada to quickly audit your finished tasks and export them to CSV in one action. Select all rows on the page and use ⬆ Exportar CSV from the Acciones menu.

Build docs developers (and LLMs) love

Get started for freeTalk to us