kossmc/admin
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Reorganize app workspaces and align Admin architecture

Browse Source
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
Download Patch File Download Diff File Expand all files Collapse all files
docs/devtools/module-generator/Readme.md
+14 -14
View File
@@ -6,21 +6,21 @@ The generator is intended to produce a maintainable starting point. Generated au
## Source Ownership
| Part | Source |
| ------------------------------- | ---------------------------------------------- |
| Generator page and form | `apps/admin/src/devtools/` |
| Copied frontend module template | `apps/admin/src/modules/_template/` |
| Generator HTTP endpoints | `backend/start/routes.ts` |
| Generator controller | `backend/app/controllers/module_controller.ts` |
| Database inspection | `backend/app/services/database_inspector.ts` |
| Backend Handlebars templates | `backend/app/templates/backend/` |
| Frontend Handlebars templates | `backend/app/templates/frontend/` |
| Part | Source |
| ------------------------------- | --------------------------------------------------- |
| Generator page and form | `apps/admin/src/devtools/` |
| Copied frontend module template | `apps/admin/src/modules/_template/` |
| Generator HTTP endpoints | `apps/backend/start/routes.ts` |
| Generator controller | `apps/backend/app/controllers/module_controller.ts` |
| Database inspection | `apps/backend/app/services/database_inspector.ts` |
| Backend Handlebars templates | `apps/backend/app/templates/backend/` |
| Frontend Handlebars templates | `apps/backend/app/templates/frontend/` |
See [frontend.md](./frontend.md) for the UI, payload builders, and generated frontend architecture. See [backend.md](./backend.md) for endpoints, database inspection, templates, and generated backend files. If generated files are not loaded or the module is missing from the menu, use the [troubleshooting guide](./troubleshooting.md).
## Prerequisites
1. Run the backend from the `backend/` workspace. The controller resolves backend and frontend destinations relative to `process.cwd()`.
1. Run the backend from the `apps/backend/` workspace. The controller resolves backend and frontend destinations relative to `process.cwd()`.
2. Run the admin app with dev mode enabled so the devtools module is registered.
3. Authenticate in the admin app. All generator endpoints use authentication middleware.
4. Create and migrate the source database table before opening the generator. The form reads tables and columns from PostgreSQL `information_schema`.
@@ -45,12 +45,12 @@ The generator first copies the complete frontend template, then overwrites gener
## Generated Locations
```txt
backend/modules/<ModuleName>/
backend/tests/modules/<ModuleName>/
apps/backend/modules/<ModuleName>/
apps/backend/tests/modules/<ModuleName>/
apps/admin/src/modules/<name>/
```
Frontend modules are discovered automatically through their `config/module.ts` manifest. Backend module routes and API routes are loaded automatically from `backend/modules/` during application startup.
Frontend modules are discovered automatically through their `config/module.ts` manifest. Backend module routes and API routes are loaded automatically from `apps/backend/modules/` during application startup.
## Important Operational Behavior
@@ -75,4 +75,4 @@ After generating a module:
For restart, module-discovery, permission, and menu problems, see [Troubleshooting](./troubleshooting.md).
The generated frontend structure follows the [React frontend architecture](../../apps-architecture/react-frontend/Readme.md). Backend modules should be reviewed against the [backend architecture](../../apps-architecture/backend/Readme.md).
The generated frontend structure follows the [React frontend architecture](../../apps/admin/architecture/Readme.md). Backend modules should be reviewed against the [backend architecture](../../apps/backend/architecture/Readme.md).