# 01 - ¿Qué es proyectosacc?

> Guía básica para entender el proyecto `proyectosacc` de Cómputo Contable Soft.

---

## 1. ¿Qué es este proyecto?

**proyectosacc** es el sistema de despliegue automático para la aplicación **SACC** (Sistema de Administración Contable y Comercial) de Cómputo Contable Soft.

En palabras simples: es el "puente" que lleva el código de los programadores desde **Bitbucket** hasta el servidor de AWS donde los usuarios pueden usarlo.

El proyecto tiene tres partes principales:
1. **Infraestructura en AWS**: el servidor de la API, la base de datos, el bucket S3 para el frontend, CloudFront y el dominio.
2. **Pipeline de Bitbucket**: el proceso automático que compila y publica tanto el frontend React como la API backend.
3. **Scripts de despliegue**: los archivos que instalan la API en el servidor y suben el frontend a S3.

---

## 2. ¿Qué problema resuelve?

Antes de `proyectosacc`, desplegar la aplicación SACC era un proceso manual y lento:
- Los desarrolladores tenían que copiar archivos a mano.
- Había errores porque olvidaban pasos.
- Era difícil saber qué versión estaba corriendo en producción.

**proyectosacc** resuelve esto automatizando todo:
- Cada vez que un programador sube código a Bitbucket, el pipeline se encarga de compilar, probar y desplegar.
- Si algo falla, se envía una alerta por Telegram.
- La infraestructura se crea con **Terraform**, así que siempre es la misma y no hay "magia" escondida.

---

## 3. ¿Quién lo usa?

| Rol | Cómo interactúa con el proyecto |
|-----|--------------------------------|
| **Desarrolladores** | Suben código a Bitbucket. El pipeline hace el resto. |
| **DevOps / SysAdmin** | Configuran el pipeline, revisan logs y arreglan problemas de infraestructura. |
| **Usuarios finales** | Acceden a `https://sacc.ccsoft.mx` para usar la aplicación. No ven el pipeline, pero se benefician de que siempre hay una versión estable. |

---

## 4. Dato clave

El dominio oficial de la aplicación es:

```
https://sacc.ccsoft.mx
```

Esto significa que cuando el despliegue termina exitosamente, la aplicación está disponible en esa dirección.

---

*Siguiente: [`02-arquitectura-general.md`](02-arquitectura-general.md)*