# oslc/lyo-adaptor-bugzilla architecture

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

- Interactive diagram: https://gitdiagram.com/oslc/lyo-adaptor-bugzilla
- Repository: https://github.com/oslc/lyo-adaptor-bugzilla

## Overview

This experimental OSLC4J application exposes Bugzilla change requests as OSLC resources. A client discovers the service catalog, then queries or creates change requests; the adaptor maps Bugzilla data into OSLC models and returns them through JAX-RS services. Catalog, root-services, and resource-shape capabilities are separate discovery/metadata branches. The README documents Bugzilla credential forwarding; source excerpts show some service-to-manager and model relationships, but do not expose the complete runtime wiring or all Bugzilla operations.

Main entry points: [`adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/servlet/Application.java`](https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/servlet/Application.java) (JAX-RS application), [`adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/ChangeRequest.java`](https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/ChangeRequest.java) (Change request models), [`adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/ServiceProviderService1.java`](https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/ServiceProviderService1.java) (Change request service), [`adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/BugzillaChangeRequest.java`](https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/BugzillaChangeRequest.java) (Bugzilla change request)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["OSLC endpoints"]
  node_app["JAX-RS application<br/>[Application.java]"]
  node_root["Root services"]
  node_catalog["Provider catalog"]
  node_provider["Provider service"]
  node_provider1["Change request service"]
  node_shapesvc["Resource shapes"]
  node_registry["Provider registry"]
  node_factory["Provider factory"]
  node_delegated["Delegated UI<br/>[delegatedUI.js]"]
  node_preview["Preview UI<br/>[preview.js]"]
end

subgraph group_domain["OSLC domain"]
  node_cr["Change request models<br/>[ChangeRequest.java]"]
  node_bugcr["Bugzilla change request"]
  node_requirement["Requirement model<br/>[Requirement.java]"]
  node_person["Person model<br/>[Person.java]"]
  node_discussion["Discussion model<br/>[Discussion.java]"]
end

subgraph group_integration["Bugzilla integration"]
  node_manager["Adaptor manager"]
end

node_client(("OSLC client"))
node_bugzilla["Bugzilla server"]

node_client -->|"requests discovery"| node_root
node_client -->|"browses providers"| node_catalog
node_client -->|"queries or creates"| node_provider1
node_app -->|"registers endpoint"| node_catalog
node_app -->|"registers endpoint"| node_provider
node_app -->|"registers endpoint"| node_shapesvc
node_app -->|"registers endpoint"| node_provider1
node_catalog -->|"uses catalog"| node_registry
node_provider -->|"uses catalog"| node_registry
node_registry -->|"creates providers"| node_factory
node_root -->|"uses catalog"| node_registry
node_provider1 -->|"queries Bugzilla"| node_manager
node_manager -.->|"reads and writes"| node_bugzilla
node_manager -->|"maps bug data"| node_bugcr
node_provider1 -->|"returns resources"| node_bugcr
node_bugcr -->|"extends model"| node_cr
node_cr -->|"renders linked people"| node_person
node_cr -->|"includes discussion"| node_discussion
node_cr -->|"links requirements"| node_requirement
node_bugcr -->|"loads legal values"| node_manager
node_delegated -.->|"supports dialogs"| node_client
node_preview -.->|"renders previews"| node_client

