mygit-admin/ken_nogi
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1582960fd4
ken_nogi/ClaudePleasanter/新・稟議申請システム/docs/site-160926_稟議コード管理_spec.md
Kenichiro NOGI 9bbc344137 Pleasanterサイト仕様書パイプラインを再構築 
生JSON取得(siteSettingJsons/)と設定分解(configs/)の保存先を分離し、
仕様書・概要書はClaudeが読み解いて執筆する方式に統一(機械生成の
generate-site-documentation.jsは不使用)。10サイト分のspec.md/
overview.mdを刷新し、サイト間連携をまとめたsite-relations_overview.md
を新規追加、全docsをPDF化した。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-11 08:49:24 +09:00

17 KiB
Raw Blame History

サイト仕様書：稟議コード管理（SiteId: 160926）

  • 取得元データ: site-160926_latest.json
  • 取得日時: 2026-05-15T15:22:14（サイト更新日時）／設定バージョン Ver: 18（SiteSettings.Version: 1.017）

1. サイト基本情報

項目 値
TenantId 1
Title 稟議コード管理
ReferenceType Results
ParentId 63543（今回対象の10サイト群には含まれない外部の親サイト／フォルダ）
InheritPermission 160926（自サイトの権限設定を使用）
Publish false（外部公開なし）
DisableCrossSearch false
Creator 460
Updator 678
CreatedTime 2023-01-24T15:56:46
SiteSettings.Version 1.017

2. アクセス権限（Permissions）

種別 対象ID 権限レベル
Dept 8 7
Dept 56 7
Group 19 511
Group 27 7
User 460 511

※権限値はビットフラグの加算方式のため、正確な意味（閲覧／編集／削除等の組み合わせ）は環境のロール定義に依存する。Group 19・User 460 が511（管理者相当）、その他が7（一般的な閲覧＋作成レベル相当）という偏りが見られる。

3. 画面構成

3.1 一覧画面（GridColumns）

順番 列名（内部） 表示ラベル
1 ResultId （標準ラベル）ID
2 Status （標準ラベル）状態
3 ClassA エリア
4 ClassB 稟議分類
5 ClassC 稟議コード
6 ClassD 契約コード
7 ClassF 用件・物件名
8 Owner 申請者
9 DateA 申請日
10 UpdatedTime （標準ラベル）更新日時

3.2 編集画面レイアウト（EditorColumnHash / Sections）

タブ「General」のみ定義。

順番 項目名（内部名） ラベル名
1 Title （標準ラベル）タイトル
2 ResultId （標準ラベル）ID
3 Status （標準ラベル）状態
4 ClassC 稟議コード
5 _Section-2 ―（セクション「稟議コード取得」開始）
6 ClassA エリア
7 ClassB 稟議分類
8 Owner 申請者
9 ClassD 契約コード
10 ClassE 派生コード
11 ClassF 用件・物件名
12 DateA 申請日
13 Comments （標準ラベル）コメント
14 ClassX ラベル未設定（Hide項目。ClassAの選択値を裏で保持）
15 ClassY ラベル未設定（Hide項目。ClassBの選択値を裏で保持）
16 _Links-319015 ―（他サイト連携表示：SiteId 319015「新・稟議申請書」の関連レコード一覧を編集画面内に表示。詳細は「7. 他サイト連携」参照）

Sections配列:

Id ラベル AllowExpand Expand
2 稟議コード取得 false true

3.3 タイトル表示（TitleColumns / TitleSeparator）

TitleColumns: ClassC, Owner, DateA を TitleSeparator " - " で連結。

表示式: [ClassC] - [Owner] - [DateA]（例: 稟議コード - 申請者 - 申請日）

4. 項目定義（Columns）

