TASKS-1823 WebManager module
This commit is contained in:
Igor Martyniuk
+15
-65
@@ -1,74 +1,24 @@
|
||||
# CRUX Documentation
|
||||
|
||||
This is documentation home for the CRUX monorepo. Use it for system-level architecture, application guides, shared package references, and core module documentation.
|
||||
|
||||
## Monorepo Map
|
||||
|
||||
| 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/admin/architecture/Readme.md) |
|
||||
| Backend | AdonisJS backend apps and backend modules | [Backend architecture](./apps/backend/architecture/Readme.md) |
|
||||
Documentation home for the CRUX monorepo. See also [Architecture](./architecture/Readme.md), [Packages](./packages/Readme.md). App docs live with each app: [admin UI style guide](../apps/admin/ui-style-guide.md), [web](../apps/web/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/access-control/Readme.md) |
|
||||
| Account Settings | Admin profile endpoints | `apps/admin/src/core/AccountSettings/` | [Overview](./core/account-settings/Readme.md) |
|
||||
| Auth | `apps/backend/app/base_modules/Auth/` | `apps/admin/src/core/Auth/` | [Overview](./core/auth/Readme.md) |
|
||||
| Devtools | Dev-only | `apps/admin/src/devtools/` | [Overview](./core/devtools/Readme.md) |
|
||||
| Fallback Screens | Frontend-only | `apps/admin/src/core/FallbackScreens/` | [Overview](./core/fallback-screens/Readme.md) |
|
||||
| File Manager | `apps/backend/app/base_modules/FileManager/` | `apps/admin/src/core/FileManager/` | [Overview](./core/file-manager/Readme.md) |
|
||||
| Permission | Permission service and policies | `apps/admin/src/core/Permission/` | [Overview](./core/permission/Readme.md) |
|
||||
| Web Manager | `apps/backend/app/base_modules/WebManager/` | `apps/admin/src/core/WebStudio/` | [Overview](./core/web-manager/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) |
|
||||
## Project Modules
|
||||
|
||||
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.
|
||||
Project-specific modules: [docs/modules/](./modules/Readme.md).
|
||||
|
||||
## How To Write Module Docs
|
||||
## Shared Packages
|
||||
|
||||
Each module should answer these questions:
|
||||
|
||||
1. What user or system problem does the module solve?
|
||||
2. Where is the backend code?
|
||||
3. Where is the frontend code?
|
||||
4. What are the main flows from route to service to UI?
|
||||
5. What data contracts cross app boundaries?
|
||||
6. Which files should a developer edit for common changes?
|
||||
7. What extension points are supported?
|
||||
8. What behavior should not be changed without a migration plan?
|
||||
|
||||
Prefer short sections, source paths, and concrete examples over long prose.
|
||||
|
||||
## Documentation Rules
|
||||
|
||||
- Use `Readme.md` as the index for each folder.
|
||||
- Use relative links between documentation pages.
|
||||
- Reference source files with repository-relative paths.
|
||||
- Keep backend and frontend details separate when their ownership differs.
|
||||
- Document current behavior first, then list planned work under a `Planned Work` section.
|
||||
- Update docs in the same change when modifying routes, DTOs, permissions, storage contracts, package APIs, or module state ownership.
|
||||
|
||||
## Local Development
|
||||
|
||||
Common root scripts:
|
||||
|
||||
| Command | Purpose |
|
||||
| ----------------------- | ------------------------------------- |
|
||||
| `npm run dev:backend` | Start the AdonisJS backend. |
|
||||
| `npm run dev:admin-app` | Start the React admin app. |
|
||||
| `npm run dev:all` | Start backend and admin app together. |
|
||||
| `npm run build:backend` | Build the backend. |
|
||||
| `npm run build:admin` | Build the admin app. |
|
||||
|
||||
For product overview, setup details, and environment variables, see the project root `Readme.md`.
|
||||
Package docs live with the package source; see the [Packages index](./packages/Readme.md).
|
||||
|
||||
Reference in New Issue
Block a user