道路照明管理

道路照明・自治会照明・商店街照明の設備を管理し、不具合の受付から修繕対応までを管理する。

照明番号	種別	設置場所(住所・目印)	灯器種類	管理者・管理団体	設置年月日	写真	備考	緯度	経度
サンプル照明番号1	道路照明	サンプル設置場所(住所・目印)1	LED	サンプル管理者・管理団体1	2026-07-02	(添付ファイルのサンプル)	備考のサンプル入力です(デモ表示用のダミーデータ)。	35.681200	139.767100
サンプル照明番号2	自治会照明	サンプル設置場所(住所・目印)2	水銀灯	サンプル管理者・管理団体2	2026-07-01	(添付ファイルのサンプル)	備考のサンプル入力です(デモ表示用のダミーデータ)。	35.682200	139.768100
サンプル照明番号3	商店街照明	サンプル設置場所(住所・目印)3	ナトリウム灯	サンプル管理者・管理団体3	2026-06-30	(添付ファイルのサンプル)	備考のサンプル入力です(デモ表示用のダミーデータ)。	35.683200	139.769100

グループ	code	ラベル	型	備考
照明情報	shoumei_bangou	照明番号	SINGLE_LINE_TEXT	必須
照明情報	shubetsu	種別	RADIO_BUTTON	必須 / 道路照明 / 自治会照明 / 商店街照明
照明情報	secchi_basho	設置場所(住所・目印)	SINGLE_LINE_TEXT
照明情報	touki_shurui	灯器種類	RADIO_BUTTON	LED / 水銀灯 / ナトリウム灯 / その他
照明情報	kanri_dantai	管理者・管理団体	SINGLE_LINE_TEXT
照明情報	secchi_nengapi	設置年月日	DATE
照明情報	shashin	写真	FILE
照明情報	biko	備考	MULTI_LINE_TEXT
照明情報	ido	緯度	NUMBER
照明情報	keido	経度	NUMBER

対象照明	不具合内容	発見日	発見経路	詳細	写真	通報者氏名	通報者電話番号	通報者メールアドレス	現在の状況	修繕予定日	備考
サンプル対象照明1	点灯しない	2026-07-02	住民通報	詳細のサンプル入力です(デモ表示用のダミーデータ)。	(添付ファイルのサンプル)	サンプル通報者氏名1	サンプル通報者電話番号1	サンプル通報者メールアドレス1	未対応	2026-07-02	備考のサンプル入力です(デモ表示用のダミーデータ)。
サンプル対象照明2	点滅・ちらつき	2026-07-01	職員パトロール	詳細のサンプル入力です(デモ表示用のダミーデータ)。	(添付ファイルのサンプル)	サンプル通報者氏名2	サンプル通報者電話番号2	サンプル通報者メールアドレス2	調査中	2026-07-01	備考のサンプル入力です(デモ表示用のダミーデータ)。
サンプル対象照明3	破損・傾斜	2026-06-30	その他	詳細のサンプル入力です(デモ表示用のダミーデータ)。	(添付ファイルのサンプル)	サンプル通報者氏名3	サンプル通報者電話番号3	サンプル通報者メールアドレス3	修繕中	2026-06-30	備考のサンプル入力です(デモ表示用のダミーデータ)。

グループ	code	ラベル	型	備考
不具合内容	taisho_shoumei	対象照明	SINGLE_LINE_TEXT	必須 / ルックアップ(参照: ?)
不具合内容	fugu_naiyou	不具合内容	RADIO_BUTTON	必須 / 点灯しない / 点滅・ちらつき / 破損・傾斜 / その他
不具合内容	hakken_bi	発見日	DATE
不具合内容	hakken_keiro	発見経路	RADIO_BUTTON	住民通報 / 職員パトロール / その他
不具合内容	fugu_shousai	詳細	MULTI_LINE_TEXT
不具合内容	shashin	写真	FILE
通報者情報	tsuuhousha_shimei	通報者氏名	SINGLE_LINE_TEXT
通報者情報	tsuuhousha_denwa	通報者電話番号	SINGLE_LINE_TEXT
通報者情報	tsuuhousha_email	通報者メールアドレス	SINGLE_LINE_TEXT
対応状況	genjou_joukyou	現在の状況	DROP_DOWN	未対応 / 調査中 / 修繕中 / 修繕済
対応状況	shuuri_yotei_bi	修繕予定日	DATE
対応状況	biko	備考	MULTI_LINE_TEXT
	tenken_rireki	点検履歴	SUBTABLE
	shuuri_rireki	修繕履歴	SUBTABLE

