# helaoban/fixtrate architecture

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

- Interactive diagram: https://gitdiagram.com/helaoban/fixtrate
- Repository: https://github.com/helaoban/fixtrate

## Overview

Fixtrate is a Python toolkit for FIX protocol communication. Its principal workflow is to configure a FIX session, establish a transport to a peer, exchange parsed and serialized messages, and maintain session state and message history. The server side accepts and authenticates peers before exposing sessions. Separate modules provide FIX session-layer messages and FIX 4.2 application messages, with typed fields and validation. The graph reflects documented and indexed references; unsampled relationships are omitted where the available evidence does not establish a call.

Main entry points: [`fixtrate/message.py`](https://github.com/helaoban/fixtrate/blob/develop/fixtrate/message.py) (FIX Message), [`fixtrate/session.py`](https://github.com/helaoban/fixtrate/blob/develop/fixtrate/session.py) (FIX Session), [`fixtrate/server.py`](https://github.com/helaoban/fixtrate/blob/develop/fixtrate/server.py) (FIX Server), [`fixtrate/store/base.py`](https://github.com/helaoban/fixtrate/blob/develop/fixtrate/store/base.py) (Store Interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_connection["FIX Connectivity"]
  node_config["Session Config<br/>[config.py]"]
  node_client["FIX Session<br/>[session.py]"]
  node_server["FIX Server<br/>[server.py]"]
  node_transport["Transport<br/>[transport.py]"]
end

subgraph group_protocol["FIX Protocol"]
  node_parser["FIX Parser<br/>[parse.py]"]
  node_message["FIX Message<br/>[message.py]"]
  node_fixtdata["Session Fields<br/>[data.py]"]
  node_fixttypes["Session Tags<br/>[types.py]"]
  node_fixtvalidate["Session Validation<br/>[validate.py]"]
  node_admin["Session Messages"]
  node_enum["Enum Utilities<br/>[enum.py]"]
end

subgraph group_application["FIX 4.2 Messages"]
  node_fix42["FIX 4.2 Messages"]
  node_fix42validate["FIX 4.2 Validation<br/>[validate.py]"]
  node_fix42types["FIX 4.2 Tags<br/>[types.py]"]
end

subgraph group_state["Session State"]
  node_helpers["Session Helpers<br/>[helpers.py]"]
  node_storefactory["Store Selection<br/>[__init__.py]"]
  node_storebase["Store Interface<br/>[base.py]"]
  node_memory[("Memory Store<br/>[inmemory.py]")]
  node_redis[("Redis Store<br/>[redis.py]")]
end

node_user(("Application"))
node_peer(("FIX Peer"))

node_user -->|"connects"| node_client
node_peer -.->|"connects"| node_server
node_client -->|"uses"| node_config
node_client -->|"reads and writes"| node_transport
node_client -->|"parses input"| node_parser
node_client -->|"stores session state"| node_storebase
node_client -->|"builds admin messages"| node_helpers
node_server -->|"creates sessions"| node_client
node_server -->|"parses logon"| node_parser
node_server -->|"reads peer data"| node_transport
node_server -->|"uses config"| node_config
node_parser -->|"constructs"| node_message
node_message -->|"uses message types"| node_fixtdata
node_message -->|"uses tags"| node_fixttypes
node_admin -->|"builds messages"| node_message
node_fixtvalidate -->|"uses type map"| node_fixttypes
node_fixtdata -->|"defines enums"| node_enum
node_fixttypes -->|"defines enums"| node_enum
node_fix42 -->|"constructs messages"| node_message
node_fix42 -->|"validates fields"| node_fix42validate
node_fix42 -->|"uses tags"| node_fix42types
node_fix42validate -->|"uses type map"| node_fix42types
node_fix42types -->|"defines enums"| node_enum
node_helpers -->|"builds messages"| node_message
node_helpers -->|"uses config"| node_config
node_helpers -->|"uses store interface"| node_storebase
node_storefactory -->|"selects implementation"| node_storebase
node_storefactory -->|"selects implementation"| node_memory
node_storefactory -->|"selects implementation"| node_redis
node_memory -->|"implements"| node_storebase
node_redis -->|"implements"| node_storebase
node_memory -->|"stores messages"| node_message
node_redis -->|"stores messages"| node_message

click node_config "https://github.com/helaoban/fixtrate/blob/develop/fixtrate/config.py"
click node_client "https://github.com/helaoban/fixtrate/blob/develop/fixtrate/session.py"
click node_server "https://github.com/helaoban/fixtrate/blob/develop/fixtrate/server.py"
click node_transport "https://github.com/helaoban/fixtrate/blob/develop/fixtrate/transport.py"
click node_parser "https://github.com/helaoban/fixtrate/blob/develop/fixtrate/parse.py"
click node_message "https://github.com/helaoban/fixtrate/blob/develop/fixtrate/message.py"
click node_fixtdata "https://github.com/helaoban/fixtrate/blob/develop/fixtrate/fixt/data.py"
click node_fixttypes "https://github.com/helaoban/fixtrate/blob/develop/fixtrate/fixt/types.py"
click node_fixtvalidate "https://github.com/helaoban/fixtrate/blob/develop/fixtrate/fixt/validate.py"
click node_admin "https://github.com/helaoban/fixtrate/tree/develop/fixtrate/fixt"
click node_fix42 "https://github.com/helaoban/fixtrate/tree/develop/fixtrate/fix42"
click node_fix42validate "https://github.com/helaoban/fixtrate/blob/develop/fixtrate/fix42/validate.py"
click node_fix42types "https://github.com/helaoban/fixtrate/blob/develop/fixtrate/fix42/types.py"
click node_enum "https://github.com/helaoban/fixtrate/blob/develop/fixtrate/utils/enum.py"
click node_helpers "https://github.com/helaoban/fixtrate/blob/develop/fixtrate/helpers.py"
click node_storefactory "https://github.com/helaoban/fixtrate/blob/develop/fixtrate/store/__init__.py"
click node_storebase "https://github.com/helaoban/fixtrate/blob/develop/fixtrate/store/base.py"
click node_memory "https://github.com/helaoban/fixtrate/blob/develop/fixtrate/store/inmemory.py"
click node_redis "https://github.com/helaoban/fixtrate/blob/develop/fixtrate/store/redis.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_config,node_client,node_server,node_transport toneBlue
class node_parser,node_message,node_fixtdata,node_fixttypes,node_fixtvalidate,node_admin,node_enum toneAmber
class node_fix42,node_fix42validate,node_fix42types toneMint
class node_helpers,node_storefactory,node_storebase,node_memory,node_redis toneRose
class node_user,node_peer toneIndigo
```

## Components

### FIX Connectivity

- [Session Config](https://github.com/helaoban/fixtrate/blob/develop/fixtrate/config.py): `fixtrate/config.py`
- [FIX Session](https://github.com/helaoban/fixtrate/blob/develop/fixtrate/session.py): `fixtrate/session.py`
- [FIX Server](https://github.com/helaoban/fixtrate/blob/develop/fixtrate/server.py): `fixtrate/server.py`
- [Transport](https://github.com/helaoban/fixtrate/blob/develop/fixtrate/transport.py): `fixtrate/transport.py`

### FIX Protocol

- [FIX Parser](https://github.com/helaoban/fixtrate/blob/develop/fixtrate/parse.py): `fixtrate/parse.py`
- [FIX Message](https://github.com/helaoban/fixtrate/blob/develop/fixtrate/message.py): `fixtrate/message.py`
- [Session Fields](https://github.com/helaoban/fixtrate/blob/develop/fixtrate/fixt/data.py): `fixtrate/fixt/data.py`
- [Session Tags](https://github.com/helaoban/fixtrate/blob/develop/fixtrate/fixt/types.py): `fixtrate/fixt/types.py`
- [Session Validation](https://github.com/helaoban/fixtrate/blob/develop/fixtrate/fixt/validate.py): `fixtrate/fixt/validate.py`
- [Session Messages](https://github.com/helaoban/fixtrate/tree/develop/fixtrate/fixt): `fixtrate/fixt`
- [Enum Utilities](https://github.com/helaoban/fixtrate/blob/develop/fixtrate/utils/enum.py): `fixtrate/utils/enum.py`

### FIX 4.2 Messages

- [FIX 4.2 Messages](https://github.com/helaoban/fixtrate/tree/develop/fixtrate/fix42): `fixtrate/fix42`
- [FIX 4.2 Validation](https://github.com/helaoban/fixtrate/blob/develop/fixtrate/fix42/validate.py): `fixtrate/fix42/validate.py`
- [FIX 4.2 Tags](https://github.com/helaoban/fixtrate/blob/develop/fixtrate/fix42/types.py): `fixtrate/fix42/types.py`

### Session State

- [Session Helpers](https://github.com/helaoban/fixtrate/blob/develop/fixtrate/helpers.py): `fixtrate/helpers.py`
- [Store Selection](https://github.com/helaoban/fixtrate/blob/develop/fixtrate/store/__init__.py): `fixtrate/store/__init__.py`
- [Store Interface](https://github.com/helaoban/fixtrate/blob/develop/fixtrate/store/base.py): `fixtrate/store/base.py`
- [Memory Store](https://github.com/helaoban/fixtrate/blob/develop/fixtrate/store/inmemory.py): `fixtrate/store/inmemory.py`
- [Redis Store](https://github.com/helaoban/fixtrate/blob/develop/fixtrate/store/redis.py): `fixtrate/store/redis.py`

### Other components

- **Application**
- **FIX Peer**

## Connections

- Application → FIX Session: connects
- FIX Peer → FIX Server: connects
- FIX Session → Session Config: uses (evidence: `fixtrate/session.py`)
- FIX Session → Transport: reads and writes (evidence: `fixtrate/session.py`)
- FIX Session → FIX Parser: parses input (evidence: `fixtrate/session.py`)
- FIX Session → Store Interface: stores session state (evidence: `fixtrate/session.py`)
- FIX Session → Session Helpers: builds admin messages (evidence: `fixtrate/session.py`)
- FIX Server → FIX Session: creates sessions (evidence: `fixtrate/server.py`)
- FIX Server → FIX Parser: parses logon (evidence: `fixtrate/server.py`)
- FIX Server → Transport: reads peer data (evidence: `fixtrate/server.py`)
- FIX Server → Session Config: uses config (evidence: `fixtrate/server.py`)
- FIX Parser → FIX Message: constructs (evidence: `fixtrate/parse.py`)
- FIX Message → Session Fields: uses message types (evidence: `fixtrate/message.py`)
- FIX Message → Session Tags: uses tags (evidence: `fixtrate/message.py`)
- Session Messages → FIX Message: builds messages (evidence: `fixtrate/fixt/logon.py`)
- Session Validation → Session Tags: uses type map (evidence: `fixtrate/fixt/validate.py`)
- Session Fields → Enum Utilities: defines enums (evidence: `fixtrate/fixt/data.py`)
- Session Tags → Enum Utilities: defines enums (evidence: `fixtrate/fixt/types.py`)
- FIX 4.2 Messages → FIX Message: constructs messages (evidence: `fixtrate/fix42/execution_report.py`)
- FIX 4.2 Messages → FIX 4.2 Validation: validates fields (evidence: `fixtrate/fix42/execution_report.py`)
- FIX 4.2 Messages → FIX 4.2 Tags: uses tags (evidence: `fixtrate/fix42/execution_report.py`)
- FIX 4.2 Validation → FIX 4.2 Tags: uses type map (evidence: `fixtrate/fix42/validate.py`)
- FIX 4.2 Tags → Enum Utilities: defines enums (evidence: `fixtrate/fix42/types.py`)
- Session Helpers → FIX Message: builds messages (evidence: `fixtrate/helpers.py`)
- Session Helpers → Session Config: uses config (evidence: `fixtrate/helpers.py`)
- Session Helpers → Store Interface: uses store interface (evidence: `fixtrate/helpers.py`)
- Store Selection → Store Interface: selects implementation (evidence: `fixtrate/store/__init__.py`)
- Store Selection → Memory Store: selects implementation (evidence: `fixtrate/store/__init__.py`)
- Store Selection → Redis Store: selects implementation (evidence: `fixtrate/store/__init__.py`)
- Memory Store → Store Interface: implements (evidence: `fixtrate/store/inmemory.py`)
- Redis Store → Store Interface: implements (evidence: `fixtrate/store/redis.py`)
- Memory Store → FIX Message: stores messages (evidence: `fixtrate/store/inmemory.py`)
- Redis Store → FIX Message: stores messages (evidence: `fixtrate/store/redis.py`)
