# liikane/tallinn architecture

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

- Interactive diagram: https://gitdiagram.com/liikane/tallinn
- Repository: https://github.com/liikane/tallinn

## Overview

##### Project type and purpose
- This repository is a small documentation/static site project (likely a GitHub Pages site or a docs site) containing a short operational guide ("WP uudiste lisamise juhend" — guide for adding news to a WordPress intranet). Key intent: host simple documentation/checklists for editors and optionally automate issue/project management via GitHub Actions.

##### File-structure analysis (what the tree tells us)
- .github/workflows/add-issue-to-project.yml — CI/CD automation using GitHub Actions; likely responds to issues/PRs or pushes to update a GitHub Project.
- CNAME — custom domain mapped to GitHub Pages (site is served under a custom hostname).
- README.md — human-facing guide/checklist (the actual content).
- SUMMARY.md — convention used by static-doc tools (GitBook, mdBook, or similar) to build navigation; indicates a docs site structure.
- index.html — root page for the static site.
- kana.txt, test.txt, tallinn — additional content files (sample pages / assets).
Overall pattern: content files + build/hosting metadata + a workflow. No server-side code, no database in repo.

##### Additional insights from README
- README is a step-by-step checklist for editors to add a news post to the WP intranet.
- Project is operational-documentation, not an application: actors are people (editors), target is an external WordPress system.
- The workflow file suggests some repository-side automation (project board management) that supplements the human process.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Actors
    Editor["Editor (human)"]:::actor
    Reviewer["Repo Maintainer / Reviewer (optional)"]:::actor

    %% Repository cluster
    subgraph "GitHub Repository (docs-as-code)" 
        direction TB
        Repo["Repository (content + config)"]:::repo
        README["README.md<br/><i>editor checklist</i>"]:::file
        SUMMARY["SUMMARY.md<br/><i>navigation</i>"]:::file
        INDEX["index.html<br/><i>site root</i>"]:::file
        CNAME["CNAME<br/><i>custom domain</i>"]:::file
        ASSETS["Static files: kana.txt, test.txt, tallinn"]:::file
        WF_DIR[".github/workflows (dir)"]:::dir
        WF_FILE["add-issue-to-project.yml"]:::workflow
    end

    %% CI / Automation
    Actions["GitHub Actions (runner)"]:::automation
    Projects["GitHub Projects / Issue Board"]:::board

    %% Hosting / Delivery
    Pages["GitHub Pages (static host)"]:::pages
    DNS["DNS / Custom Domain"]:::dns
    EndUsers["End Users / Browsers"]:::actor

    %% External system (manual target)
    WP["WordPress Intranet (Members Area)"]:::external

    %% Legend
    subgraph "Legend" 
        direction TB
        A1["Green = Human actors"]:::actor
        A2["Blue = GitHub components & files"]:::repo
        A3["Orange = External systems"]:::external
        A4["Dashed = Manual steps"]:::manual
    end

    %% Flow (vertical orientation)
    Editor -->|"commit / PR (git push)"| Repo
    Reviewer -->|"review & merge (optional)"| Repo

    Repo -->|"on: push / PR / workflow trigger"| Actions
    WF_DIR -->|contains| WF_FILE
    WF_FILE -->|"implements: project automation"| Actions
    click WF_FILE "https://github.com/liikane/tallinn/blob/main/.github/workflows/add-issue-to-project.yml"
    click WF_DIR "https://github.com/liikane/tallinn/blob/main/.github/workflows"

    Actions -->|"API: create/update issue/card"| Projects
    Actions -->|"build & deploy (optional build step)"| Pages

    Repo -->|"content files stored"| README
    Repo -->|"nav config"| SUMMARY
    Repo -->|"site root"| INDEX
    Repo -->|"custom domain config"| CNAME
    Repo -->|"assets"| ASSETS

    click README "https://github.com/liikane/tallinn/blob/main/README.md"
    click SUMMARY "https://github.com/liikane/tallinn/blob/main/SUMMARY.md"
    click INDEX "https://github.com/liikane/tallinn/blob/main/index.html"
    click CNAME "https://github.com/liikane/tallinn/tree/main/CNAME"
    click ASSETS "https://github.com/liikane/tallinn/blob/main/kana.txt"
    click ASSETS "https://github.com/liikane/tallinn/blob/main/test.txt"
    click ASSETS "https://github.com/liikane/tallinn/tree/main/tallinn"
    click Repo "https://github.com/liikane/tallinn/blob/main/."

    Pages -->|"serves site over HTTPS (custom domain)"| EndUsers
    DNS -->|"CNAME maps domain to Pages"| Pages
    click DNS "https://github.com/liikane/tallinn/tree/main/CNAME"

    %% Manual publishing to external WordPress (dashed)
    Editor -.->|"manual publish steps per README"| WP

    %% Notes / annotations
    Notes["Notes:\n1) Documentation-as-code: repo holds markdown/html + nav config\n2) Workflow file automates project board updates\n3) WordPress publishing is manual (editor follows README)"]:::note
    Repo --> Notes

    %% Styling / Classes
    classDef actor fill:#e6ffed,stroke:#2a9d3a,color:#073b13,stroke-width:1px,round
    classDef repo fill:#e9f2ff,stroke:#2563eb,color:#07204a,stroke-width:1px
    classDef file fill:#f0f7ff,stroke:#60a5fa,color:#0b3b66,stroke-width:1px
    classDef workflow fill:#fff4e6,stroke:#f97316,color:#66360f,stroke-width:1px
    classDef dir fill:#eef2ff,stroke:#6366f1,color:#1e1b4b,stroke-width:1px
    classDef automation fill:#fff7ed,stroke:#f59e0b,color:#4a2b00,stroke-width:1px
    classDef board fill:#eef6ff,stroke:#2563eb,color:#08306b,stroke-width:1px
    classDef pages fill:#f0fff4,stroke:#10b981,color:#023020,stroke-width:1px
    classDef dns fill:#fff1f2,stroke:#ef4444,color:#4a0f0f,stroke-width:1px
    classDef external fill:#fff7ed,stroke:#f97316,color:#7a3a00,stroke-width:1px
    classDef note fill:#ffffff,stroke:#9ca3af,color:#111827,stroke-width:1px
    classDef manual stroke-dasharray: 5 5

    %% Apply classes
    class Repo,README,SUMMARY,INDEX,CNAME,ASSETS repo
    class WF_FILE workflow
    class WF_DIR dir
    class Actions automation
    class Projects board
    class Pages pages
    class DNS dns
    class WP external
    class Notes note

    %% Make manual dashed style for Editor->WP link
    Editor -. manual .-> WP
```
