Skip to content

docs

設計ドキュメントを管理する。

フォルダ階層

sh
docs
├── 01_画面      # Figma、画面アクション
├── 02_WebAPI   # openapi.yaml、API処理設計
├── 03_データ    # erd.a5er(ERD)、区分値
├── ...
└── README.md

設計書

コード体系

機能IDのコード体系は以下に従う。

種別種別備考
UIS通常画面UIS01、UIS02UI Standard から
UIMモーダル画面UIM01、UIM02UI Mordal から
APIWeb APIAPI01、API02
IFSシステムI/F 送信IFS01、IFS02InterFace Send から
IFRシステムI/F 受信IFR01、IFR02InterFace Receive から
BATバッチBAT01、BAT02BATch から
RPT帳票RPT01、RPT02RePorT から

コード体系について補足:

  • UISであれば、 UIS(0[1-9]{1}|[0-9]{2} といったフォーマットに従うこと
  • Future Muscle Partnerのプロダクト規模であれば、機能数が爆発しないという想定で2桁とする
    • 万が一あぶれた場合、16進数と見なしてA~Fを導入する拡張を行う

機能IDの採番について注意点:

  • 採番後の変更は許可しない
  • 連番とする(数字部分に新しい体系を作らない)

画面設計書の記載方針

  • Web API の応答項目が、画面項目のどこにマッピングすべきかという情報は、多くの業務画面で重要である
    • 理由は、類似名称の項目がWeb API応答項目にも画面項目多く、紐づけの認識の齟齬が生じやすいからである
  • future muscle partnerにおいては、項目数は多くなくFigmaを見れば自明であるため、画面項目定義を省略する