列名（内部） 種別 表示ラベル 説明・入力ガイド 備考
ClassA 文字列（分類） エリア ラジオ選択（東京/愛知/千葉/熊本/静岡/特建事業部/不動産事業部/デザイノ/その他） NoWrap, ValidateRequired（必須）, ExtendedHtmlAfterControlあり（注意書き、4.1参照）, SearchType: PartialMatch
ClassB 文字列（分類） 稟議分類 ラジオ選択（白稟議/赤稟議/駐車場稟議/赤稟議(5万以下)/事前稟議/お客様返金稟議/社用車事故報告/自家用車事故報告）。選択肢ごとに表示色クラス（status-white等）が設定 ValidateRequired（必須）, SearchType: PartialMatch
ClassC 文字列（分類） 稟議コード 自動採番。書式 [ClassX][ClassY]-[yy]-[NNNN]、年単位でリセット、初期採番値4500 NoWrap, ExtendedFieldCss/ExtendedControlCss: code-readonly（読み取り専用風の見た目）, ExtendedHtmlAfterControlあり（4.1参照）
ClassX 文字列（拡張分類） ラベル未設定 Hide項目。ClassAの選択値（数値コード）のコピー先。稟議コード自動採番の構成要素として使用 Hide: true
ClassY 文字列（拡張分類） ラベル未設定 Hide項目。ClassBの選択値（数値コード）のコピー先。稟議コード自動採番の構成要素として使用 Hide: true
Owner ユーザー選択 申請者 — NoWrap, EditorReadOnly（編集画面では読み取り専用）
ClassD 文字列（分類） 契約コード 外部サイト（SiteId 61259）を検索して選択。表示書式 [ClassH] - [ClassJ] - [ClassO] - [ClassP] UseSearch, NoWrap, GridDesign: [ClassD][ClassE], SearchType: PartialMatch, JsonFormat: true（詳細は7章）
ClassE 文字列（分類） 派生コード 外部サイト（SiteId 64583/74927/72434の3サイト）を検索して選択 UseSearch, Link: true, SearchType: PartialMatch
ClassF 文字列（分類） 用件・物件名 「契約コードまたは派生コードを選択すると自動的に邸名が入力されます」 ValidateRequired（必須）, FieldCss: field-wide
Status 状態 （標準ラベル）状態 選択肢: 100=発行, 500=申請, 900=決裁, 910=取消（各ステータスに表示色クラス） NoWrap, ExtendedControlCss: code-readonly2
DateA 日付 申請日 DefaultInput: "0"（新規作成時に当日日付が初期値） EditorReadOnly（編集画面では読み取り専用）

上記のほか、GridColumns/EditorColumnHashに現れる ResultId（ID）, Title（タイトル）, Statusのラベル未設定, Comments（コメント）, UpdatedTime（更新日時）はColumns配列に個別定義がなく標準ラベルのまま。

4.1 項目ごとの補足HTML（ExtendedHtmlAfterControl）

列名 色（style/classから読み取れるもの） 内容
ClassA 赤字（class: commentAdd red） 「※物件・案件に対応したエリアを選択すること※」
ClassC 赤字・小フォント（style: color:red; font-size:60%;） 「※自動採番」

5. 作成・更新権限（フィールド単位）

設定 対象列 権限レベル
PermissionForCreating Owner 5
PermissionForUpdating Owner 5

加えて UpdateColumnAccessControls により、Status 列の更新のみ Dept 8・56、Group 19 に限定されている（一般ユーザーはステータスを直接変更できない）。

6. 集計設定（Aggregations）

Id GroupBy Type Target
3 Status 0 （空）
1 ClassA 0 （空）
2 ClassB 0 （空）

Type: 0 は件数集計（Count）と推定される。

7. 他サイト連携（Links / ルックアップ）

7.1 明示的なLinks設定

起点列 参照先SiteId 参照先の値→自コピー先 JsonFormat
ClassD 61259 参照先サイト（61259）の [ClassH] - [ClassJ] - [ClassO] - [ClassP] を検索・選択し、選択レコードの内容をJSON形式でこのサイトの ClassD にコピーする true
ClassE 64583 参照先サイト（64583）を検索し、選択結果をこのサイトの ClassE にコピーする —
ClassE 74927 参照先サイト（74927）を検索し、選択結果をこのサイトの ClassE にコピーする —
ClassE 72434 参照先サイト（72434）を検索し、選択結果をこのサイトの ClassE にコピーする —

