system-sekkei / library

図書館の司書業務を支援するソフトウェア

図書館の司書業務を支援するソフトウェア

司書業務とアプリケーションの対象範囲

このアプリケーションは、公立図書館の司書業務をサポートするソフトウェアです。

主な対象業務

• 貸出と返却　◎
• 書架の整理　△
• 選書と受入 〇

このアプリケーションでは対象としない司書の業務

司書の役割や関心事を理解するための参考情報です。 アプリケーションの仕様を検討する時に、司書の業務の全体を理解することが役に立ちます。

• レファレンスサービス（相談）　△
• リファレンスサービス（記録）　-
• イベント（企画・運営・評価) -

図書館業務の課題

サンプルアプリケーションの使い方

利用方法

• RDRA 2.0 ハンドブックを入手
• このリポジトリーをクローン
• Gradleタスク bootRunを実行(アプリケーションの起動)
• Gradleタスク jigReportを実行(設計ドキュメントの出力)

この実装例の内容を学ぶためのチュートリアルが公開されました。
図書館サンプルのチュートリアル

アプリケーションの内容

RDRA 2.0 ハンドブックのサンプル「図書館システム」の以下の業務を実装しています。

アプリケーションは、http://localhost:8080でトップ画面を表示できます。

RDRA 2.0 ハンドブックの図書館システムの実装例

モデルベースの要件定義手法 RDRA2.0 ハンドブックのサンプル「図書館システム」の実装です。

• RDRA 2.0 ハンドブック (Kindle Unlimited会員は無償です)

設計ドキュメント

JIGを使ってソースコードから設計ドキュメントを自動生成します。ドキュメントはbuild/jig に出力されます。
JIGドキュメントの生成には、 Graphviz のインストールが必要です。

実装の範囲

ビジネスルールを中心に実装しています。

RDRA 2.0で可視化した以下のビジネスルールと関連するユースケース、画面、テーブルを実装しています。

• 貸出制限ルール
• 予約の状態遷移

貸出業務と貸出制限ルール

予約の状態遷移

以下の業務は未実装です。

• 蔵書管理（資料の注文と蔵書として登録する）
• 会員管理（会員の登録）

要件定義・仕様化・実装の継ぎ目をなくす開発手法

この図書館サンプルは、以下の考え方とやり方で実装しています。

• 三層構造 + ビジネスロジック
• 仕様の記述にプログラミング言語(Java,SQL,HTML)を使う
• 仕様の可視化にツール(JIG)を使う

三層構造＋ビジネスロジック

ビジネスロジックを独立させるドメイン駆動設計のアプローチを採用しています。

ドメインオブジェクトを中心にしたアプリケーション構造

RDRAの要件定義モデルと実装を、以下のように対応させています。

Spring MVCとMyBatisを使い、ドメインオブジェクトを中心に周辺の外部形式との双方向のマッピングを実現するアプリケーション構造を採用しています。

ドメインオブジェクトのモデル（ビジネスロジックの表現）

ソースコードから、JIGで自動生成したドメインモデルのパッケージ構成図です。
このモデルを中心に図書館アプリケーションを組み立てています。

CCSR: Continuous Concurrent Stepwise Refinment

開発手法として、要件定義・仕様化・実装の継ぎ目をなくすCCSR手法を採用しています。

この図書館サンプル実装は、CCSR手法の実践例として開発しています。

参考記事： 要件定義・仕様化・実装の継ぎ目をなくすCCSR開発手法

RDRAアドイン

RDRA手法のモデリングツールとして、Enterprise ArchitectのRDRAアドインを使っています。

• Enterprise ArchitectでRDRA 2.0を利用する

JIG (設計可視化ツール)

Javaで記述した内容を、俯瞰したり、一覧するためのツールです。

プログラミング言語で仕様を記述するCCSR手法を実践するために必須のツールです。

• JIGリポジトリ

RDRA - CCSR - JIG 関係図

RDRAのモデル要素（左）、三層＋ビジネスロジックの構造（**）、JIGの出力ドキュメント（右）の対応関係です。

ビジネスルール駆動

図の青背景でしめした、RDRAで可視化したビジネスルールをドメインモデルとして実装することが、このアプリケーションの中核です。

RDRA 2.0で可視化された内容と、実装された内容の対応は、以下のJIGドキュメントで確認できます。

• ユースケース複合図
• パッケージ関係図（depth4, depth5）
• 区分図と区分使用図
• メソッド呼び出し関係図

参考情報

• 書籍：現場で役立つシステムの原則 ～変更を楽で安全にするオブジェクト指向の実装技法
• ドメインオブジェクトの設計パターン：設計ガイドライン
• オブジェクトと外部形式のマッピング技法の説明：CCSRオブジェクトマッピング

