# hoang1711provip/bigdata_lab01_group4 architecture

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

- Interactive diagram: https://gitdiagram.com/hoang1711provip/bigdata_lab01_group4
- Repository: https://github.com/hoang1711provip/bigdata_lab01_group4

## Overview

This repository is a Big Data lab exercise centered on Kubernetes guardrails and S3-compatible object storage. Its executable workflow is a command-line teaching client: a user selects a seed, probe, benchmark, verification, availability-watch, or TCP-connectivity mode; the client performs the selected checks and emits JSON results. Kubernetes manifests represent quota, policy, and storage scenarios, while the evidence directory records observations rather than runtime components. The source excerpt supports the client’s internal calls and S3 interactions; manifest relationships are not shown, so they are left unconnected.

Main entry points: [`s3lab.py`](https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/s3lab.py) (CLI dispatcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["S3 Lab Client"]
  node_cli["CLI dispatcher<br/>[s3lab.py]"]
  node_client_factory["S3 client setup<br/>[s3lab.py]"]
  node_seed["Bucket seeding<br/>[s3lab.py]"]
  node_probe["Object probes<br/>[s3lab.py]"]
  node_operation["S3 operations<br/>[s3lab.py]"]
  node_benchmark["Load benchmark<br/>[s3lab.py]"]
  node_verify["Object verification<br/>[s3lab.py]"]
  node_watch["Availability watch<br/>[s3lab.py]"]
  node_tcp["TCP check<br/>[s3lab.py]"]
end

subgraph group_kube["Kubernetes Scenarios"]
  node_quota["Resource quota<br/>[quota.yaml]"]
  node_guardrails["Policy guardrails<br/>[guardrails.yaml]"]
  node_positive["Positive policy case<br/>[positive.yaml]"]
  node_negative["Negative policy case<br/>[negative.yaml]"]
  node_store_manifest["Storage deployment<br/>[store.yaml]"]
end

subgraph group_outputs["Lab Results"]
  node_results["JSON observations<br/>[s3lab.py]"]
end

node_user(("Lab operator"))
node_s3[("S3-compatible store")]

node_user -->|"selects mode"| node_cli
node_cli -->|"creates client"| node_client_factory
node_cli -->|"dispatches"| node_seed
node_cli -->|"dispatches"| node_probe
node_cli -->|"dispatches"| node_benchmark
node_cli -->|"dispatches"| node_verify
node_cli -->|"dispatches"| node_watch
node_cli -->|"dispatches"| node_tcp
node_seed -->|"calls"| node_operation
node_probe -->|"calls"| node_operation
node_benchmark -->|"calls"| node_operation
node_verify -->|"calls"| node_operation
node_watch -->|"calls"| node_operation
node_operation -->|"issues requests"| node_s3
node_client_factory -->|"configures access"| node_s3
node_tcp -->|"emits status"| node_results
node_operation -->|"emits observations"| node_results
node_benchmark -->|"emits summaries"| node_results

click node_cli "https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/s3lab.py"
click node_client_factory "https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/s3lab.py"
click node_seed "https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/s3lab.py"
click node_probe "https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/s3lab.py"
click node_operation "https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/s3lab.py"
click node_benchmark "https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/s3lab.py"
click node_verify "https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/s3lab.py"
click node_watch "https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/s3lab.py"
click node_tcp "https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/s3lab.py"
click node_quota "https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/manifests/quota.yaml"
click node_guardrails "https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/manifests/guardrails.yaml"
click node_positive "https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/manifests/positive.yaml"
click node_negative "https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/manifests/negative.yaml"
click node_store_manifest "https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/manifests/store.yaml"
click node_results "https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/s3lab.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_cli,node_client_factory,node_seed,node_probe,node_operation,node_benchmark,node_verify,node_watch,node_tcp toneBlue
class node_quota,node_guardrails,node_positive,node_negative,node_store_manifest,node_s3 toneAmber
class node_results toneMint
class node_user toneIndigo
```

## Components

### S3 Lab Client

- [CLI dispatcher](https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/s3lab.py): `s3lab.py`
- [S3 client setup](https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/s3lab.py): `s3lab.py`
- [Bucket seeding](https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/s3lab.py): `s3lab.py`
- [Object probes](https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/s3lab.py): `s3lab.py`
- [S3 operations](https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/s3lab.py): `s3lab.py`
- [Load benchmark](https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/s3lab.py): `s3lab.py`
- [Object verification](https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/s3lab.py): `s3lab.py`
- [Availability watch](https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/s3lab.py): `s3lab.py`
- [TCP check](https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/s3lab.py): `s3lab.py`

### Kubernetes Scenarios

- [Resource quota](https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/manifests/quota.yaml): `manifests/quota.yaml`
- [Policy guardrails](https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/manifests/guardrails.yaml): `manifests/guardrails.yaml`
- [Positive policy case](https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/manifests/positive.yaml): `manifests/positive.yaml`
- [Negative policy case](https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/manifests/negative.yaml): `manifests/negative.yaml`
- [Storage deployment](https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/manifests/store.yaml): `manifests/store.yaml`

### Lab Results

- [JSON observations](https://github.com/hoang1711provip/bigdata_lab01_group4/blob/main/s3lab.py): `s3lab.py`

### Other components

- **Lab operator**
- **S3-compatible store**

## Connections

- Lab operator → CLI dispatcher: selects mode (evidence: `s3lab.py`)
- CLI dispatcher → S3 client setup: creates client (evidence: `s3lab.py`)
- CLI dispatcher → Bucket seeding: dispatches (evidence: `s3lab.py`)
- CLI dispatcher → Object probes: dispatches (evidence: `s3lab.py`)
- CLI dispatcher → Load benchmark: dispatches (evidence: `s3lab.py`)
- CLI dispatcher → Object verification: dispatches (evidence: `s3lab.py`)
- CLI dispatcher → Availability watch: dispatches (evidence: `s3lab.py`)
- CLI dispatcher → TCP check: dispatches (evidence: `s3lab.py`)
- Bucket seeding → S3 operations: calls (evidence: `s3lab.py`)
- Object probes → S3 operations: calls (evidence: `s3lab.py`)
- Load benchmark → S3 operations: calls (evidence: `s3lab.py`)
- Object verification → S3 operations: calls (evidence: `s3lab.py`)
- Availability watch → S3 operations: calls (evidence: `s3lab.py`)
- S3 operations → S3-compatible store: issues requests (evidence: `s3lab.py`)
- S3 client setup → S3-compatible store: configures access (evidence: `s3lab.py`)
- TCP check → JSON observations: emits status (evidence: `s3lab.py`)
- S3 operations → JSON observations: emits observations (evidence: `s3lab.py`)
- Load benchmark → JSON observations: emits summaries (evidence: `s3lab.py`)
