# sentientdoorknob/tseki architecture

> Architecture diagram of the GitHub repository sentientdoorknob/tseki, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-02-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sentientdoorknob/tseki
- Repository: https://github.com/sentientdoorknob/tseki

## Overview

##### Project type and purpose
- From the file tree and the minimal README (“# tsekI”), we see a small C-based application or library named “tsekI.”
- It uses a 3rd-party OpenGL loader (libs/glad.c/.h + khrplatform.h), has a platform-specific subfolder (src/linux/), a core interface (src/tsekI.*), and a “main.c” entry point.
- This suggests tsekI is a cross-platform C application or library that wraps some functionality (possibly graphics or system calls) behind a common interface.

##### File structure
- Top level:
- main.c – application entry point
- libs/ – 3rd-party OpenGL loading library
- src/ – our own source code
– src/tsekI.c/.h – core interface and logic
– src/tsekG.h – global definitions or shared types
– src/linux/tsekL.c/.h – Linux-specific implementation of the interface
- makefile – build orchestration
- tsekI – probably the built executable or a script wrapper
- Architectural pattern: a small “core interface” + “platform-specific” plugin/implementation + thin executable layer

##### Key insights from README
- There is no further architectural doc in the README; all hints come from the code layout.

##### Detail without over-splitting
- Essential layers: entry point, core interface, platform adapter, external lib, operating system, and build system.
- Be precise in showing which module depends on or implements which interface.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Entry Layer
    main["main.c"]:::entry

    %% Core Interface/Logic Module
    subgraph "Core Interface / Logic Module"
        direction TB
        core_c["tsekI.c"]:::core
        core_h["tsekI.h"]:::core
        core_g["tsekG.h"]:::core
    end

    %% Platform Adapter
    subgraph "Platform Adapter (Linux)"
        direction TB
        adapter_c["tsekL.c"]:::adapter
        adapter_h["tsekL.h"]:::adapter
    end

    %% Third-Party Library
    subgraph "Third-Party Library (GLAD)"
        direction TB
        glad_c["glad.c"]:::external
        glad_h["glad.h"]:::external
        khr["khrplatform.h"]:::external
    end

    %% Operating System / OpenGL Runtime
    os["OS / OpenGL Runtime"]:::os

    %% Build System
    make["Makefile"]:::build

    %% Connections
    main -->|"initialize()/draw()"| core_c
    core_c -->|"calls interface"| adapter_c
    adapter_c -->|"loads functions"| glad_c
    glad_c -->|"dynamic link"| os

    make --> main
    make --> core_c
    make --> adapter_c
    make --> glad_c

    %% Click Events
    click main "https://github.com/sentientdoorknob/tseki/blob/main/main.c"
    click core_c "https://github.com/sentientdoorknob/tseki/blob/main/src/tsekI.c"
    click core_h "https://github.com/sentientdoorknob/tseki/blob/main/src/tsekI.h"
    click core_g "https://github.com/sentientdoorknob/tseki/blob/main/src/tsekG.h"
    click adapter_c "https://github.com/sentientdoorknob/tseki/blob/main/src/linux/tsekL.c"
    click adapter_h "https://github.com/sentientdoorknob/tseki/blob/main/src/linux/tsekL.h"
    click glad_c "https://github.com/sentientdoorknob/tseki/blob/main/libs/glad.c"
    click glad_h "https://github.com/sentientdoorknob/tseki/blob/main/libs/glad.h"
    click khr "https://github.com/sentientdoorknob/tseki/blob/main/libs/khrplatform.h"
    click make "https://github.com/sentientdoorknob/tseki/tree/main/makefile"

    %% Styles
    classDef entry fill:#cce5ff,stroke:#2a6496,stroke-width:1px
    classDef core fill:#d4edda,stroke:#155724,stroke-width:1px
    classDef adapter fill:#ffe5b4,stroke:#d2691e,stroke-width:1px
    classDef external fill:#e2e3e5,stroke:#6c757d,stroke-width:1px
    classDef os fill:#f8f9fa,stroke:#adb5bd,stroke-width:1px
    classDef build fill:#fff3cd,stroke:#856404,stroke-width:1px
```
