質問をすることでしか得られない、回答やアドバイスがある。

15分調べてもわからないことは、質問しよう!

ただいまの
回答率

89.55%

効率的なシステムの保守、運用環境について

受付中

回答 1

投稿

  • 評価
  • クリップ 0
  • VIEW 149

koara_san

score 0

前提

社内SEで自社開発をしています。
各部署、業務ごとの運用に適したシステム(アプリ)が100個近くあり、
そのシステムの保守、改修、新規アプリ作成をしています。

アプリの状態
・アプリの規模は2人月~6人月くらいの小さいものがほとんど
・入力画面が数画面あって、各種情報をDBに登録するアプリ
・C#で開発
・ソースはSVNで管理
・ドキュメントはあったり、無かったり、古かったり
・利用者からの要望で改修することがある
・開発は利用者の意見を聞き、プロトタイプで利用してもらい
ながら開発をしている。アジャイルに近い。ウォーターフォールではない。

本来は、ドキュメントとソースを管理、維持してく必要がありますが、
アプリ数が多く、今の人員ではドキュメントの保守はできず、
改修案件がるたびに、ソースを追っています。

汎用的なシステムを購入し、統一することも検討しましたが、
それぞれのアプリの入力IF、DB構造が大きく異なるため、挫折しました。

現在、試みていること

維持できそうなドキュメント(運用フロー、テーブル定義、データフロー)に
絞り、維持し、全体の概要をドキュメントで把握し、後はソースを見ることで、
少しでも開発工数を削減することを試みています。

質問

具体的な質問で申し訳ありませんが、
ちょっとでも、保守しやすい環境を構築するための何か案、ヒントをご教授頂けると助かります。
ヒントになるような事項でも結構ですので、意見をもらえると助かります。

例)
この書籍を読んでみたら
こんなソフト(redmine、JIARなど)で管理してみたら
こんなドキュメントの自動化ソフトでも利用してみたら
こんな運用にしてみたら

  • 気になる質問をクリップする

    クリップした質問は、後からいつでもマイページで確認できます。

    またクリップした質問に回答があった際、通知やメールを受け取ることができます。

    クリップを取り消します

  • 良い質問の評価を上げる

    以下のような質問は評価を上げましょう

    • 質問内容が明確
    • 自分も答えを知りたい
    • 質問者以外のユーザにも役立つ

    評価が高い質問は、TOPページの「注目」タブのフィードに表示されやすくなります。

    質問の評価を上げたことを取り消します

  • 評価を下げられる数の上限に達しました

    評価を下げることができません

    • 1日5回まで評価を下げられます
    • 1日に1ユーザに対して2回まで評価を下げられます

    質問の評価を下げる

    teratailでは下記のような質問を「具体的に困っていることがない質問」、「サイトポリシーに違反する質問」と定義し、推奨していません。

    • プログラミングに関係のない質問
    • やってほしいことだけを記載した丸投げの質問
    • 問題・課題が含まれていない質問
    • 意図的に内容が抹消された質問
    • 過去に投稿した質問と同じ内容の質問
    • 広告と受け取られるような投稿

    評価が下がると、TOPページの「アクティブ」「注目」タブのフィードに表示されにくくなります。

    質問の評価を下げたことを取り消します

    この機能は開放されていません

    評価を下げる条件を満たしてません

    評価を下げる理由を選択してください

    詳細な説明はこちら

    上記に当てはまらず、質問内容が明確になっていない質問には「情報の追加・修正依頼」機能からコメントをしてください。

    質問の評価を下げる機能の利用条件

    この機能を利用するためには、以下の事項を行う必要があります。

回答 1

0

C#ならば、「XMLドキュメントコメント」を書いていますか?
ソースコードとドキュメントを一緒に書いた方が捗ると思います。

そして、ドキュメント化にはdoxygenオススメ。
doxygenの使い方を調べると、doxygen流のコメントの書き方がありますが、上記のXMLドキュメントコメントも認識してくれます。

投稿

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

15分調べてもわからないことは、teratailで質問しよう!

  • ただいまの回答率 89.55%
  • 質問をまとめることで、思考を整理して素早く解決
  • テンプレート機能で、簡単に質問をまとめられる