設計書類

道路照明管理設計書

企画キー: douro-shoumei-kanri(apps.yaml)
kintoneスペース: 道路照明管理(未作成)
関連ドキュメント: DFD / ER図

1. 目的

道路照明・自治会照明(防犯灯等)・商店街照明の設備情報を1つのマスタで一元管理し、点灯不良・破損等の不具合の受付から修繕対応までを業務アプリで管理する。JavaScriptカスタマイズは行わず、kintone標準機能(フィールド・レイアウト・グループ)のみで構成する。

2. アプリ構成

マスタアプリ(照明マスタ)を先に作成し、業務アプリ(照明不具合管理)がそれを参照する構成とする。

アプリキー	アプリ名	カテゴリ	備考
`shoumei-master`	照明マスタ	master	道路照明・自治会照明・商店街照明の位置・種別・灯器情報を管理
`shoumei-fugu-kanri`	照明不具合管理	business	照明マスタを参照し、不具合の受付・修繕対応を管理

3. 業務フロー概要

1. 道路管理担当の職員が、照明の新設・更新時に「照明マスタ」へ照明番号・種別(道路照明/自治会照明/商店街照明)・設置場所・位置(緯度経度)・灯器種類・管理者等を登録する。 2. 住民通報または職員パトロールにより不具合(点灯しない・点滅・破損等)を把握した場合、「照明不具合管理」アプリに対象照明(LOOKUP)・不具合内容・発見日・発見経路を登録する。住民からの通報の場合は通報者情報も記録する。 3. 現地確認のたびに「点検履歴」テーブルへ点検日・点検結果(良好/経過観察/要修繕/対応済)・点検内容・点検者を1行ずつ追加し、複数回の点検経過を記録する。 4. 「現在の状況」(未対応/調査中/修繕中/修繕済)を随時更新して案件全体の進捗を管理し、修繕予定日を設定する。 5. 実際の修繕対応のたびに「修繕履歴」テーブルへ対応日・対応内容・対応区分(委託/自前対応/その他)・対応者を1行ずつ追加し、複数回の修繕対応を記録する。すべて完了したら「現在の状況」を「修繕済」に更新する。

4. 「照明マスタ」アプリフィールド一覧

グループ	code	ラベル	型	備考
照明情報	`shoumei_bangou`	照明番号	文字列1行(必須・重複禁止)
照明情報	`shubetsu`	種別	ラジオボタン(必須)	道路照明 / 自治会照明 / 商店街照明
照明情報	`secchi_basho`	設置場所(住所・目印)	文字列1行
照明情報	`touki_shurui`	灯器種類	ラジオボタン	LED / 水銀灯 / ナトリウム灯 / その他
照明情報	`kanri_dantai`	管理者・管理団体	文字列1行	自治会照明・商店街照明は道路管理者以外が管理する場合があるため
照明情報	`secchi_nengapi`	設置年月日	日付
照明情報	`shashin`	写真	添付ファイル
照明情報	`biko`	備考	文字列複数行
照明情報	`ido`	緯度	数値	地図プラグイン用。慣習コード。グループ内最後尾に配置
照明情報	`keido`	経度	数値	地図プラグイン用。慣習コード。グループ内最後尾に配置
(グループ外)	(spacer: `map`)	―	スペース	地図プラグインの設置場所(高さ400px)。グループの直後、トップレベルの行として配置

5. 「照明不具合管理」アプリフィールド一覧

グループ	code	ラベル	型	備考
不具合内容	`taisho_shoumei`	対象照明	ルックアップ(文字列1行・必須)	照明マスタを参照するLOOKUPフィールド(下記6.参照)
不具合内容	`fugu_naiyou`	不具合内容	ラジオボタン(必須)	点灯しない / 点滅・ちらつき / 破損・傾斜 / その他
不具合内容	`hakken_bi`	発見日	日付
不具合内容	`hakken_keiro`	発見経路	ラジオボタン	住民通報 / 職員パトロール / その他
不具合内容	`fugu_shousai`	詳細	文字列複数行
不具合内容	`shashin`	写真	添付ファイル
通報者情報	`tsuuhousha_shimei`	通報者氏名	文字列1行	住民通報の場合のみ記入
通報者情報	`tsuuhousha_denwa`	通報者電話番号	文字列1行
通報者情報	`tsuuhousha_email`	通報者メールアドレス	文字列1行
対応状況	`genjou_joukyou`	現在の状況	ドロップダウン	未対応 / 調査中 / 修繕中 / 修繕済。案件全体の現在のステータスを表す1つの値(旧`taiou_joukyou`から改称)
対応状況	`shuuri_yotei_bi`	修繕予定日	日付
対応状況	`biko`	備考	文字列複数行
(テーブル)	`tenken_rireki`	点検履歴	テーブル(サブテーブル)	現地確認のたびに1行追加。下記5-1.参照
(テーブル)	`shuuri_rireki`	修繕履歴	テーブル(サブテーブル)	実際の修繕対応のたびに1行追加。下記5-2.参照

