# ekonurwahyudi/atemis-2.0-guide-book architecture

> Architecture diagram of the GitHub repository ekonurwahyudi/atemis-2.0-guide-book, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ekonurwahyudi/atemis-2.0-guide-book
- Repository: https://github.com/ekonurwahyudi/atemis-2.0-guide-book

## Overview

##### File structure
- Top-level folders:
- `.gitbook` / `.gitbook/assets` – configuration and binary/PDF assets.
- `getting-started`, `input-order`, `material-request`, `master-data`, `website-kalibrasi`, `file-pendukung` – these are content modules, each with multiple Markdown files.
- Root files: `README.md`, `SUMMARY.md` – GitBook entry points.
- No server-side code, build scripts or Dockerfiles exist here, so the “architecture” is essentially a static content pipeline.

##### README
- Describes the business context of Atemis 2.0 (maintenance workflows at TELKOM).
- No technical architecture section visible. The documentation is organized by feature (Replacement & Repair, Kalibrasi, Bantek, Warehouse).

##### Main components
a. Content Source
– A Git repository containing:
- Markdown modules (input-order, master-data, etc.)
- `.gitbook` config and assets
- SUMMARY.md (navigation map)
b. Build Layer
– GitBook CLI (or GitBook.com build service) that:
- Reads `SUMMARY.md` + Markdown files
- Processes `.gitbook` config and assets
- Generates static HTML/CSS/JS site
c. CI/CD Pipeline
– (Optional) GitHub Actions / GitLab CI / other that:
- Triggers on push to `main`
- Installs GitBook CLI
- Builds static output
- Deploys artifacts
d. Hosting/Deployment
– GitBook Cloud or third-party hosting (e.g., Netlify, GitHub Pages) serving the static site.
e. End-User
– Web browser or PDF export (GitBook provides PDF/ebook generation).

##### Relationships & interactions
- Developers push Markdown changes → Git repository
- CI/CD picks changes → invokes GitBook build
- Build step pulls in config/assets & content → outputs static site
- Deployed site served to end-users via CDN/hosting
- End-users navigate sections, download PDF, view embedded assets

##### Architectural patterns & design principles
- Content-as-code: Markdown files in Git
- Static site generation: no server-side runtime, improves performance & security
- Modular documentation: each feature area is its own directory, recapitulating single-responsibility
- CI/CD for automated publishing

##### Technologies, frameworks, libraries
- GitBook CLI or GitBook.com
- Markdown
- Node.js (underlying GitBook engine)
- Optional: GitHub Actions / Netlify / AWS S3 + CloudFront
- Standard web stack for static HTML/CSS/JS

##### Key points
- The .gitbook folder and SUMMARY.md as configuration inputs
- Build engine (GitBook CLI) processing into static files
- CI/CD pipeline connecting repo to build to deploy
- Deployment target (GitBook cloud or other)
- End-user consumption via web or PDF export

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Content Source"
        GS["getting-started"]:::source
        IO["input-order"]:::source
        MR["material-request"]:::source
        MD["master-data"]:::source
        WK["website-kalibrasi"]:::source
        FP["file-pendukung"]:::source
        GITBOOK[".gitbook"]:::source
        SUMMARY["SUMMARY.md"]:::source
        README["README.md"]:::source
    end

    subgraph "Build & CI/CD"
        CI["CI/CD Pipeline"]:::build
        CLI["GitBook CLI"]:::build
    end

    subgraph "Hosting & Deployment"
        HOST["Hosting Service (GitBook Cloud/Netlify)"]:::deploy
        CDN["CDN"]:::deploy
    end

    subgraph "End-User"
        BROWSER["Web Browser"]:::user
        PDF["PDF Export (.gitbook/assets/Tutorial ATEMIS 2.0 Blok Kalibrasi.pdf)"]:::user
    end

    GS --> CLI
    IO --> CLI
    MR --> CLI
    MD --> CLI
    WK --> CLI
    FP --> CLI
    GITBOOK --> CLI
    SUMMARY --> CLI
    README --> CI
    CI --> CLI
    CLI --> HOST
    CLI --> PDF
    HOST --> CDN
    CDN --> BROWSER
    PDF --> BROWSER

    click GS "https://github.com/ekonurwahyudi/atemis-2.0-guide-book/tree/main//getting-started"
    click IO "https://github.com/ekonurwahyudi/atemis-2.0-guide-book/tree/main//input-order"
    click MR "https://github.com/ekonurwahyudi/atemis-2.0-guide-book/tree/main//material-request"
    click MD "https://github.com/ekonurwahyudi/atemis-2.0-guide-book/tree/main//master-data"
    click WK "https://github.com/ekonurwahyudi/atemis-2.0-guide-book/tree/main//website-kalibrasi"
    click FP "https://github.com/ekonurwahyudi/atemis-2.0-guide-book/tree/main//file-pendukung"
    click GITBOOK "https://github.com/ekonurwahyudi/atemis-2.0-guide-book/blob/main//.gitbook"
    click SUMMARY "https://github.com/ekonurwahyudi/atemis-2.0-guide-book/blob/main//SUMMARY.md"
    click README "https://github.com/ekonurwahyudi/atemis-2.0-guide-book/blob/main//README.md"
    click PDF "https://github.com/ekonurwahyudi/atemis-2.0-guide-book/blob/main//.gitbook/assets/Tutorial ATEMIS 2.0 Blok Kalibrasi.pdf"

    classDef source fill:#cce5ff,stroke:#004085,color:#004085;
    classDef build fill:#d4edda,stroke:#155724,color:#155724;
    classDef deploy fill:#fff3cd,stroke:#856404,color:#856404;
    classDef user fill:#e2e3e5,stroke:#6c757d,color:#6c757d;
```
