庁内FAQ 設計書

• 企画キー: chounai-faq(apps.yaml)
• kintoneスペース: 庁内FAQ(spaceId: 90)
• 関連ドキュメント: DFD / ER図

1. 目的

庁内職員からの問い合わせを受け付け、そこからFAQを蓄積していく庁内向けナレッジ管理を、タグ・FAQ・問い合わせの3アプリ構成で提供する。JavaScriptカスタマイズは行わず、kintone標準機能のみで構成する(種別による表示項目の出し分けについては下記6.参照)。

本企画は、当初は採用・内定者ポータル企画(saiyo-naitei)の一部として設計・作成したが、採用・内定業務とは別階層の業務であるため分離し、独立した企画とした。分離の経緯は下記2.参照。

2. 企画分離の経緯

2026-07-06、まず採用・内定者ポータル企画の一部として、FAQタグマスタ・FAQ・問い合わせの3アプリをスペース「採用・内定者ポータル」(spaceId 89)に作成した(--apply --initiative saiyo-naitei)。

直後に、庁内FAQ業務は採用・内定業務と別階層であるべきと判断し、以下の手順で本企画として分離した。

1. apps.yaml上で、FAQタグマスタ・FAQ・問い合わせの3アプリのエントリをsaiyo-naiteiのapps:から本企画(chounai-faq)のapps:へ移し、本企画にspace: { name: 庁内FAQ, status: 未作成 }を新設した(appId・fieldsはそのまま維持)。 2. scripts/create-apps.mjsに、既存アプリ(appIdを持つアプリ)の実際のkintone上のスペースと、apps.yaml上でそのアプリが今属している企画のスペースを比較し、異なる場合はPOST /k/v1/app/move.json(アプリの所属するスペースを変更するAPI)で移動する機能を追加した(getAppSpaceId/moveAppToSpace。詳細はスクリプト冒頭のコメント、および採用・内定者ポータル企画の設計書7.参照)。 3. --apply --initiative chounai-faqを実行し、新規スペース「庁内FAQ」(spaceId 90)を作成したうえで、既存の3アプリ(appId 558/560/561)を上記の移動機能で自動的にspaceId 89から90へ移動した。フィールド構成・appIdは変更していない。

以上の経緯により、FAQタグマスタ・FAQ・問い合わせアプリのLOOKUP関係(faq/toiawaseがfaq-tag-masterをappKeyで参照する関係)は3アプリとも同一企画内に留まったまま維持されている。一方、費目マスタ(himoku-master、予算・決算企画)への参照は元々企画をまたいだ参照だったため、今回の分離による影響はない(下記7.参照)。

3. アプリ構成

1つのマスタアプリ(FAQタグマスタ)を先に作成し、その後2つの業務アプリ(FAQ・問い合わせ)を作成する。

4. 業務フロー概要

1. 庁内職員(または内定者等)からの問い合わせを「問い合わせ」で受け付ける。shubetsu(種別:会計・情シス・給与・休暇)を選択し、種別に応じた項目(節・細節、ネットワーク等)を入力する。 2. 定型的な問い合わせは、kintoneの「アプリアクション」機能(手動設定、下記5.参照)で「FAQ」にレコードを作成し、tenki_status(転記ステータス)を更新のうえFAQとして蓄積する。 3. 「FAQ」「問い合わせ」のタグは「FAQタグマスタ」をLOOKUP参照する。会計関連の節・細節は、予算・決算企画の「費目マスタ」(himoku-master)を企画をまたいでLOOKUP参照する(下記7.参照)。 4. 蓄積された「FAQ」は庁内職員が随時参照する。

5. 「FAQタグマスタ」フィールド一覧

6. 「FAQ」フィールド一覧

[給与]専用の固有項目は、idea.mdの元案でも具体化されていないため本設計でも未定義(バックログ、下記9.参照)。給与に関するFAQは、当面shubetsu=給与を選択したうえで共通項目(Q/A/タグ)のみで運用する。

7. 「問い合わせ」フィールド一覧

フィールド定義の正はapps.yamlの該当エントリであり、上記5〜7の表はその要約。フィールドを追加・変更した場合は、apps.yamlの更新に合わせて本表も必ず更新すること。

