# Proyectos

> Crea un proyecto en AI CodeOps: vincula un repositorio Git o empieza desde cero, fija la rama predeterminada y el comando de pruebas, y mira qué registra un proyecto con el tiempo.

Fuente: https://aicodeops.dev/es/docs/projects

Un proyecto es una base de código en la que trabaja AI CodeOps. Cada sesión de IA pertenece a un proyecto, y el proyecto reúne lo que le ocurre a ese código con el tiempo: sesiones, cambios, despliegues, incidentes, SBOM y registros de decisiones.

## Crear un proyecto

1. Abre **Plan → Projects** y elige **New project**.
2. Rellena el formulario (los campos están más abajo).
3. Elige **Create project**.

| Campo                | Qué introducir                                                                                                                                                                                                    |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Identifier**       | En minúsculas y sin espacios, por ejemplo `billing-api`. Se usa en las URL y en los informes. No se puede cambiar después.                                                                                        |
| **Name**             | Un nombre legible, por ejemplo "Billing API".                                                                                                                                                                     |
| **Type**             | service, library, frontend, infra, data pipeline, model, docs u other.                                                                                                                                            |
| **Repository URL**   | Opcional. La dirección del repositorio, por ejemplo `https://github.com/acme/billing-api`.                                                                                                                        |
| **Default branch**   | Opcional. La rama sobre la que trabajan las sesiones y el terminal. En blanco significa la rama predeterminada del propio repositorio.                                                                            |
| **Test command**     | Opcional. Se ejecuta después de que una sesión escriba código, contra el cambio propuesto, en un entorno aislado. En blanco significa que se detecta (un script test de `package.json`; si no, pytest o go test). |
| **Health check URL** | Opcional. Un endpoint https público que usa la monitorización.                                                                                                                                                    |
| **Description**      | Opcional.                                                                                                                                                                                                         |

### Comprobar el acceso al repositorio

Después de introducir la URL de un repositorio, elige **Verify access**. AI CodeOps te dice si se puede llegar al repositorio y cuál es su rama predeterminada. Si tienes una [cuenta de Git conectada](https://aicodeops.dev/es/docs/git/github) para ese proveedor, los repositorios privados funcionan: "Will use your GitHub account … private repos accessible." Sin ella, los repositorios públicos se clonan igualmente, pero no puedes abrir pull requests.

Con una cuenta conectada, la comprobación también indica si esa cuenta puede **hacer push** al repositorio y **abrir pull requests** en él, y qué cambiar en tu proveedor de Git cuando no puede. No se hace push de nada ni se crea nada: solo se pregunta al proveedor. Merece la pena hacerlo antes de la primera sesión, porque un token que puede leer un repositorio pero no escribir en él, de otro modo, solo falla cuando se abre el pull request.

### Cuántos proyectos puedes tener

Tu plan incluye un número de proyectos, contados entre todos los espacios de trabajo de tu organización. La página Projects muestra el recuento junto a **New project**, por ejemplo "2 of 3 used". Cuando no queda ninguno, la página lo dice en lugar del formulario: archiva un proyecto para liberar su plaza (su historial se conserva, y se puede restaurar más tarde), o mejora el plan.

### Empezar desde cero

Deja **Repository URL** vacío para empezar una base de código nueva. Las sesiones generan entonces el código fuente en la plataforma, y puedes explorarlo en **Develop → Source**. Cuando quieras entregarlo, elige **Add repo** en el proyecto e introduce un repositorio; los cambios posteriores se pueden abrir entonces como pull requests.

### Desactivar las pruebas

Marca **Don't run tests for this project** si el proyecto no tiene suite de pruebas. Las sesiones omiten entonces el paso de pruebas, y la página de la ejecución muestra que el cambio no se verificó. Así es también como le dices al control de publicación que no exija un resultado de pruebas. Sin ello, una sesión que cambió código y no tiene un resultado de pruebas con recuentos se deniega. Consulta [Controles de calidad](https://aicodeops.dev/es/docs/quality-gates).

## La página del proyecto

Abre un proyecto para ver:

- **Deployments**, **Open incidents**, **Vulnerable components (latest SBOM)** y **Recent ADRs** de un vistazo;
- una cronología **Activity** de sesiones, despliegues, incidentes y decisiones;
- **Recent deployments** y **Recent SBOMs**.

Desde aquí puedes usar **Run workflow** (describir una tarea y lanzar una sesión en este proyecto), **Browse source**, **Edit** para editar el proyecto o **Archive** para archivarlo.

Los proyectos que aparecen en tus SBOM, registros de decisiones o incidentes pero que todavía no están configurados aparecen en **Detected projects** en la lista de proyectos, listos para añadirlos.

## Archivar y restaurar

**Archive** oculta un proyecto de la lista activa. Su historial se conserva, pero no puedes ejecutar sesiones sobre él. Los proyectos archivados se listan en **Archived**, con **Restore** para recuperar uno.

## Siguientes pasos

- [Ejecutar una sesión](https://aicodeops.dev/es/docs/sessions)
- [Conectar un proveedor de Git](https://aicodeops.dev/es/docs/git/github)
- [Seguridad y SBOM](https://aicodeops.dev/es/docs/security-and-sbom)

## Preguntas frecuentes

### ¿Puedo crear un proyecto sin repositorio?

Sí. Deja vacía la URL del repositorio y el código generado por la sesión se queda en la plataforma. Añade un repositorio más tarde para entregarlo como pull request.

### ¿Puedo eliminar un proyecto?

Puedes archivarlo. Un proyecto archivado queda oculto y no puede ejecutar sesiones, pero su historial se conserva y puedes restaurarlo.
