Organizaciones y equipos en Forgejo

Las organizaciones permiten agrupar repositorios y personas bajo una entidad comun. Son la unidad de trabajo para empresas, proyectos open source o cualquier grupo que necesite colaborar en multiples repositorios.

Crear una organizacion

Desde el menu superior, haz clic en el icono + y selecciona Nueva organizacion.

Los campos principales son:

• Nombre de organizacion: identificador unico en la instancia. Se usa en URLs (/nombre-org). Solo letras, numeros y guiones.
• Visibilidad: publico (cualquiera puede verla) o privado (solo miembros).
• Descripcion: texto libre que aparece en el perfil de la organizacion.

Una vez creada, la organizacion tiene su propio perfil en /nombre-org con pestanas para repositorios, miembros y equipos.

Equipos dentro de una organizacion

Los equipos son subgrupos de miembros dentro de la organizacion. Cada equipo recibe permisos especificos sobre secciones de Forgejo y puede tener acceso a repositorios particulares.

Para crear un equipo, entra a la organizacion, ve a la pestana Equipos y haz clic en Nuevo equipo.

Campos al crear un equipo

• Nombre: por ejemplo developers, qa, ops.
• Descripcion: opcional, para documentar el proposito del equipo.
• Permisos de unidad: se configuran por separado para cada seccion (ver siguiente apartado).
• Acceso a repositorios: todos los repositorios de la org, o solo los asignados manualmente.

Permisos granulares por equipo

Forgejo permite configurar el nivel de acceso por separado para cada “unidad” del repositorio. Los niveles disponibles son:

Nivel	Significado
Ninguno	El equipo no ve esta seccion
Lectura	Puede ver pero no modificar
Escritura	Puede crear, editar y cerrar
Admin	Control total incluyendo configuracion

Las unidades sobre las que se pueden definir permisos:

• Codigo: acceso al repositorio git (clonar, push, ver ramas).
• Issues: crear, comentar, cerrar y etiquetar issues.
• Pull Requests: abrir, revisar, aprobar y mergear PRs.
• Releases: crear y editar versiones publicadas.
• Wiki: editar paginas de documentacion del repositorio.
• Paquetes: publicar y descargar paquetes del registro interno.
• Proyectos: administrar tableros Kanban del repositorio.

Ejemplo de configuracion para equipo QA

Unidad	Permiso
Codigo	Lectura
Issues	Escritura
Pull Requests	Lectura
Releases	Ninguno
Wiki	Lectura

Esto permite al equipo QA leer el codigo, gestionar issues y ver PRs, sin capacidad de subir codigo ni publicar releases.

Asignar repositorios a un equipo

Dentro del equipo, ve a la pestana Repositorios.

Tienes dos modos:

• Todos los repositorios: el equipo tiene acceso automatico a cualquier repositorio que se cree en la organizacion. Util para equipos de infraestructura o seguridad.
• Repositorios especificos: agregas manualmente cada repositorio. Recomendado para equipos de producto o por proyecto.

Para agregar un repositorio especifico, escribe su nombre en el campo de busqueda y confirmalo.

Agregar miembros a un equipo

Dentro del equipo, ve a la pestana Miembros y escribe el nombre de usuario que quieres agregar.

El usuario debe tener una cuenta activa en la instancia. Si la instancia usa invitaciones por email, el usuario debe haber completado el registro antes de poder ser agregado.

Un mismo usuario puede pertenecer a multiples equipos dentro de la misma organizacion, acumulando permisos (se toma el nivel mas alto por unidad).

Visibilidad de los equipos

Al crear o editar un equipo, puedes configurar:

• Publico: cualquier miembro de la organizacion puede ver quienes pertenecen al equipo.
• Privado: solo los miembros del equipo y los duenos de la organizacion pueden ver su composicion.

La visibilidad del equipo no afecta los permisos sobre repositorios, solo quien puede ver la lista de miembros.

Caso de uso: empresa con multiples proyectos

Una empresa con tres equipos de desarrollo puede estructurarse asi:

Organizacion: empresa-sa

Equipo	Visibilidad	Acceso repos	Codigo	Issues	PRs	Releases
owners	Privado	Todos	Admin	Admin	Admin	Admin
developers	Publico	Especificos	Escritura	Escritura	Escritura	Lectura
qa	Publico	Especificos	Lectura	Escritura	Lectura	Ninguno
externos	Privado	Especificos	Lectura	Lectura	Ninguno	Ninguno

Los repositorios se organizan por proyecto o por dominio funcional. Cada nuevo proyecto se asigna manualmente a developers y qa, mientras que owners tiene acceso automatico a todo.

Esta estructura permite escalar sin modificar permisos individuales: agregar un desarrollador nuevo solo requiere sumarlo al equipo developers.

---

Siguiente: Capitulo 12: Wikis, Proyectos y Releases —>