📜 Documentación Técnica: Proyecto Tamalbits (PHP/JS)

Esta documentación ha sido preparada para estudiantes de ingeniería de software, enfocándose en la arquitectura, el flujo de datos y la integración de sistemas.

🏗️ Arquitectura del Sistema

El proyecto utiliza un modelo de Arquitectura Desacoplada donde el frontend y el backend interactúan mediante servicios RESTful.

graph TD
    A[Frontend: HTML5/JS/Bootstrap] -- Fetch API --> B[Proxy PHP]
    B -- cURL --> C[API Externa: Banco]
    A -- Fetch API --> D[Backend Local PHP]
    D -- mysqli --> E[(Base de Datos MySQL)]

Capas del Sistema:

Presentación: HTML5, CSS3 (Vanilla + Bootstrap 5).
Lógica del Cliente: JavaScript asíncrono (Fetch API).
Integración: Proxy PHP para consumo de APIs externas.
Servicios Backend: Endpoints PHP para lógica de negocio local.
Persistencia: MySQL gestionado vía MySQLi.

📂 Descripción de Archivos

1. Capa de Datos (Backend PHP)

Archivo	Propósito	Puntos Clave
`db.php`	Conexión a la Base de Datos	Configura el charset `utf8mb4` y maneja errores de conexión.
`productos.php`	Catálogo de Productos	Consulta la tabla `productos` y retorna un JSON normalizado.
`usuario.php`	Perfil de Usuario	Obtiene saldo de "Tamalbits" usando Sentencias Preparadas.
`gastos.php`	Transacciones y Puntos	Registra compras y actualiza puntos de fidelidad (Tamalbits).

2. Capa de Integración (Integración)

proxy.php: Implementa el Patrón Proxy. Actúa como intermediario entre el navegador y una API bancaria externa.
- Razón técnica: Resuelve problemas de CORS y oculta la estructura de la API externa al cliente.

📜 Documentación Técnica: Proyecto Tamalbits (PHP/JS)

🏗️ Arquitectura del Sistema

Capas del Sistema:

📂 Descripción de Archivos

1. Capa de Datos (Backend PHP)

2. Capa de Integración (Integración)

3. Frontend y Estilos