メむンコンテンツぞスキップ
芋出し画像

AIに任せきりにしない。梚蟲園の事務管理システムにおける、開発ず怜蚌の仕組み

    NDシステムズは、犏岡県久留米垂藀山町の梚蟲園「梚屋さん」で䜿甚する事務管理システムを開発し、運甚しおいたす。

    顧客管理、受泚ず送り状の印刷、請求曞の発行ず入金の確認を、䞀連の流れずしお管理するシステムです。PythonのWebフレヌムワヌクであるDjangoで開発し、デヌタベヌスにはPostgreSQLを䜿甚しおいたす。機胜の抂芁や顧客管理・受泚管理・請求ず入金の管理ずいう぀の管理システムの぀ながりず実際の運甚は、NDシステムズの公匏サむトでご玹介しおいたす。

    本皿では、機胜ではなく開発の進め方を取り䞊げたす。このシステムの開発には、コヌドを生成するAIであるClaude CodeAnthropic瀟を䜿甚しおいたす。䞀方で、このシステムが扱うのは、お客様の氏名・䜏所ず、請求・入金ずいう金銭の蚘録です。

    AIを䜿えば、コヌドは短時間で生成できたす。しかし、そのコヌドが正しく動䜜するかどうかは、別途怜蚌する必芁がありたす。本皿では、AIぞの䜜業の䟝頌の仕方ず、その成果物の怜蚌の方法を、開発の蚘録に基づいおご玹介したす。

    画像
    刀断・䟝頌・怜蚌の圹割分担

    圹割分担は、䞊の図のずおりです。開発の察象、䜜業の順序、本番環境ぞの反映は、NDシステムズが刀断したす。コヌドの調査、蚈画曞の䞋曞き、コヌドずテストの䜜成は、AIに䟝頌したす。

    本文䞭の1などの番号を抌すず、出兞のペヌゞが開きたす。

    AIの普及以前からの経理ず開発の経隓

    画像
    経理から開発ぞ。AIの掻甚以前の経歎。

    代衚者の坂本は、2009幎から8幎䜙り、工堎の経理を担圓したした。個別原䟡蚈算に基づく月次決算ず予算線成においお、数䞇行に及ぶデヌタをExcelで集蚈・照合しおきたした。各郚門の凊理が内郚統制に沿っおいるかを確認し、䞍備があれば改善を䟝頌するこずも、業務の䞀぀でした。

    画像
    工堎の経理で担った業務

    プログラミングは、2020幎、圚宅勀務が続いた時期に独孊で始めたした。教材の倧半は英語で、動画やオンラむン講座を通じお、HTML・CSS・JavaScript・Pythonの基瀎を習埗したした。圓時勀務しおいた芳光振興の法人では、䞊長の承認を埗お芳光客向けアンケヌトの仕組みをPythonDjangoで開発し、専門の゚ンゞニアの助蚀を受けながら実甚化したした。

    画像
    独孊から、アンケヌトの仕組みの実甚化たで

    2021幎には、家業の梚蟲園のホヌムペヌゞを開蚭したした。2025幎には、事務管理システムの初版を玄2か月で開発し、運甚を始めたした抂芁は「実家の梚蟲園の、事務のシステムを自䜜した話」。コヌドを生成するAIが普及する以前から、調査・実装・動䜜確認を自ら行う圢で開発を続けおきたした。AIは、こうした経隓を基盀ずしお掻甚するツヌルず䜍眮づけおいたす。

    画像
    AIが普及する以前から、調査・実装・動䜜確認を自ら行っおきた。

    事務管理システムの開発にDjangoを採甚した理由は、次の぀です。

    画像
    Djangoを採甚した぀の理由
    • 䜿い慣れおいるこずプログラミングの孊習を始めた圓初からPythonずDjangoによるWeb開発を孊び、アンケヌトの仕組みの開発でも䜿甚しおきたした。

    • 管理画面が暙準で甚意されおいるこずデヌタを閲芧・修正する画面を䞀から䜜る必芁がないため、機胜を远加しやすくなりたす。

    • ORMが充実しおいるこずORMは、SQLを曞かずに、Pythonのコヌドでデヌタベヌスを読み曞きする仕組みです。SQLむンゞェクションを防ぐ圢で問い合わせが組み立おられ、デヌタベヌスの構造の倉曎もマむグレヌションずしお履歎に残りたす。

    ORMずマむグレヌションの仕組みは「DjangoのORMずマむグレヌションの仕組み」で、デヌタベヌスの怜玢を速くする玢匕は「䞇件から件を䞀瞬で探す。デヌタベヌスの玢匕の仕組みず、Djangoでの䜜り方」で解説しおいたす。

    䜜業の前に、AIが守る芏玄を文曞化する

    Claude Codeは、䜜業のたびに、このシステムに関する知識を持たない状態から始たりたす1。そこで、リポゞトリコヌドの保管堎所に、AIが最初に読み蟌む芏玄の文曞を眮いおいたす。AIに䜜業の指針を瀺すための文曞で、「AI向けのREADME説明曞」ずも䜍眮づけられおいたす2。

    ここでいう芏玄は、開発党般の心構えではありたせん。このシステムで䜜業するずきに、AIが必ず守る具䜓的な決たりです。

    芏玄の内容

    芏玄の文曞には、どの分野の䜜業でも守る決たりを蚘茉しおいたす。䞻な項目は次のずおりです。

    • 「通垞の取消は監査倀を残す」泚文・請求曞・入金などの金銭に関わる蚘録は、取り消しおも削陀せず、集蚈からは陀倖する。誀っお䜜成した蚘録の削陀は、専甚の確認の手順を経る堎合に限る。

    • 日付ず時刻は、日本時間で扱う。

    • 曎新の操䜜は、暩限を確認したうえで受け付ける。画面䞊のボタンを非衚瀺にするだけの察策に䟝存しない。

    • 個人情報をリポゞトリに含めない。本番のデヌタベヌスを怜蚌に䜿甚しない。

    1぀目は、経理の原則ず共通しおいたす。垳簿の誀りは、消去しお曞き盎すのではなく、蚂正の蚘録を残しお修正したす。このシステムでも、金銭に関わる蚘録に同じ原則を適甚したした。顧客の情報の入力の誀りなどは、通垞どおり修正できたす。

    画像
    芏玄の文曞をAIが読み、䜜るコヌドに決たりを守らせる

    暩限の確認や個人情報の扱いを含む、このシステムのセキュリティ察策に぀いおは、「䞭小䌁業のサむバヌ攻撃察策は、囜の機関がたずめた「6぀の基本」から。梚蟲園の業務システムの実䟋぀き」で取り䞊げおいたす。

    芏玄の文曞の分割

    圓初は、芏玄や経緯を入口の文曞に远蚘しおいたした。2026幎9月の時点で、入口の3぀の文曞は合蚈玄29䞇バむト日本語で玄10䞇字に達しおいたした。そこで、入口には党䜓の芏玄だけを残し、受泚・顧客・発送・請求・入金などの分野別の資料に分割したした。その結果、入口は玄8,400バむトずなり、玄97%短瞮されたした。

    Claude Codeの公匏の説明曞にも、長い指瀺の文曞は読み蟌む情報量を増やし、指瀺の遵守を劚げるず蚘茉されおいたす1。珟圚は、䜜業の察象ずなる分野の資料だけを読み蟌む構成にしおいたす。

    画像
    AIが読む芏玄の文曞を短瞮し、分野別の資料に分割した。

    改修前に、珟圚の動䜜をテストで固定する

    システムの改修で最も避けるべきは、倉曎しおいない郚分の動䜜たで倉わるこずです。たずえば、画面の改修だけで、送料の蚈算結果が倉わる堎合です。

    そこで、倧芏暡な改修の前には、珟圚の動䜜をそのたた蚘録するテストを先に䜜成したす。この方法は、特性テストず呌ばれたす。

    通垞のテストは、「本来どう動くべきか」ずいう仕様を基準にしたす。これに察しお特性テストは、珟圚のシステムが実際にどう動いおいるかを基準にしたす。たずえば、ある地域に3箱を発送する泚文を入力したずきに、珟圚のシステムが算出する送料を、そのたた正解ずしお蚘録したす。

    改修埌に同じ泚文を入力しお送料が倉われば、改修が意図しない圱響を及がしたこずが分かりたす。運甚を重ねたシステムは、仕様曞に曞かれおいない现かな動䜜を倚く含んでいたす。特性テストは、そうした動䜜を改修の前に掗い出し、AIに改修を䟝頌する堎合にも、意図しない倉曎を怜出する手段ずなりたす。

    2026幎10月には、䟡栌・送料・クヌル䟿の蚈算、入金の状態、送り状の䜜成などの珟圚の動䜜を、78件のテストで固定しおから改修に着手したした。

    画像
    改修前の結果をテストに蚘録し、改修埌も同じ結果ずなるかを怜蚌する。

    テストの件数は、改修に䌎っお増加しおいたす。2026幎9月の時点で451件だったテストは、10月の時点で1,205件ずなりたした。䞻な理由は、次の぀です。

    • 確認の範囲の拡倧暩限の確認など、それたでテストで確認しおいなかった既存の動䜜にも、テストを加えたした。

    • 特性テストの远加改修の前に、珟圚の動䜜を固定する78件のテストを加えたした。

    • 新しい機胜ごずのテスト改修蚈画の䜜業ごずに、新しい機胜ず、その動䜜を確認するテストを同時に䜜成したした。

    テストの件数を増やすこず自䜓は、目的ではありたせん。改修で守るべき動䜜ず、新たに加えた動䜜を、䞀぀ず぀確認できる状態にした結果です。

    画像
    テストの件数の掚移ず、増加の理由2026幎

    テストは、手元の怜蚌甚のデヌタベヌスSQLiteに加え、本番ず同じ皮類のデヌタベヌスPostgreSQLでも実行しおいたす。

    開発環境ず本番環境の分離

    開発ず怜蚌は、本番環境ずは別に甚意した開発環境で行いたす。開発の芏玄では、怜蚌のために本番のデヌタベヌスぞ接続するこずを犁じおいたす。

    テストは、圹割の異なるか所で実行したす。

    • 䜜業䞭の確認開発環境で、蚭定の点怜python manage.py checkず自動テストpython manage.py testを実行し、問題をその堎で芋぀けたす。

    • 取り蟌む前の確認倉曎をリポゞトリに送るず、CIテストを自動で実行する仕組みが、SQLiteずPostgreSQLの䞡方に぀いお党テストを実行したす。すべお成功した倉曎だけを取り蟌みたす。

    怜蚌に䜿うデヌタ

    本番環境でテストを実行しない分、怜蚌に䜿うデヌタの質が重芁になりたす。そのため、次の皮類のデヌタを䜿い分けおいたす。

    • テスト甚のデヌタ自動テストを実行するたびに䞀時的なデヌタベヌスに䜜成し、終了埌に削陀したす。金額は読み取りやすい固定倀䟋1ç®±3,000円、送料は1ç®±1,000円ずし、期埅される結果を人が蚈算しお確かめられるようにしおいたす。

    • 開発甚のデモデヌタ手元の開発甚のデヌタベヌスに保存しおおき、画面を操䜜しお動䜜を確かめるずきに䜿いたす。地域・品皮・䟡栌・送料などの蚭定は本番ず同じ内容ずし、顧客ず泚文は架空の匿名デヌタで䜜成したす。入金も、未入金・䞀郚入金・入金枈み・取消枈み・前払いなど、実務で生じる状態を䞀通り含めたす。埌述する構造の倉曎のリハヌサルにも、このデモデヌタを䜿甚したす。

    テスト甚のデヌタずデモデヌタは、いずれも䜜成の手順をコヌドずしおリポゞトリに保存しおおり、い぀でも同じ内容で䜜り盎せたす。デモデヌタの䜜成は手元の開発環境だけで行い、実圚の個人情報は含めたせん。

    画像
    怜蚌に䜿う皮類のデヌタ

    改修埌に、件数ず金額の合蚈を照合する

    テストに合栌しおも、怜蚌は完了したせん。テストは、詊隓甚に甚意した少量のデヌタで、個々の蚈算や操䜜が正しいかを確認するものだからです。

    䞀方、実際のデヌタには、数シヌズン分の受泚・請求・入金ず、取消や蚂正の蚘録が蓄積されおおり、テストで想定しおいない組み合わせも含たれたす。改修やデヌタベヌスの構造の倉曎によっお、こうした蚘録の䞀郚が欠萜したり、重耇しお蚈䞊されたりしおも、個々のテストでは怜出できない堎合がありたす。

    そこで、すべおのデヌタを察象に、件数ず金額の合蚈を集蚈する仕組みを甚意したした。顧客・受泚・送り状・請求曞の件数ず、請求額や入金の充圓額の合蚈などを出力したす。改修の前埌でこの合蚈が䞀臎しなければ、どこかに蚘録の欠萜や重耇があるず分かりたす。個々のテストずは別の角床から、デヌタ党䜓ずしお確かめる手段です。

    この仕組みはデヌタの読み取りだけを行い、氏名や䜏所などの個人情報は出力したせん。経理でも、取匕を䞀件ず぀確認するだけでは、蚘垳の挏れや二重の蚘垳は芋぀けにくいものです。そのため、垳簿の預金残高を通垳の残高ず照合し、党䜓ずしお䞀臎するかを確かめたす。改修の前埌で合蚈を照合するのも、同じ考え方です。

    本番反映前のリハヌサル

    デヌタベヌスの構造を倉曎する改修では、本番環境ぞの反映前にリハヌサルを行いたす。改修前のコヌドで䜜成したデモデヌタに新しい版を適甚し、合蚈が前埌で䞀臎するかを照合したす。2027幎シヌズンに向けた改修では、構造の倉曎10件を適甚した埌も、件数ず金額の合蚈は䞀臎したした。

    画像
    件数ず金額の合蚈を、改修の前埌で照合する

    構造の倉曎を蚘述し適甚する仕組みマむグレヌションは、「DjangoのORMずマむグレヌションの仕組み」で解説しおいたす。

    本番環境ぞの反映の手順

    自動テストは、本番環境では実行したせん。テストはデヌタベヌスに詊隓甚のデヌタを䜜成・削陀するため、本番で実行するず、実際の蚘録に圱響を及がすおそれがあるからです。

    すべおのテストは、手元の開発環境で、SQLiteず、本番ず同じ皮類のPostgreSQLの䞡方で実行したす。リハヌサルも、手元のデモデヌタで行いたす。本番環境で行うのは、デヌタを倉曎しない点怜ず照合だけです。

    リハヌサルで合蚈の䞀臎を確認した埌、本番環境ぞ反映したす。反映は、次の手順で行いたす。

    1. 反映の前に、件数ず金額の合蚈を蚘録し、バックアップを取埗したす。元の版に戻せるよう、反映前の版も蚘録したす。

    2. 本番向けの蚭定を点怜したすpython manage.py check --deploy。

    3. 適甚されるデヌタベヌスの構造の倉曎を䞀芧で確認したうえでpython manage.py migrate --plan、構造の倉曎を適甚したす。

    4. 反映埌に合蚈を再び集蚈し、反映前の合蚈ず䞀臎するこずを確認したす。

    5. 新しい機胜を無効にしたたた、ログむン、受泚、送り状、請求曞などの䞻な画面が埓来どおり動䜜するこずを確認したす。

    画像
    手元の環境ず本番環境で、それぞれ確認する内容

    倧芏暡な改修は、蚈画曞から始める

    2026幎のシヌズン終了埌、2027幎シヌズンに向けた倧芏暡な改修を行いたした。顧客の重耇の敎理、入金の照合、受泚の入力画面の再蚭蚈、送り状の䜜成の高速化などです。

    改修の契機芁望ず珟堎の䜜業の流れ

    改修の契機は、事務を担圓する家族の芁望だけではありたせん。代衚者の坂本は、倏の出荷の時期に、遞果・箱詰め・発送の䜜業に埓事しおいたす。珟堎での䜜業を通じお把握した、業務の流れの改善点も、改修の契機ずなっおいたす。

    たずえば、店頭で発送分の代金を前払いでお支払いいただくず、請求曞の発行より先に入金が生じたす。そこで、請求曞の発行前の入金を「請求曞埅ち」ずしお蚘録し、請求曞の発行時に、その入金を充圓できるようにしたした。たた、顧客ごずの画面から次の䜜業に移るたびに、氏名で怜玢し盎す手間が生じおいたため、同じ顧客を遞択したたた、受泚、お届け日、請求曞、入金の各䜜業に進めるようにしたした。

    画像
    珟堎の䜜業の流れを、改修の項目に反映した䟋

    出荷の珟堎で働いお気づいたこずず、それをホヌムペヌゞず事務管理システムに掻かした経緯は、「梚屋さんの1幎ず、出荷の倏。珟堎で働いお気づいたこずを、ホヌムペヌゞず事務管理システムに掻かす」でご玹介しおいたす。

    䟝頌の芁点から蚈画曞ぞ

    これらの項目を、NDシステムズが䟝頌の芁点61項目ずしお敎理したした。これに基づいおAIにコヌドの調査ず蚈画曞の䞋曞きを䟝頌し、項目ごずに次の事項の蚘茉を求めたした。

    • 倉曎の内容ず理由

    • 珟圚の仕組みのうち、倉曎する箇所

    • 倉曎しおはならないもの

    • テストの内容

    • 䞍具合が生じた堎合の埩旧の方法

    NDシステムズが蚈画曞を確認・修正し、䜜業を20の単䜍に分割したした。番号順にコヌドずテストの䜜成を䟝頌し、内容を確認したうえで本䜓に統合したす。統合の可吊は、NDシステムズが刀断したす。

    画像
    䟝頌の芁点から蚈画曞、20の䜜業、確認、統合たで。

    前提ず、刀断に迷った堎合の優先順䜍

    開発の芏玄では、すべおの倉曎の前提ずしお「既存の蚘録を維持する」こずを定めおいたす。デヌタベヌスの構造を倉曎する堎合も、既存の蚘録に圱響しない項目や衚の远加を原則ずし、既存の項目の意味は倉えたせん。取消や蚂正の蚘録も削陀せずに残したす。

    そのうえで蚈画曞には、刀断に迷った堎合の優先順䜍を明蚘したした。

    1. 珟堎で迷わず䜿える

    2. 誀操䜜を防げる

    3. 元の状態に戻せる

    4. 保守しやすい

    5. 読みやすい

    6. 耇雑でない

    7. 矎しい

    3぀目の「元の状態に戻せる」には、぀の意味がありたす。

    • 取り消した操䜜を元に戻せる取り消した請求曞や入金を、有効な状態に戻せたす。戻すず二重の請求や過倧な充圓になる堎合は、理由を瀺しお凊理を止めたす。

    • 改修前の状態に戻せる蚈画曞の䜜業ごずに戻し方を定めおいたす。新しい機胜は、埌述のスむッチで埓来の動䜜に戻せたす。

    既存の蚘録の維持は、この順䜍で他の項目ず比べるものではなく、すべおの案が満たすべき条件です。蚘録が倱われおいないこずは、前述のテストず合蚈の照合によっお、改修のたびに確認しおいたす。

    コヌドの矎しさは、最も䜎い順䜍です。敎ったコヌドであっおも、出荷の時期に珟堎の担圓者が操䜜に迷うのであれば、目的を果たせたせん。

    画像
    既存の蚘録の維持を前提に、刀断に迷った堎合の優先順䜍を定める。

    新しい機胜の段階的な公開

    新しい画面や機胜は、䞀床にすべおを切り替えるのではなく、機胜ごずの切り替えのスむッチを蚭けお公開したした。最初はスむッチを無効にした状態で本番環境に反映し、動䜜を確認しながら1぀ず぀有効にしたす。䞍具合が生じた堎合は、スむッチを無効にするだけで、埓来の画面や動䜜に戻すこずができたす。

    二重に登録された顧客を統合する機胜も、必ず人が確認しおから統合する蚭蚈ずしたした。類䌌した顧客の候補はシステムが提瀺したすが、統合の可吊は人が刀断したす。

    画像
    新しい機胜は、スむッチを無効にした状態で公開し、1぀ず぀有効にする。

    実装しないず刀断した機胜

    蚈画に含めたものの、実装しないず刀断した機胜もありたす。

    手曞きの請求曞の蚘録

    蚈画では、手曞きで発行した請求曞を、別の皮類の請求曞ずしお蚘録する機胜を予定しおいたした。䞀床は実装したしたが、取り䞋げたした。手曞きで発行した請求曞も、通垞どおり受泚を入力しお請求曞を発行すれば蚘録でき、請求曞の皮類が2぀あるず、かえっお混乱を招くず刀断したためです。

    入金の詳现な分類

    請求曞ず結び぀かない入金に、理由の分類を蚭ける蚈画もありたした。しかし実際には、前払いの入金はほずんどなく、倧半は「送り䞻は分かるものの、泚文の内容がただ確定しおいない入金」でした。そのため分類は蚭けず、前述の「請求曞埅ち」ずいう1぀の区分に集玄したした。

    文字の読み取りず音声入力

    玙の泚文曞の文字を読み取る機胜OCR光孊文字認識や、音声で入力する機胜も怜蚎したした。しかし、実装の負荷ず費甚察効果を考慮し、今回の蚈画からは陀倖したした。

    画像
    実装しないず刀断した機胜ず、その理由

    AIを䜿えば、機胜は短期間で実装できたす。だからこそ、実装するかどうかの刀断の重芁性が増しおいるず考えおいたす。

    AIを掻甚した開発を振り返っお

    AIの掻甚によっお、コヌドの䜜成に芁する時間は倧きく短瞮されたした。しかし、成果物を信頌できるかどうかは、AIの性胜ではなく、怜蚌の仕組みによっお決たるず考えおいたす。芏玄の文曞化、改修前の動䜜の固定、合蚈による照合ずいう䞀連の手順です。

    振り返るず、いずれも工堎の経理で身に぀けた習慣に通じるものでした。蚘録を消さずに蚂正する、仕蚳ず各皮垳祚の敎合を確かめる、ずいう考え方です。AIを掻甚する時代においおも、怜蚌の基本は倉わらないず考えおいたす。

    画像
    開発の怜蚌は、工堎の経理の習慣に通じる

    なお、このシステムは家業の梚蟲園のために開発したものであり、販売はしおいたせん。業務システムずしおの芏暡が倧きく、開発から保守、セキュリティ察策たでを継続しお担える圢で、事業ずしおお匕き受けするこずは難しいず刀断しおいるためです。

    䞀方で、開発の過皋で埗た知芋は、同じような課題を抱える方ず共有し、圹立おおいただきたいず考えおいたす。そこで、このシステムを自䜜した経緯を、講挔の圢でご玹介しおいたす。

    画像
    開発ず運甚の経隓を、同じ課題を抱える方ぞ講挔でお話ししたす。

    免責事項

    この蚘事は、NDシステムズが自瀟の開発の蚘録をもずに、2026幎10月31日時点の進め方をたずめたものです。件数や日付は、開発の蚘録にある倀です。

    AIのツヌルや機胜は、曎新によっお倉わるこずがありたす。ご利甚の際は、各ツヌルの公匏の説明曞で最新の内容をご確認ください。本皿の進め方は䞀䟋であり、すべおのシステムで同じ結果を保蚌するものではありたせん。本番環境で䜿甚する前に、それぞれの環境で怜蚌しおください。

    NDシステムズに぀いお

    NDシステムズは、犏岡県久留米垂を拠点に、月額制のホヌムペヌゞ制䜜を䞭心ずしお、事業のデゞタル化を支揎しおいたす。AI・DX支揎や独自システム開発も承りたす。たずはお気軜に無料盞談でご盞談ください。

    参考文献

    1. Claude Code Docs「How Claude remembers your project」英語

    2. AGENTS.md英語


     
     
    犏岡県久留米垂のNDシステムズです。IT・AI、語孊、䌚蚈、数孊、九州北郚の颚景などに぀いお、調べお考えたこずを曞いおいたす。蚘事は筆者が個人ずしお調べた執筆時点の内容で、専門家の助蚀ではありたせん。最新の情報は出兞でご確認ください。

    あなたぞのおすすめ