
帳票あるある①ー帳票で案件が止まった話
導入
SI の現場でよく起きる話として、要件定義の山を越えて、画面の試作も動き始めて、もうすぐ結合テスト、というフェーズで、案件が止まることがあります。
止まる原因の上位に、繰り返し帳票が入ってくるように見えます。
同じ場所で詰まり続けるのはなぜだろう、という問いを持ち続けていて、今日はそのパターンを書き残しておきたくなりました。
「帳票はあとで」が積み残される
SI の現場でよく聞くパターンとして、設計レビューの場でこういうやりとりが起きることがあります。
「帳票はあとで詰めましょう。とりあえず仕様書には『出力可能』とだけ入れておいてください」
誰も止めません。優先順位として画面と業務ロジックが先、という空気は理解できます。
ところが、その「あとで」が来るのは、結合テストの直前になることが多いようです。
「この帳票、どこで作るんですか?」
実装フェーズに入ってから、こういう声が上がることがあります。
「この帳票、どこで作るんですか? 設計書には『出力可能』としか書いてないんですけど」
このとき、設計者と実装者の間で「帳票」という言葉の中身が違っていた、ということに気づきます。
設計者の頭の中では、画面の検索結果を CSV か PDF で落とせれば「出力可能」でした。一方、業務側のお客様の頭の中では、帳票は A4 縦の決まった様式で、社判の枠があり、明細行の罫線が二重線になっていて、合計欄は右下にゼロ埋めで揃っているもの、でした。
同じ「帳票を出力する」という一行が、見ている人によってまるで違うものを指している、ということが起きがちです。
この温度差は、構造としてよく起きるように見える
これは特定の現場の話ではなくて、似た場面に何度か出会っている気がしています。
背景を書き出してみると、こんな構造になっているように見えます。
業務システムの設計書に出てくる「帳票」は、機能一覧の一行で表現されることが多い
その一行は、画面側の人にとっては「ボタンを押したら何かが出る」程度の解像度になりがち
一方、お客様側にとっての帳票は、紙の上の位置・線の太さ・フォント・余白まで含めた成果物
その差を埋める担当が、設計書のフェーズでは決まっていないことがよくある
つまり、帳票という言葉だけが先に決まって、中身を誰が握るかが宙に浮いたまま実装フェーズに入ってしまう、という構造のように見えます。
客先で帳票を見せた瞬間、1 ヶ月戻る
そして、これも一度や二度ではなく観測している場面があります。
客先で初めて帳票のサンプルをお見せした瞬間、業務担当の方の表情が静かに変わって、こう言われます。
「あ、これ、うちの様式と違うんですね」
その一言で、おおむね 1 ヶ月分の手戻りが確定する感覚があります。様式の調整、印刷余白の調整、項目の並び替え、押印欄の配置、フォントの指定、印影の位置、続けて第 2 様式のサンプル提出、という流れに乗ります。
多くの場合、この時点で工数バッファは尽きていることが多いように見えます。
「印刷ロジックを業務系コードに直書きしたくない」という小さい声
もうひとつ、横で観察していて気になるのは、実装側の方が小さい声で言うことがあるセリフです。
「印刷の処理、業務ロジックと同じところに書きたくないんですよね」
気持ちは分かる気がします。明細の取得や金額の集計を担当しているクラスの中に、ミリメートル単位の座標指定や用紙サイズの分岐が混ざってくると、ファイルがすぐに肥大化していきます。あとから読み返すと、業務の話なのか印刷の話なのか分からなくなってきます。
一方で、商用の帳票エンジンを別途導入する判断は、ライセンスや導入時期や運用引き継ぎの観点で、案件の中盤からは入りづらくなります。結果として、Excel テンプレートに値を流し込む実装が暫定的に選ばれて、その暫定がそのまま保守フェーズに引き継がれていく、という流れを何度か見てきました。
同じパターンで何度もハマる構造があるように見える
ここまで書いてきて、同じ構造で繰り返し詰まっている気がしています。
帳票の解像度がフェーズによって違うのに、同じ言葉で会話が進む
その解像度の差が、客先で帳票を見せた瞬間に表面化する
実装側は印刷ロジックを業務コードに混ぜたくないが、商用ツールの導入判断は遅すぎる
結果、Excel テンプレ運用と業務コード直書きの中間で、誰も嬉しくない実装が残る
個別の現場の事情ではなく、業界全体で似たパターンを引き受け続けているのかもしれない、という見え方になってきました。
結び
この記事には答えを書きません。私自身、毎回うまくやれているわけではないからです。
ただ、帳票の話で案件が止まったことが一度でもある方は、似たような朝の場面に心当たりがあるのではないか、という気がしています。「あとで」と言ったその「あと」が、想像より重かった、というあの感覚です。
次回は、この続きで「Excel テンプレートと印刷フォーマットの二重管理」の話を書く予定です。設計者と実装者の間にある、もう少しコードに近い側の話になりそうです。
同じ場面に出会ったことがある方がいたら、反応をいただけると嬉しいです。続きは追って書いていきます。気になる方はフォローから覗いてみてください。