フィールド定義・レイアウトの正はapps.yamlの該当エントリ(fields / layout)であり、本表はその要約。フィールドを追加・変更した場合は、apps.yamlの更新に合わせて本表も必ず更新すること。

5-1. 「点検履歴」テーブルの行フィールド

code	ラベル	型	備考
`tenken_bi`	点検日	日付
`tenken_kekka`	点検結果	ドロップダウン	良好 / 経過観察 / 要修繕 / 対応済。その点検時点でのステータス(履歴として複数回分残る)
`tenken_naiyou`	点検内容	文字列複数行
`tenken_sha`	点検者	文字列1行

5-2. 「修繕履歴」テーブルの行フィールド

code	ラベル	型	備考
`shuuri_bi`	対応日	日付
`shuuri_naiyou`	対応内容	文字列複数行
`taiou_kubun`	対応区分	ラジオボタン	委託 / 自前対応 / その他
`taiousha`	対応者	文字列1行

5-3. 「現在の状況」と「点検結果」の使い分け

genjou_joukyou(現在の状況): レコード全体(=1件の不具合案件)としての進捗を表す単一のステータス。一覧・絞り込みで案件の対応状況を俯瞰するために使う。
tenken_kekka(点検結果): tenken_rirekiテーブルの各行(=1回の点検)ごとのステータス。何度も点検を重ねた場合の経過を追うために使い、行を追加しても過去の点検結果は削除・上書きされない。

6. マスタ参照(LOOKUPフィールド)について

「照明不具合管理」のtaisho_shoumeiは、「照明マスタ」を参照するLOOKUPフィールド。コピー元フィールドはshoumei_bangou(照明番号・重複禁止)で、選択時のピッカーにはshoumei_bangou/shubetsu/secchi_bashoを表示する。

apps.yamlではlookup.relatedApp.appKey: shoumei-masterのように参照先を企画内のアプリキーで指定しており、scripts/create-apps.mjsがマスタアプリ作成後に実際のappIdへ解決してからkintone APIに送る仕組み(resolveLookupField())を利用している(公園管理の設計書6.も参照)。

7. 地図プラグインについて

「照明マスタ」のido(緯度)/keido(経度)フィールドの直後に、地図プラグイン設置用のスペース(elementId: map)をレイアウトに配置済み。プラグイン自体の選定・設定は本設計書の範囲外(未着手)。

8. サブテーブル(点検履歴・修繕履歴)のレイアウトについて

apps.yamlのlayoutDSL(scripts/create-apps.mjsのcomputeDesiredLayout())は、現状トップレベルのROWとGROUPのみを明示的に配置対象として扱い、SUBTABLEをレイアウト内の特定位置に指定する機能を持たない。そのためtenken_rireki(点検履歴)・shuuri_rireki(修繕履歴)はDSLのlayoutに含めておらず、フィールド追加時にkintoneが自動配置した位置(=管理下のGROUPの後ろ)がそのまま「管理対象外のレイアウト行」として保持される(同スクリプトのleftover保持の仕組みによる)。位置を明示的に調整したい場合は、アプリ作成・デプロイ後にkintone側のフォーム編集画面で手動調整するか、DSLの拡張を別途検討する。

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

住民からの不具合通報を受け付ける窓口(電話・メール・フォーム等)の運用フローの詳細化
自治会照明・商店街照明について、電気料金負担先(自治会・商店会/市)の管理をマスタに持たせるか

道路照明管理 DFD(データフロー図)

対象: 「照明マスタ」アプリ・「照明不具合管理」アプリ

