mirror of
https://github.com/All-Hands-AI/OpenHands.git
synced 2026-04-29 03:00:45 -04:00
e1caf1db33
* feat(i18n): initial i18n setup
- Configured i18n settings in docusaurus.config.js
- Implemented Translate component and translate function in key components
* docs(i18n): complete documentation internationalization
- Added support for Simplified Chinese and French
* Update docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/troubleshooting/troubleshooting.md
* Update docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/troubleshooting/troubleshooting.md
* Update docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/troubleshooting/troubleshooting.md
* fix(build): resolve broken links causing build failure
- Fix issue causing build errors due to broken links in Docusaurus documentation.
- Resolve uncontrolled resource consumption in braces (see: https://github.com/advisories/GHSA-grv7-fg5c-xmjg).
- Bump Docusaurus to ^3.4.0 to fix MDX loader: linkify should process the md AST instead of the md string.
* fix: sync with commit 868b746
- Change to `docusaurus write-translations` to provide translation for JSON files.
---------
Co-authored-by: Yufan Song <33971064+yufansong@users.noreply.github.com>
Co-authored-by: Graham Neubig <neubig@gmail.com>
52 lines
2.6 KiB
Plaintext
52 lines
2.6 KiB
Plaintext
---
|
|
sidebar_position: 4
|
|
---
|
|
|
|
# 🏛️ System Architecture Overview
|
|
|
|
This is a high-level overview of the system architecture. The system is divided into two main components: the frontend and the backend. The frontend is responsible for handling user interactions and displaying the results. The backend is responsible for handling the business logic and executing the agents.
|
|
|
|
|
|
|
|
This Overview is simplified to show the main components and their interactions. For a more detailed view of the backend architecture, see the [Backend Architecture](#backend-architecture-en) section.
|
|
|
|
# Backend Architecture {#backend-architecture-en}
|
|
|
|
_**Disclaimer**: The backend architecture is a work in progress and is subject to change. The following diagram shows the current architecture of the backend based on the commit that is shown in the footer of the diagram._
|
|
|
|
|
|
|
|
<details>
|
|
<summary>Updating this Diagram</summary>
|
|
<div>
|
|
The generation of the backend architecture diagram is partially automated.
|
|
The diagram is generated from the type hints in the code using the py2puml
|
|
tool. The diagram is then manually reviewed, adjusted and exported to PNG
|
|
and SVG.
|
|
|
|
## Prerequisites
|
|
|
|
- Running python environment in which opendevin is executable
|
|
(according to the instructions in the README.md file in the root of the repository)
|
|
- [py2puml](https://github.com/lucsorel/py2puml) installed
|
|
|
|
## Steps
|
|
|
|
1. Autogenerate the diagram by running the following command from the root of the repository:
|
|
`py2puml opendevin opendevin > docs/architecture/backend_architecture.puml`
|
|
|
|
2. Open the generated file in a PlantUML editor, e.g. Visual Studio Code with the PlantUML extension or [PlantText](https://www.planttext.com/)
|
|
|
|
3. Review the generated PUML and make all necessary adjustments to the diagram (add missing parts, fix mistakes, improve positioning).
|
|
_py2puml creates the diagram based on the type hints in the code, so missing or incorrect type hints may result in an incomplete or incorrect diagram._
|
|
|
|
4. Review the diff between the new and the previous diagram and manually check if the changes are correct.
|
|
_Make sure not to remove parts that were manually added to the diagram in the past and are still relevant._
|
|
|
|
5. Add the commit hash of the commit that was used to generate the diagram to the diagram footer.
|
|
|
|
6. Export the diagram as PNG and SVG files and replace the existing diagrams in the `docs/architecture` directory. This can be done with (e.g. [PlantText](https://www.planttext.com/))
|
|
|
|
</div>
|
|
</details>
|