click node_app "https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/servlet/Application.java"
click node_root "https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/RootServicesService.java"
click node_catalog "https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/ServiceProviderCatalogService.java"
click node_provider "https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/ServiceProviderService.java"
click node_provider1 "https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/ServiceProviderService1.java"
click node_shapesvc "https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/ResourceShapeService.java"
click node_registry "https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/servlet/ServiceProviderCatalogSingleton.java"
click node_factory "https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/servlet/ServiceProvidersFactory.java"
click node_manager "https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/BugzillaAdaptorManager.java"
click node_cr "https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/ChangeRequest.java"
click node_bugcr "https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/BugzillaChangeRequest.java"
click node_requirement "https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/Requirement.java"
click node_person "https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/Person.java"
click node_discussion "https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/Discussion.java"
click node_delegated "https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/webapp/delegatedUI.js"
click node_preview "https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/webapp/static/js/preview.js"

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_app,node_root,node_catalog,node_provider,node_provider1,node_shapesvc,node_registry,node_factory,node_delegated,node_preview,node_client toneBlue
class node_cr,node_bugcr,node_requirement,node_person,node_discussion toneAmber
class node_manager,node_bugzilla toneMint
```

## Components

### OSLC endpoints

- [JAX-RS application](https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/servlet/Application.java): `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/servlet/Application.java`
- [Root services](https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/RootServicesService.java): `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/RootServicesService.java`
- [Provider catalog](https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/ServiceProviderCatalogService.java): `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/ServiceProviderCatalogService.java`
- [Provider service](https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/ServiceProviderService.java): `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/ServiceProviderService.java`
- [Change request service](https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/ServiceProviderService1.java): `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/ServiceProviderService1.java`
- [Resource shapes](https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/ResourceShapeService.java): `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/ResourceShapeService.java`
- [Provider registry](https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/servlet/ServiceProviderCatalogSingleton.java): `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/servlet/ServiceProviderCatalogSingleton.java`
- [Provider factory](https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/servlet/ServiceProvidersFactory.java): `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/servlet/ServiceProvidersFactory.java`
- [Delegated UI](https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/webapp/delegatedUI.js): `adaptor-bugzilla/src/main/webapp/delegatedUI.js`
- [Preview UI](https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/webapp/static/js/preview.js): `adaptor-bugzilla/src/main/webapp/static/js/preview.js`

### OSLC domain

- [Change request models](https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/ChangeRequest.java): `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/ChangeRequest.java`
- [Bugzilla change request](https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/BugzillaChangeRequest.java): `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/BugzillaChangeRequest.java`
- [Requirement model](https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/Requirement.java): `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/Requirement.java`
- [Person model](https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/Person.java): `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/Person.java`
- [Discussion model](https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/Discussion.java): `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/Discussion.java`

### Bugzilla integration

- [Adaptor manager](https://github.com/oslc/lyo-adaptor-bugzilla/blob/main/adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/BugzillaAdaptorManager.java): `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/BugzillaAdaptorManager.java`

### Other components

- **OSLC client**
- **Bugzilla server**

## Connections

- OSLC client → Root services: requests discovery
- OSLC client → Provider catalog: browses providers
- OSLC client → Change request service: queries or creates
- JAX-RS application → Provider catalog: registers endpoint (evidence: `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/servlet/Application.java`)
- JAX-RS application → Provider service: registers endpoint (evidence: `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/servlet/Application.java`)
- JAX-RS application → Resource shapes: registers endpoint (evidence: `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/servlet/Application.java`)
- JAX-RS application → Change request service: registers endpoint (evidence: `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/servlet/Application.java`)
- Provider catalog → Provider registry: uses catalog (evidence: `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/ServiceProviderCatalogService.java`)
- Provider service → Provider registry: uses catalog (evidence: `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/ServiceProviderService.java`)
- Provider registry → Provider factory: creates providers (evidence: `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/servlet/ServiceProviderCatalogSingleton.java`)
- Root services → Provider registry: uses catalog (evidence: `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/RootServicesService.java`)
- Change request service → Adaptor manager: queries Bugzilla (evidence: `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/ServiceProviderService1.java`)
- Adaptor manager → Bugzilla server: reads and writes
- Adaptor manager → Bugzilla change request: maps bug data (evidence: `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/BugzillaAdaptorManager.java`)
- Change request service → Bugzilla change request: returns resources (evidence: `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/services/ServiceProviderService1.java`)
- Bugzilla change request → Change request models: extends model (evidence: `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/BugzillaChangeRequest.java`)
- Change request models → Person model: renders linked people (evidence: `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/ChangeRequest.java`)
- Change request models → Discussion model: includes discussion (evidence: `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/ChangeRequest.java`)
- Change request models → Requirement model: links requirements (evidence: `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/ChangeRequest.java`)
- Bugzilla change request → Adaptor manager: loads legal values (evidence: `adaptor-bugzilla/src/main/java/se/kth/md/it/bcm/resources/BugzillaChangeRequest.java`)
- Delegated UI → OSLC client: supports dialogs
- Preview UI → OSLC client: renders previews
