# webitel/cc-quality-auditor architecture

> Architecture diagram of the GitHub repository webitel/cc-quality-auditor, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/webitel/cc-quality-auditor
- Repository: https://github.com/webitel/cc-quality-auditor

## Overview

This is a Vue-based Webitel Quality Auditor application. The primary user workflow is to enter the scorecard list, search and manage audit forms, then open a form to edit its general details and criteria or save a copy. The README describes setup and development only, so product capabilities are inferred from the routes and sampled components; other runtime modules are retained where the source index identifies them, but unsampled behavior and links are not assumed.

Main entry points: [`src/app/router/index.ts`](https://github.com/webitel/cc-quality-auditor/blob/main/src/app/router/index.ts) (Route setup), [`src/main.ts`](https://github.com/webitel/cc-quality-auditor/blob/main/src/main.ts) (App bootstrap), [`src/modules/scorecards/components/opened-scorecard.vue`](https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/scorecards/components/opened-scorecard.vue) (Scorecard editor), [`src/app/components/the-auditor-workspace.vue`](https://github.com/webitel/cc-quality-auditor/blob/main/src/app/components/the-auditor-workspace.vue) (Auditor workspace)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_bootstrap["App bootstrap<br/>[main.ts]"]
  node_root["Root view<br/>[app.vue]"]
  node_router["Route setup<br/>[index.ts]"]
  node_workspace["Auditor workspace"]
  node_appearance["Theme state<br/>[appearanceStore.ts]"]
end

subgraph group_identity["Identity and access"]
  node_access["Access control"]
  node_userinfo["User state<br/>[userInfoStore.ts]"]
end

subgraph group_scorecards["Scorecard workflow"]
  node_scorecard_list["Scorecard list<br/>[the-scorecards.vue]"]
  node_list_store["List state and API"]
  node_list_headers["Table headers<br/>[headers.ts]"]
  node_card_view["Scorecard editor"]
  node_card_store["Card state and API"]
  node_general["General details"]
  node_criteria["Criteria editor"]
end

subgraph group_shared["Shared services"]
  node_error_redirect["Error redirects"]
  node_not_found["Not-found view"]
  node_api_instance["API instance<br/>[instance.js]"]
  node_ui_sdk["Webitel UI setup<br/>[ui-sdk.ts]"]
  node_api_services_config["API services setup"]
end

node_user(("Auditor"))

node_user -->|"navigates"| node_router
node_bootstrap -->|"initializes"| node_userinfo
node_bootstrap -->|"creates"| node_access
node_bootstrap -->|"initializes"| node_router
node_bootstrap -->|"mounts"| node_root
node_bootstrap -->|"sets default"| node_api_instance
node_bootstrap -->|"installs"| node_ui_sdk
node_bootstrap -.->|"configuration commented out"| node_api_services_config
node_root -->|"loads theme"| node_appearance
node_router -->|"routes to"| node_workspace
node_router -->|"routes to"| node_scorecard_list
node_router -->|"routes to"| node_card_view
node_router -->|"routes to"| node_general
node_router -->|"routes to"| node_criteria
node_router -->|"routes to"| node_not_found
node_workspace -->|"reads theme"| node_appearance
node_workspace -->|"reads user state"| node_userinfo
node_scorecard_list -->|"checks permissions"| node_access
node_scorecard_list -->|"loads and manages"| node_list_store
node_list_store -->|"uses headers"| node_list_headers
node_card_view -->|"checks permissions"| node_access
node_card_view -->|"loads and saves"| node_card_store
node_card_view -->|"renders tab"| node_general
node_card_view -->|"renders tab"| node_criteria
node_card_view -->|"handles load errors"| node_error_redirect

click node_bootstrap "https://github.com/webitel/cc-quality-auditor/blob/main/src/main.ts"
click node_root "https://github.com/webitel/cc-quality-auditor/blob/main/src/app.vue"
click node_router "https://github.com/webitel/cc-quality-auditor/blob/main/src/app/router/index.ts"
click node_workspace "https://github.com/webitel/cc-quality-auditor/blob/main/src/app/components/the-auditor-workspace.vue"
click node_appearance "https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/appearance/stores/appearanceStore.ts"
click node_access "https://github.com/webitel/cc-quality-auditor/blob/main/src/app/composables/useUserAccessControl.ts"
click node_userinfo "https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/userinfo/userInfoStore.ts"
click node_scorecard_list "https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/scorecards/components/the-scorecards.vue"
click node_list_store "https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/scorecards/stores/datalist/scorecardsDatalistStore.ts"
click node_list_headers "https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/scorecards/stores/datalist/_internals/headers.ts"
click node_card_view "https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/scorecards/components/opened-scorecard.vue"
click node_card_store "https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/scorecards/stores/card/scorecardsCardStore.ts"
click node_general "https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/scorecards/components/opened-scorecard-general.vue"
click node_criteria "https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/scorecards/components/opened-scorecard-criterias.vue"
click node_error_redirect "https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/error-pages/composable/useErrorRedirectHandler.ts"
click node_not_found "https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/error-pages/components/the-not-found-component.vue"
click node_api_instance "https://github.com/webitel/cc-quality-auditor/blob/main/src/app/api/instance.js"
click node_ui_sdk "https://github.com/webitel/cc-quality-auditor/blob/main/src/app/plugins/webitel/ui-sdk.ts"
click node_api_services_config "https://github.com/webitel/cc-quality-auditor/blob/main/src/app/plugins/webitel-api-services.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_bootstrap,node_root,node_router,node_workspace,node_appearance toneBlue
class node_access,node_userinfo toneAmber
class node_scorecard_list,node_list_store,node_list_headers,node_card_view,node_card_store,node_general,node_criteria toneMint
class node_error_redirect,node_not_found,node_api_instance,node_ui_sdk,node_api_services_config toneRose
class node_user toneIndigo
```

## Components

### Application shell

- [App bootstrap](https://github.com/webitel/cc-quality-auditor/blob/main/src/main.ts): `src/main.ts`
- [Root view](https://github.com/webitel/cc-quality-auditor/blob/main/src/app.vue): `src/app.vue`
- [Route setup](https://github.com/webitel/cc-quality-auditor/blob/main/src/app/router/index.ts): `src/app/router/index.ts`
- [Auditor workspace](https://github.com/webitel/cc-quality-auditor/blob/main/src/app/components/the-auditor-workspace.vue): `src/app/components/the-auditor-workspace.vue`
- [Theme state](https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/appearance/stores/appearanceStore.ts): `src/modules/appearance/stores/appearanceStore.ts`

### Identity and access

- [Access control](https://github.com/webitel/cc-quality-auditor/blob/main/src/app/composables/useUserAccessControl.ts): `src/app/composables/useUserAccessControl.ts`
- [User state](https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/userinfo/userInfoStore.ts): `src/modules/userinfo/userInfoStore.ts`

### Scorecard workflow

- [Scorecard list](https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/scorecards/components/the-scorecards.vue): `src/modules/scorecards/components/the-scorecards.vue`
- [List state and API](https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/scorecards/stores/datalist/scorecardsDatalistStore.ts): `src/modules/scorecards/stores/datalist/scorecardsDatalistStore.ts`
- [Table headers](https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/scorecards/stores/datalist/_internals/headers.ts): `src/modules/scorecards/stores/datalist/_internals/headers.ts`
- [Scorecard editor](https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/scorecards/components/opened-scorecard.vue): `src/modules/scorecards/components/opened-scorecard.vue`
- [Card state and API](https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/scorecards/stores/card/scorecardsCardStore.ts): `src/modules/scorecards/stores/card/scorecardsCardStore.ts`
- [General details](https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/scorecards/components/opened-scorecard-general.vue): `src/modules/scorecards/components/opened-scorecard-general.vue`
- [Criteria editor](https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/scorecards/components/opened-scorecard-criterias.vue): `src/modules/scorecards/components/opened-scorecard-criterias.vue`

### Shared services

- [Error redirects](https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/error-pages/composable/useErrorRedirectHandler.ts): `src/modules/error-pages/composable/useErrorRedirectHandler.ts`
- [Not-found view](https://github.com/webitel/cc-quality-auditor/blob/main/src/modules/error-pages/components/the-not-found-component.vue): `src/modules/error-pages/components/the-not-found-component.vue`
- [API instance](https://github.com/webitel/cc-quality-auditor/blob/main/src/app/api/instance.js): `src/app/api/instance.js`
- [Webitel UI setup](https://github.com/webitel/cc-quality-auditor/blob/main/src/app/plugins/webitel/ui-sdk.ts): `src/app/plugins/webitel/ui-sdk.ts`
- [API services setup](https://github.com/webitel/cc-quality-auditor/blob/main/src/app/plugins/webitel-api-services.ts): `src/app/plugins/webitel-api-services.ts`

### Other components

- **Auditor**

## Connections

- Auditor → Route setup: navigates (evidence: `src/app/router/index.ts`)
- App bootstrap → User state: initializes (evidence: `src/main.ts`)
- App bootstrap → Access control: creates (evidence: `src/main.ts`)
- App bootstrap → Route setup: initializes (evidence: `src/main.ts`)
- App bootstrap → Root view: mounts (evidence: `src/main.ts`)
- App bootstrap → API instance: sets default (evidence: `src/main.ts`)
- App bootstrap → Webitel UI setup: installs (evidence: `src/main.ts`)
- App bootstrap → API services setup: configuration commented out (evidence: `src/main.ts`)
- Root view → Theme state: loads theme (evidence: `src/app.vue`)
- Route setup → Auditor workspace: routes to (evidence: `src/app/router/index.ts`)
- Route setup → Scorecard list: routes to (evidence: `src/app/router/index.ts`)
- Route setup → Scorecard editor: routes to (evidence: `src/app/router/index.ts`)
- Route setup → General details: routes to (evidence: `src/app/router/index.ts`)
- Route setup → Criteria editor: routes to (evidence: `src/app/router/index.ts`)
- Route setup → Not-found view: routes to (evidence: `src/app/router/index.ts`)
- Auditor workspace → Theme state: reads theme (evidence: `src/app/components/the-auditor-workspace.vue`)
- Auditor workspace → User state: reads user state (evidence: `src/app/components/the-auditor-workspace.vue`)
- Scorecard list → Access control: checks permissions (evidence: `src/modules/scorecards/components/the-scorecards.vue`)
- Scorecard list → List state and API: loads and manages (evidence: `src/modules/scorecards/components/the-scorecards.vue`)
- List state and API → Table headers: uses headers (evidence: `src/modules/scorecards/stores/datalist/scorecardsDatalistStore.ts`)
- Scorecard editor → Access control: checks permissions (evidence: `src/modules/scorecards/components/opened-scorecard.vue`)
- Scorecard editor → Card state and API: loads and saves (evidence: `src/modules/scorecards/components/opened-scorecard.vue`)
- Scorecard editor → General details: renders tab (evidence: `src/app/router/index.ts`)
- Scorecard editor → Criteria editor: renders tab (evidence: `src/app/router/index.ts`)
- Scorecard editor → Error redirects: handles load errors (evidence: `src/modules/scorecards/components/opened-scorecard.vue`)
