module-index.md 3.7 KB
Read this when choosing the analysis depth required before modifying a module.
Module Index
Tier 1 requires full context loading. Tier 2 is customized business logic. Tier 3 is standard framework usage. Tier 4 is thin/generated. Tier 5 is reference-only.
| Module | Path | Tier | Summary | Spec link |
|---|---|---|---|---|
| Bootstrap | index.php |
1 | Starts F3, loads encrypted runtime configuration, and boots plugins. | file structure |
| Plugin composition | src/OpenMind/System/ApplicationComposition.php, PluginStrategy.php |
1 | Discovers initializer classes by directory convention and maintains menu/route registration primitives. | add plugin rule |
| System services | src/OpenMind/System/System.php, OMUtils.php, ErrorHandlers.php |
1 | Database/cache initialization, config codec, framework error responses, and legacy utilities. | integrations |
| Identity and user management | src/OpenMind/System/User.php, UserRoles.php, src/OpenMind/Api/AuthController.php, UserController.php, Controller.php |
1 | Session login, CSRF, roles, account persistence, and user-mutation invariants. | identity spec |
| API registry | src/OpenMind/Api/Api.php |
2 | Maps all versioned JSON routes to controllers. | API routes |
| Configuration administration | src/OpenMind/Api/AdminController.php, cfg/, scripts/generate-config-bin.sh |
1 | Reads, encodes, backs up, and replaces runtime configuration. | configuration spec |
| Navigation | src/OpenMind/Api/NavigationController.php, src/OpenMind/Admin/Admin.php |
2 | Builds the role-filtered and ordered application menu. | API routes |
| Notifications | src/OpenMind/System/Notifications.php, src/OpenMind/Api/NotificationController.php |
2 | Persists, groups, polls, and deletes notification records. | API routes |
| Blank plugin | src/Modules/Blank/Blank.php |
4 | Example/demo plugin and permission registration. | add plugin rule |
| Database schema | omlink.sql |
1 | MySQL schema, constraints, and sample data source. | database conventions |
| React boot and routes | ui/app/src/main.jsx, App.jsx, routes.jsx |
2 | React/MUI setup, session bootstrap, guarded routes, and page selection. | frontend conventions |
| Frontend API client | ui/app/src/api/client.js |
1 | Same-origin URL resolution, cookies, JSON errors, and in-memory CSRF handling. | browser API integration |
| Admin React features | ui/app/src/features/admin/ |
2 | Configuration editor and user-management UI. | API routes |
| Shell and notification UI | ui/app/src/features/shell/, features/notifications/ |
2 | Responsive dark drawer, route-aware selected navigation, contextual header, and 30-second notification polling. | frontend conventions |
| Home, auth, and demo pages | ui/app/src/features/auth/, features/home/, features/demo/ |
3 | Standard page-level views and login form. | frontend conventions |
| Visual configuration | ui/app/src/theme.js, styles.css |
2 | Customized MUI palette, navigation tokens, typography, shape, and Tailwind/global style entry points. | frontend conventions |
| Frontend build output | vite.config.js, assets/app/ |
4 | Vite configuration (including filtered "use client" warnings) and generated application assets. |
commands |
| Static assets | assets/images/ |
5 | Images referenced by the UI and legacy menus. | file structure |