library's Issues

会員が貸出状況を確認できるようにする

会員登録を行えるようにする

• はじめて借りる場合、図書館カードを発行する必要がある。
• 市内に住んでいる、もしくは市内の学校に在席している場合作成することが可能。

READMEの説明追加と視覚化

会員が予約をキャンセルすることができるようにする

• 会員がWebから予約をキャンセルする
• 予約履歴を削除する
• 所蔵品が取置かれている場合、在庫に戻す

予約の待ち人数を確認できるようにする

予約がはいっていない図書は1回だけ15日間貸出延長できるようにする

2か月以上延滞がある会員のサービスの利用を一定期間停止する

2か月以上延滞すると、貸出や予約など、図書館カードが必要なサービスの利用を1ヶ月間停止。

図書館システム設計

会員に貸出可能な点数まで所蔵品を貸し出すことができるようにする

• 借りる本と図書カードをカウンターに出すと、本を借りることができる。
• 小学生以下は1人15点まで(うちＤＶＤ・ＣＤはあわせて5点まで) 15日間。
• 中学生以上は20点まで(うちＤＶＤ・ＣＤはあわせて5点まで) 15日間。

未準備の予約一覧に取置可否を表示する

予約一覧で、在庫があり取置可能な予約かどうかをわかるようにする。
同一の所蔵品目に複数予約が入っている場合、在庫数分の予約を先に予約されたものを取置可能とする。

会員が予約状況を確認できるようにする

予約の待ち状況や取り置き状況を確認できるようにする。

会員が予約可能点数まで所蔵品を予約できるようにする

• ひとり15点まで（うちＤＶＤ・ＣＤはあわせて5点まで）予約可能。
  • 貸出中でも在庫中でも予約できる。

予約が取り消されたり無効になった取置資料を確認・処理する機能を作る

• 取り消された、もしくは期限切れなどで無効になった取置一覧を出す
• 図書館員が確認し、在庫に戻すか、次の予約者用に取置く

取置期限内に受け取られなかった取置を無効にする

• 取り置き期限内に受け取らない場合は取置は無効になる。
  • 取り置き期限は連絡をした日の翌日から7開館日。
    • 休館日：月曜日と年末年始

15日以上延滞している資料があるときは、新たに借りることができないようにする

会員の有効期限をつける

• カードの有効期限は3年。

所蔵品の貸出可否を提示する ユースケースの妥当性

貸出を登録する際には、本（所蔵品）の現物を持って窓口に来ているので、
所蔵品の貸出可否を判定するユースケースはないかと思いました。

窓口、もしくはWebで、所蔵品目から保有する全ての所蔵品の貸出可否を問い合わせて、
「予約もしくは貸出」という業務の方がありそうに思います。

library/src/main/java/library/application/scenario/loan/LoanScenario.java

Lines 72 to 81 in 1836f04

	/**
	* 所蔵品の貸出可否を提示する
	*/
	public ItemLoanability 所蔵品の貸出可否を提示する(ItemNumber itemNumber) {
	ItemStatus 所蔵品の状態 = itemQueryService.status(itemNumber);
	Item 借りたい所蔵品 = itemQueryService.findBy(itemNumber);
	ItemWithStatus 借りたい所蔵品とその状態 = new ItemWithStatus(借りたい所蔵品, 所蔵品の状態);
	return ItemLoanability.貸出可能かどうか(借りたい所蔵品とその状態);
	}

図書館 延滞問題についての参考リンク

図書館 延滞問題

延滞の状況の数値データが具体的な資料

• 「本が帰ってこない」悩む公立図書館: 日本経済新聞
  • 10年以上返却されなかった本が1万9千冊。総額役2500万円。
  • 15年度までの4年間で4502冊。16年度に回収できたのが19冊。
  • 16年度に督促はがきを約1万7千枚送り、約84万円がかかった。過去5年間では500万。
• 大学図書館における督促について
  • 24%が未返却
• 貸出規則 と延滞防止
  • 昭和38年の資料
  • 貸出の30%が未返却
• 図書館資料延滞者を減らす取り組みについて（案）
  • 名張市の資料
  • 督促者数一覧あり
  • 貸出人数5,512人で延滞者が437人。(7.9%)。貸出冊数25,356冊のうち延滞が1,503冊 (5.9%)
  • 3年以上回収不能な資料は除籍。(平成24年度 30点、25年度 24点)

軽度な延滞の対応方法や、延滞の予防的な取り組みが具体的な資料

• 督促・お知らせメールサービス :: 長崎大学附属図書館
  • 督促メールサービス
    • 毎週月曜日13時の時点で延滞されている場合メールでお知らせ
  • 返却日事前通知
    • 返却期限2日前にメールでお知らせ