8. カスタマイズ想定(本設計では未実装)

「FAQ」「問い合わせ」のshubetsu(種別:会計/情シス/給与/休暇)には、本来「選択した種別に応じて関連フィールドのみを画面に表示し、他の種別の項目は非表示にしたい」という意図がある(idea.mdの元アイデア「ラジオの結果によって表示項目を分ける」)。しかし本リポジトリの方針(CLAUDE.md「JavaScriptによるカスタマイズは行わない」)により、本設計ではこれを実装しない。

標準機能の範囲では以下の代替措置にとどめる。

• レコード追加・編集・詳細画面で、会計用/情シス用/休暇用の項目群を「グループ」フィールドでまとめ、視覚的にセクション分けする(グループの折りたたみ自体は可能だが、shubetsuの選択値に連動した自動開閉・自動非表示は標準機能では不可)。
• 一覧画面は、種別ごとに絞り込んだビュー(kintoneの「絞り込み」機能、標準機能で対応可能)を用意し、種別ごとの一覧を見やすくする。
• 運用上は「選択した種別以外のフィールドは空欄のまま残る」という前提で運用する。

将来的にJavaScriptカスタマイズを実装する場合に想定される実装内容(未実装、参考情報として記載しておく)。

- 会計用: shishutsu_saishutsu_kubun / setsu_lookup / setsu_code / setsu_mei / saisetsu_lookup / saisetsu_code / saisetsu_mei /(問い合わせのみ)denpyou_bangou - 情シス用: network / joho_shisu_kubun - 休暇用: kyuuka_kubun

• kintoneのレコード追加・編集・詳細画面イベント(app.record.create.show / app.record.edit.show / app.record.detail.show)にイベントハンドラを登録する。
• ハンドラ内でshubetsuフィールドの値を判定し、kintone.app.record.setFieldShown(code, boolean)を用いて、以下のフィールド群のうち選択中の種別に対応するものだけを表示し、他は非表示にする。
• shubetsuフィールドの変更イベント(app.record.create.change.shubetsu / app.record.edit.change.shubetsu)にも同様のハンドラを登録し、種別を変更した際にリアルタイムで表示が切り替わるようにする。
• 一覧画面についても、app.record.index.showイベントで種別ごとの列表示を切り替えることは可能だが、優先度は低い(上記の絞り込みビューで代替可能なため)。

9. アプリアクション設定(手動設定が必要な項目)

「問い合わせ」から「FAQ」へのレコード作成導線は、議会事務企画の「一般質問受付→答弁作成」(設計書17.参照)と同様、kintoneの「アプリアクション」機能で実現する想定。この設定はアプリの一般設定APIではなく、REST API未対応のスペース固有設定のためscripts/create-apps.mjsの対象外であり、両アプリ作成後に管理画面から手動で設定すること(未対応)。

10. 費目マスタへの企画をまたいだLOOKUP参照について

「FAQ」「問い合わせ」の節・細節は、本企画(chounai-faq)ではなく予算・決算企画(yosan-kessan)の「費目マスタ」(himoku-master)を参照する。scripts/create-apps.mjsのappKeyによるLOOKUP解決は同一企画内のアプリしか探索しない仕様のため、本企画ではlookup.relatedApp.appKeyではなく、既に確定している費目マスタの実際のappId(484)をlookup.relatedApp.appに直接指定している。

この方式は、参照先アプリが既に作成済み(appId確定済み)であることが前提であり、apps.yaml上の他企画にはまだ前例がない。将来的に費目マスタを作り直してappIdが変わった場合、この参照は追従されず壊れる点に注意すること。

11. 未決定・今後の検討事項

• 上記8.のフィールド出し分けJavaScriptカスタマイズ(方針により本設計では未実装、標準機能の範囲で運用)
• 上記9.のアプリアクション設定(手動対応、未着手)
• [給与]FAQ・問い合わせの固有項目(idea.mdの元案でも具体化されていないためバックログ)
• 各アプリのlayout(フォームレイアウト)は未設定(kintoneのデフォルト順序に従う)