# ebana27/congo_libs architecture

> Architecture diagram of the GitHub repository ebana27/congo_libs, 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/ebana27/congo_libs
- Repository: https://github.com/ebana27/congo_libs

## Overview

Congolibs is a mobile educational-document library: learners browse or search resources, open a resource detail, then read or download its associated document; account screens support registration and profile use. The app uses a shared API client, while the Django backend exposes document and user functionality backed by persistent models. The README also describes administration and organization by category and study level, although corresponding implementation details are not established by the sampled source. Edges are limited to source-index references and documented architecture; the excerpts do not show the complete API routing or deployment configuration.

Main entry points: [`App/src/services/api/congolibsAPI.js`](https://github.com/ebana27/congo_libs/blob/main/App/src/services/api/congolibsAPI.js) (API client), [`App/src/constants/themes.js`](https://github.com/ebana27/congo_libs/blob/main/App/src/constants/themes.js) (Theme tokens), [`App/app/(tabs)/index.js`](https://github.com/ebana27/congo_libs/blob/main/App/app/(tabs)/index.js) (Home catalogue), [`App/app/search.js`](https://github.com/ebana27/congo_libs/blob/main/App/app/search.js) (Search resources)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile["Mobile experience"]
  node_home["Home catalogue<br/>[index.js]"]
  node_search["Search resources<br/>[search.js]"]
  node_discovery["Discovery<br/>[discovery.js]"]
  node_library["Library<br/>[library.js]"]
  node_resource_detail["Resource detail<br/>[&#91;id&#93;.js]"]
  node_reader["Document reader<br/>[reader.js]"]
  node_book_card["Resource cards<br/>[BookCard.js]"]
end

subgraph group_account["Accounts"]
  node_signup["Registration<br/>[signup.js]"]
  node_login["Sign in<br/>[login.js]"]
  node_profile["Profile<br/>[profil.js]"]
  node_profile_confirm["Profile confirmation<br/>[ConfirmModal.js]"]
end

subgraph group_backend["Backend services"]
  node_backend_docs["Document API<br/>[api.py]"]
  node_document_serializer["Document serialization<br/>[serializers.py]"]
  node_document_model[("Document records<br/>[models.py]")]
  node_user_views["User endpoints<br/>[views.py]"]
  node_user_serializer["User serialization<br/>[serializers.py]"]
  node_user_model[("User records<br/>[models.py]")]
  node_postgres[("PostgreSQL")]
end

subgraph group_shared["Shared app layers"]
  node_api_client["API client<br/>[congolibsAPI.js]"]
  node_error_modal["Error feedback<br/>[ErrorModal.js]"]
  node_success_modal["Success feedback<br/>[SuccessModal.js]"]
  node_themes["Theme tokens<br/>[themes.js]"]
  node_add_menu["Add and feedback menu<br/>[ArcAddMenu.js]"]
  node_onboarding_art["Onboarding illustrations"]
end

node_learner(("Learner"))

node_learner -->|"opens"| node_home
node_learner -->|"searches"| node_search
node_learner -->|"browses"| node_library
node_home -->|"requests resources"| node_api_client
node_search -->|"requests matches"| node_api_client
node_search -->|"renders results"| node_book_card
node_home -->|"renders resources"| node_book_card
node_learner -->|"opens resource"| node_resource_detail
node_resource_detail -->|"fetches and downloads"| node_api_client
node_learner -->|"reads document"| node_reader
node_learner -->|"creates account"| node_signup
node_signup -->|"registers"| node_api_client
node_login -->|"authenticates"| node_api_client
node_profile -->|"uses account API"| node_api_client
node_profile -->|"shows confirmation"| node_profile_confirm
node_signup -->|"shows errors"| node_error_modal
node_signup -->|"shows success"| node_success_modal
node_login -->|"shows errors"| node_error_modal
node_login -->|"shows success"| node_success_modal
node_api_client -.->|"calls API"| node_backend_docs
node_backend_docs -->|"serializes documents"| node_document_serializer
node_backend_docs -->|"uses document records"| node_document_model
node_user_views -->|"serializes users"| node_user_serializer
node_user_views -->|"uses user records"| node_user_model
node_document_serializer -->|"maps fields"| node_document_model
node_user_serializer -->|"maps fields"| node_user_model
node_document_model -.->|"persists to"| node_postgres
node_user_model -.->|"persists to"| node_postgres
node_home -->|"uses styles"| node_themes
node_search -->|"uses styles"| node_themes
node_book_card -->|"uses styles"| node_themes
node_resource_detail -->|"uses styles"| node_themes
node_add_menu -->|"uses styles"| node_themes
node_onboarding_art -->|"uses styles"| node_themes

click node_home "https://github.com/ebana27/congo_libs/blob/main/App/app/(tabs)/index.js"
click node_search "https://github.com/ebana27/congo_libs/blob/main/App/app/search.js"
click node_discovery "https://github.com/ebana27/congo_libs/blob/main/App/app/(tabs)/discovery.js"
click node_library "https://github.com/ebana27/congo_libs/blob/main/App/app/(tabs)/library.js"
click node_resource_detail "https://github.com/ebana27/congo_libs/blob/main/App/app/document/%5Bid%5D.js"
click node_reader "https://github.com/ebana27/congo_libs/blob/main/App/app/reader.js"
click node_book_card "https://github.com/ebana27/congo_libs/blob/main/App/src/components/books/BookCard.js"
click node_signup "https://github.com/ebana27/congo_libs/blob/main/App/app/auth/signup.js"
click node_login "https://github.com/ebana27/congo_libs/blob/main/App/app/auth/login.js"
click node_profile "https://github.com/ebana27/congo_libs/blob/main/App/app/(tabs)/profil.js"
click node_profile_confirm "https://github.com/ebana27/congo_libs/blob/main/App/src/components/profil/ConfirmModal.js"
click node_api_client "https://github.com/ebana27/congo_libs/blob/main/App/src/services/api/congolibsAPI.js"
click node_error_modal "https://github.com/ebana27/congo_libs/blob/main/App/src/components/shared/ErrorModal.js"
click node_success_modal "https://github.com/ebana27/congo_libs/blob/main/App/src/components/shared/SuccessModal.js"
click node_themes "https://github.com/ebana27/congo_libs/blob/main/App/src/constants/themes.js"
click node_add_menu "https://github.com/ebana27/congo_libs/blob/main/App/src/components/shared/ArcAddMenu.js"
click node_onboarding_art "https://github.com/ebana27/congo_libs/blob/main/App/src/components/onboarding/OnboardingIllustrations.js"
click node_backend_docs "https://github.com/ebana27/congo_libs/blob/main/Backend/apps/documents/api/api.py"
click node_document_serializer "https://github.com/ebana27/congo_libs/blob/main/Backend/apps/documents/api/serializers.py"
click node_document_model "https://github.com/ebana27/congo_libs/blob/main/Backend/apps/documents/models.py"
click node_user_views "https://github.com/ebana27/congo_libs/blob/main/Backend/apps/users/views.py"
click node_user_serializer "https://github.com/ebana27/congo_libs/blob/main/Backend/apps/users/api/serializers.py"
click node_user_model "https://github.com/ebana27/congo_libs/blob/main/Backend/apps/users/models.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_home,node_search,node_discovery,node_library,node_resource_detail,node_reader,node_book_card toneBlue
class node_signup,node_login,node_profile,node_profile_confirm toneAmber
class node_backend_docs,node_document_serializer,node_document_model,node_user_views,node_user_serializer,node_user_model,node_postgres toneMint
class node_api_client,node_error_modal,node_success_modal,node_themes,node_add_menu,node_onboarding_art toneRose
class node_learner toneIndigo
```

## Components

### Mobile experience

- [Home catalogue](https://github.com/ebana27/congo_libs/blob/main/App/app/(tabs)/index.js): `App/app/(tabs)/index.js`
- [Search resources](https://github.com/ebana27/congo_libs/blob/main/App/app/search.js): `App/app/search.js`
- [Discovery](https://github.com/ebana27/congo_libs/blob/main/App/app/(tabs)/discovery.js): `App/app/(tabs)/discovery.js`
- [Library](https://github.com/ebana27/congo_libs/blob/main/App/app/(tabs)/library.js): `App/app/(tabs)/library.js`
- [Resource detail](https://github.com/ebana27/congo_libs/blob/main/App/app/document/%5Bid%5D.js): `App/app/document/[id].js`
- [Document reader](https://github.com/ebana27/congo_libs/blob/main/App/app/reader.js): `App/app/reader.js`
- [Resource cards](https://github.com/ebana27/congo_libs/blob/main/App/src/components/books/BookCard.js): `App/src/components/books/BookCard.js`

### Accounts

- [Registration](https://github.com/ebana27/congo_libs/blob/main/App/app/auth/signup.js): `App/app/auth/signup.js`
- [Sign in](https://github.com/ebana27/congo_libs/blob/main/App/app/auth/login.js): `App/app/auth/login.js`
- [Profile](https://github.com/ebana27/congo_libs/blob/main/App/app/(tabs)/profil.js): `App/app/(tabs)/profil.js`
- [Profile confirmation](https://github.com/ebana27/congo_libs/blob/main/App/src/components/profil/ConfirmModal.js): `App/src/components/profil/ConfirmModal.js`

### Backend services

- [Document API](https://github.com/ebana27/congo_libs/blob/main/Backend/apps/documents/api/api.py): `Backend/apps/documents/api/api.py`
- [Document serialization](https://github.com/ebana27/congo_libs/blob/main/Backend/apps/documents/api/serializers.py): `Backend/apps/documents/api/serializers.py`
- [Document records](https://github.com/ebana27/congo_libs/blob/main/Backend/apps/documents/models.py): `Backend/apps/documents/models.py`
- [User endpoints](https://github.com/ebana27/congo_libs/blob/main/Backend/apps/users/views.py): `Backend/apps/users/views.py`
- [User serialization](https://github.com/ebana27/congo_libs/blob/main/Backend/apps/users/api/serializers.py): `Backend/apps/users/api/serializers.py`
- [User records](https://github.com/ebana27/congo_libs/blob/main/Backend/apps/users/models.py): `Backend/apps/users/models.py`
- **PostgreSQL**

### Shared app layers

- [API client](https://github.com/ebana27/congo_libs/blob/main/App/src/services/api/congolibsAPI.js): `App/src/services/api/congolibsAPI.js`
- [Error feedback](https://github.com/ebana27/congo_libs/blob/main/App/src/components/shared/ErrorModal.js): `App/src/components/shared/ErrorModal.js`
- [Success feedback](https://github.com/ebana27/congo_libs/blob/main/App/src/components/shared/SuccessModal.js): `App/src/components/shared/SuccessModal.js`
- [Theme tokens](https://github.com/ebana27/congo_libs/blob/main/App/src/constants/themes.js): `App/src/constants/themes.js`
- [Add and feedback menu](https://github.com/ebana27/congo_libs/blob/main/App/src/components/shared/ArcAddMenu.js): `App/src/components/shared/ArcAddMenu.js`
- [Onboarding illustrations](https://github.com/ebana27/congo_libs/blob/main/App/src/components/onboarding/OnboardingIllustrations.js): `App/src/components/onboarding/OnboardingIllustrations.js`

### Other components

- **Learner**

## Connections

- Learner → Home catalogue: opens (evidence: `README.md`)
- Learner → Search resources: searches (evidence: `README.md`)
- Learner → Library: browses (evidence: `README.md`)
- Home catalogue → API client: requests resources (evidence: `App/app/(tabs)/index.js`)
- Search resources → API client: requests matches (evidence: `App/app/search.js`)
- Search resources → Resource cards: renders results (evidence: `App/app/search.js`)
- Home catalogue → Resource cards: renders resources (evidence: `App/app/(tabs)/index.js`)
- Learner → Resource detail: opens resource (evidence: `README.md`)
- Resource detail → API client: fetches and downloads (evidence: `App/app/document/[id].js`)
- Learner → Document reader: reads document (evidence: `README.md`)
- Learner → Registration: creates account (evidence: `README.md`)
- Registration → API client: registers (evidence: `App/app/auth/signup.js`)
- Sign in → API client: authenticates (evidence: `App/app/auth/login.js`)
- Profile → API client: uses account API (evidence: `App/app/(tabs)/profil.js`)
- Profile → Profile confirmation: shows confirmation (evidence: `App/app/(tabs)/profil.js`)
- Registration → Error feedback: shows errors (evidence: `App/app/auth/signup.js`)
- Registration → Success feedback: shows success (evidence: `App/app/auth/signup.js`)
- Sign in → Error feedback: shows errors (evidence: `App/app/auth/login.js`)
- Sign in → Success feedback: shows success (evidence: `App/app/auth/login.js`)
- API client → Document API: calls API (evidence: `README.md`)
- Document API → Document serialization: serializes documents (evidence: `Backend/apps/documents/api/api.py`)
- Document API → Document records: uses document records (evidence: `Backend/apps/documents/api/api.py`)
- User endpoints → User serialization: serializes users (evidence: `Backend/apps/users/views.py`)
- User endpoints → User records: uses user records (evidence: `Backend/apps/users/views.py`)
- Document serialization → Document records: maps fields (evidence: `Backend/apps/documents/api/serializers.py`)
- User serialization → User records: maps fields (evidence: `Backend/apps/users/api/serializers.py`)
- Document records → PostgreSQL: persists to (evidence: `README.md`)
- User records → PostgreSQL: persists to (evidence: `README.md`)
- Home catalogue → Theme tokens: uses styles (evidence: `App/app/(tabs)/index.js`)
- Search resources → Theme tokens: uses styles (evidence: `App/app/search.js`)
- Resource cards → Theme tokens: uses styles (evidence: `App/src/components/books/BookCard.js`)
- Resource detail → Theme tokens: uses styles (evidence: `App/app/document/[id].js`)
- Add and feedback menu → Theme tokens: uses styles (evidence: `App/src/components/shared/ArcAddMenu.js`)
- Onboarding illustrations → Theme tokens: uses styles (evidence: `App/src/components/onboarding/OnboardingIllustrations.js`)
