Guía del Desarrollador

Developer Guide

This guide is intended for software engineers contributing to AuditorIA.

Local Development Setup

Prerequisites: Docker Desktop, Node.js 18+, Python 3.10+.

1. Clone the Repository

git clone https://github.com/your-org/AuditorIA.git
cd AuditorIA

2. Run with Docker Compose

The easiest way to start the entire stack (Backend, Frontend, Database, MinIO, Keycloak) is:

docker-compose up --build

3. Service Endpoints

ServiceURLCredentials
Frontendhttp://localhost:3000N/A
Backend APIhttp://localhost:8000/docsN/A
MinIO Consolehttp://localhost:9001minioadmin / minioadmin
Keycloakhttp://localhost:8008admin / admin

Database Schema

AuditorIA uses PostgreSQL. Here is the high-level schema:

Authentication Flow (Keycloak)

  1. Frontend redirects user to Keycloak Login Page.
  2. User authenticates.
  3. Keycloak redirects back with Authorization Code.
  4. Frontend exchanges code for Access Token + Refresh Token.
  5. Frontend sends Access Token in Authorization header to Backend.
  6. Backend validates token signature (JWKS).
ArquitecturaOperaciones