italia/developers-italia-onboarding

Developers Italia Onboarding

!https://img.shields.io/circleci/project/github/italia/developers-italia-onboarding/master.svg?style=flat !https://img.shields.io/github/issues/italia/developers-italia-onboarding.svg !https://img.shields.io/github/license/italia/developers-italia-onboarding.svg?style=flat

通过onboarding应用，公共行政部门（PA）可以在https://innovazione.gov.it/it/progetti/developers-italia/%E9%97%A8%E6%88%B7%E4%B8%8A%E6%B3%A8%E5%86%8C%E5%85%B6%E4%BB%A3%E7%A0%81%E6%89%98%E7%AE%A1%E4%BB%93%E5%BA%93%E3%80%82%E8%BF%99%E6%A0%B7%E5%8F%AF%E4%BB%A5%E5%B0%86%E4%BB%93%E5%BA%93%E6%B7%BB%E5%8A%A0%E5%88%B0%E9%97%A8%E6%88%B7%E7%88%AC%E8%99%AB%E7%9A%84%E7%B4%A2%E5%BC%95%E5%88%97%E8%A1%A8%E4%B8%AD%EF%BC%8C%E7%88%AC%E8%99%AB%E4%BC%9A%E5%A1%AB%E5%85%85%E5%A4%8D%E7%94%A8%E7%9B%AE%E5%BD%95%E3%80%82

Developers Italia

有关Developers Italia项目的更多信息，请访问https://innovazione.gov.it/it/progetti/developers-italia/%E7%BD%91%E7%AB%99%E3%80%82

应用流程

• PA输入组织相关数据。使用“行政部门搜索”功能，系统会自动填充“iPA代码、行政部门和PEC”字段。

• 点击“注册”按钮后，应用会向表单中指定的行政部门***发送一封PEC邮件。

• 发送的邮件中包含确认注册的链接，点击链接后会重定向到确认页面。

• 在确认页面点击“注册”后，行政部门即被注册到系统中。

如流程所示，同一PA可以注册多个公共代码仓库的URL。

private文件夹与whitelist.db.json文件

应用使用名为private/data的本地文件夹，该文件夹必须包含：

• 用于生成注册时发送给PA的邮件令牌的私钥（软件运行后自动生成）

• 数据库文件whitelist.db.json，包含已注册PA的列表（应用首次启动时可为空）

出于安全考虑，该文件夹：

• 默认不提交到代码库。若要本地运行，需在克隆仓库后在根目录创建该文件夹

• 已添加到本仓库的.gitignore中

whitelist.db.json格式

如前所述，已注册的PA保存在本地JSON文件whitelist.db.json中。文件结构如下：

json
{
  "registrati": [
    {
      "referente": "pluto",
      "ipa": "c_a123",
      "url": "https://github.com/undefined",
      "pec": "protocollo.comunemaramao@pec.it"
    },
    {
      "referente": "pluto",
      "ipa": "c_a123",
      "url": "https://gitlab.com/undefined",
      "pec": "protocollo.comunemaramao@pec.it"
    }
  ]
}

示例文件可参考此处。

API - 已注册PA列表

调用返回已注册PA列表的API，使用URL http://localhost/repo-list。返回格式如下：

yaml
---

registrati: 
  - 
    timestamp: "2019-05-27T09:45:00.770Z"
    ipa: "c_a123"
    url: "https://github.com/undefined"
    pec: "protocollo.comunemaramao@pec.it"
  - 
    timestamp: "2019-05-28T09:45:00.770Z"
    ipa: "c_a123"
    url: "https://gitlab.com/undefined"
    pec: "protocollo.comunemaramao@pec.it"

支持的仓库

目前支持以下代码仓库：

• https://github.com

• https://bitbucket.org

• https://gitlab.com

• [***]

• https://gitea.io

• https://gogs.io

该列表会持续更新。

开发与调试环境

应用可在本地运行，既可直接在开发者机器上运行，也可通过Docker容器运行。无论使用哪种方式，都需先克隆仓库到本地文件夹。

复制.env.example文件为.env，根据需要修改环境变量。

直接在开发者机器运行（npm/yarn）

要直接在开发者机器上运行应用，需安装依赖。在克隆的文件夹中执行以下命令：

bash
npm install

在仓库根目录创建private/data文件夹，在其中创建空文件whitelist.db.json（或从[demo-data/whitelist.db.json]复制）。

然后可通过以下命令启动服务器：

bash
npm run dev

该命令通过nodemon在本地创建开发服务器（localhost），文件变更时自动重载，便于开发测试。现在可在浏览器中访问UI，地址为localhost:3000。

Docker

应用在生产环境中以Docker镜像形式分发和使用。为方便使用，除Dockerfile外，还提供docker-compose.yaml文件。

Docker Compose会将whitelist.db.json文件挂载到容器的private/data/目录。

创建并启动容器：

bash
docker-compose up [-d] [--build]

其中：

• -d：后台运行容器

• --build：强制构建容器

销毁容器：

bash
docker-compose down

许可证

本项目采用BSD 3-Clause License许可（SPDX代码：BSD-3-Clause）。更多信息请参见LICENSE文件。