FOR_DEVELOPERS.md

開発者向け情報

1. 環境構築

以下のアプリケーション開発をおこなう環境へインストールします。

アプリケーション名	バージョン(指定がある場合のみ、記載する)	インストール条件
Node.js	14.16.0以上	必須
Visual Studio Code		Visual Studio Codeを利用する場合
yarn		本プログラムをyarnで実行する場合
docker compose		本プログラムをdocker composeで実行する場合
Vagrant		本プログラムをVagrantで実行する場合
Visual Studio Code + Remote Containers		Visual Studio Code + Remote Containersで開発する場合

1-1. Visual Studio Codeの拡張機能

Visual Studio Codeを利用する場合は、以下の拡張機能をインストールします。

拡張機能	インストール条件
ESLint	任意
Vetur	任意
TSLint	任意
Debugger for Chrome	任意
Remote Development	Visual Studio CodeでRemote Developmentを利用する場合

---

2. 実行

コマンドの実行は、WorkingCopyのルートディレクトリでおこないます。

2-1. yarn を使う場合

2-1-1. 依存関係を構築する

# install dependencies
$ yarn install

2-1-2. プログラムを実行する

以下のコマンドを実行した後、 http://localhost:3000 にアクセスすると、開発中のプログラムを確認する事ができます。

2-1-2-1. 通常

# serve with hot reload at localhost:3000
$ yarn dev

2-1-2-2. 軽量モード

開発用ローカルサーバが重い場合、以下のようにアクセシビリティチェック(vue-axe)を無効にして、起動できます。

# serve with hot reload at localhost:3000
$ yarn dev-no-axe

2-1-3. トラブルシュート

2-1-3-1. Cannot find module **** と怒られた時

再度、依存関係を構築し直し、プログラムを実行します。

2-2. docker compose を使う場合

2-2-1. 依存関係を構築し、プログラムを実行する

以下のコマンドを実行した後、 http://localhost:3000 にアクセスすると、開発中のプログラムを確認する事ができます。

# serve with hot reload at localhost:3000
$ docker-compose up --build

2-2-2. トラブルシュート

2-2-2-1. Cannot find module **** と怒られた時

プログラムを止め、以下のコマンドを実行します。

# serve with hot reload at localhost:3000
$ docker-compose run --rm app yarn install

2-3. Vagrant を使う場合

2-3-1. 依存関係を構築し、プログラムを実行する

以下のコマンドを実行した後、 http://localhost:3000 にアクセスすると、開発中のプログラムを確認する事ができます。

# serve with hot reload at localhost:3000
$ vagrant up

2-4. Visual Studio Code + Remote Containersで開発する場合

2-4-1. 依存関係を構築し、プログラムを実行する

Quick start: Try a dev containerの画像 (外部サイト)のように、左下部の「Open Folder in Container」でこのリポジトリのルートを選択すれば、環境構築が始まります。

環境を構築した後に http://localhost:3000 にアクセスすると、開発中のプログラムを確認する事ができます。

2-4-2. Topic

• 設定を変更したい場合は、devcontainer.json reference (外部サイト)を参照し、.devcontainer/devcontainer.jsonを変更してください。
• Remote Container実行時のみ有効な拡張機能「ESLint」を導入していますが、必要に応じて.devcontainer/devcontainer.jsonのextensionsに追加してください。 詳細な手順は、Managing extensions (外部サイト)を参照してください。
• 開発環境を再構築する場合は、左下部の「Rebuild Container」を実行してください。

---

3. 本番環境/その他の判定

process.env.GENERATE_ENV の値が、本番の場合は'production'に、それ以外の場合は 'development' になっています。 テスト環境のみで実行したい処理がある場合は、こちらの値をご利用ください。

---

4. 各数値の格納場所

(1) 最新のお知らせ

• 基本的な項目　→　data/news.jsonに記載。
• 最終更新　→　data/data.json中の"lastUpdate"に記載

