docs: READMEを追加

stepfunctions/README.md

@@ -0,0 +1,57 @@
+# AWS StepFunctions
+
+## 概要
+
+- MeDaCa基板上でバッチ処理を行うStepFunctionsステートマシン定義を格納する
+- ステートマシン定義を格納する際のフォルダ構成は以下とする
+  - `ステートマシン名/ステートマシン名.json`
+- Git管理するファイルは雛形とし、実際の環境にデプロイする定義は`/TOOLS`フォルダ内のツールで生成したものを使用する
+- ステートマシン定義の雛形内の環境固有の値は`#{値を表すキー名}`の形式で記述すること
+
+## バージョン情報
+
+- Python3.9.x
+
+## フォルダ構成
+
+```text
+.
+├── TOOLS                            -- 環境ごとのステートマシン定義生成ツール置き場
+│   ├── convert.conf.yaml            -- ステートマシンの変換定義ファイル
+│   ├── convert_definition.py        -- 定義変換ツールの本体
+└── r-crm-datafetch-state            -- CRMデータ取得処理のステートマシン定義置き場
+    ├── build                        -- 【Git管理対象外】TOOLSによって生成され、環境名のフォルダに、環境ごとの値に置き換えたステートマシン定義を配置する
+    │   ├── product
+    │   └── staging
+    └── r-crm-datafetch-state.json   -- CRMデータ取得処理のステートマシン定義
+```
+
+## ツールの利用方法
+
+### 事前準備
+
+- `/TOOLS`フォルダに移動し、以下のコマンドを実行して、Pythonの仮想環境を作成する
+
+```sh
+cd ./TOOLS
+# 仮想環境を作成
+python -m venv ./.venv
+# 仮想環境を有効化
+# Mac/Linuxの場合
+source ./.venv/bin/activate
+# Windowsの場合
+.\.venv\Scripts\activate
+```
+
+- 以下のコマンドを実行し、YAMLのパッケージをインストールする
+
+```sh
+pip install PyYAML
+```
+
+### 起動方法
+
+```sh
+cd ./TOOLS
+python convert_definition.py r-crm-datafetch-state staging
+```