# lucassantss/coderise-server-02 architecture

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

- Interactive diagram: https://gitdiagram.com/lucassantss/coderise-server-02
- Repository: https://github.com/lucassantss/coderise-server-02

## Overview

CodeRise is an admin and user dashboard backed by an API for configuring and monitoring e-commerce, chatbot, logistics, synchronization, and webhook integrations. The main workflow is to configure a store or integration, receive or initiate catalog/order activity, process it through platform adapters, and inspect webhook or sync results in the dashboard. The graph follows documented router dispatches and indexed imports; unsampled subsystems are represented by their exact directories where their precise calls are not shown.

Main entry points: [`api/index.js`](https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/index.js) (API router), [`api/_lib/webhook-receiver.js`](https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/_lib/webhook-receiver.js) (Webhook processing), [`api/_lib/ecommerce`](https://github.com/lucassantss/coderise-server-02/tree/LucasSantss/api/_lib/ecommerce) (E-commerce adapters), [`api/_lib/db.js`](https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/_lib/db.js) (Application database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Dashboard UI"]
  node_dashboard["Dashboard pages"]
  node_admin["Admin pages"]
  node_app["Route application<br/>[App.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
  node_auth_state["Auth state<br/>[auth.ts]"]
end

subgraph group_api["API and Accounts"]
  node_api_router["API router<br/>[index.js]"]
  node_auth["Authentication<br/>[auth.js]"]
  node_users["User management<br/>[users.js]"]
  node_integrations_api["Integration settings<br/>[integrations.js]"]
  node_webhook_config["Webhook registration"]
end

subgraph group_sync["Commerce and Events"]
  node_sync_catalog["Catalog synchronization<br/>[sync-catalog.js]"]
  node_catalog_poll["Catalog polling<br/>[poll-catalog.js]"]
  node_webhook_receiver["Webhook processing"]
  node_sync_rules["Sync rules<br/>[sync-rules.js]"]
end

subgraph group_integrations["External Integrations"]
  node_ecommerce_adapters["E-commerce adapters"]
  node_suri["Suri chatbot"]
  node_logistics["Logistics quoting<br/>[logistics-quote.js]"]
end

subgraph group_state["Persistence and Alerts"]
  node_db[("Application database<br/>[db.js]")]
  node_error_alerts["Integration error alerts<br/>[error-webhook.js]"]
end

node_operator(("Dashboard user"))
node_external_stores{{"Commerce platforms"}}
node_external_suri{{"Suri service"}}
node_carrier{{"Correios carrier"}}

node_operator -.->|"uses"| node_app
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_admin
node_dashboard -.->|"requests data"| node_api_client
node_admin -->|"requests data"| node_api_client
node_api_client -->|"reads credentials"| node_auth_state
node_api_router -->|"dispatches"| node_auth
node_api_router -->|"dispatches"| node_users
node_api_router -->|"dispatches"| node_integrations_api
node_api_router -->|"dispatches"| node_webhook_receiver
node_api_router -->|"dispatches"| node_webhook_config
node_api_router -->|"dispatches"| node_sync_catalog
node_api_router -->|"dispatches"| node_sync_rules
node_webhook_receiver -->|"records events"| node_db
node_webhook_receiver -->|"reports failures"| node_error_alerts
node_webhook_receiver -->|"processes Suri events"| node_suri
node_webhook_receiver -->|"processes store events"| node_ecommerce_adapters
node_sync_catalog -->|"reads configuration"| node_db
node_sync_catalog -->|"syncs catalog"| node_ecommerce_adapters
node_catalog_poll -.->|"polls catalog"| node_ecommerce_adapters
node_webhook_config -->|"stores registrations"| node_db
node_error_alerts -->|"stores alerts"| node_db
node_error_alerts -.->|"notifies service"| node_external_suri
node_ecommerce_adapters -.->|"calls APIs"| node_external_stores
node_suri -.->|"calls API"| node_external_suri
node_logistics -.->|"requests quotes"| node_carrier

click node_dashboard "https://github.com/lucassantss/coderise-server-02/tree/LucasSantss/src/pages/dashboard"
click node_admin "https://github.com/lucassantss/coderise-server-02/tree/LucasSantss/src/pages/admin"
click node_app "https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/src/App.tsx"
click node_api_client "https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/src/services/api.ts"
click node_auth_state "https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/src/store/auth.ts"
click node_api_router "https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/index.js"
click node_auth "https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/_lib/auth.js"
click node_users "https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/users.js"
click node_integrations_api "https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/integrations.js"
click node_webhook_config "https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/_lib/register-webhook.js"
click node_sync_catalog "https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/_lib/sync-catalog.js"
click node_catalog_poll "https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/_lib/poll-catalog.js"
click node_webhook_receiver "https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/_lib/webhook-receiver.js"
click node_sync_rules "https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/sync-rules.js"
click node_ecommerce_adapters "https://github.com/lucassantss/coderise-server-02/tree/LucasSantss/api/_lib/ecommerce"
click node_suri "https://github.com/lucassantss/coderise-server-02/tree/LucasSantss/api/_lib/chatbot/suri"
click node_logistics "https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/_lib/logistics-quote.js"
click node_db "https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/_lib/db.js"
click node_error_alerts "https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/_lib/error-webhook.js"

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_dashboard,node_admin,node_app,node_api_client,node_auth_state,node_operator toneBlue
class node_api_router,node_auth,node_users,node_integrations_api,node_webhook_config toneAmber
class node_sync_catalog,node_catalog_poll,node_webhook_receiver,node_sync_rules toneMint
class node_ecommerce_adapters,node_suri,node_logistics toneRose
class node_db,node_error_alerts,node_external_stores,node_external_suri,node_carrier toneIndigo
```

## Components

### Dashboard UI

- [Dashboard pages](https://github.com/lucassantss/coderise-server-02/tree/LucasSantss/src/pages/dashboard): `src/pages/dashboard`
- [Admin pages](https://github.com/lucassantss/coderise-server-02/tree/LucasSantss/src/pages/admin): `src/pages/admin`
- [Route application](https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/src/App.tsx): `src/App.tsx`
- [API client](https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/src/services/api.ts): `src/services/api.ts`
- [Auth state](https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/src/store/auth.ts): `src/store/auth.ts`

### API and Accounts

- [API router](https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/index.js): `api/index.js`
- [Authentication](https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/_lib/auth.js): `api/_lib/auth.js`
- [User management](https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/users.js): `api/users.js`
- [Integration settings](https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/integrations.js): `api/integrations.js`
- [Webhook registration](https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/_lib/register-webhook.js): `api/_lib/register-webhook.js`

### Commerce and Events

- [Catalog synchronization](https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/_lib/sync-catalog.js): `api/_lib/sync-catalog.js`
- [Catalog polling](https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/_lib/poll-catalog.js): `api/_lib/poll-catalog.js`
- [Webhook processing](https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/_lib/webhook-receiver.js): `api/_lib/webhook-receiver.js`
- [Sync rules](https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/sync-rules.js): `api/sync-rules.js`

### External Integrations

- [E-commerce adapters](https://github.com/lucassantss/coderise-server-02/tree/LucasSantss/api/_lib/ecommerce): `api/_lib/ecommerce`
- [Suri chatbot](https://github.com/lucassantss/coderise-server-02/tree/LucasSantss/api/_lib/chatbot/suri): `api/_lib/chatbot/suri`
- [Logistics quoting](https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/_lib/logistics-quote.js): `api/_lib/logistics-quote.js`

### Persistence and Alerts

- [Application database](https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/_lib/db.js): `api/_lib/db.js`
- [Integration error alerts](https://github.com/lucassantss/coderise-server-02/blob/LucasSantss/api/_lib/error-webhook.js): `api/_lib/error-webhook.js`

### Other components

- **Dashboard user**
- **Commerce platforms**
- **Suri service**
- **Correios carrier**

## Connections

- Dashboard user → Route application: uses
- Route application → Dashboard pages: routes to (evidence: `src/App.tsx`)
- Route application → Admin pages: routes to (evidence: `src/App.tsx`)
- Dashboard pages → API client: requests data (evidence: `src/pages/dashboard/Webhooks.tsx`)
- Admin pages → API client: requests data (evidence: `src/pages/admin/Clients.tsx`)
- API client → Auth state: reads credentials (evidence: `src/services/api.ts`)
- API router → Authentication: dispatches (evidence: `api/index.js`)
- API router → User management: dispatches (evidence: `api/index.js`)
- API router → Integration settings: dispatches (evidence: `api/index.js`)
- API router → Webhook processing: dispatches (evidence: `api/index.js`)
- API router → Webhook registration: dispatches (evidence: `api/index.js`)
- API router → Catalog synchronization: dispatches (evidence: `api/index.js`)
- API router → Sync rules: dispatches (evidence: `api/index.js`)
- Webhook processing → Application database: records events (evidence: `api/_lib/webhook-receiver.js`)
- Webhook processing → Integration error alerts: reports failures (evidence: `api/_lib/webhook-receiver.js`)
- Webhook processing → Suri chatbot: processes Suri events (evidence: `api/_lib/webhook-receiver.js`)
- Webhook processing → E-commerce adapters: processes store events (evidence: `api/_lib/webhook-receiver.js`)
- Catalog synchronization → Application database: reads configuration (evidence: `api/_lib/sync-catalog.js`)
- Catalog synchronization → E-commerce adapters: syncs catalog (evidence: `api/_lib/sync-catalog.js`)
- Catalog polling → E-commerce adapters: polls catalog
- Webhook registration → Application database: stores registrations (evidence: `api/_lib/register-webhook.js`)
- Integration error alerts → Application database: stores alerts (evidence: `api/_lib/error-webhook.js`)
- Integration error alerts → Suri service: notifies service
- E-commerce adapters → Commerce platforms: calls APIs
- Suri chatbot → Suri service: calls API
- Logistics quoting → Correios carrier: requests quotes