• 米原市立図書館の資料の返却督促および貸出制限基準
  • 返却期日から30日以上経過で督促
  • 督促をうけながら返却期日から60日以上経過する遅滞者に対して督促状を送付
    • 電話、電子メール、はがき
  • 遅滞者不在時に、書名・著者名などは伝えない
  • 郵便の督促時、書名・著者名は掲載しない
    • 遅滞者の読書の秘密を守るため
  • 遅滞者に対しては、資料が返却されるまでの期間は貸出停止・予約受付停止
• 図書館資料延滞者を減らす取り組みについて（案）
  • 督促
    • 返却期日が過ぎた時点で電話・窓口で督促、14日以上未返却で督促はがきを送付
    • 2ヶ月以上の長期延滞で封書を送付
• 図書資料延滞者に対する貸出し制限等について
  • 毎月2回、直前2週間前の返却期限までに資料未返却の利用者に対してハガキで督促
  • 返却期限が過ぎた時点でまず電話で督促
  • メールアドレスが登録してある利用者について、返却期限から２週間経過した時点で督促メールを送信
    • 年4回、前年度以前3年分も併せて送信
  • 返却期限から30日経過で貸出・予約停止
    • 罰則開始の2週間前にハガキ・メールで通知

重度な延滞についての統計や取り組みの資料

• 図書館資料の督促や延滞や時効などに関する資料 | レファレンス協同データベース
• 「図書館の自由」と図書館ネットワーク －延滞督促方法をめぐって－
• 市民の図書館
  • p52 延滞・亡失
    • 『利用者はなかなか期限内に本を返さず延滞が貸出しの10%、多くなると20%にも達することがある』
    • 督促を促す、一定期間の貸出停止処分とするか罰を課さないことにするのがよく、延滞料の徴収は労多くして効少ないとある。
• 図書館と法: 図書館の諸問題への法的アプローチ (JLA図書館実践シリーズ 12) 鑓水 三千男
  • p196 Q2 図書館資料の延滞について、法的に妥当な処置方法を教えてください
    1. 督促
       • 電話、電子メール、郵便
    2. 訴訟の提起
       • 督促を行ってもなお返却がない場合
    3. 貸出制限
       • 一定の期間貸出を禁止・制限する
    4. 延滞料の徴収
       • 費用対効果の点を考え、現在ではほとんどない

予約した資料が準備できたことを会員に通知する

ビジネスルールを、実在の図書館に近いものにする

よりリアルなサンプルにするために、実際の図書館を参考にして、ビジネスルールを実在の図書館に近いものにする。

貸出期限切れを通知する

正常系とそれ以外のシナリオを分ける

現在、正常系とそれ以外のキャンセル系のユースケースが同一のシナリオクラスにまとまっているので、これらを整理して分ける。

借りた所蔵品を返却できるようにする

図書館員が予約を取り消すことができるようにする

なんからの事情で資料が用意できなかった場合に、図書館員が予約を取り消すことができるようにする。

・図書館員が予約を取り消す
・予約履歴を取り消す
・会員に、資料が準備できなかった旨を通知する

図書館事業や図書館業務の基礎知識の参考リンク

業務

• 図書館司書の10個の業務
• 司書になるには・仕事内容と本音・全国の求人｜スタンバイ

遅延罰則

大阪市

市の条例で規定。

• 図書館資料利用規程 - 大阪市立図書館
  • 13条

公立図書館の事業

役割・目的

• 図書館法 | e-Gov法令検索

予算（コスト構造）

• 図書館経営：文部科学省

貸出統計・蔵書統計

• 統計 - 大阪市立図書館
• 大阪市立図書館年報 - 大阪市立図書館

司書インタビューや生の声

• 丸善雄松堂の図書館支援サービス｜図書館で働きたい方へ｜全国で活躍するスタッフの声
• 司書のやりがい・楽しさ・魅力 | 司書の仕事・なり方・年収・資格を解説 | キャリアガーデン
• とある図書館司書見習いのブログ
  • 図書館員の方のブログ。窓口や予約業務などの様子がわかる。
    • 図書館がサービス業と感じる瞬間。 - とある図書館司書見習いのブログ
    • 何かと急かす利用者さん〜とある図書館員の日記〜 - とある図書館司書見習いのブログ
• 【通信教育部】大人が今学びたい司書講座「もし大人になった今、本について学んだとしたら」 - YouTube
• 発見！こうべおしごと調査隊－図書館司書のおしごと - YouTube
• 【岩手県 久慈市】久慈市立図書館（YOMUNOSU）に行ってみた！ - YouTube
• 貸出冊数 - 図書館ごくらく日記

参考書籍

