Files

T

Patrick Plate 155d56e8e8 chore: reorganize into polyglot monorepo (workshop)

- Move bigmind/ -> mcp/bigmind/
- Move webscraper/ -> mcp/webscraper/
- Move mss-failsafe/ -> java/mss-failsafe/
- Move Wellmann-Shop/ -> java/wellmann-shop/ (normalize to kebab-case)
- Add .roo/ IDE config files to tracking
- Add plans/REPO_STRATEGY.md (monorepo strategy document)
- Expand .gitignore: Java/Maven, Node/TS, coverage, uv.lock
- Rewrite README.md as navigation index
- Update .roo/mcp.json webscraper path to mcp/webscraper/

2026-04-04 08:51:15 +02:00

2.0 KiB

Raw Permalink Blame History

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)

🐍 MCP Servers (`mcp/`)

Server	Description	Stack
`mcp/bigmind/`	Persistent AI memory — sessions, facts, hypotheses, profile UI	Python, FastMCP, SQLite, Flask
`mcp/webscraper/`	Web scraping — fetch, links, tables, sections, sitemaps	Python, FastMCP, httpx, BeautifulSoup

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.

2.0 KiB Raw Permalink Blame History