# manyfaces-coder/bads_platform architecture

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

- Interactive diagram: https://gitdiagram.com/manyfaces-coder/bads_platform
- Repository: https://github.com/manyfaces-coder/bads_platform

## Overview

Bads Platform is an API-first catalog for supplement information and published quality analyses. The visible workflow is a client request entering the FastAPI routes, using domain CRUD and database sessions, and returning validated API data. Category, manufacturer, and marketplace CRUD are shown; supplement endpoints and expertise, source, and offer data are present in the tree, but their full workflows were not sampled. The README documents PostgreSQL and SQLAlchemy; Redis is mentioned as a capability, but no runtime integration is evidenced in the supplied tree. Some relationships are therefore omitted.

Main entry points: [`app/core/models/base.py`](https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/models/base.py) (ORM foundation), [`app/core/db_helper.py`](https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/db_helper.py) (Session helper), [`app/api/v1/__init__.py`](https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/v1/__init__.py) (Versioned routes), [`app/api/v1/supplements.py`](https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/v1/supplements.py) (Supplement routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_app_entry["Application entry<br/>[main.py]"]
  node_api_router["API router<br/>[__init__.py]"]
  node_v1_router["Versioned routes<br/>[__init__.py]"]
end

subgraph group_catalog["Catalog operations"]
  node_category_routes["Category routes<br/>[views.py]"]
  node_manufacturer_routes["Manufacturer routes<br/>[views.py]"]
  node_marketplace_routes["Marketplace routes<br/>[views.py]"]
  node_category_crud["Category CRUD<br/>[crud.py]"]
  node_manufacturer_crud["Manufacturer CRUD<br/>[crud.py]"]
  node_marketplace_crud["Marketplace CRUD<br/>[crud.py]"]
  node_base_crud["Shared CRUD<br/>[base_crud.py]"]
end

subgraph group_domain["Supplement domain"]
  node_supplement_routes["Supplement routes<br/>[supplements.py]"]
  node_supplement_crud["Supplement CRUD<br/>[supplements.py]"]
  node_supplement_schema["Supplement schemas<br/>[supplement.py]"]
  node_expertise_model["Analysis expertise"]
  node_offer_model["Product offers"]
  node_source_model["Analysis sources<br/>[source.py]"]
  node_supplement_model["Supplement model<br/>[supplement.py]"]
  node_category_model["Category model<br/>[category.py]"]
  node_manufacturer_model["Manufacturer model<br/>[manufacturer.py]"]
  node_marketplace_model["Marketplace model<br/>[marketplace.py]"]
end

subgraph group_persistence["Persistence"]
  node_db_helper["Session helper<br/>[db_helper.py]"]
  node_orm_base["ORM foundation<br/>[base.py]"]
  node_settings["Runtime settings<br/>[config.py]"]
end

node_client(("API client"))
node_postgres[("PostgreSQL")]

node_client -->|"sends requests"| node_app_entry
node_app_entry -->|"includes routes"| node_api_router
node_api_router -->|"includes v1"| node_v1_router
node_v1_router -->|"registers routes"| node_category_routes
node_v1_router -->|"registers routes"| node_manufacturer_routes
node_v1_router -->|"registers routes"| node_marketplace_routes
node_category_routes -->|"calls"| node_category_crud
node_manufacturer_routes -->|"calls"| node_manufacturer_crud
node_marketplace_routes -->|"calls"| node_marketplace_crud
node_category_routes -->|"gets session"| node_db_helper
node_manufacturer_routes -->|"gets session"| node_db_helper
node_marketplace_routes -->|"gets session"| node_db_helper
node_category_crud -->|"uses helpers"| node_base_crud
node_manufacturer_crud -->|"uses helpers"| node_base_crud
node_marketplace_crud -->|"uses helpers"| node_base_crud
node_supplement_routes -->|"calls"| node_supplement_crud
node_supplement_routes -->|"gets session"| node_db_helper
node_supplement_routes -->|"uses schemas"| node_supplement_schema
node_supplement_crud -->|"uses schemas"| node_supplement_schema
node_supplement_crud -->|"queries model"| node_supplement_model
node_db_helper -->|"loads database config"| node_settings
node_app_entry -->|"uses sessions"| node_db_helper
node_db_helper -.->|"connects"| node_postgres
node_orm_base -->|"uses naming config"| node_settings
node_category_model -->|"inherits"| node_orm_base
node_manufacturer_model -->|"inherits"| node_orm_base
node_marketplace_model -->|"inherits"| node_orm_base
node_supplement_model -->|"inherits"| node_orm_base
node_expertise_model -->|"inherits"| node_orm_base
node_offer_model -->|"inherits"| node_orm_base
node_source_model -->|"inherits"| node_orm_base

click node_app_entry "https://github.com/manyfaces-coder/bads_platform/blob/main/app/main.py"
click node_api_router "https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/__init__.py"
click node_v1_router "https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/v1/__init__.py"
click node_category_routes "https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/v1/categories/views.py"
click node_manufacturer_routes "https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/v1/manufacturers/views.py"
click node_marketplace_routes "https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/v1/marketplaces/views.py"
click node_category_crud "https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/v1/categories/crud.py"
click node_manufacturer_crud "https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/v1/manufacturers/crud.py"
click node_marketplace_crud "https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/v1/marketplaces/crud.py"
click node_base_crud "https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/v1/base_crud.py"
click node_supplement_routes "https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/v1/supplements.py"
click node_supplement_crud "https://github.com/manyfaces-coder/bads_platform/blob/main/app/crud/supplements.py"
click node_supplement_schema "https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/schemas/supplement.py"
click node_expertise_model "https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/models/supplement_expertise.py"
click node_offer_model "https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/models/supplement_offer.py"
click node_source_model "https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/models/source.py"
click node_supplement_model "https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/models/supplement.py"
click node_category_model "https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/models/category.py"
click node_manufacturer_model "https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/models/manufacturer.py"
click node_marketplace_model "https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/models/marketplace.py"
click node_db_helper "https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/db_helper.py"
click node_orm_base "https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/models/base.py"
click node_settings "https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/config.py"

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_app_entry,node_api_router,node_v1_router,node_client toneBlue
class node_category_routes,node_manufacturer_routes,node_marketplace_routes,node_category_crud,node_manufacturer_crud,node_marketplace_crud,node_base_crud,node_postgres toneAmber
class node_supplement_routes,node_supplement_crud,node_supplement_schema,node_expertise_model,node_offer_model,node_source_model,node_supplement_model,node_category_model,node_manufacturer_model,node_marketplace_model toneMint
class node_db_helper,node_orm_base,node_settings toneRose
```

## Components

### REST API

- [Application entry](https://github.com/manyfaces-coder/bads_platform/blob/main/app/main.py): `app/main.py`
- [API router](https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/__init__.py): `app/api/__init__.py`
- [Versioned routes](https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/v1/__init__.py): `app/api/v1/__init__.py`

### Catalog operations

- [Category routes](https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/v1/categories/views.py): `app/api/v1/categories/views.py`
- [Manufacturer routes](https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/v1/manufacturers/views.py): `app/api/v1/manufacturers/views.py`
- [Marketplace routes](https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/v1/marketplaces/views.py): `app/api/v1/marketplaces/views.py`
- [Category CRUD](https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/v1/categories/crud.py): `app/api/v1/categories/crud.py`
- [Manufacturer CRUD](https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/v1/manufacturers/crud.py): `app/api/v1/manufacturers/crud.py`
- [Marketplace CRUD](https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/v1/marketplaces/crud.py): `app/api/v1/marketplaces/crud.py`
- [Shared CRUD](https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/v1/base_crud.py): `app/api/v1/base_crud.py`

### Supplement domain

- [Supplement routes](https://github.com/manyfaces-coder/bads_platform/blob/main/app/api/v1/supplements.py): `app/api/v1/supplements.py`
- [Supplement CRUD](https://github.com/manyfaces-coder/bads_platform/blob/main/app/crud/supplements.py): `app/crud/supplements.py`
- [Supplement schemas](https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/schemas/supplement.py): `app/core/schemas/supplement.py`
- [Analysis expertise](https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/models/supplement_expertise.py): `app/core/models/supplement_expertise.py`
- [Product offers](https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/models/supplement_offer.py): `app/core/models/supplement_offer.py`
- [Analysis sources](https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/models/source.py): `app/core/models/source.py`
- [Supplement model](https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/models/supplement.py): `app/core/models/supplement.py`
- [Category model](https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/models/category.py): `app/core/models/category.py`
- [Manufacturer model](https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/models/manufacturer.py): `app/core/models/manufacturer.py`
- [Marketplace model](https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/models/marketplace.py): `app/core/models/marketplace.py`

### Persistence

- [Session helper](https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/db_helper.py): `app/core/db_helper.py`
- [ORM foundation](https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/models/base.py): `app/core/models/base.py`
- [Runtime settings](https://github.com/manyfaces-coder/bads_platform/blob/main/app/core/config.py): `app/core/config.py`

### Other components

- **API client**
- **PostgreSQL**

## Connections

- API client → Application entry: sends requests (evidence: `README.md`)
- Application entry → API router: includes routes (evidence: `app/main.py`)
- API router → Versioned routes: includes v1 (evidence: `app/api/__init__.py`)
- Versioned routes → Category routes: registers routes (evidence: `app/api/v1/__init__.py`)
- Versioned routes → Manufacturer routes: registers routes (evidence: `app/api/v1/__init__.py`)
- Versioned routes → Marketplace routes: registers routes (evidence: `app/api/v1/__init__.py`)
- Category routes → Category CRUD: calls (evidence: `app/api/v1/categories/views.py`)
- Manufacturer routes → Manufacturer CRUD: calls (evidence: `app/api/v1/manufacturers/views.py`)
- Marketplace routes → Marketplace CRUD: calls (evidence: `app/api/v1/marketplaces/views.py`)
- Category routes → Session helper: gets session (evidence: `app/api/v1/categories/views.py`)
- Manufacturer routes → Session helper: gets session (evidence: `app/api/v1/manufacturers/views.py`)
- Marketplace routes → Session helper: gets session (evidence: `app/api/v1/marketplaces/views.py`)
- Category CRUD → Shared CRUD: uses helpers (evidence: `app/api/v1/categories/crud.py`)
- Manufacturer CRUD → Shared CRUD: uses helpers (evidence: `app/api/v1/manufacturers/crud.py`)
- Marketplace CRUD → Shared CRUD: uses helpers (evidence: `app/api/v1/marketplaces/crud.py`)
- Supplement routes → Supplement CRUD: calls (evidence: `app/api/v1/supplements.py`)
- Supplement routes → Session helper: gets session (evidence: `app/api/v1/supplements.py`)
- Supplement routes → Supplement schemas: uses schemas (evidence: `app/api/v1/supplements.py`)
- Supplement CRUD → Supplement schemas: uses schemas (evidence: `app/crud/supplements.py`)
- Supplement CRUD → Supplement model: queries model (evidence: `app/crud/supplements.py`)
- Session helper → Runtime settings: loads database config (evidence: `app/core/db_helper.py`)
- Application entry → Session helper: uses sessions (evidence: `app/main.py`)
- Session helper → PostgreSQL: connects (evidence: `README.md`)
- ORM foundation → Runtime settings: uses naming config (evidence: `app/core/models/base.py`)
- Category model → ORM foundation: inherits (evidence: `app/core/models/category.py`)
- Manufacturer model → ORM foundation: inherits (evidence: `app/core/models/manufacturer.py`)
- Marketplace model → ORM foundation: inherits (evidence: `app/core/models/marketplace.py`)
- Supplement model → ORM foundation: inherits (evidence: `app/core/models/supplement.py`)
- Analysis expertise → ORM foundation: inherits (evidence: `app/core/models/supplement_expertise.py`)
- Product offers → ORM foundation: inherits (evidence: `app/core/models/supplement_offer.py`)
- Analysis sources → ORM foundation: inherits (evidence: `app/core/models/source.py`)