{
    "newsItems": [
        {
            "date": "2021\/04\/30",
            "url": "https:\/\/www.city.shiroi.chiba.jp\/kenko\/covid19\/jokyo/8420.html",
            "text": "市内における感染者の発生について｜4月30日更新"
        },
        {
            "date": "2021\/04\/30",
            "url": "https:\/\/www.city.shiroi.chiba.jp\/kenko/covid19\/info\/8404.html",
            "text": "千葉県からのお願い【新型コロナ】"
        },
        {
            "date": "2021\/04\/30",
            "url": "https:\/\/www.city.shiroi.chiba.jp\/kenko/covid19\/jokyo/8421.html",
            "text": "市内小中学校の感染状況について｜4月30日更新"
        },
        
        {
            "date": "2021\/04\/27",
            "url": "https:\/\/www.city.shiroi.chiba.jp\/kenko\/covid19\/vaccine\/9121.html",
            "text": "ワクチン接種時に利用できるタクシー券を交付（要介護2以上・重度心身障がいの方向け）"
        },
        {
            "date": "2021\/04\/23",
            "url": "https:\/\/www.city.shiroi.chiba.jp\/kenko\/covid19\/jokyo\/8562.html",
            "text": "市職員の感染について｜4月23日更新"
        }
        
    ]
}

"lastUpdate": "2021\/05\/05 21:00",

(2) 検査陽性者の状況

• 各種人数・更新日　→　data/data.json中の"main_summary"に記載

"main_summary": {
        "children": [
            {
                "attr": "陽性患者数",
                "date": "2021\/4\/30 21:00",
                "value": 325,
                "children": [
                    {
                        "attr": "入院中",
                        "value": 2,
                        "children": [
                            {
                                "attr": "軽症・中等症",
                                "value": 0
                            },
                            {
                                "attr": "重症",
                                "value": 0
                            }
                        ]
                    },
                    {
                        "attr": "退院",
                        "value": 299
                    },
                    {
                        "attr": "死亡",
                        "value": 12
                    },
                    {
                        "attr": "宿泊療養",
                        "value": 7
                    },
                    {
                        "attr": "自宅療養",
                        "value": 5
                    },
                    {
                        "attr": "調査中",
                        "value": 0
                    }
                ]
            }
        ]
    }

(3) 報告日別による陽性者数の推移

• 日付と数字　→　data/data.json中の"patients_summary"に記載
• 最終更新日は"patients_summary"中の"date"に記載

"patients_summary": {
        "date": "2021\/05\/05 21:30",
        "data": [
            {	
                "日付": "2020-04-01T08:00:00.000Z",
                "小計": 0
            },	
            
            （略）

            {	
                "日付": "2021-05-04T08:00:00.000Z",
                "小計": 0
            },
            {	
                "日付": "2021-05-05T08:00:00.000Z",
                "小計": 1
            }
            
            
            
        ]
    },

(4) モニタリング項目（１）新規陽性者数

• 人数と7日間平均　→　data/daily_positive_detail.jsonに記載
• 最終更新日は"date"に記載する

{
    "date": "2021\/05\/05 21:30",
    "data": [
        {
            "diagnosed_date": "2020-04-01",
            "count": 0,
            "missing_count": null,
            "reported-count": null,
            "weekly_gain_ratio": null,
            "untracked_percent": null,
            "weekly_average_count": null,
            "weekly_average_untracked_count": null,
            "weekly_average_untracked_increse_percent": null
        },	
        
        （略）

        {
            "diagnosed_date": "2021-05-04",
            "count": 0,
            "missing_count": null,
            "reported-count": null,
            "weekly_gain_ratio": null,
            "untracked_percent": null,
            "weekly_average_count": 3.1,
            "weekly_average_untracked_count": null,
            "weekly_average_untracked_increse_percent": null
        },
        {
            "diagnosed_date": "2021-05-05",
            "count": 1,
            "missing_count": null,
            "reported-count": null,
            "weekly_gain_ratio": null,
            "untracked_percent": null,
            "weekly_average_count": 3.1,
            "weekly_average_untracked_count": null,
            "weekly_average_untracked_increse_percent": null
        }
        

    ]
}