Soberanía Digital · Capital Cognitivo · Local-First Enclave

---

🧠 Atlantyqa Cognitive Suite

No venimos solo a construir software. Entrenamos criterio humano para cooperar con sistemas inteligentes.

Atlantyqa Cognitive Suite es un ecosistema local-first diseñado para la ingesta, análisis semántico y gobernanza de capital cognitivo. Este proyecto permite a individuos y cooperativas gestionar sus datos de forma soberana, reproducible y auditable, alineándose con los estándares de privacidad y soberanía digital europea.

🌟 Pilares del Proyecto

• Soberanía Digital: Ejecución local (Enclave) sin dependencia de nubes externas para el procesamiento crítico.
• Aprendizaje Gamificado: Ruta de aprendizaje basada en la práctica ("Learning by Doing").
• Ecosistema Cooperativo: Diseñado para el capital compartido en comunidades técnicas y sociales.

---

🔁 Flujo de Inteligencia

La suite automatiza el ciclo de vida del dato desde su origen hasta su visualización y persistencia segura:

graph LR
    A[Fuentes de Datos] -->|Ingesta| B[Ingestor Multi-formato]
    B -->|Normalización| C[Pipeline Cognitivo]
    C -->|NLP / Semántica| D[Análisis & Insights]
    D -->|Visualización| E[UX Prototype]
    D -->|Persistencia| F[GitOps Sync]

Loading

---

⚡ Quick Start

A. Demo Local (Docker)

Ideal para una primera exploración sin configurar el entorno de desarrollo.

# 1. Login en el registro (requiere PAT si es privado)
docker login ghcr.io

# 2. Desplegar servicios demo
docker compose -f docker-compose.local-demo.yml up -d

Tip

Accede a la interfaz en http://localhost:8501 tras el despliegue.

B. Modo Desarrollador (Python CLI)

Para aquellos que quieren entrar directo al código y personalizar el pipeline.

# Sincroniza y prepara el entorno
python cogctl.py init

# Ingesta y análisis
python cogctl.py ingest data/input/mi_archivo.pdf
python cogctl.py analyze

---

🚀 Onboarding por Audiencia (Nuevo)

Para acelerar adopción en early-adopters, la suite incluye bootstraps por rol/dispositivo:

# Developer (Ubuntu/Debian)
./scripts/bootstrap.sh --role developer --profile full

# DevSecOps (Ubuntu/Debian)
./scripts/bootstrap.sh --role devsecops --profile full

# Android (Termux, perfil ligero)
./scripts/bootstrap-android.sh --role developer --profile lite

# Stakeholder / usuario final (demo rápida)
./scripts/bootstrap-stakeholder.sh --lang es --run-demo

Smoke test transversal de bootstraps:

./test-bootstrap.sh

---

🧰 VSCode Canonizado para Early-Adopters

Se versionó un perfil de workspace común para estandarizar setup local:

• .vscode/settings.json
• .vscode/extensions.json
• .vscode/tasks.json

Guía de uso:

• ES: docs/vscode-tooling-setup.md
• EN: docs/vscode-tooling-setup.en.md

---

🔒 Seguridad y SCA en la Rama

Se replicó la auditoría de dependencias (pip-audit) para:

• requirements.txt
• requirements-docs.txt
• frontend/requirements.txt
• ingestor/requirements.txt
• pipeline/requirements.txt

Resultado: No known vulnerabilities found en los manifests auditables.

---

🎮 Ruta de Aprendizaje (Gamified)

Cada contribución es un paso en tu evolución como profesional de la Era Cognitiva.

Nivel	Rol	Badge	Reto Sugerido
1	Cognitive Explorer		Ejecuta el flujo init → ingest → analyze y valida los resultados.
2	Cognitive Builder		Ajusta pesos o categorías en el pipeline de análisis semántico.
3	Cognitive Engineer		Desarrolla un nuevo conector de ingesta o mejora los tests de CI.
4	Cognitive Steward		Lidera la gobernanza de datos y mentoriza a nuevos compañeros.

---

� Arquitectura

Directorio	Propósito
docs/	Documentación técnica y estratégica (MkDocs).
ingestor/	Extracción de contenido (PDF, DOCX, Audio, Vídeo).
pipeline/	Motor de análisis cognitivo (spaCy + Transformers).
frontend/	UI interactiva basada en Streamlit.
gitops/	Automatización de flujos de sincronización.
schemas/	Definición de contratos de datos (JSON Schema).

---

📚 Documentación Expandida

La suite cuenta con un portal de documentación completo generado con MkDocs Material:

• 📖 Portal de Docs: https://atlantyqa-labs.github.io/cognitive-suite/
• 🛠️ Guía de Instalación
• 🧭 Bootstraps por Audiencia
• 🧰 VSCode para early-adopters
• 🧭 Visión de Usuario
• 🤝 Cómo Contribuir

---

⚖️ Licencia y Modelo

Este proyecto es software libre bajo la licencia EUPL-1.2. Desarrollado dentro del ecosistema ATLANTYQA como infraestructura de capital cognitivo compartido.

"El futuro no se predice. Se entrena. Y se entrena mejor en cooperación."