getanthill/datastore

Datastore / ![MIT license]([] ![]([***]

![pipeline]([] ![Quality Gate Status]([] ![Coverage]([] ![Security Rating]([] ![Reliability Rating]([***]

FAQ - 功能 - 教程

目的

本项目旨在提供一个系统，轻松启用Event-Source系统的所有功能。该项目在实现此模式方面有强烈的立场，让您有机会开始使用事件溯源模型。

优势

⏱ 历史记录

使用Datastore处理的每个实体都遵循Event-Source模式，这意味着您可以自然地访问数据库中任何实体的完整历史记录。

json
[
  {
    "created_at": "2022-03-24T09:25:35.790Z",
    "type": "CREATED",
    "firstname": "Alice",
    "version": 0,
    "user_id": "623c390fb0f17a0c02c8d815"
  },
  {
    "created_at": "2022-03-29T05:29:11.348Z",
    "type": "UPDATED",
    "firstname": "Bernard",
    "version": 1,
    "user_id": "623c390fb0f17a0c02c8d815"
  }
]

🧾 契约化

从长期收益来看，使用Datastore的首要好处是您将编写的契约，用于精确定义数据。

json
{
  "additionalProperties": true,
  "properties": {
    "firstname": {
      "type": "string",
      "description": "用户的名字"
    }
  }
}

json
{
  "created_at": "2022-03-24T09:25:35.790Z",
  "firstname": "Alice",
  "updated_at": "2022-03-24T09:25:35.790Z",
  "version": 0,
  "user_id": "623c390fb0f17a0c02c8d815"
}

json
[
  {
    "_id": "623c390fb0f17a0c02c8d816",
    "created_at": "2022-03-24T09:25:35.790Z",
    "type": "CREATED",
    "v": "0_0_0",
    "firstname": "Alice",
    "version": 0,
    "user_id": "623c390fb0f17a0c02c8d815"
  }
]

🪙 标准化

由于Datastore选择了行业标准，如JSON Schema¹或OpenAPI 3.0²，您的模型可立即用于整个技术栈：

• 可从OpenAPI 3.0规范生成API客户端
• 事件通过JSON Schema完全契约化，可用于RabbitMQ ³、Redis ⁴或Kafka ⁵。

为什么时间旅行很重要？

如今，访问数据的完整历史非常重要。当然，您可能需要解决以下用例：

• 了解数据库中对象在特定日期的值
• 将数据库中的对象恢复到特定日期可用的特定版本
• 准确识别随时间的变化

迈向星辰的3个“小步骤”✨

安装Docker

[***]

部署MongoDB

shell
docker run --name mongo6 -p 27017:27017 mongo:6 mongodb

docker exec -it mongo6 mongo --eval 'rs.initiate({"_id":"rs","members":[{"_id":0,"host":"localhost:27017"}]})'

启动Datastore

shell
docker run -d --name datastore --network host -e FEATURE_API_ADMIN=true getanthill/datastore:latest

或

shell
git clone git@gitlab.com:getanthill/datastore.git
cd datastore
npm i
TELEMETRY_LOGGER_LEVEL=50 TELEMETRY_LOGGER_JSON=false FEATURE_API_ADMIN=true npm run dev