feat: 設計ドキュメント追加

README.md

@@ -3,8 +3,13 @@
 このフローチャートは医学的見地やデータに基づいたものではなく、作者が育児を通じて経験則的に得られた知識、SNS上で寄せられたご意見などを参考に作られた簡易的なものです。
 異常を感じたら、近くの小児科や[小児救急電話相談](http://kodomo-qq.jp/index.php?pname=n8000#:~:text=%E5%B0%8F%E5%85%90%E7%A7%91%E5%8C%BB%E5%B8%AB%E3%83%BB%E7%9C%8B%E8%AD%B7%E5%B8%AB%E3%81%8B%E3%82%89,%E3%81%AB%E8%87%AA%E5%8B%95%E8%BB%A2%E9%80%81%E3%81%95%E3%82%8C%E3%81%BE%E3%81%99%E3%80%82)に連絡することを躊躇しないでください。
 
+[Design Doc](design.md)
+
 ![flowchart.png](flowchart.png)
 
+### 注意事項
+- 「全裸で泣き出した場合はオムツチェックできないがどうするのか」というご意見が複数回寄せられましたが、 こちらのフローはオムツと服を着せられている赤ちゃんを想定したものになっています。お風呂中に泣き出した場合等には使用できません、申し訳ありません。
+
 #### きっかけ
 [この投稿](https://twitter.com/akkie30/status/1773341405869400372)への反響が大きかったのでオープンソース化してみました。
 

design.md

@@ -1,3 +1,50 @@
+# 新生児ギャン泣きオンコール対応フローチャートのデザイン
+
+## はじめに
+3月中旬に育児を開始して以来、最も体力と時間を削られるのが「子供を泣き止ませる」ことでした。
+ギャン泣きは24時間いつ起きるか予想ができない上に、声が裏返るほどの大きさで目の前で悲壮な顔で泣かれると、寝不足も重なり（私のような育児に慣れていない親は特に）焦って冷静な対処ができなくなってしまいます。
+
+ただ、私には似たような体験を「オンコール対応」という仕事でしたことがあるなという記憶がありました。
+
+現在は育休中ですが、普段はシステムの開発・運用を行うエンジニアをしています。
+24時間稼働することが求められるシステムの運用においては、緊急対応が必要なインシデント（システム障害やセキュリティ問題)が発生した場合に即座に対応できるよう、対応者や対応方法をあらかじめ決めておく仕組みを「オンコール対応」と呼び、私も日々担当していました。
+
+システムに障害が起きると私のスマホは大音量で鳴り、PCを開くとSNS上でのお客さまからの反応やシステムエラーのログがリアルタイムに流れるのを見て焦ります。
+が、そこで障害の原因を冷静に1つずつ潰してなるべく早く障害を解決しようと試みます。
+同僚が「育児は24時間オンコールだ」と言っていたのを思い出しました。
+
+ギャン泣きは赤ちゃんにとって正常なことでシステム障害とは異なりますが、あらかじめ決められた対応方法があれば役立つ点は同じじゃないかな、と思ったのが作成のきっかけでした。
+Web上で「泣き止ませる方法」を調べると様々な情報が出てくるものの、方法を列挙しているだけのものが多く優先度が分からないし、いまいち自分が納得できるほどには整備されていなかったため、自分でフローチャート作ることを決意しました。
+
+チャートができてからは、「さて、次はげっぷ出すか…」「一度オムツチェックに戻るか…あ、またウンチ出てるじゃん…」と頭の中で作戦を練れるようになり、前よりも少しだけ冷静になれたような気がします。
+
+作ったものがどの家庭にも当てはまるものではなく、医学的見地、データに基づいたものでないことは重々承知ですが、このチャートのおかげで泣き止んだ赤ちゃんや笑ってくれた親が1人でも居ればいいなと思います。
+
+## ゴールとゴールでないこと
+TODO
+
+## 設計において考慮したこと
+
+### オムツ・授乳・抱っこは特別
+私の経験上、赤ちゃんを泣き止ませる上で「オムツ替え・授乳・抱っこ」が最も泣き止む確率の高い方法でした。感覚的にはこの3つで息子の70%の泣き止ませはカバーできます。
+こども家庭庁が提供している「[赤ちゃんが泣きやまない～泣きへの理解と対処のために～ DVDガイドブック](https://www.cfa.go.jp/assets/contents/node/basic_page/field_ref_resources/d6749ad9-a350-40b3-bca7-25a0ed06735a/7ec0729c/20230401_policies_jidougyakutai_nakiyamanai_02.pdf)」の中でもまずこの3つが対処として最初にあげられているところからも、これは一般的な感覚から大きく外れてはいないだろうと予想しています。
+
+そのため、ギャン泣き対応フローを作るときにこれら3つは特別視したいという思いがありました。
+つまり、これらの対応後は(泣き止む確率も高いため)フローの上位に持ってくると同時に、対処後は一度「泣き止んだ？」への分岐を設け、一呼吸おいて状態をチェックするフローにしたかった。
+
+現実的には、他の対応方法を行った後にも暗黙的に「泣き止んだ？」のチェックが入るのでしょうが、それらを忠実に記載してしまうと横長で可読性が低いフロー図になってしまう懸念がありあえてしませんでした。
+
+上記3つで解決しなかったときに、げっぷでも音楽でも輸送でもなんでもいい、それらがたとえベストな順番でなくてもいいので、考えられる対応をたたみかけることで泣き止ませる手段を冷静に取り続けたい。
+「どうしたらいいんだろう…」と途方にくれるのではなく、「あ、そういえばこういう方法もあったな」と半ば面白半分で対処を行ってもらえたらいいなと思っています。
+私もギャン泣き中の息子をダメ元のやけくそで抱っこしながらスクワットし、狂言の動画をYoutubeで流すと泣き止んだ経験があります。
+
+うちの息子に関して言うとおしゃぶりも上記3つと同程度のパワーを持っているのですが、一度癖になると抜けにくいなど賛否両論が多い対処でもあるので、特別視はやめています。
+
+### オムツのチェック頻度は高くてもいい
+フローを１回ししたあとオムツを再度チェックに行くのはオーバヘッドが大きい、というコメントもあれば、
+現場の声として「５分前に替えたはずのオムツにまたウンチがあった」という状況もよくある（から必要）というコメントもありました。
+おむつのお知らせマークやサイドギャザーの隙間からおむつ状態をチェックするには数秒しかかからないことに鑑みて、一旦フローは現在の状態（＝フローを１回まわすたびにおむつ状態をチェックする）を維持してみます。
+
 ### 病気の兆候
 [パンパース「赤ちゃんの病気の兆候](https://www.jp.pampers.com/newborn/care/article/signs-of-illness-in-babies)」を全面的に参考にしました。
 発熱や嘔吐、呼吸の異常だけでなく他にも様々な可能性があることは重々承知であるものの、それらを全て書き並べてしまうと可読性が失われるし、

flowchart.puml

@@ -7,8 +7,8 @@ start
 :泣く;
 
 repeat;
-  if (オムツ/服/寝具等が汚れている?) then (はい)
-    :オムツ/服/寝具等を替える;
+  if (オムツ/服/寝具が汚れている?) then (はい)
+    :オムツ/服/寝具を替える;
   else (いいえ)
     if (前回の授乳/ミルクから2時間以上経過している、\nもしくは舌を出す、\n乳房を探して首を振るなど空腹のサインが出ている?) then (はい)
       :授乳/ミルクを与える;
@@ -49,6 +49,7 @@ repeat;
         :手を握る;
         if (車を出せる?) then (はい)
           :ドライブする;
+        else (いいえ)
         endif
         :自分が深呼吸する;
         :300秒放置する;