Evert Daniel Romero Garrido
57 lines
2.2 KiB
Markdown
57 lines
2.2 KiB
Markdown
# 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)*
|