thangldw.github.io

A build-free static portfolio for engineering side projects and browser-based JLPT N1 study tools. The public site is thangldw.github.io.

Published surfaces

Surface	Location	Ownership
English profile	/	This repository
Project catalog	/apps/	This repository
Data Copilot	/apps/data-copilot/	This repository
Pipeline Observability	/apps/pipeline/	This repository
Proofline	/proofline/	External showcase
RAGOps	/ragops/	External showcase
NamiQuant	Catalog entry only	Internal project; no public application
KakeFlow	/apps/kakeflow/	Coming-soon showcase; product remains private

The canonical JLPT routes live under apps/. Old bookmarks are preserved by the redirects documented in apps/URL-MIGRATION.md; legacy application copies are not kept.

Delivery map

flowchart LR
  subgraph Build[Content]
    A[HTML · CSS · JavaScript]
    B[Local data · fonts · images]
  end

  subgraph Check[Quality gate]
    C[Local preview]
    D{Validator passes?}
  end

  subgraph Ship[Publishing]
    E[Push master]
    F[GitHub Pages]
    G([Public site])
  end

  A --> C
  B --> C
  C --> D
  D -->|Fix| A
  D -->|Pass| E
  E --> F --> G

  classDef content fill:#FFF4CC,stroke:#B88A00,color:#292300,stroke-width:1.5px;
  classDef quality fill:#E8E5FF,stroke:#5B5BD6,color:#24225A,stroke-width:1.5px;
  classDef delivery fill:#DDF5E7,stroke:#238653,color:#153B29,stroke-width:1.5px;
  class A,B content;
  class C,D quality;
  class E,F,G delivery;

Loading

Work locally

Requirements: Python 3 and a current browser.

python3 -m http.server 4173

Open http://127.0.0.1:4173/. Use the server instead of opening files directly because the site relies on root-relative URLs and browser APIs.

Before publishing, run:

python3 scripts/validate_site.py

The validator checks HTML parsing, duplicate IDs, local file references, canonical and Open Graph metadata, sitemap coverage, every compatibility redirect, and accidental external font requests.

Repository map

.
├── .github/workflows/    # scheduled market-data refresh
├── apps/                 # applications and compatibility redirects
├── assets/               # local data, images, and icon-font subsets
├── css/                  # shared styles and design tokens
├── js/                   # shared browser behavior
├── scripts/              # validation and data-refresh utilities
├── index.html            # English profile
├── sitemap.xml
└── robots.txt

There is no package installation or production build. GitHub Pages serves the repository root from master; a normal git push origin master publishes through GitHub's Pages deployment job.

Data refresh

The portfolio does not need a custom deployment workflow. The only repository workflow, .github/workflows/refresh-stocks.yml, refreshes Data Copilot's market data on a schedule or by manual dispatch.

flowchart LR
  A([Schedule or manual run]) --> B[Fetch quotes]
  B --> C[Transform data]
  C --> D{Output changed?}
  D -->|No| E([Finish])
  D -->|Yes| F[Commit generated files]
  F --> G[Push master]
  G --> H([Pages republishes])

  classDef trigger fill:#E8E5FF,stroke:#5B5BD6,color:#24225A,stroke-width:1.5px;
  classDef action fill:#DDEBFF,stroke:#4262FF,color:#172B4D,stroke-width:1.5px;
  classDef decision fill:#FFF4CC,stroke:#B88A00,color:#292300,stroke-width:1.5px;
  classDef finish fill:#DDF5E7,stroke:#238653,color:#153B29,stroke-width:1.5px;
  class A trigger;
  class B,C,F,G action;
  class D decision;
  class E,H finish;

Loading

UI and documentation rules

• Typography uses system sans-serif, serif/Mincho, and monospace stacks. No font service is called.
• Icons come from small local WOFF2 subsets; add a glyph only when an interface actually uses it.
• Diagrams remain editable Mermaid, not screenshot-only documentation.
• For workflows and infographics, follow Miro's flowchart guidance and mapping and diagramming guidance: one clear reading direction, short labels, aligned groups, visible connectors, swimlanes or subgraphs for ownership, and a small high-contrast palette whose meaning is reinforced by text.