System Architecture

This page presents the complete system architecture of the knowledge base, helping contributors and maintainers quickly understand module responsibilities and data flows.

End-to-End Data Flow

Module Responsibilities

Module	File	Responsibility
Data model	schema.py	Category, AlgorithmEntry, Reference dataclass definitions
Registry	algorithm_registry.py	Load, index, full-text search
Category manager	category_manager.py	Category hierarchy queries, category_exists() validation
Validator	validate.py	Field rules + JSON Schema dual validation
Doc generator	generate_docs.py	Bilingual VitePress page generation
CLI	__main__.py	Command dispatch entry point

Design principle: All presentation layers (docs, README) are auto-generated from the data layer. Manual editing of generated files is prohibited.