diff --git a/.claude-context/00-overview.md b/.claude-context/00-overview.md new file mode 100644 index 0000000..da1b55f --- /dev/null +++ b/.claude-context/00-overview.md @@ -0,0 +1,29 @@ +# LEGO Instructions Manager (LIM) + +Flask web app for organising LEGO instruction manuals — official sets and MOCs (My Own Creations). + +**Repository:** https://gitea.hideawaygaming.com.au/jessikitty/lego-instructions-manager + +## Architecture +- Flask with modular `app/` package: separate `services/`, `routes/` (blueprints), models, templates +- SQLAlchemy + SQLite (PostgreSQL planned for production); Bootstrap 5 front end +- PDF/image instruction uploads; PyMuPDF for PDF thumbnails, Pillow for cover image optimisation +- Brickset API for auto-populating set details +- Auth with admin panel, user management, stats dashboard, role-based access +- MOC numbering via `MOCNumberGenerator` — global sequence, `MOC-0001` format + +## Deployment +- Windows host at `E:\LIM`, Python 3.14, served with waitress +- Auto-start via `start_lim.bat` + Task Scheduler (`setup_startup.bat`) + +## Conventions +- Flexible dependency ranges; minimums for Py 3.14: PyMuPDF ≥1.24.0, Pillow ≥11.0.0, SQLAlchemy ≥2.0.35 +- Quote version specifiers on Windows (`pip install "pkg>=x"`) — unquoted `>` creates stray files + +## Session Log +- 2025-12-12 — Python 3.14 Compatibility and Windows Auto-Start — Raised dependency minimums, flexible ranges, Task Scheduler startup +- 2025-12-15 — MOC Number Auto-Generation (Global Numbering) — MOC service/blueprint, global MOC-0001 numbering, auto-fill + validation +- 2026-01-05 — LEGO-Themed Visual Refresh — Brand-styled base template, dashboard and home page + +--- +*Created by: Jess Rogerson (yelling commands at Claude.AI)*