# antoniiolpzzz/ssii-inferenceengine architecture

> Architecture diagram of the GitHub repository antoniiolpzzz/ssii-inferenceengine, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-03-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/antoniiolpzzz/ssii-inferenceengine
- Repository: https://github.com/antoniiolpzzz/ssii-inferenceengine

## Overview

A continuación se detalla cómo diseñar un diagrama de arquitectura del sistema específico para el Motor de Inferencia SBR. Este diagrama debe capturar claramente todos los componentes críticos y su flujo de información. Tenga en cuenta lo siguiente:

##### Identificar el Tipo de Proyecto y Propósito
- Se trata de un motor de inferencia basado en reglas (SBR) implementado en C++.
- El sistema utiliza el encadenamiento hacia atrás y calcula factores de certeza en el intervalo [-1,1].
- Su función principal es procesar archivos de definición de base de conocimientos (.bc) y base de hechos (.bh) para inferir conclusiones y documentar el proceso en archivos .log.

##### Analizar la Estructura del Proyecto
- Los directorios principales son:
- includes/: Contiene los archivos de cabecera con las definiciones de las clases centrales (Fact, FactBase, Rule, KnowledgeBase, InferenceEngine, Utils).
- sources/: Contiene las implementaciones correspondientes (.cpp) de las clases.
- main.cpp: Punto de entrada del programa, donde se orquesta el flujo del proceso de inferencia.
- test/: Conjuntos de archivos de entrada para pruebas.
- Se observa que la estructura está organizada en términos de “modelo” (las clases que representan la lógica de negocio) y el punto de entrada que centraliza la ejecución del algoritmo de inferencia.

##### Componentes Principales del Sistema
a. Entrada/Salida y Parsing:
- Entrada: Archivos de base de conocimientos (.bc) y base de hechos (.bh).
- Parseo: Proceso inicial en main.cpp que lee y valida estos archivos.
- Salida: Generación de archivos .log que documentan el proceso de inferencia.

b. Modelo de Datos:
- Fact: Representa hechos con un identificador y factor de certeza.
- Rule: Define las reglas con antecedente(s), consecuente, y operador lógico (AND/OR) junto con el factor de certeza.
- FactBase: Maneja el almacenaje, consulta y adición de hechos, incluyendo la gestión del hecho objetivo.
- KnowledgeBase: Almacena y gestiona las reglas.

c. Motor de Inferencia:
- InferenceEngine: Implementa la lógica de encadenamiento hacia atrás para evaluar el objetivo. Además, se encarga del cálculo y combinación de factores de certeza y la resolución de conflictos.
- Este componente es el centro de decisión que utiliza las bases de hechos y conocimientos para determinar el resultado de inferencia.

##### Relaciones e Interacciones
- main.cpp actúa como integrador: lee los archivos de entrada, crea instancias de FactBase y KnowledgeBase, y pasa estas instancias al InferenceEngine.
- El InferenceEngine consulta la KnowledgeBase para recuperar las reglas y, según el objetivo, utiliza la FactBase para evaluar si los hechos están presentes o necesitan ser inferidos.
- La salida se genera a partir de la evaluación de cada regla, registrando el proceso paso a paso en el log correspondiente.

##### Patrones de Diseño y Principios
- Separación de Concerns: Claramente se separa la lógica de lectura/parsing, el modelo (datos y reglas) y el motor de inferencia.
- Modularidad: Cada clase (Fact, Rule, etc.) se encarga de funciones específicas, lo que facilita pruebas y mantenimiento.
- Flujo de datos descendente: Desde la entrada (archivos .bc y .bh), pasando por la carga en estructuras internas (KnowledgeBase y FactBase) hasta la evaluación mediante InferenceEngine y la posterior generación de logs.