flowchart LR staff["職員\n(道路管理担当)"] resident["住民"] subgraph masterApp["照明マスタアプリ (kintone)"] master[("照明マスタ\nレコード")] end subgraph fuguApp["照明不具合管理アプリ (kintone)"] fugu[("照明不具合管理\nレコード")] end staff -- "1. 照明番号/種別/位置(緯度経度)/\n灯器種類/管理者等を登録" --> master master -- "2. LOOKUPで対象照明を選択\n(taisho_shoumei)" --> fugu resident -- "3. 点灯不良等を通報" --> staff staff -- "4. 不具合内容/発見日/発見経路/\n通報者情報を登録" --> fugu staff -- "5. 現地確認のたびに\n点検履歴テーブルへ1行追加" --> fugu staff -- "6. 現在の状況・修繕予定日を更新" --> fugu staff -- "7. 修繕対応のたびに\n修繕履歴テーブルへ1行追加" --> fugu

フロー説明

1. 道路管理担当の職員が、照明の新設・更新時に照明マスタへ位置情報等を登録する。 2. 照明不具合管理アプリのtaisho_shoumeiはLOOKUPフィールドで、照明マスタのshoumei_bangou(照明番号)をキーに参照する(設計書6.参照)。 3. 住民が点灯不良・破損等を発見し、電話・窓口等で職員に通報する(職員のパトロールで発見する場合もある)。 4. 職員が照明不具合管理アプリで対象照明をLOOKUPから選択し、不具合内容・発見日・発見経路・(住民通報の場合は)通報者情報を入力して受け付ける。 5. 現地確認を行うたびに、tenken_rireki(点検履歴)テーブルへ点検日・点検結果(良好/経過観察/要修繕/対応済)・点検内容・点検者を1行追加し、複数回の点検経過を記録する。 6. 担当課がgenjou_joukyou(現在の状況: 未対応/調査中/修繕中/修繕済)を随時更新し、修繕予定日を設定する。 7. 実際に修繕対応を行うたびに、shuuri_rireki(修繕履歴)テーブルへ対応日・対応内容・対応区分・対応者を1行追加し、すべて完了したら現在の状況を「修繕済」に更新する。

道路照明管理 ER図

対象: 「照明マスタ」アプリ・「照明不具合管理」アプリ

erDiagram SHOUMEI_MASTER { string shoumei_bangou "照明番号(必須・重複禁止)" radio_button shubetsu "種別(必須、道路照明/自治会照明/商店街照明)" string secchi_basho "設置場所(住所・目印)" radio_button touki_shurui "灯器種類" string kanri_dantai "管理者・管理団体" date secchi_nengapi "設置年月日" file shashin "写真" text biko "備考" number ido "緯度" number keido "経度" } SHOUMEI_FUGU_KANRI { string taisho_shoumei "対象照明(LOOKUP、必須)" radio_button fugu_naiyou "不具合内容(必須)" date hakken_bi "発見日" radio_button hakken_keiro "発見経路" text fugu_shousai "詳細" file shashin "写真" string tsuuhousha_shimei "通報者氏名" string tsuuhousha_denwa "通報者電話番号" string tsuuhousha_email "通報者メールアドレス" drop_down genjou_joukyou "現在の状況(案件全体のステータス)" date shuuri_yotei_bi "修繕予定日" text biko "備考" } TENKEN_RIREKI { date tenken_bi "点検日" drop_down tenken_kekka "点検結果(良好/経過観察/要修繕/対応済)" text tenken_naiyou "点検内容" string tenken_sha "点検者" } SHUURI_RIREKI { date shuuri_bi "対応日" text shuuri_naiyou "対応内容" radio_button taiou_kubun "対応区分" string taiousha "対応者" } SHOUMEI_MASTER ||--o{ SHOUMEI_FUGU_KANRI : "taisho_shoumei(LOOKUP)で参照" SHOUMEI_FUGU_KANRI ||--o{ TENKEN_RIREKI : "tenken_rireki(サブテーブル)" SHOUMEI_FUGU_KANRI ||--o{ SHUURI_RIREKI : "shuuri_rireki(サブテーブル)"

備考

SHOUMEI_MASTERとSHOUMEI_FUGU_KANRIは、taisho_shoumei(LOOKUPフィールド、コピー元: shoumei_bangou)で連携している(設計書6.参照)。
TENKEN_RIREKI(点検履歴)・SHUURI_RIREKI(修繕履歴)は独立したアプリ/レコードではなく、SHOUMEI_FUGU_KANRI内のサブテーブル(type: SUBTABLE)。1件の不具合案件に対して点検・修繕を複数回記録できるようにするためのもので、案件全体の現在のステータスはgenjou_joukyouが単独で保持する(設計書5-3.参照)。
ido(緯度)/keido(経度)は地図プラグイン連携用の慣習コード。フィールドの正はkintone上の設定であり、apps.yamlのfieldsがその定義元。