fogserv — Project-Specific Notes

Status: Active
Last Updated: 2026-08-26
Category: Project Reference
Prerequisites: kb/README
Tags: fogserv, project, deployment, website, k3s, prisma, tanstack

Summary

Project-specific reference for the fogserv.cloud codebase and its live deployment — how the pieces fit together and where to look in the KB for each concern. Generic learning lives in the other sections; anything true only of this stack belongs here.

Contents

• README.md — this file (section map)
• Created articles:
  • architecture-overview.md — TanStack Start + Tailwind frontend, Prisma data layer, Forgejo-hosted repo (git.shire.one/fogserv/website) ✅ 2026-08-26
  • deployment-runbook.md — k3s cluster deployment, PVC-backed SQLite persistence, secrets handling (../sysadmin/secrets.md) ✅ 2026-08-26
  • kb-browser.md — the in-site KB browser feature and how /kb/ content reaches the UI ✅ 2026-08-26

Related Sections

• frontend/ — TanStack/Tailwind patterns used by this site
• databases/ — Prisma connections and schema overview
• containers/ — Docker/k0s deployment knowledge
• cicd/ — Forgejo + Woodpecker pipeline that ships changes
• sysadmin/ — Dotenvx/secrets hygiene for this repo

Change Log

2026-08-26

• Section created per kb-build-plan.md Task 0.1; article stubs listed as planned.