web-dev-qa-db-ja.com

デザインの要素をコードの対応する要素に近づけるワークフロードキュメントを作成する方法は何ですか?

CodeIgniterを使用してMVC形式で記述された中規模のPHP Webアプリを開始します。ほとんどの機能仕様が記述されており、改善されたものに確実に置き換えられる機能がいくつかあります。プロジェクトの後の段階での動作。

私は技術的な観点からワークフロードキュメントを作成する必要があります。ここで取り上げたいのは、理想的には次のとおりです。

  • ドキュメントは、ある種の図であることが望ましいです。
  • モデル/ビュー/コントローラー/ js関数/コード内の他の重要なブロックを使用したドキュメント内の要素の緊密なマッピング。これらのモジュールを呼び出しましょう

さまざまなモジュールを個別にテストし、さまざまなプログラマーにさまざまなモジュールを割り当てる方法をそこから導き出すことができるので、それで十分です。

コードの一部を置き換える必要があることがわかったときにドキュメントの一部を書き換えるという側面は問題ではありません。必要に応じて、コードと図の同期を維持するように書き直します。

これまでのペトリネットとUML相互作用図での私の試みは、コントローラー内の意思決定ロジックの多くを公開しなければならないことに気付いて失敗しました。

私はアドバイスを探しています、そして誰かが以前にこれをしたことがあるかどうか私は興味があります。

1
Valentin Brasso

質問の「要素」が何を意味するのかわかりませんが、答えを試みます。

悪いASCIIアートは次のとおりです:

--------------                                      -----------------
|  element   | -------- is created by ------------  |    module     |
--------------                                      -----------------

--------------                                      -----------------
|  element   | -------- is modified by -----------  |    module     |
--------------                                      -----------------

基本的に、要素作用を受けるモジュール。 1つの要素に複数のモジュールを関連付けることができます。

1