MajoorWaldi
cb171e826d
- Introduced runtime bootstrap helpers in `mjr_am_backend.features.runtime` for dependency initialization. - Implemented `apply_startup_settings` to handle various startup configurations. - Added search request normalization helpers in `mjr_am_backend.features.search` including `SearchRequestContext` and `parse_search_request` for better query handling. - Created audit logging helpers in `mjr_am_backend.routes.core.audit_log` for state-changing route handlers. - Developed a quality gate script in `scripts/run_quality_gate.py` to enforce code quality checks. - Added comprehensive tests for audit routes, scan consistency, vendor routes, and code quality metrics.
3.5 KiB
3.5 KiB
Majoor Assets Manager - Documentation Index
Welcome to the documentation hub for Majoor Assets Manager for ComfyUI.
Current Version: 2.4.2
Last Updated: March 25, 2026
Quick Start
New users
- Installation Guide - Install and set up the extension
- User Guide (HTML) - Visual walkthrough with screenshots
- Hotkeys & Shortcuts - Essential keyboard shortcuts
- Basic Search - Find assets quickly
Returning users
- AI Features Guide - AI-assisted search and enrichment features
- Viewer Feature Tutorial - Floating viewer and analysis tools
- Changelog - Recent releases and fixes
- Architecture Map - Backend boundaries and refactor guide
Documentation Categories
Getting Started
| Document | Description |
|---|---|
| INSTALLATION.md | Detailed installation instructions |
| user_guide.html | Full visual user guide |
| HOTKEYS_SHORTCUTS.md | Keyboard shortcuts |
| SHORTCUTS.md | Extra gestures and shortcuts |
Core Features
| Document | Description |
|---|---|
| SEARCH_FILTERING.md | Full-text search, filters, and sorting |
| VIEWER_FEATURE_TUTORIAL.md | Viewer, MFV, and analysis tools |
| RATINGS_TAGS_COLLECTIONS.md | Ratings, tags, and collections |
| DRAG_DROP.md | Drag and drop behavior |
| AI_FEATURES.md | Semantic search, auto-tags, and enrichment |
Configuration And Security
| Document | Description |
|---|---|
| SETTINGS_CONFIGURATION.md | UI and runtime settings |
| SECURITY_ENV_VARS.md | Environment variables and security model |
| THREAT_MODEL.md | Threats, mitigations, and residual risk |
| ARCHITECTURE_MAP.md | Package responsibilities and internal boundaries |
Maintenance And Development
| Document | Description |
|---|---|
| DB_MAINTENANCE.md | Database maintenance and recovery |
| TESTING.md | Tests, reports, and quality gate |
| QUALITY_IMPROVEMENT_PLAN.md | Codebase metrics, hotspots, and improvement roadmap |
| API_REFERENCE.md | Backend endpoint reference |
| adr/ | Architecture Decision Records |
Quality And Verification
Use the canonical gate from the repo root:
python scripts/run_quality_gate.py
Useful variants:
python scripts/run_quality_gate.py --python-only --skip-tests
tox -e quality
npm run test:js
The quality gate enforces:
- UTF-8 text files without BOM
rufflinting on changed Python files during the migration windowmypybanditpip-audit- xenon/radon complexity checks
- backend tests
- frontend tests
npm audit
Security Note
The backend keeps a compatibility-first local security model:
- loopback writes remain allowed by default
- remote writes are denied unless explicitly authorized
MAJOOR_REQUIRE_AUTH=1switches to strict token-auth for local writes too
That nuance is intentional and is the documented target behavior for current releases.