Knowledge Portal · engineering documentation

Skip to content

ZAIXOS Engineering Platform — Technical Architecture Index

Document type: Technical Authority Index
Version: 1.0 · Phase: 12-3
Status: Permanent technical authority — supersedes informal layout assumptions
Parent: PLATFORM_INDEX.md


Purpose

This index is the entry point for how ZEP works internally — packages, dependencies, installation, configuration, materialization, validation, execution, lifecycle, and evolution.

Governance answers who owns what. Product definition answers what ZEP is. This layer answers how components connect and behave.


Start here

RoleDocument
Implementer (any layer)TECHNICAL_ARCHITECTURE.md
Package / Composer authorPACKAGE_ARCHITECTURE.md · DEPENDENCY_MODEL.md
Product integratorINSTALLATION_ARCHITECTURE.md · PLATFORM_CONFIGURATION_REFERENCE.md
Adapter authorRUNTIME_MATERIALIZATION.md · PUBLIC_API_ARCHITECTURE.md
Extension authorEXTENSION_ARCHITECTURE.md
Validation authorVALIDATION_ARCHITECTURE.md
Architect / phase ownerEXECUTION_ARCHITECTURE.md · EXECUTION_PIPELINE.md
Release managerPLATFORM_STATE_MACHINE.md · ASSET_LIFECYCLE.md · EVOLUTION_MODEL.md

Technical specification suite (Phase 12-3)

#DocumentTopic
1TECHNICAL_ARCHITECTURE.mdMaster technical architecture and models
2PACKAGE_ARCHITECTURE.mdLogical and physical package layout
3DEPENDENCY_MODEL.mdDependency graph and rules
4INSTALLATION_ARCHITECTURE.mdInstall modes and bootstrap
5CONFIGURATION_ARCHITECTURE.mdConfiguration hierarchy
6EXTENSION_ARCHITECTURE.mdExtension merge and registry
7RUNTIME_MATERIALIZATION.mdMaterialization engine and flows
8VALIDATION_ARCHITECTURE.mdValidation layers and gates
9PUBLIC_API_ARCHITECTURE.mdPublic API technical surface
10PLATFORM_CONFIGURATION_REFERENCE.mdNormative config schemas
11TECHNICAL_DECISION_RECORDS.mdTDR-001–TDR-012
12EXECUTION_ARCHITECTURE.mdExecution pipeline overview
13PLATFORM_STATE_MACHINE.mdPlatform asset states
14ASSET_LIFECYCLE.mdPer-asset lifecycle matrix
15EXECUTION_PIPELINE.mdRuntime pipelines (control + data)
16EVOLUTION_MODEL.mdChange, migration, compatibility

Authority hierarchy

Company Constitution
    └── Platform Constitution (governance)
            └── Platform Boundaries · Public API · Versioning · Extension Model
                    └── Product Definition (12-2)
                            └── Technical Architecture (12-3) ◄── THIS LAYER
                                    └── Extraction Planning (12-4+) — not started

Technical specs implement governance constraints; they do not amend Runtime Contract obligations (contracts@1 frozen).


Canonical topic map

TopicTechnical authorityGovernance authority
Asset ownershipReferenced in all technical docsPLATFORM_BOUNDARIES.md
Public vs Internal APIPUBLIC_API_ARCHITECTURE.mdPLATFORM_PUBLIC_API.md
ExtensionsEXTENSION_ARCHITECTURE.mdPLATFORM_EXTENSION_MODEL.md
VersioningEVOLUTION_MODEL.mdPLATFORM_VERSIONING_POLICY.md
Execution phasesEXECUTION_PIPELINE.mdMethodology docs (Platform Core)

Technical Index v1.0 — Phase 12-3 complete. Phase table: PLATFORM_INDEX.md.

ZAIXOS Knowledge Portal — public engineering docs at /docs · Staff operations at /admin