※SiteId 61259・64583・74927・72434 はいずれも今回対象の10サイト（稟議承認ワークフロー関連サイト群）には含まれない、別系統の「契約コード」「派生コード」マスタと推測される。

7.2 編集画面のリンク表示（_Links-319015）

EditorColumnHash.General の末尾に _Links-319015 が定義されており、編集画面内に SiteId 319015（新・稟議申請書） の関連レコード一覧が表示される。これはPleasanterの「関連リンク（Links）」ウィジェットであり、319015側のいずれかの項目がこのサイト（160926）のレコードを参照していることを示す（319015のLinks設定は本仕様書の対象外のため、319015側のspec.mdで裏付けを確認すること）。10サイト間の明示的な連携として重要。

7.3 暗黙的なテーブル参照（ServerScripts/Scriptsのハードコード）

クライアントスクリプト scripts/3_03.更新時の処理.js（Script Id: 3）内で、SiteId 319027（事前稟議一覧）が直接ハードコードされている（let targetTable = '319027'; および url = '.../api/items/' + targetTable + '/upsert'）。

  • 動作: レコード更新後（after_send）に自身のAPIデータを取得し直し、Title・Status・Owner・ClassHash・DateHash を、ClassC（稟議コード）をキーとして SiteId 319027 へ upsert（挿入または更新）で複製送信している。
  • これは正式なLinks設定には現れない、稟議コード管理（160926）→事前稟議一覧（319027）への一方向の暗黙的なデータ複製である。
  • このスクリプトにはAPIキーとみられる文字列がソースコード中に2箇所ハードコードされている。値そのものは本書に転記しないが、セキュリティ上の懸念として「気になる点」に記載する。

7.4 ParentId

ParentId: 63543 は今回対象の10サイト（319014/319020/319021/319027/335730/319017/319015/319022/319016/160926）のいずれにも一致しない。稟議コード管理サイトは、これら10サイトとは別の親（フォルダ的な位置づけの外部サイト）の配下に置かれている。

8. プロセス設定（Processes）

定義ファイル: processes.json

Id Name・DisplayName 実行条件（CurrentStatus→ChangedStatus） 動作 成功メッセージ
1 取消 / 取消 100（発行）→ 910（取消） 実行可能者: Dept 8・56, Group 19。実行後、通知（Type1）を送信：宛先 [Owner]、CC [Updator], systemadmin@next-hd.co.jp、件名「発行された稟議コードを取り消しました」 発行された稟議コードを取り消しました

9. スタイル（Styles）

Id Title 適用範囲 ファイル
1 readonly-font130%-bold New, Edit styles/1_readonly-font130%-bold.css
2 取消しグレー表示 Index styles/2_取消しグレー表示.css
3 太字赤文字化 New, Edit, Index styles/3_太字赤文字化.css

概要:

  • Id1: .code-readonly を pointer-events無効・フォント130%・太字にする（読み取り専用に見せるための装飾）。.code-readonly2 も同様にクリック操作を無効化。
  • Id2: .cancelCode クラスの行背景をグレーにする（一覧画面で取消済みレコードを視覚的に区別。ServerScripts Id1と連動）。
  • Id3: マークダウン内の <strong> タグを赤字にする（ガイド文の強調表示を目立たせる）。

10. スクリプト（Scripts）／サーバースクリプト（ServerScripts）

Id Title 適用画面 ファイル
1 稟議コード生成 New scripts/1_稟議コード生成.js
2 編集禁止処理 Edit scripts/2_編集禁止処理.js
3 03.更新時の処理 New, Edit scripts/3_03.更新時の処理.js
Id Title 実行タイミング ファイル
1 取消しグレー表示 BeforeOpeningRow serverscripts/1_取消しグレー表示.js

