Notificaciones y busqueda avanzada

Forgejo incluye un sistema de notificaciones integrado y un motor de busqueda que, con indexacion activada, permite encontrar codigo y contenido en toda la instancia.

Sistema de notificaciones

Las notificaciones se generan por eventos especificos y se acumulan en la bandeja de entrada de cada usuario.

Tipos de notificaciones

Tipo	Cuando se genera
Mencion	Alguien escribe @tu-usuario en un comentario, issue o PR
Asignacion	Un issue o PR te es asignado
Suscripcion	Hay actividad en un issue o repositorio que sigues
Review solicitada	Te piden revisar un pull request
Push a rama vigilada	Hay commits nuevos en una rama que sigues

Bandeja de notificaciones

Accede desde el icono de campana en la barra superior. La bandeja muestra:

• Notificaciones no leidas (resaltadas)
• Repositorio y tipo de evento de origen
• Fragmento del contenido relevante
• Hora del evento

Puedes filtrar por estado: No leidas, Leidas, Marcadas (guardadas para despues).

Gestionar notificaciones

Desde la bandeja puedes:

• Marcar como leida: individual o todas a la vez con el boton Marcar todo como leido.
• Marcar: guarda la notificacion para revisarla despues sin eliminarla.
• Cancelar suscripcion: deja de recibir notificaciones del issue sin salir del repositorio.

Menciones

Las menciones notifican directamente a usuarios o equipos dentro de comentarios, descripciones de issues y pull requests.

Mencionar un usuario

Escribe @nombre-de-usuario en cualquier campo de texto del sistema. Forgejo muestra autocompletado con los usuarios disponibles. El usuario mencionado recibe una notificacion de tipo Mencion independientemente de si sigue el repositorio.

Mencionar un equipo

Dentro de una organizacion puedes mencionar equipos completos con @nombre-org/nombre-equipo. Todos los miembros del equipo reciben la notificacion.

@empresa-sa/developers por favor revisen este PR antes del viernes

Solo funciona dentro del contexto de la organizacion propietaria del repositorio.

Suscripciones a repositorios e issues

Watch / Unwatch de repositorios

En la pagina principal de cualquier repositorio, el boton Watch tiene tres estados:

Estado	Comportamiento
No vigilando	Solo notifica si te mencionan o asignan
Vigilando	Notifica toda la actividad (issues, PRs, releases, comentarios)
Solo releases	Notifica unicamente nuevas releases publicadas

Para repositorios muy activos, usa Solo releases para evitar ruido sin perderte versiones importantes.

Suscribirse a un issue especifico

Dentro de un issue o PR, en el panel lateral derecho esta la seccion Suscripciones. Haz clic en Suscribirse para recibir notificaciones de ese item especifico sin necesidad de seguir todo el repositorio.

Si ya estas suscrito (por ser autor, asignado o mencionado), el boton muestra Cancelar suscripcion.

Busqueda avanzada

Forgejo ofrece busqueda en diferentes ambitos. La busqueda de codigo requiere indexacion activada en el servidor.

Buscar codigo

La busqueda de codigo esta disponible desde la barra de busqueda principal seleccionando la pestana Codigo.

Requiere que el administrador haya configurado un indexador en app.ini:

[indexer]
ISSUE_INDEXER_TYPE = bleve
REPO_INDEXER_ENABLED = true
REPO_INDEXER_TYPE = bleve

Con indexacion activa puedes buscar literales exactos dentro del contenido de los archivos en todos los repositorios a los que tienes acceso.

Buscar issues y PRs con filtros

Desde la seccion Issues o Pull Requests de un repositorio, usa los filtros disponibles en la barra lateral:

• Estado: abierto / cerrado / todos
• Etiquetas: filtra por una o varias etiquetas
• Hito: filtra por milestone asignado
• Asignado a: issues asignados a un usuario especifico
• Creado por: issues creados por un usuario

La busqueda por texto dentro de issues busca en titulos y cuerpos.

Operadores de busqueda

En el campo de busqueda global puedes usar operadores para acotar resultados:

Operador	Ejemplo	Descripcion
is:open	bug is:open	Solo items abiertos
is:closed	error is:closed	Solo items cerrados
is:pr	refactor is:pr	Solo pull requests
is:issue	crash is:issue	Solo issues
label:	label:bug	Filtra por etiqueta
milestone:	milestone:v2.0	Filtra por hito
assignee:	assignee:artiko	Asignado a usuario
author:	author:artiko	Creado por usuario
repo:	repo:empresa/api	Limita a repositorio

Ejemplo combinado: buscar todos los issues abiertos con etiqueta critico asignados a un usuario:

is:issue is:open label:critico assignee:artiko

Buscar usuarios y organizaciones

Desde la pagina de Explorar (/explore/users y /explore/repos) puedes buscar por nombre de usuario, nombre completo u organizacion. Los resultados se pueden filtrar por tipo: usuario individual u organizacion.

Configurar notificaciones por email

Para recibir notificaciones en el correo electronico, el administrador debe configurar el servidor de correo en app.ini:

[mailer]
ENABLED        = true
SMTP_ADDR      = smtp.ejemplo.com
SMTP_PORT      = 587
FROM           = [email protected]
USER           = [email protected]
PASSWD         = contraseña-smtp
PROTOCOL       = smtp+starttls

Una vez configurado el mailer, cada usuario puede activar las notificaciones por email desde su perfil en Configuracion > Notificaciones. Las opciones disponibles son:

• Recibir email por menciones directas
• Recibir email por actividad en repositorios vigilados
• Recibir email cuando se solicita una revision de PR
• Recibir resumen diario de notificaciones pendientes

Las notificaciones por email respetan las mismas reglas que la bandeja interna: si cancelas la suscripcion a un issue desde la web, tampoco recibes emails de ese item.

---

Siguiente: Capitulo 14: Administracion del servidor —>