How whenkey2007/synapse works
Synapse is a self-healing knowledge base: users trigger audits of connected documentation, review detected findings, and approve or roll back corrections. Its backend exposes document, audit, policy, history, authentication, and ledger capabilities; semantic analysis and confidence scoring inform findings, while SQLite stores knowledge and audit state. The README documents the broader product capabilities, but excerpts do not establish every runtime connection—unverified optional notification delivery is shown separately.
Main entry points: api.py REST API · engine.py Audit Engine · database.py SQLite Knowledge Store · intelligence.py Semantic Intelligence
Components 15
User Interface & API
- Web Application
dist/app.js - REST API
backend/api.py - API Schemas
backend/models.py
Audit & Intelligence
- Audit Engine
backend/engine.py - Semantic Intelligence
backend/intelligence.py - AI Evaluation
backend/evaluate_ml_model.py
Review & Security
- Findings & Healing
backend/engine.py - Authentication & RBAC
backend/security.py - Alert Dispatcher
backend/notifications.py
Knowledge & Ledger
- Document Sources
backend/api.py - Initial Knowledge Data
backend/seed_data.py - SQLite Knowledge Store
backend/database.py - Audit History Ledger
backend/database.py
Other components
- Knowledge Users
- Slack Webhook
Connections 20
- Knowledge Users → Web Application: uses
README.md - Web Application → REST API: requests data
- REST API → Web Application: serves application
README.md - REST API → API Schemas: uses schemas
backend/api.py - REST API → SQLite Knowledge Store: reads and writes
backend/api.py - REST API → Audit Engine: triggers audits
backend/api.py - REST API → Authentication & RBAC: authenticates and authorizes
backend/api.py - REST API → Semantic Intelligence: verifies ledger
backend/api.py - REST API → Document Sources: syncs sources
README.md - Audit Engine → SQLite Knowledge Store: reads and updates
backend/engine.py - Audit Engine → Semantic Intelligence: uses reasoning
backend/engine.py - Audit Engine → Findings & Healing: routes findings
README.md - Findings & Healing → Audit History Ledger: records decisions
backend/engine.py - Semantic Intelligence → Audit History Ledger: verifies chain
backend/api.py - AI Evaluation → Semantic Intelligence: evaluates analysis
backend/evaluate_ml_model.py - AI Evaluation → Audit Engine: evaluates routing
backend/evaluate_ml_model.py - SQLite Knowledge Store → Initial Knowledge Data: loads initial data
backend/database.py - SQLite Knowledge Store → Authentication & RBAC: hashes seeded passwords
backend/database.py - Findings & Healing → Alert Dispatcher: may dispatch alerts
- Alert Dispatcher → Slack Webhook: posts webhook
backend/notifications.py