# wrlu/seciot-web architecture

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

- Interactive diagram: https://gitdiagram.com/wrlu/seciot-web
- Repository: https://github.com/wrlu/seciot-web

## Overview

SecIoT is a server-side IoT firmware security analysis platform. Its principal workflow accepts a firmware upload, analyzes and extracts it, identifies supported third-party libraries and firmware configuration risks, then returns findings and records an analysis history. Separate API branches manage risk definitions, history, and users. Java delegates firmware inspection to a Python service over a local socket. The README documents supported filesystem, library, and configuration checks; unsampled Python dispatch details and persistence wiring are not asserted here.

Main entry points: [`src/main/java/com/wrlus/seciot/fw/controller/FwController.java`](https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/fw/controller/FwController.java) (Firmware API), [`src/main/webapp/WEB-INF/python/socket_server.py`](https://github.com/wrlu/seciot-web/blob/master/src/main/webapp/WEB-INF/python/socket_server.py) (Python analysis service), [`src/main/java/com/wrlus/seciot/fw/service/FwServiceImpl.java`](https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/fw/service/FwServiceImpl.java) (Firmware analysis), [`src/main/java/com/wrlus/seciot/library/service/ThirdLibraryServiceImpl.java`](https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/library/service/ThirdLibraryServiceImpl.java) (Library risk catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_analysis["Firmware analysis"]
  node_fw_api["Firmware API<br/>[FwController.java]"]
  node_fw_service["Firmware analysis<br/>[FwServiceImpl.java]"]
  node_fw_model["Firmware metadata<br/>[FwInfo.java]"]
  node_py_client["Python socket client<br/>[PyClient.java]"]
  node_py_server["Python analysis service<br/>[socket_server.py]"]
  node_fw_tools["Firmware tools"]
  node_library_checks["Library version checks"]
  node_platform_checks["Platform checks"]
end

subgraph group_catalog["Risk catalogs"]
  node_library_api["Library risk catalog"]
  node_library_mapper["Library mapper"]
  node_platform_api["Platform risk catalog"]
  node_platform_mapper["Platform mapper"]
  node_cve_api["CVE catalog"]
  node_cve_mapper["CVE mapper<br/>[CVEMapper.java]"]
end

subgraph group_history["History"]
  node_history_api["History service"]
  node_history_mapper["History mapper<br/>[HistoryMapper.java]"]
  node_history_records["Analysis records<br/>[FwHistoryDao.java]"]
  node_history_web["History API"]
end

subgraph group_accounts["Accounts"]
  node_user_web["User API"]
  node_user_service["User service"]
  node_user_mapper["User mapper<br/>[UserMapper.java]"]
end

node_operator(("Web user"))

node_operator -->|"uploads firmware"| node_fw_api
node_fw_api -->|"requests analysis"| node_fw_service
node_fw_service -->|"maps results"| node_fw_model
node_fw_service -->|"sends commands"| node_py_client
node_py_client -->|"sends socket requests"| node_py_server
node_py_server -.->|"dispatches tools"| node_fw_tools
node_py_server -.->|"dispatches checks"| node_library_checks
node_py_server -.->|"dispatches checks"| node_platform_checks
node_fw_api -->|"loads library risks"| node_library_api
node_fw_api -->|"loads platform risks"| node_platform_api
node_fw_api -->|"records analysis"| node_history_api
node_library_api -->|"queries"| node_library_mapper
node_platform_api -->|"queries"| node_platform_mapper
node_cve_api -->|"queries"| node_cve_mapper
node_history_api -->|"delegates queries"| node_history_mapper
node_fw_api -->|"assembles findings"| node_history_records
node_history_web -->|"requests history"| node_history_api
node_user_web -->|"manages accounts"| node_user_service
node_user_service -->|"delegates queries"| node_user_mapper
node_library_api -.->|"looks up CVEs"| node_cve_api

click node_fw_api "https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/fw/controller/FwController.java"
click node_fw_service "https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/fw/service/FwServiceImpl.java"
click node_fw_model "https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/fw/model/FwInfo.java"
click node_py_client "https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/pysocket/PyClient.java"
click node_py_server "https://github.com/wrlu/seciot-web/blob/master/src/main/webapp/WEB-INF/python/socket_server.py"
click node_fw_tools "https://github.com/wrlu/seciot-web/tree/master/src/main/webapp/WEB-INF/python/run_tools"
click node_library_checks "https://github.com/wrlu/seciot-web/tree/master/src/main/webapp/WEB-INF/python/fw_third_library"
click node_platform_checks "https://github.com/wrlu/seciot-web/tree/master/src/main/webapp/WEB-INF/python/fw_platform"
click node_library_api "https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/library/service/ThirdLibraryServiceImpl.java"
click node_library_mapper "https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/library/dao/ThirdLibraryMapper.java"
click node_platform_api "https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/platform/service/PlatformRiskServiceImpl.java"
click node_platform_mapper "https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/platform/dao/PlatformRiskMapper.java"
click node_cve_api "https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/cve/service/CVEServiceImpl.java"
click node_cve_mapper "https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/cve/dao/CVEMapper.java"
click node_history_api "https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/history/service/HistoryServiceImpl.java"
click node_history_mapper "https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/history/dao/HistoryMapper.java"
click node_history_records "https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/history/model/FwHistoryDao.java"
click node_history_web "https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/history/controller/HistoryController.java"
click node_user_web "https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/user/controller/UserController.java"
click node_user_service "https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/user/service/UserServiceImpl.java"
click node_user_mapper "https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/user/dao/UserMapper.java"

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_fw_api,node_fw_service,node_fw_model,node_py_client,node_py_server,node_fw_tools,node_library_checks,node_platform_checks,node_operator toneBlue
class node_library_api,node_library_mapper,node_platform_api,node_platform_mapper,node_cve_api,node_cve_mapper toneAmber
class node_history_api,node_history_mapper,node_history_records,node_history_web toneMint
class node_user_web,node_user_service,node_user_mapper toneRose
```

## Components

### Firmware analysis

- [Firmware API](https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/fw/controller/FwController.java): `src/main/java/com/wrlus/seciot/fw/controller/FwController.java`
- [Firmware analysis](https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/fw/service/FwServiceImpl.java): `src/main/java/com/wrlus/seciot/fw/service/FwServiceImpl.java`
- [Firmware metadata](https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/fw/model/FwInfo.java): `src/main/java/com/wrlus/seciot/fw/model/FwInfo.java`
- [Python socket client](https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/pysocket/PyClient.java): `src/main/java/com/wrlus/seciot/pysocket/PyClient.java`
- [Python analysis service](https://github.com/wrlu/seciot-web/blob/master/src/main/webapp/WEB-INF/python/socket_server.py): `src/main/webapp/WEB-INF/python/socket_server.py`
- [Firmware tools](https://github.com/wrlu/seciot-web/tree/master/src/main/webapp/WEB-INF/python/run_tools): `src/main/webapp/WEB-INF/python/run_tools`
- [Library version checks](https://github.com/wrlu/seciot-web/tree/master/src/main/webapp/WEB-INF/python/fw_third_library): `src/main/webapp/WEB-INF/python/fw_third_library`
- [Platform checks](https://github.com/wrlu/seciot-web/tree/master/src/main/webapp/WEB-INF/python/fw_platform): `src/main/webapp/WEB-INF/python/fw_platform`

### Risk catalogs

- [Library risk catalog](https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/library/service/ThirdLibraryServiceImpl.java): `src/main/java/com/wrlus/seciot/library/service/ThirdLibraryServiceImpl.java`
- [Library mapper](https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/library/dao/ThirdLibraryMapper.java): `src/main/java/com/wrlus/seciot/library/dao/ThirdLibraryMapper.java`
- [Platform risk catalog](https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/platform/service/PlatformRiskServiceImpl.java): `src/main/java/com/wrlus/seciot/platform/service/PlatformRiskServiceImpl.java`
- [Platform mapper](https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/platform/dao/PlatformRiskMapper.java): `src/main/java/com/wrlus/seciot/platform/dao/PlatformRiskMapper.java`
- [CVE catalog](https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/cve/service/CVEServiceImpl.java): `src/main/java/com/wrlus/seciot/cve/service/CVEServiceImpl.java`
- [CVE mapper](https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/cve/dao/CVEMapper.java): `src/main/java/com/wrlus/seciot/cve/dao/CVEMapper.java`

### History

- [History service](https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/history/service/HistoryServiceImpl.java): `src/main/java/com/wrlus/seciot/history/service/HistoryServiceImpl.java`
- [History mapper](https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/history/dao/HistoryMapper.java): `src/main/java/com/wrlus/seciot/history/dao/HistoryMapper.java`
- [Analysis records](https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/history/model/FwHistoryDao.java): `src/main/java/com/wrlus/seciot/history/model/FwHistoryDao.java`
- [History API](https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/history/controller/HistoryController.java): `src/main/java/com/wrlus/seciot/history/controller/HistoryController.java`

### Accounts

- [User API](https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/user/controller/UserController.java): `src/main/java/com/wrlus/seciot/user/controller/UserController.java`
- [User service](https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/user/service/UserServiceImpl.java): `src/main/java/com/wrlus/seciot/user/service/UserServiceImpl.java`
- [User mapper](https://github.com/wrlu/seciot-web/blob/master/src/main/java/com/wrlus/seciot/user/dao/UserMapper.java): `src/main/java/com/wrlus/seciot/user/dao/UserMapper.java`

### Other components

- **Web user**

## Connections

- Web user → Firmware API: uploads firmware (evidence: `src/main/java/com/wrlus/seciot/fw/controller/FwController.java`)
- Firmware API → Firmware analysis: requests analysis (evidence: `src/main/java/com/wrlus/seciot/fw/controller/FwController.java`)
- Firmware analysis → Firmware metadata: maps results (evidence: `src/main/java/com/wrlus/seciot/fw/service/FwServiceImpl.java`)
- Firmware analysis → Python socket client: sends commands (evidence: `src/main/java/com/wrlus/seciot/fw/service/FwServiceImpl.java`)
- Python socket client → Python analysis service: sends socket requests (evidence: `src/main/java/com/wrlus/seciot/pysocket/PyClient.java`)
- Python analysis service → Firmware tools: dispatches tools
- Python analysis service → Library version checks: dispatches checks
- Python analysis service → Platform checks: dispatches checks
- Firmware API → Library risk catalog: loads library risks (evidence: `src/main/java/com/wrlus/seciot/fw/controller/FwController.java`)
- Firmware API → Platform risk catalog: loads platform risks (evidence: `src/main/java/com/wrlus/seciot/fw/controller/FwController.java`)
- Firmware API → History service: records analysis (evidence: `src/main/java/com/wrlus/seciot/fw/controller/FwController.java`)
- Library risk catalog → Library mapper: queries (evidence: `src/main/java/com/wrlus/seciot/library/service/ThirdLibraryServiceImpl.java`)
- Platform risk catalog → Platform mapper: queries (evidence: `src/main/java/com/wrlus/seciot/platform/service/PlatformRiskServiceImpl.java`)
- CVE catalog → CVE mapper: queries (evidence: `src/main/java/com/wrlus/seciot/cve/service/CVEServiceImpl.java`)
- History service → History mapper: delegates queries (evidence: `src/main/java/com/wrlus/seciot/history/service/HistoryServiceImpl.java`)
- Firmware API → Analysis records: assembles findings (evidence: `src/main/java/com/wrlus/seciot/fw/controller/FwController.java`)
- History API → History service: requests history (evidence: `src/main/java/com/wrlus/seciot/history/controller/HistoryController.java`)
- User API → User service: manages accounts (evidence: `src/main/java/com/wrlus/seciot/user/controller/UserController.java`)
- User service → User mapper: delegates queries (evidence: `src/main/java/com/wrlus/seciot/user/service/UserServiceImpl.java`)
- Library risk catalog → CVE catalog: looks up CVEs
