# luckkrit/mini_projects architecture

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

- Interactive diagram: https://gitdiagram.com/luckkrit/mini_projects
- Repository: https://github.com/luckkrit/mini_projects

## Overview

This is a small C TCP server for a board-and-task tracker. A client sends comma-separated commands over a socket; the server accepts connections, dispatches ADD_BOARD or ADD_TASK, validates and updates shared project state, persists it to files, then returns a status response. Startup loads boards and tasks from storage. The graph separates request handling, domain operations, and persistence; source excerpts show these calls, while the README documents the netcat interface. It documents no task-list, update, or delete command.

Main entry points: [`src/server.c`](https://github.com/luckkrit/mini_projects/blob/main/src/server.c) (Add-task handler), [`src/models.c`](https://github.com/luckkrit/mini_projects/blob/main/src/models.c) (Project loader), [`src/models.h`](https://github.com/luckkrit/mini_projects/blob/main/src/models.h) (Shared project state), [`src/common.c`](https://github.com/luckkrit/mini_projects/blob/main/src/common.c) (Input helpers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_server["Server and protocol"]
  node_listener["TCP listener<br/>[server.c]"]
  node_dispatcher["Command dispatcher<br/>[server.c]"]
  node_board_handler["Add-board handler<br/>[server.c]"]
  node_task_handler["Add-task handler<br/>[server.c]"]
  node_protocol["Command statuses<br/>[protocol.h]"]
  node_common["Input helpers<br/>[common.c]"]
end

subgraph group_domain["Board and task model"]
  node_shared_state["Shared project state<br/>[models.h]"]
  node_board_ops["Board operations<br/>[models.c]"]
  node_task_ops["Task operations<br/>[models.c]"]
  node_board_lookup["Board lookup<br/>[models.c]"]
  node_task_lookup["Task lookup<br/>[models.c]"]
end

subgraph group_storage["File persistence"]
  node_project_loader["Project loader<br/>[models.c]"]
  node_board_file[("Board file<br/>[models.c]")]
  node_task_file[("Task file<br/>[models.c]")]
end

node_client(("Netcat client"))

node_client -->|"sends commands"| node_listener
node_listener -->|"loads project"| node_project_loader
node_listener -->|"dispatches input"| node_dispatcher
node_dispatcher -->|"routes ADD_BOARD"| node_board_handler
node_dispatcher -->|"routes ADD_TASK"| node_task_handler
node_dispatcher -->|"uses command constants"| node_protocol
node_board_handler -->|"validates title"| node_common
node_task_handler -->|"validates arguments"| node_common
node_board_handler -->|"adds board"| node_board_ops
node_board_handler -->|"saves boards"| node_board_file
node_task_handler -->|"finds board"| node_board_lookup
node_task_handler -->|"adds task"| node_task_ops
node_task_handler -->|"saves tasks"| node_task_file
node_project_loader -->|"reads boards"| node_board_file
node_project_loader -->|"reads tasks"| node_task_file
node_project_loader -->|"populates state"| node_shared_state
node_board_ops -->|"updates boards"| node_shared_state
node_task_ops -->|"updates tasks"| node_shared_state
node_board_lookup -->|"searches boards"| node_shared_state
node_task_lookup -->|"resolves board"| node_board_lookup

click node_listener "https://github.com/luckkrit/mini_projects/blob/main/src/server.c"
click node_dispatcher "https://github.com/luckkrit/mini_projects/blob/main/src/server.c"
click node_board_handler "https://github.com/luckkrit/mini_projects/blob/main/src/server.c"
click node_task_handler "https://github.com/luckkrit/mini_projects/blob/main/src/server.c"
click node_protocol "https://github.com/luckkrit/mini_projects/blob/main/src/protocol.h"
click node_shared_state "https://github.com/luckkrit/mini_projects/blob/main/src/models.h"
click node_board_ops "https://github.com/luckkrit/mini_projects/blob/main/src/models.c"
click node_task_ops "https://github.com/luckkrit/mini_projects/blob/main/src/models.c"
click node_board_lookup "https://github.com/luckkrit/mini_projects/blob/main/src/models.c"
click node_task_lookup "https://github.com/luckkrit/mini_projects/blob/main/src/models.c"
click node_project_loader "https://github.com/luckkrit/mini_projects/blob/main/src/models.c"
click node_board_file "https://github.com/luckkrit/mini_projects/blob/main/src/models.c"
click node_task_file "https://github.com/luckkrit/mini_projects/blob/main/src/models.c"
click node_common "https://github.com/luckkrit/mini_projects/blob/main/src/common.c"

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_listener,node_dispatcher,node_board_handler,node_task_handler,node_protocol,node_common,node_client toneBlue
class node_shared_state,node_board_ops,node_task_ops,node_board_lookup,node_task_lookup toneAmber
class node_project_loader,node_board_file,node_task_file toneMint
```

## Components

### Server and protocol

- [TCP listener](https://github.com/luckkrit/mini_projects/blob/main/src/server.c): `src/server.c`
- [Command dispatcher](https://github.com/luckkrit/mini_projects/blob/main/src/server.c): `src/server.c`
- [Add-board handler](https://github.com/luckkrit/mini_projects/blob/main/src/server.c): `src/server.c`
- [Add-task handler](https://github.com/luckkrit/mini_projects/blob/main/src/server.c): `src/server.c`
- [Command statuses](https://github.com/luckkrit/mini_projects/blob/main/src/protocol.h): `src/protocol.h`
- [Input helpers](https://github.com/luckkrit/mini_projects/blob/main/src/common.c): `src/common.c`

### Board and task model

- [Shared project state](https://github.com/luckkrit/mini_projects/blob/main/src/models.h): `src/models.h`
- [Board operations](https://github.com/luckkrit/mini_projects/blob/main/src/models.c): `src/models.c`
- [Task operations](https://github.com/luckkrit/mini_projects/blob/main/src/models.c): `src/models.c`
- [Board lookup](https://github.com/luckkrit/mini_projects/blob/main/src/models.c): `src/models.c`
- [Task lookup](https://github.com/luckkrit/mini_projects/blob/main/src/models.c): `src/models.c`

### File persistence

- [Project loader](https://github.com/luckkrit/mini_projects/blob/main/src/models.c): `src/models.c`
- [Board file](https://github.com/luckkrit/mini_projects/blob/main/src/models.c): `src/models.c`
- [Task file](https://github.com/luckkrit/mini_projects/blob/main/src/models.c): `src/models.c`

### Other components

- **Netcat client**

## Connections

- Netcat client → TCP listener: sends commands (evidence: `README.md`)
- TCP listener → Project loader: loads project (evidence: `src/server.c`)
- TCP listener → Command dispatcher: dispatches input (evidence: `src/server.c`)
- Command dispatcher → Add-board handler: routes ADD_BOARD (evidence: `src/server.c`)
- Command dispatcher → Add-task handler: routes ADD_TASK (evidence: `src/server.c`)
- Command dispatcher → Command statuses: uses command constants (evidence: `src/server.c`)
- Add-board handler → Input helpers: validates title (evidence: `src/server.c`)
- Add-task handler → Input helpers: validates arguments (evidence: `src/server.c`)
- Add-board handler → Board operations: adds board (evidence: `src/server.c`)
- Add-board handler → Board file: saves boards (evidence: `src/server.c`)
- Add-task handler → Board lookup: finds board (evidence: `src/server.c`)
- Add-task handler → Task operations: adds task (evidence: `src/server.c`)
- Add-task handler → Task file: saves tasks (evidence: `src/server.c`)
- Project loader → Board file: reads boards (evidence: `src/models.c`)
- Project loader → Task file: reads tasks (evidence: `src/models.c`)
- Project loader → Shared project state: populates state (evidence: `src/models.c`)
- Board operations → Shared project state: updates boards (evidence: `src/models.c`)
- Task operations → Shared project state: updates tasks (evidence: `src/models.c`)
- Board lookup → Shared project state: searches boards (evidence: `src/models.c`)
- Task lookup → Board lookup: resolves board (evidence: `src/models.c`)
