Introduction to TAMV Atlas
Relevant source files
The following files were used as context for generating this wiki page:
TAMV Atlas is a full-stack platform and monorepo designed to operate as a central knowledge and operational base for the TAMV ONLINE (Tecnología Avanzada Mexicana Versátil) ecosystem. It integrates a React-based frontend with a Node.js backend to manage identity through Decentralized Identifiers (DIDs) and Persistent Identifiers (PIDs), execute cryptographic signatures, and handle repository federation. The system is defined as a Federated Civilizational Ecosystem that provides technological sovereignty infrastructure for Latin America.
Sources: README.md:3-10, src/pages/wiki/modulo-cero/Introduccion.tsx:7-12
Architectural Overview
The project follows a modular, full-stack architecture that bridges theoretical documentation with executable code. It consists of a frontend for wiki and module rendering, a backend API for core services, and a federated kernel that manages logic for protocols and identity.
System Dimensions
The ecosystem is organized into five interdependent dimensions:
- Ontological: Defines entities via ISNI, PIDs (ORCID, DOI, ROR), and DIDs/SSI.
- Technical (MD-X4 / MD-X5): Provides infrastructure for execution, observability, and the HOYO NEGRO protocol.
- Cognitive (Isabella AI): Orchestrates system interaction and cognitive security.
- Academic (UTAMV): Manages knowledge structure and competency validation.
- Territorial (RDM Digital): Connects the digital ecosystem to physical nodes like Real del Monte.
Sources: src/pages/wiki/modulo-cero/Introduccion.tsx:24-30, README.md:38-46
Component Relationship Diagram
This diagram illustrates the high-level flow between the user interface, the API server, and the underlying kernel services.
The diagram shows the interaction between the React/Vite frontend and the Node API Server, which orchestrates various services including identity modules and the AtlasKernelRuntime.
Sources: README.md:40-48
Core System Modules
The TAMV Atlas is structured into 14 distinct modules, ranging from foundational identity concepts to advanced AI and philosophy.
| Module ID | Code | Label | Description |
|---|---|---|---|
| 0 | MD-X4 | Modulo 0 · Observabilidad | MD-X4 civilizational observability core. |
| 1 | ISNI-CORE | Modulo 1 · Fundamentos ISNI | Base architecture for Sovereign Name Infrastructure. |
| 2 | ISNI-ARCH | Modulo 2 · Arquitectura ISNI | System layers, domains, and ontologies. |
| 8 | APIS | Modulo 8 · Implementación Técnica | Service specifications and sovereign endpoints. |
| 12 | XR-AI | Modulo 12 · Metaverso / XR / IA | Isabella AI, DreamSpaces, and DEKATEOTL security. |
| 13 | OMEGA | Modulo Ω · Filosofía | TAMV Manifesto and editorial intelligence. |
Sources: src/App.tsx:39-54, src/data/wikiStructure.ts:16-160
Technical Implementation and CI/CD
The system operates under the QC-TAMV-01 Constitutional Quality Framework, which enforces non-negotiable technical invariants via automated pipelines. This framework applies to humans, AI agents, and CI/CD runners.
Constitutional Laws (L1-L4)
- L1 (Unique Root):
createRootmust exist only insrc/main.tsx. - L2 (Unique Router):
BrowserRouterrestricted tosrc/App.tsx. - L3 (Unique Design):
Layout.tsxmounted exactly once inApp.tsx. - L4 (Route-Page Correspondence): Every file in
src/pages/*maps to a single route.
Sources: src/pages/wiki/implementacion/CicdPipelines.tsx:21-38
MD-X5 (Deca-V) Pipeline
The pipeline consists of 10 cycles required for pull requests to the main branch:
This diagram outlines the mandatory 10-cycle deployment pipeline defined in the MD-X5 kernel.
Sources: src/pages/wiki/implementacion/CicdPipelines.tsx:49-65
Operational Status and Readiness
TAMV Atlas is currently in an advanced pre-production phase. Functional areas such as the frontend and core backend endpoints are highly developed, while enterprise security and monitoring are still in active evolution.
| Area | Status | Progress % |
|---|---|---|
| Frontend | Stable for iteration | 78% |
| Backend Core | Functional, monolithic | 72% |
| Repository Federation | Functional (GitHub/Subtree) | 68% |
| Global Readiness | Production hardening required | 56% |
Sources: README.md:104-122
Runtime Behavior and Security
The system implements safety locks for documental agents and AI entities. External text is treated as untrusted data, and restricted operations include prohibiting direct changes to production logic without human authorization. The CANON_LOCK is set to TRUE to preserve the Master Canon from unauthorized modifications.
Sources: federation/tamv-digital-nexus/AGENTS.md:7-12, federation/tamv-digital-nexus/AGENTS.md:21-25
Summary
The TAMV Atlas serves as the executive interface between governance and engineering for the TAMV ONLINE ecosystem. It provides the necessary infrastructure to manage digital identities, federate code repositories, and maintain a verifiable narrative of technological sovereignty through its MD-X4/X5 kernels. Its development focuses on "Dignity-by-Design," ensuring that technical functionality remains secondary to ethical and human-centric principles.
Sources: src/pages/wiki/modulo-cero/Introduccion.tsx:12-18, README.md:88-92