Reorganize app workspaces and align Admin architecture

This commit is contained in:
Igor Martyniuk
2026-07-17 13:46:21 +00:00
parent ba691d3a0c
commit 0ba01cd111
183 changed files with 3745 additions and 4354 deletions
+20 -20
View File
@@ -4,34 +4,34 @@ This is documentation home for the CRUX monorepo. Use it for system-level archit
## Monorepo Map
| Area | Source | Documentation |
| --------------- | --------------------------------------------------- | -------------------------------------------- |
| Backend API | `backend/` | Core module docs and backend-specific guides |
| Admin frontend | `apps/admin/` | [Admin app docs](./apps/admin/Readme.md) |
| Shared packages | `packages/` | [Packages index](./packages/Readme.md) |
| Devtools | `apps/admin/src/devtools/` | [Devtools docs](./devtools/Readme.md) |
| Core modules | `backend/app/base_modules/`, `apps/admin/src/core/` | [Core modules](#core-modules) |
| Future apps | `apps/*` | Add an app page under `docs/apps/` |
| Area | Source | Documentation |
| --------------- | -------------------------------------------------------- | -------------------------------------------- |
| Backend API | `apps/backend/` | Core module docs and backend-specific guides |
| Admin frontend | `apps/admin/` | [Admin app docs](./apps/admin/Readme.md) |
| Shared packages | `packages/` | [Packages index](./packages/Readme.md) |
| Devtools | `apps/admin/src/devtools/` | [Devtools docs](./devtools/Readme.md) |
| Core modules | `apps/backend/app/base_modules/`, `apps/admin/src/core/` | [Core modules](#core-modules) |
| Future apps | `apps/*` | Add an app page under `docs/apps/` |
## App Architecture
| Architecture | Scope | Documentation |
| -------------- | ------------------------------------------------- | --------------------------------------------------------------------------- |
| React frontend | Frontend apps and frontend modules under `apps/*` | [React frontend architecture](./apps-architecture/react-frontend/Readme.md) |
| Backend | AdonisJS backend apps and backend modules | [Backend architecture](./apps-architecture/backend/Readme.md) |
| Architecture | Scope | Documentation |
| -------------- | ------------------------------------------------- | ------------------------------------------------------------------ |
| React frontend | Frontend apps and frontend modules under `apps/*` | [React frontend architecture](./apps/admin/architecture/Readme.md) |
| Backend | AdonisJS backend apps and backend modules | [Backend architecture](./apps/backend/architecture/Readme.md) |
## Core Modules
Core modules are reusable admin panel areas that may have both backend and frontend implementations.
| Module | Backend | Frontend | Documentation |
| ---------------- | --------------------------------------- | -------------------------------------- | ----------------------------------------------------- |
| Access Control | Admin, Role, Permission base modules | `apps/admin/src/core/AccessControl/` | [Overview](./core-modules/access-control/Readme.md) |
| Account Settings | Admin profile endpoints | `apps/admin/src/core/AccountSettings/` | [Overview](./core-modules/account-settings/Readme.md) |
| Auth | `backend/app/base_modules/Auth/` | `apps/admin/src/core/Auth/` | [Overview](./core-modules/auth/Readme.md) |
| Fallback Screens | Frontend-only | `apps/admin/src/core/FallbackScreens/` | [Overview](./core-modules/fallback-screens/Readme.md) |
| File Manager | `backend/app/base_modules/FileManager/` | `apps/admin/src/core/FileManager/` | [Overview](./core-modules/file-manager/Readme.md) |
| Permission | Permission service and policies | `apps/admin/src/core/Permission/` | [Overview](./core-modules/permission/Readme.md) |
| Module | Backend | Frontend | Documentation |
| ---------------- | -------------------------------------------- | -------------------------------------- | ----------------------------------------------------- |
| Access Control | Admin, Role, Permission base modules | `apps/admin/src/core/AccessControl/` | [Overview](./core-modules/access-control/Readme.md) |
| Account Settings | Admin profile endpoints | `apps/admin/src/core/AccountSettings/` | [Overview](./core-modules/account-settings/Readme.md) |
| Auth | `apps/backend/app/base_modules/Auth/` | `apps/admin/src/core/Auth/` | [Overview](./core-modules/auth/Readme.md) |
| Fallback Screens | Frontend-only | `apps/admin/src/core/FallbackScreens/` | [Overview](./core-modules/fallback-screens/Readme.md) |
| File Manager | `apps/backend/app/base_modules/FileManager/` | `apps/admin/src/core/FileManager/` | [Overview](./core-modules/file-manager/Readme.md) |
| Permission | Permission service and policies | `apps/admin/src/core/Permission/` | [Overview](./core-modules/permission/Readme.md) |
Add a new page when the information has a stable owner. Keep temporary notes in issue trackers or task files until they are worth maintaining.