##### Guías para el Diagrama del Sistema
- Divida el diagrama en los siguientes bloques de componentes:
- Entrada/Salida: Incluir “Archivos .bc y .bh”, y “Parser (en main.cpp)” que transforma la entrada en estructuras internas.
- Capa de Modelo: Incluir bloques separados para las clases Fact, FactBase, Rule, y KnowledgeBase.
- Motor de Inferencia: Un bloque central para InferenceEngine que se conecta a la FactBase y KnowledgeBase.
- Salida: Bloque que representa la generación de archivos .log.
- Mostrar claramente las interacciones:
- Flechas direccionales desde Entrada al Parser, de este a la Capa de Modelo, y desde ambos al Motor de Inferencia.
- Flechas de flujo de información desde el Motor de Inferencia hacia la salida.
- Indicar en el diagrama los elementos claves como:
- Etiquetas claras en cada componente.
- Uso de colores o formas distintas para diferenciar entre módulos (por ejemplo: entrada/salida, lógica de negocio, motor de inferencia).
- Flechas direccionales que muestren el flujo, por ejemplo, “Lectura de archivos” → “Parseo y carga en FactBase/KnowledgeBase” → “Evaluación en InferenceEngine” → “Log de Salida”.

##### Instrucciones Específicas para el Diagrama
- Etiquetar cada componente con su nombre (ej. “Fact”, “Rule”, “InferenceEngine”) y agregar notas breves sobre su responsabilidad.
- Utilizar flechas para denotar dependencias: por ejemplo, main.cpp inicializa FactBase y KnowledgeBase, las cuales se utilizan en InferenceEngine.
- Se recomienda el uso de formas rectangulares para representar módulos, y de líneas o flechas con orientación para indicar el flujo de datos.
- Incluir en el diagrama una representación de los archivos de entrada y salida, enfatizando la transformación de datos.

Al seguir estas pautas, el diagrama de sistema reflejará con precisión la arquitectura del Motor de Inferencia SBR, mostrando cada módulo, su función, y cómo interactúan para procesar la información desde la entrada hasta la generación de log, lo que ayudará en el análisis, mantenimiento y posible ampliación del sistema.

## Diagram (Mermaid)

```mermaid
graph TD
    %% Entrada/Salida
    subgraph "Entrada/Salida"
        ES1["Archivos .bc y .bh"]:::entrada
        ES2["Parser (main.cpp)"]:::entrada
    end

    %% Capa de Modelo
    subgraph "Capa de Modelo"
        M1["Fact"]:::modelo
        M2["FactBase"]:::modelo
        M3["Rule"]:::modelo
        M4["KnowledgeBase"]:::modelo
        U["Utils"]:::modelo
    end

    %% Motor de Inferencia
    subgraph "Motor de Inferencia"
        IE["InferenceEngine"]:::motor
    end

    %% Salida
    subgraph "Salida"
        OUT["Log de Salida (.log)"]:::salida
    end

    %% Relaciones entre bloques
    ES1 -->|"Lectura_de_archivos"| ES2
    ES2 -->|"Carga_de_datos_en_FactBase"| M2
    ES2 -->|"Carga_de_datos_en_KnowledgeBase"| M4
    M1 -->|"almacena_en"| M2
    M3 -->|"almacena_en"| M4
    M2 -->|"datos_para"| IE
    M4 -->|"datos_para"| IE
    IE -->|"genera"| OUT
    IE -.->|"utiliza"| U

    %% Click Events
    click ES1 "https://github.com/antoniiolpzzz/ssii-inferenceengine/tree/main/test/"
    click ES2 "https://github.com/antoniiolpzzz/ssii-inferenceengine/blob/main/main.cpp"
    click M1 "https://github.com/antoniiolpzzz/ssii-inferenceengine/blob/main/includes/Fact.h"
    click M2 "https://github.com/antoniiolpzzz/ssii-inferenceengine/blob/main/includes/FactBase.h"
    click M3 "https://github.com/antoniiolpzzz/ssii-inferenceengine/blob/main/includes/Rule.h"
    click M4 "https://github.com/antoniiolpzzz/ssii-inferenceengine/blob/main/includes/KnowledgeBase.h"
    click IE "https://github.com/antoniiolpzzz/ssii-inferenceengine/blob/main/includes/InferenceEngine.h"
    click U "https://github.com/antoniiolpzzz/ssii-inferenceengine/blob/main/includes/Utils.h"

    %% Estilos
    classDef entrada fill:#AED6F1,stroke:#1B4F72,color:#000;
    classDef modelo fill:#ABEBC6,stroke:#196F3D,color:#000;
    classDef motor fill:#F5B7B1,stroke:#AF601A,color:#000;
    classDef salida fill:#F9E79F,stroke:#B7950B,color:#000;
```
