Patrick Plate 7a573d7193 docs(lumen-exchange): CannaManage local Docker testing + Playwright e2e plan for Work Lumen
Why curl wasn't enough (hydration + missing auth token), the bug catalogue
(hydration crash, PWA middleware, consent principal bug, and the systemic
'frontend never sends the access token' issue), how to run the stack locally
on the Mac, and the concrete Playwright real-token e2e suite to implement.
2026-06-13 11:00:13 +02:00

Workshop — Patrick's Homelab Monorepo

A polyglot monorepo for personal engineering projects: MCP servers, Java web apps, and whatever comes next. Hosted on Gitea @ TrueNAS.local.

See plans/REPO_STRATEGY.md for the full structure rationale and conventions.


📂 Structure

workshop/
├── mcp/          Python MCP servers (FastMCP + uv)
├── java/         Java web projects (Maven + Jakarta EE)
├── plans/        Architecture & strategy docs
└── .roo/         IDE config (Roo Code, MCP wiring)

📖 Wiki

Full documentation lives in the Gitea wiki.

Wiki source: docs/wiki/pages/ — edit here, deploy with:

./docs/wiki/deploy_wiki.sh

MCP Servers (mcp/)

Server Description Stack
mcp/bigmind/ Persistent AI memory — sessions, facts, hypotheses, profile UI Python, FastMCP, SQLite, Flask
mcp/webscraper/ Web scraping, search — fetch, links, tables, Brave Search Python, FastMCP, httpx, BeautifulSoup
mcp/mcp-image-gen/ AI image generation — text-to-image via ComfyUI + FLUX.1-schnell Python, FastMCP, httpx, ComfyUI

Run a server:

cd mcp/bigmind   # or mcp/webscraper
./run.sh

Each server is an independent Python package. uv sync handles dependencies, no shared virtualenv.


Java Projects (java/)

Project Description Stack
java/mss-failsafe/ MSS Failsafe — multi-module Java EE web application Java EE, Maven, WildFly
java/wellmann-shop/ Wellmann online shop — JSF/PrimeFaces e-commerce Java 8, JSF, PrimeFaces, EclipseLink, MySQL

Build a project:

cd java/wellmann-shop
mvn clean package

📐 Plans & Architecture (plans/)

Document Description
plans/REPO_STRATEGY.md Monorepo strategy, taxonomy, naming conventions, migration log

🔧 IDE Wiring

MCP servers are wired into VS Code via .roo/mcp.json.

BigMind memory DB lives at ~/.mcp/bigmind/memory.db (outside the repo — not committed).


License

MIT — personal homelab use.

S
Description
Homelab MCP servers monorepo
Readme 98 MiB
Languages
Java 33%
HTML 32.7%
Python 24.7%
TypeScript 3.8%
CSS 3.8%
Other 2%