How fastboard-org/dashboards works
Project Type and Purpose
• This is a backend microservice written in Python for managing Fastboard dashboards.
• It’s a standalone service, built using poetry for dependency management and supports deployment via Docker. The microservice exposes a set of APIs (via routers) to interact with dashboards and related models.
Analyzing the File Structure
• The top-level file and configuration files (.env-example, Dockerfile, pyproject.toml) point to environment configuration, dependency management, CI/CD workflows (in .github), and deployment setups.
• The src directory is subdivided into several folders that hint at a layered architecture:
• configs: Contains configuration and settings, including database configurations.
• models: Defines the domain models (e.g., dashboard, connection, folder, query).
• routers: Contains API endpoint handlers that expose the microservice’s API. This is the presentation layer.
• services: Implements the business logic related to dashboards and connections.
• repositories: Acts as the data access layer, managing interactions with data sources or a database.
• lib: Contains utility libraries (like encryption functions) that offer common functionalities.
• The main entry point is src/main.py which bootstraps the application.