• 夜明けの図書館 ： 1 (ジュールコミックス) | 埜納 タオ | 女性マンガ | Kindleストア | Amazon
  • 司書レファレンス業がテーマのマンガ
• Amazon.co.jp: レファレンスと図書館 ある図書館司書の日記 eBook : 大串 夏身: 本
  • 実際のレファレンスのやり取り記録や、資料の探し方についてなど。
• 図書館概論 (JLA図書館情報学テキストシリーズ3) | 昇, 塩見 |本 | 通販 | Amazon
• 中小都市における公共図書館の運営―中小公共図書館運営基準委員会報告 | 日本図書館協会 |本 | 通販 | Amazon
• 図書館のしごと ―よりよい利用をサポートするために 独立行政法人国際交流基金関西国際センター
• 市民の図書館
• 図書館と法: 図書館の諸問題への法的アプローチ (JLA図書館実践シリーズ 12) 鑓水 三千男

取置番号を発行する

現在、取置を予約番号で識別しているが、取置番号を発行して識別するように変更する。

ミニマムの認証・認可の追加

検索して予約する画面：登録会員専用
貸出・返却：図書館スタッフ専用

というのを、Spring Security( with Spring Bootで、可能な限りミニマムの設定で実装する

• システムコンテキストのアクタ（ロール）をソフトウェアで表現するサンプルとして
• 認証・認可の実装技術のミニサンプル（Spring Security+Spring Bootのデフォルトできるだけシンプルに）
• 遅滞などの状況に関連するユースケースの実装をより具体的にするため

現在の、会員テーブルとは別に、UserDetail用のテーブルを用意するか検討する

履歴系のテーブル名を変更する

• 履歴系のテーブルから「履歴」という言葉をなくす。
• DeleteInsert系の状態管理テーブルの名前に _ をつける。

会員に予約の取置期限切れを通知する

返却が終わったら、どの会員が何を借りたかの履歴を削除する（個人情報保護）

予約された所蔵品を取り置いて、会員に貸し出すことができるようにする

• 会員がWebから所蔵品目を選び予約をする
• 図書館員が未準備の予約を探す
• 所蔵品を取り置く
• 会員に貸し出す

シナリオテストを充実させる

アプリケーション層の機能にたいして、データベース操作まで含めたテストを作成する。
テストシナリオは、もっとも重要なシナリオ（最低１，多くても３）。

どの会員が何を予約したかの履歴を適切なタイミングで削除する（個人情報保護）

注意点

• 予約の状態管理の終了パターンがいくつかあることに注意する
• 正常系：どの時点で削除するか？
• 期限切れ等：どんな終了パターンがあるか？　どの時点で削除するか？

個人の貸出履歴・予約履歴を残さない設計に変更する

目的

図書館は利用者の秘密(個人情報)を守る必要があり、個人の貸出履歴・予約履歴を残すことができない。

• 図書館ホームページに自分の「貸出履歴」を残せない理由とは | Biblio Hack https://biblio-hack.com/%e5%9b%b3%e6%9b%b8%e9%a4%a8%e3%83%9b%e3%83%bc%e3%83%a0%e3%83%9a%e3%83%bc%e3%82%b8%e3%81%ab%e8%87%aa%e5%88%86%e3%81%ae%e3%80%8c%e8%b2%b8%e5%87%ba%e5%b1%a5%e6%ad%b4%e3%80%8d%e3%82%92%e6%ae%8b%e3%81%9b/

そのため、履歴の持ち方を変更する必要がある。

設計方針

基本は、

• 個人の貸し出し記録は返却時に削除
• 本の貸し出し履歴は残す

という設計にする。

削除した未準備の予約記録テーブルを再作成する

現在、未準備の予約は 取置.準備完了 に存在しない予約を取得しているが、わかりにくいため、当初のように 予約.未準備 テーブルを作成し、未準備状態の予約番号を格納するように戻す。

延滞者の把握ができるようにする

• 図書館館長は毎月末日に遅滞者の把握を行う。
• 督促は、窓口、電話、電子メール、はがき等で行う。
• 予約がはいっている資料については、返却期日が過ぎた時点で電話で速やかに督促を行う。
• 返却期日から60日以上経過する遅滞者に対して、督促を行う。
• 通知内容は、図書館カード番号、資料の番号および返却期限日。
• 個人情報保護の観点から、書名・著者名は本人が希望しない限り通知しない。

LibraryDBTestアノテーションを削除できそうであれば削除する

現在、全テストにLibraryDBTestアノテーションをつけている。
テストレイヤー毎にアノテーションを作成する方針にしたい。

• シナリオテスト用のアノテーションを作成する
• シナリオテスト用の設定ファイル (application-test.properties)を作成する
• シナリオテストをトランザクションとロールバック不要な形に修正する

JDKのバージョンを17に上げる