# intuitem/ciso-assistant-doc architecture

> Architecture diagram of the GitHub repository intuitem/ciso-assistant-doc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-14). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/intuitem/ciso-assistant-doc
- Repository: https://github.com/intuitem/ciso-assistant-doc

## Overview

##### Project type and purpose
- This repository is purely documentation for “CISO Assistant,” an open-source GRC (Governance, Risk, Compliance) tool. It is structured for GitBook: all content is Markdown plus assets, organized into sections (contributing, customization, deployment, features-highlight, guide, model).
- The README confirms that this is the docs site: it links to guides, explains the vision, and references the docs branch.

##### File structure
- Top-level:
- .gitbook (configuration and assets)
- README.md, SUMMARY.md (GitBook entry points)
- A set of directories, each representing a content section:
– contributing/
– customization/
– deployment/
– features-highlight/
– guide/
– model/
- In .gitbook/assets you find videos and sample spreadsheets that get embedded in pages.
- No source code or runtime components—this is a static-site documentation project.
- No deployment scripts here, but there are “deployment” docs describing how to deploy the product itself (not the docs).

##### README for additional insights
- Confirms the GitBook-based workflow (“Documentation has been merged … docs branch”)
- There is no “architecture” section here, because this repo is documentation for another project.
- The “model” directory deeply outlines the domain model (governance, risk, compliance), but again purely text.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Authoring Layer
    subgraph "Authoring"
        direction TB
        RC["README.md"]:::content
        SUMMARY["SUMMARY.md"]:::content
        CONTR["contributing/"]:::content
        CUSTOM["customization/"]:::content
        DEPLOY_DIR["deployment/"]:::content
        FEATURES["features-highlight/"]:::content
        GUIDE["guide/"]:::content
        MODEL["model/"]:::content
        ASSETS[".gitbook/assets/"]:::content
    end

    %% Build Pipeline
    CI["CI/CD Pipeline"]:::process
    GB["GitBook Generator (.gitbook/)"]:::process

    %% Output and Hosting
    SITE["Generated Static Site"]:::infra
    HOST["Hosting / CDN"]:::infra

    %% Consumption Layer
    USER["User Browser"]:::user

    %% Connections
    RC --> CI
    SUMMARY --> CI
    CONTR --> CI
    CUSTOM --> CI
    DEPLOY_DIR --> CI
    FEATURES --> CI
    GUIDE --> CI
    MODEL --> CI
    ASSETS --> CI

    CI -->|"run build"| GB
    GB -->|"produce HTML/CSS/JS"| SITE
    SITE -->|"deploy"| HOST
    HOST -->|"HTTP requests"| USER

    %% Click Events
    click RC "https://github.com/intuitem/ciso-assistant-doc/blob/main/README.md"
    click SUMMARY "https://github.com/intuitem/ciso-assistant-doc/blob/main/SUMMARY.md"
    click CONTR "https://github.com/intuitem/ciso-assistant-doc/tree/main/contributing/"
    click CUSTOM "https://github.com/intuitem/ciso-assistant-doc/tree/main/customization/"
    click DEPLOY_DIR "https://github.com/intuitem/ciso-assistant-doc/tree/main/deployment/"
    click FEATURES "https://github.com/intuitem/ciso-assistant-doc/tree/main/features-highlight/"
    click GUIDE "https://github.com/intuitem/ciso-assistant-doc/tree/main/guide/"
    click MODEL "https://github.com/intuitem/ciso-assistant-doc/tree/main/model/"
    click ASSETS "https://github.com/intuitem/ciso-assistant-doc/tree/main/.gitbook/assets/"

    %% Styles
    classDef content fill:#D6EFFF,stroke:#0366d6,stroke-width:1px
    classDef process fill:#FFD8A8,stroke:#d97706,stroke-width:1px
    classDef infra fill:#D2F8D2,stroke:#15803d,stroke-width:1px
    classDef user fill:#FFEEBA,stroke:#b45309,stroke-width:1px
```