概要:

  • Scripts Id1（稟議コード生成）: 新規作成送信直前（before_send_Create）に、選択済みの ClassA（エリア）・ClassB（稟議分類）の値をそれぞれ隠し項目 ClassX・ClassY にコピーする（ClassC の自動採番書式 [ClassX][ClassY]-[yy]-[NNNN] の構成要素として使用するため）。また ClassD（契約コード）または ClassE（派生コード）変更時に、他方の入力を無効化した上でAPI経由（$p.apiGet、7.1のLinks設定に基づく参照先サイトを辿る）で関連レコードを取得し、ClassF（用件・物件名）へ自動反映する。
  • Scripts Id2（編集禁止処理）: 編集画面読み込み時（on_editor_load）に ClassA・ClassB（ラジオボタン全選択肢）・ClassC・ClassD・ClassE・ClassF の入力を無効化し、実質的に編集不可（作成後は内容変更させない）状態にする。あわせて外部CDN（cdnjs.cloudflare.com）から toastr.js を読み込み、ClassC（稟議コード）の値をクリップボードにコピーする「Copy」ボタンを追加する。
  • Scripts Id3（03.更新時の処理）: レコード送信後（after_send）に自身のデータをAPIで再取得し、SiteId 319027（事前稟議一覧）へ複製データをupsert送信する。詳細・懸念事項は「7.3 暗黙的なテーブル参照」を参照。ソースコード中にAPIキーらしき文字列がハードコードされている（値は本書に転記しない）。
  • ServerScripts Id1（取消しグレー表示）: 一覧行の表示直前（BeforeOpeningRow）に、Statusが910（取消）であれば ExtendedRowCss に cancelCode を設定し、Styles Id2のCSSと連動して一覧上でグレー表示にする。

11. その他設定

設定 値・状態
NoDisplayIfReadOnly false
HideLink true
AllowCopy false（レコードのコピー作成を禁止）
SectionLatestId 2
GridGuide 設定あり（一覧画面上部に稟議コード発行に関する案内文を表示。発行ミス時の取消手順等）
EditorGuide 設定あり（GridGuideと同内容を編集画面にも表示）
CalendarGuide / CrosstabGuide / GanttGuide / BurnDownGuide / TimeSeriesGuide / AnalyGuide / KambanGuide / ImageLibGuide いずれも未設定
Comments EditorColumnHashに含まれており使用されている（コメント追記時にNotifications設定により通知が飛ぶ）
Notifications（レコードレベル） Type1、Comments列の変更を監視（MonitorChangesColumns）し、コメント追記時に [Owner], somu@eco-ntk.com, k.nogi@next-hd.co.jp 宛（CC: [Updator]、BCC: systemadmin@next-hd.co.jp）に通知

気になる点（レビュー観点）

  • セキュリティ: scripts/3_03.更新時の処理.js（Script Id 3）内にAPIキーとみられる長い16進文字列がソースコード直書きで2箇所存在する。クライアントスクリプトは画面のHTML/JSとしてブラウザに配信されるため、この形での秘匿情報埋め込みは第三者に閲覧され得る状態であり、漏えいリスクが高い。サーバースクリプト側での実行への切り替え、または資格情報の外部管理（環境変数・シークレットストア等）を検討すべき。
  • 保守性: レコードレベルのNotifications設定のCC/宛先に、役職名ではなく個人のメールアドレス（somu@eco-ntk.com, k.nogi@next-hd.co.jp）が直接ハードコードされている。担当者交代時に通知設定の更新漏れが起きるリスクがある。
  • 暗黙的な依存: SiteId 319027（事前稟議一覧）への複製送信がクライアントスクリプトのafter_sendイベントに依存しているため、ブラウザ側でJavaScriptの実行が妨げられた場合（通信エラー・スクリプトエラー等）、319027側にデータが反映されずサイト間の不整合が生じ得る。
  • 権限の偏り: Permissionsにおいて Group 19・User 460 が511（管理者相当）、他は7と、権限レベルの差が大きい。想定通りの設計か要確認。
  • 外部CDN依存: Script Id2で cdnjs.cloudflare.com から toastr.js を都度読み込んでおり、外部サービス障害時にはコピー機能のトースト通知が失敗する可能性がある（機能自体（クリップボードコピー）には支障しない）。
  • ClassE用途の紐付け先が3サイトに分散: ClassE（派生コード）は64583/74927/72434の3サイトを横断検索する設計であり、他の10サイト仕様書と合わせて全体像を確認する際は、この3サイトが「稟議」10サイトの範囲外である点に注意。