# dturkuler/human-design architecture

> Architecture diagram of the GitHub repository dturkuler/human-design, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dturkuler/human-design
- Repository: https://github.com/dturkuler/human-design

## Overview

##### Main Components

a) Core Engine Components:
- Feature Calculator Module (hd_features.py)
- Constants Module (hd_constants.py)
- JSON Converter (convertJSON.py)
- Geocoding Service (geocode.py)

b) Input/Output Systems:
- Time/Date Input Handler
- Timezone Processing System
- JSON Output Formatter

c) Calculation Modules:
- Single Feature Calculator
- Composite Feature Calculator
- Multiple Instance Calculator

##### Component Relationships

**[Input Layer]**

- ▼
**[Core Processing Layer]**

- [Single Feature Calculator]

- Basic Values Calculator
- Profile Calculator
- Authority Calculator
- Type Calculator

- [Composite Feature Calculator]

- Channel Compositor
- Chakra Compositor

- [Multiple Instance Calculator]

- Parallel Processing Unit
- Results Aggregator

- ▼
**[Output Layer]**

##### Important Elements to Highlight

a) Data Flow Patterns:
- How birth time data flows through the system
- Parallel processing paths for multiple calculations
- Timezone conversion points

b) Key Integration Points:
- Timezone handling (pytz integration)
- Geocoding services
- JSON conversion interface

##### Technical Details

- Python version compatibility
- CPU utilization for parallel processing
- Memory management for large calculations
- Data structure transformations

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles
    classDef input fill:#a8d1f0,stroke:#000
    classDef core fill:#90EE90,stroke:#000
    classDef utility fill:#FFE5B4,stroke:#000
    classDef critical fill:#FFB6C1,stroke:#000
    classDef output fill:#a8d1f0,stroke:#000

    %% Input Layer
    subgraph InputLayer
        TimeInput["Time/Date Input Handler"]:::input
        TZProcess["Timezone Processing"]:::input
        GeoService["Geocoding Service"]:::utility
    end

    %% Core Processing Layer
    subgraph CoreLayer
        FeatureCalc["Feature Calculator"]:::core
        Constants["Constants Module"]:::core
        JsonConv["JSON Converter"]:::utility
    end

    %% Calculation Modules
    subgraph CalcModules
        %% Single Feature Calculator
        subgraph SingleCalc
            BasicCalc["Basic Values Calculator"]:::core
            ProfileCalc["Profile Calculator"]:::core
            AuthCalc["Authority Calculator"]:::core
            TypeCalc["Type Calculator"]:::core
        end

        %% Composite Feature Calculator
        subgraph CompositeCalc
            ChannelComp["Channel Compositor"]:::core
            ChakraComp["Chakra Compositor"]:::core
        end

        %% Multiple Instance Calculator
        subgraph MultiCalc
            ParallelProc["Parallel Processing Unit"]:::core
            ResultsAgg["Results Aggregator"]:::core
        end
    end

    %% Output Layer
    subgraph OutputLayer
        JsonOut["JSON Output"]:::output
        ValidationOut["Validation Output"]:::output
    end

    %% Relationships
    TimeInput --> GeoService
    TimeInput --> TZProcess
    TZProcess --> FeatureCalc
    GeoService --> FeatureCalc

    FeatureCalc --> SingleCalc
    FeatureCalc --> CompositeCalc
    FeatureCalc --> MultiCalc
    Constants --> FeatureCalc
    
    BasicCalc & ProfileCalc & AuthCalc & TypeCalc --> JsonConv
    ChannelComp & ChakraComp --> JsonConv
    ParallelProc --> ResultsAgg
    ResultsAgg --> JsonConv
    
    JsonConv --> JsonOut
    JsonConv --> ValidationOut

    %% Click Events
    click FeatureCalc "https://github.com/dturkuler/Human-Design/blob/main/hd_features.py"
    click Constants "https://github.com/dturkuler/Human-Design/blob/main/hd_constants.py"
    click JsonConv "https://github.com/dturkuler/Human-Design/blob/main/convertJSON.py"
    click GeoService "https://github.com/dturkuler/Human-Design/blob/main/geocode.py"

    %% Legend
    subgraph Legend
        L1["Input/Output Components"]:::input
        L2["Core Components"]:::core
        L3["Utility Components"]:::utility
        L4["Critical Path Components"]:::critical
    end
```
