# vahehovak15-wq/it-projects architecture

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

- Interactive diagram: https://gitdiagram.com/vahehovak15-wq/it-projects
- Repository: https://github.com/vahehovak15-wq/it-projects

## Overview

This repository is a portfolio of three independent Linux projects. In the shell, a user enters commands that the main loop parses, handles as built-ins or dispatches to an external process; history and prompt customization are part of that same workflow. The HTTP project sends CHLP/1.0 requests from a client to a threaded server, which validates requests and serves files or echoes bodies. The Bash analyzer processes SSH authentication logs into a security report. The README documents several capabilities whose detailed implementation was not sampled, so those branches are shown at the project level.

Main entry points: [`Custom_Shell/main.c`](https://github.com/vahehovak15-wq/it-projects/blob/main/Custom_Shell/main.c) (Command loop), [`HTTP_Client_Server/server.c`](https://github.com/vahehovak15-wq/it-projects/blob/main/HTTP_Client_Server/server.c) (Request validation and dispatch), [`Security_Log_Analyzer/analyze_logs.sh`](https://github.com/vahehovak15-wq/it-projects/blob/main/Security_Log_Analyzer/analyze_logs.sh) (SSH log analyzer), [`Custom_Shell/executor.c`](https://github.com/vahehovak15-wq/it-projects/blob/main/Custom_Shell/executor.c) (External command executor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Custom Shell"]
  node_shell_loop["Command loop<br/>[main.c]"]
  node_shell_parser["Command parser<br/>[parser.c]"]
  node_shell_builtin["Built-ins, history, prompt<br/>[main.c]"]
  node_shell_executor["External command executor<br/>[executor.c]"]
end

subgraph group_http["HTTP Client Server"]
  node_http_client["CHLP client<br/>[client.c]"]
  node_http_server["TCP listener<br/>[server.c]"]
  node_http_handler["Request validation and dispatch<br/>[server.c]"]
  node_http_files["Served files"]
end

subgraph group_security["Security Log Analyzer"]
  node_security_script["SSH log analyzer<br/>[analyze_logs.sh]"]
  node_security_report["Security report"]
end

node_shell_user(("Shell user"))
node_os_process["Linux process execution"]
node_http_client_user(("HTTP client user"))
node_http_user_result(("HTTP response"))
node_security_user(("Analyzer user"))
node_security_logs["Authentication log input"]

node_shell_user -->|"enters commands"| node_shell_loop
node_shell_loop -->|"parses input"| node_shell_parser
node_shell_loop -->|"handles built-ins"| node_shell_builtin
node_shell_loop -->|"dispatches external"| node_shell_executor
node_shell_executor -->|"forks and execs"| node_os_process
node_http_client_user -->|"chooses method"| node_http_client
node_http_client -->|"sends CHLP request"| node_http_server
node_http_server -->|"dispatches clients"| node_http_handler
node_http_handler -->|"reads requested file"| node_http_files
node_http_handler -->|"sends response"| node_http_user_result
node_security_user -->|"runs analysis"| node_security_script
node_security_logs -->|"analyzes SSH logs"| node_security_script
node_security_script -->|"generates report"| node_security_report

click node_shell_loop "https://github.com/vahehovak15-wq/it-projects/blob/main/Custom_Shell/main.c"
click node_shell_parser "https://github.com/vahehovak15-wq/it-projects/blob/main/Custom_Shell/parser.c"
click node_shell_builtin "https://github.com/vahehovak15-wq/it-projects/blob/main/Custom_Shell/main.c"
click node_shell_executor "https://github.com/vahehovak15-wq/it-projects/blob/main/Custom_Shell/executor.c"
click node_http_client "https://github.com/vahehovak15-wq/it-projects/blob/main/HTTP_Client_Server/client.c"
click node_http_server "https://github.com/vahehovak15-wq/it-projects/blob/main/HTTP_Client_Server/server.c"
click node_http_handler "https://github.com/vahehovak15-wq/it-projects/blob/main/HTTP_Client_Server/server.c"
click node_http_files "https://github.com/vahehovak15-wq/it-projects/tree/main/HTTP_Client_Server/server_files"
click node_security_script "https://github.com/vahehovak15-wq/it-projects/blob/main/Security_Log_Analyzer/analyze_logs.sh"
click node_security_report "https://github.com/vahehovak15-wq/it-projects/blob/main/Security_Log_Analyzer/security_report.txt"

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_shell_loop,node_shell_parser,node_shell_builtin,node_shell_executor,node_shell_user,node_http_client_user,node_security_user toneBlue
class node_http_client,node_http_server,node_http_handler,node_http_files toneAmber
class node_security_script,node_security_report toneMint
class node_os_process,node_http_user_result,node_security_logs toneIndigo
```

## Components

### Custom Shell

- [Command loop](https://github.com/vahehovak15-wq/it-projects/blob/main/Custom_Shell/main.c): `Custom_Shell/main.c`
- [Command parser](https://github.com/vahehovak15-wq/it-projects/blob/main/Custom_Shell/parser.c): `Custom_Shell/parser.c`
- [Built-ins, history, prompt](https://github.com/vahehovak15-wq/it-projects/blob/main/Custom_Shell/main.c): `Custom_Shell/main.c`
- [External command executor](https://github.com/vahehovak15-wq/it-projects/blob/main/Custom_Shell/executor.c): `Custom_Shell/executor.c`

### HTTP Client Server

- [CHLP client](https://github.com/vahehovak15-wq/it-projects/blob/main/HTTP_Client_Server/client.c): `HTTP_Client_Server/client.c`
- [TCP listener](https://github.com/vahehovak15-wq/it-projects/blob/main/HTTP_Client_Server/server.c): `HTTP_Client_Server/server.c`
- [Request validation and dispatch](https://github.com/vahehovak15-wq/it-projects/blob/main/HTTP_Client_Server/server.c): `HTTP_Client_Server/server.c`
- [Served files](https://github.com/vahehovak15-wq/it-projects/tree/main/HTTP_Client_Server/server_files): `HTTP_Client_Server/server_files`

### Security Log Analyzer

- [SSH log analyzer](https://github.com/vahehovak15-wq/it-projects/blob/main/Security_Log_Analyzer/analyze_logs.sh): `Security_Log_Analyzer/analyze_logs.sh`
- [Security report](https://github.com/vahehovak15-wq/it-projects/blob/main/Security_Log_Analyzer/security_report.txt): `Security_Log_Analyzer/security_report.txt`

### Other components

- **Shell user**
- **Linux process execution**
- **HTTP client user**
- **HTTP response**
- **Analyzer user**
- **Authentication log input**

## Connections

- Shell user → Command loop: enters commands (evidence: `README.md`)
- Command loop → Command parser: parses input (evidence: `Custom_Shell/main.c`)
- Command loop → Built-ins, history, prompt: handles built-ins (evidence: `Custom_Shell/main.c`)
- Command loop → External command executor: dispatches external (evidence: `Custom_Shell/main.c`)
- External command executor → Linux process execution: forks and execs (evidence: `Custom_Shell/executor.c`)
- HTTP client user → CHLP client: chooses method (evidence: `README.md`)
- CHLP client → TCP listener: sends CHLP request (evidence: `README.md`)
- TCP listener → Request validation and dispatch: dispatches clients (evidence: `HTTP_Client_Server/server.c`)
- Request validation and dispatch → Served files: reads requested file (evidence: `HTTP_Client_Server/server.c`)
- Request validation and dispatch → HTTP response: sends response (evidence: `HTTP_Client_Server/server.c`)
- Analyzer user → SSH log analyzer: runs analysis (evidence: `README.md`)
- Authentication log input → SSH log analyzer: analyzes SSH logs (evidence: `README.md`)
- SSH log analyzer → Security report: generates report (evidence: `README.md`)
