# sivakumarravi3101/server_table architecture

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

- Interactive diagram: https://gitdiagram.com/sivakumarravi3101/server_table
- Repository: https://github.com/sivakumarravi3101/server_table

## Overview

Server Table is a Flutter package for displaying large, backend-paged datasets. The main workflow is a user-configured table widget, backed by a controller and generic data source, requesting data through a backend-specific query builder and Dio client; response mapping turns API results into typed rows for display. Documented capabilities also include OData and REST serializers, configurable backend support, sorting, filtering, search, pagination, and customizable table states and builders. No source excerpts were provided, so relationships below are limited to those documented in the README.

Main entry points: [`lib/src/widgets/server_table_widget.dart`](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/widgets/server_table_widget.dart) (Server table), [`lib/src/core/datasource/server_data_source.dart`](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/datasource/server_data_source.dart) (Server data source), [`lib/src/core/controller/server_table_controller.dart`](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/controller/server_table_controller.dart) (Table controller), [`lib/src/core/query/query_builder.dart`](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/query/query_builder.dart) (Query builder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_table_ui["Table UI"]
  node_table_widget["Server table"]
  node_table_header["Table header<br/>[table_header.dart]"]
  node_table_body["Table body<br/>[table_body.dart]"]
  node_table_row["Table row<br/>[table_row.dart]"]
  node_toolbar["Table toolbar<br/>[table_toolbar.dart]"]
  node_search_field["Search field<br/>[search_field.dart]"]
  node_filter_row["Filter row"]
  node_filter_button["Filter button<br/>[filter_button.dart]"]
  node_filter_popup["Filter popup<br/>[filter_popup.dart]"]
  node_paginator["Table paginator"]
end

subgraph group_table_control["Table Control"]
  node_controller["Table controller"]
  node_controller_state["Controller state"]
  node_datasource["Server data source"]
  node_response_parser["Response parser"]
end

subgraph group_query_network["Queries and Network"]
  node_dio_client["Dio client<br/>[dio_client.dart]"]
  node_query_builder["Query builder<br/>[query_builder.dart]"]
  node_standard_query["REST query builder"]
  node_rest_serializer["REST serializer"]
  node_odata_builder["OData builder"]
end

subgraph group_data_contracts["Data Contracts"]
  node_query_options["Query options<br/>[query_options.dart]"]
  node_response_config["Response config"]
  node_capabilities["Backend capabilities"]
  node_server_column["Table columns<br/>[server_column.dart]"]
  node_page_result["Page result<br/>[page_result.dart]"]
end

node_user(("Table user"))
node_backend(("Backend API"))

node_user -->|"displays"| node_table_widget
node_table_widget -->|"uses controller"| node_controller
node_controller -->|"loads data"| node_datasource
node_datasource -->|"requests API"| node_dio_client
node_datasource -->|"builds query"| node_query_builder
node_query_builder -.->|"supports REST"| node_standard_query
node_query_builder -.->|"supports OData"| node_odata_builder
node_standard_query -->|"uses serializer"| node_rest_serializer
node_dio_client -->|"sends request"| node_backend
node_backend -.->|"returns response"| node_dio_client
node_datasource -->|"maps response"| node_response_parser
node_datasource -->|"uses mapping"| node_response_config
node_controller -.->|"configures query"| node_query_options
node_datasource -->|"checks capabilities"| node_capabilities
node_table_widget -->|"displays columns"| node_server_column
node_response_parser -.->|"maps page"| node_page_result
node_table_widget -.->|"renders"| node_table_header
node_table_widget -.->|"renders"| node_table_body
node_table_body -.->|"renders"| node_table_row
node_table_widget -.->|"renders"| node_toolbar
node_toolbar -.->|"includes search"| node_search_field
node_table_widget -.->|"supports filtering"| node_filter_row
node_filter_row -.->|"opens filter"| node_filter_button
node_filter_button -.->|"opens popup"| node_filter_popup
node_table_widget -.->|"supports pagination"| node_paginator
node_controller -.->|"manages state"| node_controller_state

click node_table_widget "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/widgets/server_table_widget.dart"
click node_table_header "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/widgets/table_header.dart"
click node_table_body "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/widgets/body/table_body.dart"
click node_table_row "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/widgets/body/table_row.dart"
click node_toolbar "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/widgets/toolbar/table_toolbar.dart"
click node_search_field "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/widgets/toolbar/search_field.dart"
click node_filter_row "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/widgets/table_filter_row.dart"
click node_filter_button "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/widgets/filter/filter_button.dart"
click node_filter_popup "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/widgets/filter/filter_popup.dart"
click node_paginator "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/widgets/pagination/table_paginator.dart"
click node_controller "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/controller/server_table_controller.dart"
click node_controller_state "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/controller/server_table_state.dart"
click node_datasource "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/datasource/server_data_source.dart"
click node_response_parser "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/adapters/data_response_parser.dart"
click node_dio_client "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/network/dio_client.dart"
click node_query_builder "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/query/query_builder.dart"
click node_standard_query "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/query/standard/standard_query_builder.dart"
click node_rest_serializer "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/query/standard/rest_query_serializer.dart"
click node_odata_builder "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/query/odata/odata_query_builder.dart"
click node_query_options "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/models/query_options.dart"
click node_response_config "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/models/response_config.dart"
click node_capabilities "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/models/backend_capabilities.dart"
click node_server_column "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/models/server_column.dart"
click node_page_result "https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/models/page_result.dart"

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_table_widget,node_table_header,node_table_body,node_table_row,node_toolbar,node_search_field,node_filter_row,node_filter_button,node_filter_popup,node_paginator,node_user toneBlue
class node_controller,node_controller_state,node_datasource,node_response_parser toneAmber
class node_dio_client,node_query_builder,node_standard_query,node_rest_serializer,node_odata_builder,node_backend toneMint
class node_query_options,node_response_config,node_capabilities,node_server_column,node_page_result toneRose
```

## Components

### Table UI

- [Server table](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/widgets/server_table_widget.dart): `lib/src/widgets/server_table_widget.dart`
- [Table header](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/widgets/table_header.dart): `lib/src/widgets/table_header.dart`
- [Table body](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/widgets/body/table_body.dart): `lib/src/widgets/body/table_body.dart`
- [Table row](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/widgets/body/table_row.dart): `lib/src/widgets/body/table_row.dart`
- [Table toolbar](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/widgets/toolbar/table_toolbar.dart): `lib/src/widgets/toolbar/table_toolbar.dart`
- [Search field](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/widgets/toolbar/search_field.dart): `lib/src/widgets/toolbar/search_field.dart`
- [Filter row](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/widgets/table_filter_row.dart): `lib/src/widgets/table_filter_row.dart`
- [Filter button](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/widgets/filter/filter_button.dart): `lib/src/widgets/filter/filter_button.dart`
- [Filter popup](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/widgets/filter/filter_popup.dart): `lib/src/widgets/filter/filter_popup.dart`
- [Table paginator](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/widgets/pagination/table_paginator.dart): `lib/src/widgets/pagination/table_paginator.dart`

### Table Control

- [Table controller](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/controller/server_table_controller.dart): `lib/src/core/controller/server_table_controller.dart`
- [Controller state](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/controller/server_table_state.dart): `lib/src/core/controller/server_table_state.dart`
- [Server data source](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/datasource/server_data_source.dart): `lib/src/core/datasource/server_data_source.dart`
- [Response parser](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/adapters/data_response_parser.dart): `lib/src/adapters/data_response_parser.dart`

### Queries and Network

- [Dio client](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/network/dio_client.dart): `lib/src/core/network/dio_client.dart`
- [Query builder](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/query/query_builder.dart): `lib/src/core/query/query_builder.dart`
- [REST query builder](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/query/standard/standard_query_builder.dart): `lib/src/core/query/standard/standard_query_builder.dart`
- [REST serializer](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/query/standard/rest_query_serializer.dart): `lib/src/core/query/standard/rest_query_serializer.dart`
- [OData builder](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/query/odata/odata_query_builder.dart): `lib/src/core/query/odata/odata_query_builder.dart`

### Data Contracts

- [Query options](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/models/query_options.dart): `lib/src/core/models/query_options.dart`
- [Response config](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/models/response_config.dart): `lib/src/core/models/response_config.dart`
- [Backend capabilities](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/models/backend_capabilities.dart): `lib/src/core/models/backend_capabilities.dart`
- [Table columns](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/models/server_column.dart): `lib/src/core/models/server_column.dart`
- [Page result](https://github.com/sivakumarravi3101/server_table/blob/main/lib/src/core/models/page_result.dart): `lib/src/core/models/page_result.dart`

### Other components

- **Table user**
- **Backend API**

## Connections

- Table user → Server table: displays (evidence: `README.md`)
- Server table → Table controller: uses controller (evidence: `README.md`)
- Table controller → Server data source: loads data (evidence: `README.md`)
- Server data source → Dio client: requests API (evidence: `README.md`)
- Server data source → Query builder: builds query (evidence: `README.md`)
- Query builder → REST query builder: supports REST
- Query builder → OData builder: supports OData
- REST query builder → REST serializer: uses serializer (evidence: `README.md`)
- Dio client → Backend API: sends request (evidence: `README.md`)
- Backend API → Dio client: returns response
- Server data source → Response parser: maps response (evidence: `README.md`)
- Server data source → Response config: uses mapping (evidence: `README.md`)
- Table controller → Query options: configures query
- Server data source → Backend capabilities: checks capabilities (evidence: `README.md`)
- Server table → Table columns: displays columns (evidence: `README.md`)
- Response parser → Page result: maps page
- Server table → Table header: renders
- Server table → Table body: renders
- Table body → Table row: renders
- Server table → Table toolbar: renders
- Table toolbar → Search field: includes search
- Server table → Filter row: supports filtering
- Filter row → Filter button: opens filter
- Filter button → Filter popup: opens popup
- Server table → Table paginator: supports pagination
- Table controller → Controller state: manages state
