# jimmyfreecoding/buildingos.software architecture

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

- Interactive diagram: https://gitdiagram.com/jimmyfreecoding/buildingos.software
- Repository: https://github.com/jimmyfreecoding/buildingos.software

## Overview

This repository is a VitePress documentation site for BuildingOS software copyright materials and user manuals, with source-code submission pages for listed products. Readers select a product and consult its copyright, manual, and source documents. The tree and README establish the documentation scope; sampled source is limited to package configuration and document-conversion utilities, so no backend or product runtime is represented.

Main entry points: [`docs/index.md`](https://github.com/jimmyfreecoding/buildingos.software/blob/main/docs/index.md) (Documentation index), [`docs/access`](https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/access) (Access system), [`docs/visitor`](https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/visitor) (Visitor system), [`docs/reservation`](https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/reservation) (Space reservation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Site entry"]
  node_index["Documentation index<br/>[index.md]"]
end

subgraph group_building["Building systems"]
  node_access["Access system"]
  node_visitor["Visitor system"]
  node_reservation["Space reservation"]
  node_meetingroom["Meeting room"]
  node_workflow["Scene orchestration"]
  node_operation["Operations system"]
  node_bmp["Control system"]
  node_screen["Display system"]
end

subgraph group_channels["User channels"]
  node_meetingpad["Meeting pad"]
  node_wallpad["Wall pad"]
  node_wechat["WeCom client"]
  node_feishu["Feishu client"]
  node_dingding["DingTalk client"]
  node_mini["Mini program"]
end

subgraph group_platform["AIoT platform"]
  node_face["Face library"]
  node_iot["IoT gateway"]
  node_visioncount["AI perception"]
  node_agent["AI agent"]
end

node_reader(("Reader"))

node_reader -->|"opens"| node_index
node_index -->|"lists"| node_access
node_index -->|"lists"| node_visitor
node_index -->|"lists"| node_reservation
node_index -->|"lists"| node_meetingroom
node_index -->|"lists"| node_workflow
node_index -->|"lists"| node_operation
node_index -->|"lists"| node_bmp
node_index -->|"lists"| node_screen
node_index -->|"lists"| node_meetingpad
node_index -->|"lists"| node_wallpad
node_index -->|"lists"| node_wechat
node_index -->|"lists"| node_feishu
node_index -->|"lists"| node_dingding
node_index -->|"lists"| node_mini
node_index -->|"lists"| node_face
node_index -->|"lists"| node_iot
node_index -->|"lists"| node_visioncount
node_index -->|"lists"| node_agent
node_reader -->|"consults"| node_access
node_reader -->|"consults"| node_visitor
node_reader -->|"consults"| node_reservation
node_reader -->|"consults"| node_meetingroom
node_reader -->|"consults"| node_workflow
node_reader -->|"consults"| node_operation
node_reader -->|"consults"| node_bmp
node_reader -->|"consults"| node_screen
node_reader -->|"consults"| node_meetingpad
node_reader -->|"consults"| node_wallpad
node_reader -->|"consults"| node_wechat
node_reader -->|"consults"| node_feishu
node_reader -->|"consults"| node_dingding
node_reader -->|"consults"| node_mini
node_reader -->|"consults"| node_face
node_reader -->|"consults"| node_iot
node_reader -->|"consults"| node_visioncount
node_reader -->|"consults"| node_agent

click node_index "https://github.com/jimmyfreecoding/buildingos.software/blob/main/docs/index.md"
click node_access "https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/access"
click node_visitor "https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/visitor"
click node_reservation "https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/reservation"
click node_meetingroom "https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/meetingroom"
click node_workflow "https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/workflow"
click node_operation "https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/operation"
click node_bmp "https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/bmp"
click node_screen "https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/screen"
click node_meetingpad "https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/meetingpad"
click node_wallpad "https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/wallpad"
click node_wechat "https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/wechat"
click node_feishu "https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/feishu"
click node_dingding "https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/dingding"
click node_mini "https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/mini"
click node_face "https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/face"
click node_iot "https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/iot"
click node_visioncount "https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/visioncount"
click node_agent "https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/agent"

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_index toneBlue
class node_access,node_visitor,node_reservation,node_meetingroom,node_workflow,node_operation,node_bmp,node_screen toneAmber
class node_meetingpad,node_wallpad,node_wechat,node_feishu,node_dingding,node_mini toneMint
class node_face,node_iot,node_visioncount,node_agent toneRose
class node_reader toneIndigo
```

## Components

### Site entry

- [Documentation index](https://github.com/jimmyfreecoding/buildingos.software/blob/main/docs/index.md): `docs/index.md`

### Building systems

- [Access system](https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/access): `docs/access`
- [Visitor system](https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/visitor): `docs/visitor`
- [Space reservation](https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/reservation): `docs/reservation`
- [Meeting room](https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/meetingroom): `docs/meetingroom`
- [Scene orchestration](https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/workflow): `docs/workflow`
- [Operations system](https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/operation): `docs/operation`
- [Control system](https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/bmp): `docs/bmp`
- [Display system](https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/screen): `docs/screen`

### User channels

- [Meeting pad](https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/meetingpad): `docs/meetingpad`
- [Wall pad](https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/wallpad): `docs/wallpad`
- [WeCom client](https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/wechat): `docs/wechat`
- [Feishu client](https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/feishu): `docs/feishu`
- [DingTalk client](https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/dingding): `docs/dingding`
- [Mini program](https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/mini): `docs/mini`

### AIoT platform

- [Face library](https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/face): `docs/face`
- [IoT gateway](https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/iot): `docs/iot`
- [AI perception](https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/visioncount): `docs/visioncount`
- [AI agent](https://github.com/jimmyfreecoding/buildingos.software/tree/main/docs/agent): `docs/agent`

### Other components

- **Reader**

## Connections

- Reader → Documentation index: opens
- Documentation index → Access system: lists
- Documentation index → Visitor system: lists
- Documentation index → Space reservation: lists
- Documentation index → Meeting room: lists
- Documentation index → Scene orchestration: lists
- Documentation index → Operations system: lists
- Documentation index → Control system: lists
- Documentation index → Display system: lists
- Documentation index → Meeting pad: lists
- Documentation index → Wall pad: lists
- Documentation index → WeCom client: lists
- Documentation index → Feishu client: lists
- Documentation index → DingTalk client: lists
- Documentation index → Mini program: lists
- Documentation index → Face library: lists
- Documentation index → IoT gateway: lists
- Documentation index → AI perception: lists
- Documentation index → AI agent: lists
- Reader → Access system: consults
- Reader → Visitor system: consults
- Reader → Space reservation: consults
- Reader → Meeting room: consults
- Reader → Scene orchestration: consults
- Reader → Operations system: consults
- Reader → Control system: consults
- Reader → Display system: consults
- Reader → Meeting pad: consults
- Reader → Wall pad: consults
- Reader → WeCom client: consults
- Reader → Feishu client: consults
- Reader → DingTalk client: consults
- Reader → Mini program: consults
- Reader → Face library: consults
- Reader → IoT gateway: consults
- Reader → AI perception: consults
- Reader → AI agent: consults