# 1c-company/ssl-support architecture

> Architecture diagram of the GitHub repository 1c-company/ssl-support, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/1c-company/ssl-support
- Repository: https://github.com/1c-company/ssl-support

## Overview

##### Project type and purpose
- This is an Eclipse-based extension (“1C:SSL support for 1C:EDT”) that plugs into the 1C:Enterprise Development Tools (EDT) IDE.
- It consists of multiple OSGi bundles (plugins), a feature set, a p2 update site, integration tests, and documentation modules.
- Its goal is to provide content-assist, hyperlinked navigation, and on-the-fly type computation for the 1C BSL (Business-specific Language) libraries in the IDE.

##### File structure
- Top-level Maven aggregation pom.xml orchestrates submodules under directories:
- bom (Bill of Materials)
- bundles (three core OSGi plugins: com.e1c.ssl.ui, com.e1c.ssl.bsl, com.e1c.ssl.bsl.ui)
- features (feature descriptors for p2 packaging)
- repositories (p2 repository definitions)
- targets (target platform definitions)
- tests (integration tests for the BSL plugin)
- docs (documentation site sources)
- Each “bundle” folder contains an Eclipse .project, META-INF/MANIFEST.MF, plugin.xml, source code under src/com/e1c/…, and a pom.xml.
- CI/CD workflows and release pipelines are defined under .github/workflows.
- The p2 repository and features directory generate the installable update site.

##### Extract architectural insights from the README
- The extension is delivered as a p2 repository of OSGi bundles and features.
- The core services compute types and provide content assist for string literals and function return types.
- The UI layer registers extension points with the EDT IDE to hook into content-assist and navigation actions.
- Type-computing logic resides in the bsl bundle; the bsl.ui bundle wires that logic into the UI.

##### Detail
- Major directory/module as a component.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Host Container"
        IDE["1C:EDT IDE"]:::host
    end

    subgraph "OSGi Bundles"
        UILayer["com.e1c.ssl.ui (UI Layer)"]:::ui
        UIBridge["com.e1c.ssl.bsl.ui (UI Bridge)"]:::bridge
        Core["com.e1c.ssl.bsl (Core Logic)"]:::core
    end

    UILayer -->|"invokes UI Bridge"| UIBridge
    UIBridge -->|"calls Type API"| Core
    Core -->|"provides type-computation"| UIBridge
    UIBridge -->|"wired into UI"| UILayer

    subgraph "Features & Repository"
        FeatureSSL["SSL Feature"]:::feature
        FeatureSDK["SDK Feature"]:::feature
        RepoSSL["SSL Repository"]:::repo
        RepoSDK["SDK Repository"]:::repo
    end

    RepoSSL -->|"exposes Feature"| FeatureSSL
    RepoSDK -->|"exposes Feature"| FeatureSDK
    RepoSSL -->|"p2 install"| IDE
    RepoSDK -->|"p2 install"| IDE

    subgraph "Build & Packaging"
        XMAVEN["Maven Aggregator POM"]:::build
        XBOM["BOM Module"]:::build
        BundlesParent["Bundles Parent POM"]:::build
        XTARGET["Target Platform Definition"]:::build
        XCI["GitHub Actions CI/CD"]:::ci
    end

    XMAVEN --> XBOM
    XMAVEN --> BundlesParent
    XMAVEN --> XTARGET
    XMAVEN --> XCI
    XMAVEN -->|"orchestrates build"| FeatureSSL
    XMAVEN -->|"orchestrates build"| FeatureSDK
    XMAVEN -->|"produces p2 repo"| RepoSSL
    XMAVEN -->|"produces p2 repo"| RepoSDK

    subgraph "Testing & Documentation"
        Tests["Integration Tests"]:::test
        Docs["Documentation Site"]:::doc
    end

    Tests -->|"launches Eclipse runtime"| IDE
    XMAVEN -->|"builds docs"| Docs

    click Core "https://github.com/1c-company/ssl-support/blob/master/bundles/com.e1c.ssl.bsl"
    click UIBridge "https://github.com/1c-company/ssl-support/blob/master/bundles/com.e1c.ssl.bsl.ui"
    click UILayer "https://github.com/1c-company/ssl-support/blob/master/bundles/com.e1c.ssl.ui"
    click XMAVEN "https://github.com/1c-company/ssl-support/blob/master/pom.xml"
    click XBOM "https://github.com/1c-company/ssl-support/blob/master/bom/pom.xml"
    click BundlesParent "https://github.com/1c-company/ssl-support/blob/master/bundles/pom.xml"
    click FeatureSSL "https://github.com/1c-company/ssl-support/blob/master/features/com.e1c.ssl.feature"
    click FeatureSDK "https://github.com/1c-company/ssl-support/blob/master/features/com.e1c.ssl.sdk.feature"
    click RepoSSL "https://github.com/1c-company/ssl-support/blob/master/repositories/com.e1c.ssl.repository"
    click RepoSDK "https://github.com/1c-company/ssl-support/blob/master/repositories/com.e1c.ssl.repository.sdk"
    click XTARGET "https://github.com/1c-company/ssl-support/blob/master/targets/default/default.target"
    click Tests "https://github.com/1c-company/ssl-support/blob/master/tests/com.e1c.ssl.bsl.itests"
    click Docs "https://github.com/1c-company/ssl-support/tree/master/docs"
    click XCI "https://github.com/1c-company/ssl-support/tree/master/.github/workflows"

    classDef host fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef ui fill:#FFF2CC,stroke:#333,stroke-width:1px
    classDef bridge fill:#FFD966,stroke:#333,stroke-width:1px
    classDef core fill:#FFFF99,stroke:#333,stroke-width:1px
    classDef feature fill:#C6EFCE,stroke:#333,stroke-width:1px
    classDef repo fill:#D5E8D4,stroke:#333,stroke-width:1px
    classDef build fill:#E1E1E1,stroke:#333,stroke-width:1px
    classDef ci fill:#F8CECC,stroke:#333,stroke-width:1px
    classDef test fill:#F4B183,stroke:#333,stroke-width:1px
    classDef doc fill:#FDE9D9,stroke:#333,stroke-width:1px
```
