Skip to main content

Workspace Map

The repo is an Angular workspace with two applications and one shared library.

Main folders​

PathWhat belongs thereWhy it exists
projects/local-appviews and flows that only make sense in the local frontendkeeps local behavior out of the global UI
projects/global-appviews and flows for the global frontendkeeps platform-wide behavior separate from local workflows
projects/shared-libreusable UI, modules, services, assets, and stylesavoids copying code between both apps
cypressend-to-end tests for both appscatches startup and integration issues

What is inside the apps​

Both apps are organized around feature folders under src/app/modules.

Examples from the current codebase:

  • global-app has modules like project, pipeline, workflow, schema, and tool-development
  • local-app has modules like patient, training, data-review, connector, and cohort

That split is the first routing hint for new work. If your change only matters to one app, keep it there first.

What is inside the shared library​

The shared library is more than a component bucket. It already contains:

  • reusable components in projects/shared-lib/src/lib/components
  • reusable feature modules in projects/shared-lib/src/lib/modules
  • shared services, directives, interceptors, pipes, models, and utils
  • shared styles and per-brand themes in projects/shared-lib/src/lib/styles
  • images and translations in projects/shared-lib/src/assets

Mental model​

If you start in an app folder and notice you are duplicating markup, styles, or service code, that is usually the moment to stop and extract the common part into shared-lib.

If you already know the task but not the folder, continue with Where to change what. If you know the feature area but not the path, jump to Systems overview.