Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dentsusoken/tw-subsidy
https://github.com/dentsusoken/tw-subsidy
Last synced: 15 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/dentsusoken/tw-subsidy
- Owner: dentsusoken
- Created: 2022-09-13T23:35:49.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-06-05T08:38:13.000Z (over 1 year ago)
- Last Synced: 2024-11-11T06:21:00.694Z (2 months ago)
- Language: TypeScript
- Size: 72.9 MB
- Stars: 0
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 補助金プロトタイプアプリ
## プロジェクト概要
中小法人・個人事業者向けの補助金・給付金申請において、本人確認と実在証明に必要となる証明書類を検証可能な形でデータ化し、関係者間で安全な方法でデータ共有することで、補助金・給付金の申請手続きを効率化するとともに、データの利活用が可能となる仕組みの提供を目指しています。
## プロトタイプシステムのデータフローと登場するエンティティ
データフロー：データの保有者である申請者は、証明者にVCの発行を依頼してVCを取得する。
申請者はローカルストレージ上にてVCを管理し、申請先の応募資格を確認した上で開示を行う。
プロトタイプシステムではVCをブラウザのローカルストレージに保持し、アクセスコントロールは行っていない。
（今後、ネットワーク越しにVCを管理する際には、送信者と受信者のみが見ることのできるアクセスコントロールを実装する予定。）
エンティティ1：公的支援（補助金・給付金等）を申請する中小法人・個人事業者（=申請者）
発行されたVCに対する所有権を持ち、ローカルストレージ上に自分に関する属性情報を保存し、
申請先の依頼に基づき、申請先に提示する。申請に必要な各種証明を取得するため、申請者から証明者にVC発行依頼をする。
エンティティ2：国、自治体、金融機関（=証明者）
申請者から申請依頼を受け取り、審査する。申請された内容が各証明者が保有している内容と相違がないことを確認する。
ブロックチェーン上にVC status管理スマートコントラクトを作成して、VCを発行する。
スマートコントラクトはVCの状態を保持しており、VCの取り消しはVCの状態を取り消し済みに変更することで行っている。
取り消しはメッセージではなく、状態の更新であり、状態を変更したログが残り続けるため、スマートコントラクトを利用している。
また、VCの発行者しか状態の更新をできないようにしている。
エンティティ3：補助金・給付金執行事務局等（=申請先）
申請者から申請情報を受け取り、審査する。補助金・給付金が、適切かつ迅速に申請者に届くようにする。
VPからVCを取得し、申請情報を審査する。そして審査結果についてシステムに登録する。
## プロトタイプシステムによる補助金・給付金申請手順
1. 申請者は、このシステムと申請者の氏名等の紐づけに使用する「住民票VC」を自治体に申請する。
2. 申請を受けた自治体は、申請された内容が正しいかどうかをシステム外で照会を行い、取り消し処理が可能な「住民票VC」を発行する。
3. 申請者は 紐づけされた「住民票VC」のデータを活用して、補助金申請に必要となる「口座実在証明書VC」と「納税証明書VC」の発行依頼を行う。
4. 申請を受けた金融機関は、申請された内容が正しいかどうかをシステム外で照会を行い、取り消し処理が可能な「口座実在証明VC」を発行する。
5. 申請を受けた税務署は、申請された内容が正しいかどうかをシステム外で照会を行い、取り消し処理が可能な「納税証明VC」を発行する。
6. ３種類のVCを申請者が保有している状態で、申請者は、補助金事務局に対して「補助金申請のVP」を提示する。
7. 補助金事務局はVCの検証を行い、申請を受理し「補助金申請受理VC」を発行する。
8. 証明者は「発行済みVC」の取り消しを行うことができる。
9. 補助金事務局は「補助金申請受理VC」を発行した後も、証明者がVCの取り消しを行った場合など、「補助金申請受理VC」を取り消しを行うことができる。
## 実行モジュールについて
ソースコードをデプロイして、クラウド上で動かすので、実行ファイル自体の個別提供はありません。
ソースコードは以下の構成です。
- /algo/firebase 要件定義書における申請者、証明者、申請先のWebアプリ
- /algo/asc1 要件定義書のrevokedInfo（VC取消）の実装におけるスマートコントラクトを定義。asc1で定義されたスマートコントラクトは、revokedInfoのアプリケーションインデックス(スマートコントラクトのID）を使って呼び出す。
## 動作環境
以下の環境で動作します。
ミドルウェア
- Node.js 18.x
- Next.js 12.x
- Python 3.10.x
## 環境構築手順
以下の手順で環境構築を行います。
1. [Visual Studio Codeのインストール](https://code.visualstudio.com/download)及びセットアップ
2. [Dockerのインストール](https://www.docker.com/products/docker-desktop/)
3. Gitアカウント作成
4. Gitのインストール（Windowsのみ）
5. [ソースコード](https://github.com/ISID/tw-subsidy)のダウンロード
6. ローカル環境でのアプリケーション起動
7. Firebaseプロジェクトの作成
8. Firebaseへのデプロイ
Firebaseへのデプロイ後、"Trusted Web Subsidy"のアプリケーション画面が表示されれば構築完了です。
詳細については、[環境構築手順書](https://github.com/ISID/tw-subsidy/blob/768e512b40a0358855a530593c8b23a83e6ecd51/doc/%E3%83%87%E3%83%A2%E7%92%B0%E5%A2%83%E6%A7%8B%E7%AF%89%E6%89%8B%E9%A0%86.docx?raw=true)を御覧ください。
## 注意事項
本アプリケーションは実証実験用のプロトタイプシステムです。
実運用上での利用は保障されていません。
実運用においては、性能およびセキュリティ等についても別途検討が必要です。