Initial commit: Terraform infrastructure, pipelines, docs and scripts

2026-04-14 14:53:05 -06:00
commit 85297b12a2
31 changed files with 4015 additions and 0 deletions
@@ -0,0 +1,56 @@
+# 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)*