Skip to content

SYSTEM_OVERVIEW.md

Latest commit

 

History

History
110 lines (82 loc) · 4.27 KB

SYSTEM_OVERVIEW.md

File metadata and controls

110 lines (82 loc) · 4.27 KB
Raw

TeachLink System Overview

Welcome to the TeachLink ecosystem—a decentralized knowledge-sharing platform powered by the Stellar network. This document provides a high-level overview of the entire system architecture, integrating blockchain smart contracts, real-time data indexing, and machine learning-driven recommendations.

🏗️ The Three Pillars

The TeachLink platform is built on three foundational pillars that work in harmony to deliver a seamless decentralized learning experience.

1. Blockchain Core (Soroban Smart Contracts)

The heart of TeachLink resides on the Stellar network. Our smart contracts, written in Rust for the Soroban platform, handle all critical business logic with transparency and security.

  • Key Features: Cross-chain bridging, BFT consensus, multi-sig escrow, content tokenization (NFTs), and decentralized reputation scoring.
  • Location: contracts/
  • Documentation: Architecture Details | API Reference

2. Data Availability Layer (Indexer Runtime)

To provide a fast and responsive user experience, TeachLink employs a high-performance indexer that monitors the Stellar blockchain in real-time.

  • Tech Stack: TypeScript, NestJS, PostgreSQL, Prometheus.
  • Key Features: Event processing, historical data archival, and a robust REST API for client applications.
  • Location: indexer/
  • Documentation: Indexer Implementation | Monitoring Guide

3. Intelligence Layer (Recommendation System)

TeachLink leverages machine learning to personalize the learning journey for every user, ensuring high engagement and effective knowledge transfer.

  • Tech Stack: Python, TensorFlow/PyTorch, Scikit-learn.
  • Key Features: Content discovery, personalized learning paths, and predictive reputation modeling.
  • Location: recommendation-system/
  • Documentation: ML Architecture | Implementation Guide

🗺️ Global System Map

The following diagram illustrates how the three pillars interact to form the complete TeachLink ecosystem.

graph TD
    subgraph Users["User Interfaces"]
        UI[Web/Mobile Apps]
    end

    subgraph Intelligence["Intelligence Layer"]
        RS[Recommendation System]
        ML[ML Models]
        RS --- ML
    end

    subgraph Data["Data Layer"]
        IDX[Indexer Runtime]
        DB[(PostgreSQL)]
        PROM[Prometheus/Grafana]
        IDX --- DB
        IDX --- PROM
    end

    subgraph Chain["Blockchain Layer (Stellar)"]
        SC[TeachLink Smart Contracts]
        LEDGER[Stellar Ledger]
        SC --- LEDGER
    end

    UI <-->|"API Requests"| IDX
    UI <-->|"Contract Calls"| SC
    IDX <--"Syncs events"--> SC
    RS <--"Consumes data"--> DB
    UI <--"Personalization"--> RS

    style Chain fill:#e1f5fe,stroke:#01579b
    style Data fill:#f3e5f5,stroke:#4a148c
    style Intelligence fill:#e8f5e9,stroke:#1b5e20
    style Users fill:#fff3e0,stroke:#e65100
Loading

🛠️ Technology Stack

Layer Technologies
Smart Contracts Rust, Soroban SDK, Stellar CLI
Indexer/Backend TypeScript, NestJS, TypeORM, PostgreSQL
Machine Learning Python, Pandas, NumPy, Scikit-learn
DevOps Docker, GitHub Actions, Prometheus, Grafana
Testing Cargo Test, Jest, Property-based Testing

🚀 Getting Started

If you are a developer looking to contribute or deploy the system, follow these links:

  1. Environment Setup: See the Onboarding section in README.
  2. Contract Development: Explore the Developer Experience Toolkit.
  3. Indexing & Monitoring: Check the Observability Guide.
  4. Contribution: Read our Contributing Guidelines.

📜 Repository Health & Safety

Built with ❤️ by the TeachLink Team