Technical Documentation / Documentacion Tecnica

This folder contains the bilingual technical and operational documentation for the Link Analysis Platform, based on the current implementation in the repository.

Esta carpeta contiene la documentacion tecnica y operativa bilingue de Link Analysis Platform, basada en la implementacion actual del repositorio.

Scope / Alcance

• Source of truth: current codebase, especially server.ts, src/App.tsx, ontology_config.json, package.json, Dockerfile, and docker-compose.yml.

• Fuente de verdad: el codigo actual, especialmente server.ts, src/App.tsx, ontology_config.json, package.json, Dockerfile y docker-compose.yml.

• This documentation does not rewrite or replace the existing project README.

• Esta documentacion no reescribe ni sustituye el README actual del proyecto.

• The goal is technical and operational clarity for developers, operators, and reviewers.

• El objetivo es aportar claridad tecnica y operativa para desarrolladores, operadores y revisores.

Documents / Documentos

• architecture.md: system architecture, runtime model, major components, and functional flows.

• architecture.md: arquitectura del sistema, modelo de ejecucion, componentes principales y flujos funcionales.

• api.md: authentication, authorization, endpoint inventory, and main request/response contracts.

• api.md: autenticacion, autorizacion, inventario de endpoints y contratos principales de peticion/respuesta.

• data-model.md: SQLite schema, ontology model, risk engine, snapshots, and audit concepts.

• data-model.md: esquema SQLite, modelo de ontologia, motor de riesgo, snapshots y conceptos de auditoria.

• operations.md: environment variables, local execution, build/deployment, persistence, and operational considerations.

• operations.md: variables de entorno, ejecucion local, build/despliegue, persistencia y consideraciones operativas.

Current Documentation Notes / Notas Sobre La Documentacion Actual

• The repository already contains a functional README, but parts of it do not fully match the current implementation.

• El repositorio ya contiene un README funcional, pero algunas partes no coinciden del todo con la implementacion actual.

• Examples: the backend currently uses Anthropic for AI features, while some config files still reference Gemini-related variables.

• Ejemplos: el backend usa actualmente Anthropic para las funciones de IA, mientras algunos archivos de configuracion todavia mencionan variables relacionadas con Gemini.

• Therefore, this docs/ set should be treated as the implementation-aligned reference.

• Por eso, este conjunto dentro de docs/ debe considerarse la referencia alineada con la implementacion.