# microsoft/bcapps architecture

> Architecture diagram of the GitHub repository microsoft/bcapps, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/microsoft/bcapps
- Repository: https://github.com/microsoft/bcapps

## Overview

BCApps is the open-source application codebase for Microsoft Dynamics 365 Business Central, spanning its platform, business applications, first-party extensions, and developer tools. A typical user starts a business task in the localized Base Application; shared platform and business logic support application behavior, while first-party apps add focused capabilities such as e-documents and integrations. The graph reflects the repository structure documented in the README and sampled control add-ins; detailed runtime wiring among unsampled application areas is not inferred.

Main entry points: [`src/Apps`](https://github.com/microsoft/bcapps/tree/main/src/Apps) (First-party apps), [`src/Layers`](https://github.com/microsoft/bcapps/tree/main/src/Layers) (Base Application), [`src/Apps/W1/EDocument`](https://github.com/microsoft/bcapps/tree/main/src/Apps/W1/EDocument) (E-Documents), [`src/Apps/W1/EDocument/App/src/ControlAddIn/script.js`](https://github.com/microsoft/bcapps/blob/main/src/Apps/W1/EDocument/App/src/ControlAddIn/script.js) (PDF viewer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_platform["Platform foundation"]
  node_systemapp["System Application"]
  node_businessfoundation["Business Foundation"]
end

subgraph group_business["Business applications"]
  node_baseapp["Base Application"]
  node_localizations["Localizations"]
  node_gdl["Regional content"]
end

subgraph group_firstparty["First-party apps"]
  node_firstparty["First-party apps"]
  node_edoc["E-Documents"]
  node_pdfviewer["PDF viewer<br/>[script.js]"]
  node_ukmtd["UK tax headers<br/>[MTDFPHeaders.js]"]
  node_shopify["Shopify connector"]
  node_powerbi["Power BI reports"]
end

subgraph group_devtools["Developer tools"]
  node_devtools["Developer tools"]
  node_demotool["Demo data tool"]
  node_testframework["Test frameworks"]
end

node_user(("Business user"))
node_externalservices{{"External services"}}

node_user -->|"starts task"| node_baseapp
node_baseapp -->|"localized by"| node_localizations
node_baseapp -->|"uses shared logic"| node_businessfoundation
node_baseapp -->|"uses platform"| node_systemapp
node_user -->|"uses extensions"| node_firstparty
node_firstparty -->|"includes"| node_edoc
node_edoc -->|"displays PDF"| node_pdfviewer
node_pdfviewer -.->|"loads PDF.js"| node_externalservices
node_firstparty -->|"includes"| node_ukmtd
node_ukmtd -.->|"requests public IP"| node_externalservices
node_firstparty -->|"includes"| node_shopify
node_firstparty -->|"includes"| node_powerbi
node_devtools -->|"includes"| node_testframework
node_user -->|"generates demo data"| node_demotool

click node_systemapp "https://github.com/microsoft/bcapps/tree/main/src/System%20Application"
click node_businessfoundation "https://github.com/microsoft/bcapps/tree/main/src/Business%20Foundation"
click node_baseapp "https://github.com/microsoft/bcapps/tree/main/src/Layers"
click node_localizations "https://github.com/microsoft/bcapps/tree/main/src/Layers"
click node_gdl "https://github.com/microsoft/bcapps/tree/main/src/GDL"
click node_firstparty "https://github.com/microsoft/bcapps/tree/main/src/Apps"
click node_edoc "https://github.com/microsoft/bcapps/tree/main/src/Apps/W1/EDocument"
click node_pdfviewer "https://github.com/microsoft/bcapps/blob/main/src/Apps/W1/EDocument/App/src/ControlAddIn/script.js"
click node_ukmtd "https://github.com/microsoft/bcapps/blob/main/src/Apps/GB/UKMakingTaxDigital/app/src/FraudPrevention/MTDFPHeaders.js"
click node_shopify "https://github.com/microsoft/bcapps/tree/main/src/Apps"
click node_powerbi "https://github.com/microsoft/bcapps/tree/main/src/Apps"
click node_demotool "https://github.com/microsoft/bcapps/tree/main/src/DemoTool"

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_systemapp,node_businessfoundation,node_user toneBlue
class node_baseapp,node_localizations,node_gdl toneAmber
class node_firstparty,node_edoc,node_pdfviewer,node_ukmtd,node_shopify,node_powerbi toneMint
class node_devtools,node_demotool,node_testframework toneRose
class node_externalservices toneIndigo
```

## Components

### Platform foundation

- [System Application](https://github.com/microsoft/bcapps/tree/main/src/System%20Application): `src/System Application`
- [Business Foundation](https://github.com/microsoft/bcapps/tree/main/src/Business%20Foundation): `src/Business Foundation`

### Business applications

- [Base Application](https://github.com/microsoft/bcapps/tree/main/src/Layers): `src/Layers`
- [Localizations](https://github.com/microsoft/bcapps/tree/main/src/Layers): `src/Layers`
- [Regional content](https://github.com/microsoft/bcapps/tree/main/src/GDL): `src/GDL`

### First-party apps

- [First-party apps](https://github.com/microsoft/bcapps/tree/main/src/Apps): `src/Apps`
- [E-Documents](https://github.com/microsoft/bcapps/tree/main/src/Apps/W1/EDocument): `src/Apps/W1/EDocument`
- [PDF viewer](https://github.com/microsoft/bcapps/blob/main/src/Apps/W1/EDocument/App/src/ControlAddIn/script.js): `src/Apps/W1/EDocument/App/src/ControlAddIn/script.js`
- [UK tax headers](https://github.com/microsoft/bcapps/blob/main/src/Apps/GB/UKMakingTaxDigital/app/src/FraudPrevention/MTDFPHeaders.js): `src/Apps/GB/UKMakingTaxDigital/app/src/FraudPrevention/MTDFPHeaders.js`
- [Shopify connector](https://github.com/microsoft/bcapps/tree/main/src/Apps): `src/Apps`
- [Power BI reports](https://github.com/microsoft/bcapps/tree/main/src/Apps): `src/Apps`

### Developer tools

- **Developer tools**
- [Demo data tool](https://github.com/microsoft/bcapps/tree/main/src/DemoTool): `src/DemoTool`
- **Test frameworks**

### Other components

- **Business user**
- **External services**

## Connections

- Business user → Base Application: starts task
- Base Application → Localizations: localized by
- Base Application → Business Foundation: uses shared logic
- Base Application → System Application: uses platform
- Business user → First-party apps: uses extensions
- First-party apps → E-Documents: includes
- E-Documents → PDF viewer: displays PDF
- PDF viewer → External services: loads PDF.js
- First-party apps → UK tax headers: includes
- UK tax headers → External services: requests public IP
- First-party apps → Shopify connector: includes
- First-party apps → Power BI reports: includes
- Developer tools → Test frameworks: includes
- Business user → Demo data tool: generates demo data
