# DOC

## Table of content

<!-- toc -->

## Theme

```js
localStorage.setItem('dbm_is_dark_theme', 'true');
```

## Database connections

| key | owner  | token | repo           | modes       |
| --- | ------ | ----- | -------------- | ----------- |
| 1   | db-man | ...   | db             |             |
| 2   | db-man | ...   | split-table-db | split-table |

When a database is set `split-table`, when update a table record, will only update the table record file, not the whole table file.

## Database structure

- dbs.json - @db-man/cli will use this file to find which dir contains db files (Only need this file in split-table mode)
- dbs/iam/dbcfg.json All tables in this database, and all columns in each table
- dbs/iam/users.data.json Table data file
- dbs/iam/users/\*.json Table record files. These files are split from `users.data.json` file. (Only in `split-table` mode)

## Table definition

Table is defined in `dbcfg.json` file.

See `src/types/DbTable.ts`

An example:

```json
{
  "name": "users",
  "columns": [
    { "id": "userId", "name": "User ID", "primary": true },
    { "id": "name", "name": "Name" },
    { "id": "age", "name": "Age", "type": "NUMBER" },
    { "id": "active", "name": "Active", "type": "BOOL" },
    { "id": "tags", "name": "Tags", "type": "STRING_ARRAY" },
    {
      "id": "notes",
      "name": "Notes",
      "type": "STRING",
      "type:createUpdatePage": "TextArea"
    }
  ],
  "large": true
}
```

## Column definition

See `src/types/DbColumn.ts`

An example:

```json
{
  "id": "userId",
  "name": "User ID",
  "type": "string",
  "primary": true
}
```

### `id` (Required)

### `name` (Required)

### `type` (Required)

See `src/types/DbColumn.ts::DbColumnType`

### `primary`

See `src/types/DbColumn.ts`

### `ui:listPage:isFilter`

TODO add description here

### `ui:createUpdatePage:placeholder`

See `src/types/DbColumn.ts::ColumnPlaceholder`

### `ui:createUpdatePage:enum`

See `src/types/DbColumn.ts::RadioGroupUiTypeEnum`

### `ui:presets`

See `src/types/DbColumn.ts::Column`

### `tableProps`

TODO add description here

### `referenceTable`

TODO add description here

### `ui:listPage:isImageViewKey`

TODO add description here

### `type:listPage`

See `src/types/DbColumn.ts::DbColumnExtendsUiType`

### `ui:listPage:randomView`

On the List Page, Random View, choose the UI component to use for one of the list item.

Below is an example of using `ImageLink` component. The string after "ImageLink" is a template (Handlebars).
It will transform the `record` which passing from antd `Table` component, into a props object like `{url:'',imgSrc:''}`.
This props will pass to `ImageLink` component.

```json
{
  "id": "product_id",
  "ui:listPage:randomView": [
    [
      "ImageLink",
      "{\"url\":\"{{record.photos.[0]}}\",\"imgSrc\":\"{{record.photos.[0]}}\"}"
    ]
  ]
}
```

## Migrate to split-table mode

### The repo structure for split-table mode

- .github/workflows/merge.yml - https://github.com/db-man/split-table-db/blob/main/.github/workflows/merge.yml
- .github/workflows/split.yml - https://github.com/db-man/split-table-db/blob/main/.github/workflows/split.yml
- merge.mjs - https://github.com/db-man/split-table-db/blob/main/merge.mjs
- split.mjs - https://github.com/db-man/split-table-db/blob/main/split.mjs
- cli/utils.mjs - https://github.com/db-man/split-table-db/blob/main/cli/utils.mjs

### Need to check

- Primary key value not too long.
  - For example, if the primary key is `user_id`, one of the record is `user_id=1234567890...1234567890`, and value is more than 255 bytes, then the pipeline will fail because on CI the OS is Linux, and the max file name length is 255 bytes. And also when you git pull on macOS, it will fail because the file name is too long.

## Database examples

- [https://github.com/db-man/db](https://github.com/db-man/db)
- [https://github.com/db-man/split-table-db](https://github.com/db-man/split-table-db)

## Glossary

```json
{
  "id": "product_id",
  "type:listPage": [
    "ImageLink",
    "{\"url\":\"https://brickset.com/{{record.product_id}}-1\",\"imgSrc\":\"https://img.brickset.com/{{record.product_id}}-1.jpg\"}"
  ]
}
```

- `"type:listPage"` - render key
- `["ImageLink","{\"url\":\"http://a.com/{{record.id}}\",\"imgSrc\":\"http://b.com/{{record.name}}.jpg\"}"]` - render expression
  - `ImageLink` - render expression built-in function name
  - `"{\"url\":\"http://a.com/{{record.id}}\",\"imgSrc\":\"http://b.com/{{record.name}}.jpg\"}"]` - render expression function template
