# wwpdb/py-wwpdb_apps_ccmodule architecture

> Architecture diagram of the GitHub repository wwpdb/py-wwpdb_apps_ccmodule, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wwpdb/py-wwpdb_apps_ccmodule
- Repository: https://github.com/wwpdb/py-wwpdb_apps_ccmodule

## Overview

This repository provides the wwPDB Chemical Component and Chemical Component Lite applications. Users submit component or ligand requests through the web application, which dispatches assignment, search, sketch, or viewing operations and returns rendered results; assignment also manages component data and reports. Other documented-by-module capabilities include extraction, annotation, depiction, and database search. The graph captures relationships visible in excerpts or the SOURCE INDEX; unsampled modules are represented by their tree paths without inferred call links.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_webapp["Chemical Component web app"]
  node_liteapp["Lite web app"]
end

subgraph group_analysis["Assignment and analysis"]
  node_assign["Component assignment"]
  node_assigndepict["Assignment depiction"]
  node_assignlite["Lite assignment depiction"]
  node_pdbxassign["PDBx assignment"]
  node_annotate["Component annotation"]
  node_extract["Component extraction"]
  node_sketch["Component sketching"]
end

subgraph group_search["Search and views"]
  node_search["Component search"]
  node_searchdb["Database search"]
  node_searchdepict["Search results depiction"]
  node_view["Component viewing"]
  node_reports["Component reports"]
  node_images["Alignment images"]
  node_depict["HTML depiction helpers"]
end

subgraph group_data["Component data"]
  node_datastore["Assignment data store"]
  node_import["Component data import"]
  node_export["Component data export"]
  node_io["Component file I/O"]
  node_config["Application configuration"]
  node_state["Ligand analysis state"]
  node_exceptions["Domain exceptions"]
  node_dbsession["Database session"]
end

node_user(("Depositor or user"))

node_user -->|"submits requests"| node_webapp
node_webapp -->|"dispatches views"| node_view
node_webapp -->|"dispatches assignment"| node_assign
node_webapp -->|"dispatches depiction"| node_assigndepict
node_webapp -->|"dispatches search"| node_search
node_webapp -->|"dispatches database search"| node_searchdb
node_webapp -->|"renders search results"| node_searchdepict
node_webapp -->|"generates images"| node_images
node_webapp -->|"creates reports"| node_reports
node_webapp -->|"dispatches sketching"| node_sketch
node_webapp -->|"uses assignment data"| node_datastore
node_webapp -->|"imports component data"| node_import
node_webapp -->|"exports component data"| node_export
node_webapp -->|"uses file I/O"| node_io
node_liteapp -->|"dispatches assignment"| node_assign
node_liteapp -->|"renders assignment"| node_assignlite
node_liteapp -->|"uses assignment data"| node_datastore
node_liteapp -->|"exports data"| node_export
node_liteapp -->|"uses ligand state"| node_state
node_liteapp -->|"raises domain errors"| node_exceptions
node_assign -->|"uses PDBx assignment"| node_pdbxassign
node_assign -->|"imports input"| node_import
node_assign -->|"exports results"| node_export
node_assign -->|"uses component I/O"| node_io
node_assign -->|"stores assignment data"| node_datastore
node_assigndepict -->|"uses depiction"| node_depict
node_assigndepict -->|"uses assignment data"| node_datastore
node_assignlite -->|"uses depiction"| node_depict
node_assignlite -->|"uses assignment"| node_assign
node_assignlite -->|"uses assignment data"| node_datastore
node_searchdb -->|"opens database session"| node_dbsession
node_searchdepict -->|"uses depiction"| node_depict
node_view -->|"uses reports"| node_reports
node_view -->|"uses depiction"| node_depict
node_images -->|"supports reporting"| node_reports
node_sketch -->|"uses component I/O"| node_io
node_sketch -->|"reads configuration"| node_config
node_sketch -->|"uses component operations"| node_extract
node_state -->|"uses domain errors"| node_exceptions
node_webapp -.->|"offers annotation"| node_annotate
node_webapp -.->|"offers extraction"| node_extract

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_webapp,node_liteapp,node_user toneBlue
class node_assign,node_assigndepict,node_assignlite,node_pdbxassign,node_annotate,node_extract,node_sketch toneAmber
class node_search,node_searchdb,node_searchdepict,node_view,node_reports,node_images,node_depict toneMint
class node_datastore,node_import,node_export,node_io,node_config,node_state,node_exceptions,node_dbsession toneRose
```

## Components

### Web interface

- **Chemical Component web app**
- **Lite web app**

### Assignment and analysis

- **Component assignment**
- **Assignment depiction**
- **Lite assignment depiction**
- **PDBx assignment**
- **Component annotation**
- **Component extraction**
- **Component sketching**

### Search and views

- **Component search**
- **Database search**
- **Search results depiction**
- **Component viewing**
- **Component reports**
- **Alignment images**
- **HTML depiction helpers**

### Component data

- **Assignment data store**
- **Component data import**
- **Component data export**
- **Component file I/O**
- **Application configuration**
- **Ligand analysis state**
- **Domain exceptions**
- **Database session**

### Other components

- **Depositor or user**

## Connections

- Depositor or user → Chemical Component web app: submits requests (evidence: `README.md`)
- Chemical Component web app → Component viewing: dispatches views
- Chemical Component web app → Component assignment: dispatches assignment
- Chemical Component web app → Assignment depiction: dispatches depiction
- Chemical Component web app → Component search: dispatches search
- Chemical Component web app → Database search: dispatches database search
- Chemical Component web app → Search results depiction: renders search results
- Chemical Component web app → Alignment images: generates images
- Chemical Component web app → Component reports: creates reports
- Chemical Component web app → Component sketching: dispatches sketching
- Chemical Component web app → Assignment data store: uses assignment data
- Chemical Component web app → Component data import: imports component data
- Chemical Component web app → Component data export: exports component data
- Chemical Component web app → Component file I/O: uses file I/O
- Lite web app → Component assignment: dispatches assignment
- Lite web app → Lite assignment depiction: renders assignment
- Lite web app → Assignment data store: uses assignment data
- Lite web app → Component data export: exports data
- Lite web app → Ligand analysis state: uses ligand state
- Lite web app → Domain exceptions: raises domain errors
- Component assignment → PDBx assignment: uses PDBx assignment
- Component assignment → Component data import: imports input
- Component assignment → Component data export: exports results
- Component assignment → Component file I/O: uses component I/O
- Component assignment → Assignment data store: stores assignment data
- Assignment depiction → HTML depiction helpers: uses depiction
- Assignment depiction → Assignment data store: uses assignment data
- Lite assignment depiction → HTML depiction helpers: uses depiction
- Lite assignment depiction → Component assignment: uses assignment
- Lite assignment depiction → Assignment data store: uses assignment data
- Database search → Database session: opens database session
- Search results depiction → HTML depiction helpers: uses depiction
- Component viewing → Component reports: uses reports
- Component viewing → HTML depiction helpers: uses depiction
- Alignment images → Component reports: supports reporting
- Component sketching → Component file I/O: uses component I/O
- Component sketching → Application configuration: reads configuration
- Component sketching → Component extraction: uses component operations
- Ligand analysis state → Domain exceptions: uses domain errors
- Chemical Component web app → Component annotation: offers annotation
- Chemical Component web app → Component extraction: offers extraction
