Patrick Plate
c25a97c37b
- 01-PROJECT-CHARTER.md: project charter with Gantt chart and risk register - 02-USER-STORIES.md: 25 user stories with MoSCoW priorities and ACs - 03-ARCHITECTURE.md: system architecture, ERD (8 entities), multi-tenancy design - 04-FLOWCHARTS.md: 5 business logic flow charts (distribution, recall, etc) - 05-API-SPEC.md: REST API spec (7 controllers, 30+ endpoints) - 06-WIREFRAMES.md: 6 screen wireframes with AI-generated mockup images - 07-CODING-STANDARDS.md: Java 21 standards, Git strategy, compliance rules - 08-TEST-PLAN.md: 26 test cases, JaCoCo coverage gates - 09-DEPLOYMENT-GUIDE.md: Hetzner Docker Compose + Gitea CI/CD pipeline - README.md + CHANGELOG.md + 10-RETROSPECTIVE.md - 5 AI-generated UI mockup images (Flux Schnell/ComfyUI)
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.