System architecture
This chapter explains the system architecture so IT administrators can manage the system and troubleshoot problems more effectively. 丰盘ECM is built on Docker. If you are not familiar with Docker, read Why 丰盘 is built on Docker.
System components
丰盘 is built and deployed with Docker. After installation, run docker ps to list the running containers on the host. All containers are attached to the same virtual network and can reach each other, but nodes outside the host can reach only port 80, port 443 (if HTTPS is enabled), and port 5432 (PostgreSQL) on that network.

Info
To make containerization easier to understand, think of each Docker container as the running process of one component. The containers listed above are simply several processes of our software serving requests.
All 丰盘 containers use the xpan- prefix, and each has a specific role:
- xpan-gw: the external web traffic gateway, which presents a unified access address:
http[s]://IP[:port]/. - xpan-api: the backend API service, which provides most product logic.
- xpan-fe: the frontend HTML site, which provides the browser UI.
- xpan-db: the PostgreSQL database, which stores structured data (user-uploaded documents excluded).
- xpan-ota: the daemon, version check, and online upgrade component.
Data storage
All data files of the system are stored under /opt/xpan/. The subdirectories are organized as follows:
- bin: binary upgrade packages for some components
- data: database files, user-uploaded files, keys, and other sensitive data of the whole 丰盘 system.
- logs: log files of key components; see Troubleshooting.
- tools: the CLI tool package for managing 丰盘; see Linux server operations.
- setup: temporary files generated during installation and upgrades
The /opt/xpan/data/ directory contains three subdirectories:
- files: all documents uploaded by users
- pgdata: the PostgreSQL data directory, including user information, system permissions, and document metadata.
- secrets: important key files, including database passwords and certificates.
Warning
IT administrators should at least schedule regular backups of the /opt/xpan/data/ directory, so that 丰盘 data can be restored promptly if the host fails. Back up other directories as needed. See Backup.