9bbc344137
生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>
237 lines
19 KiB
Markdown
237 lines
19 KiB
Markdown
# サイト仕様書：【部署別】稟議改善（SiteId: 319022）
|
||
|
||
- 取得元データ: [site-319022_latest.json](../siteSettingJsons/site-319022_latest.json)
|
||
- 取得日時: 2026-04-23T08:56:12（サイト更新日時）／設定バージョン `Ver: 4`
|
||
|
||
## 1. サイト基本情報
|
||
|
||
| 項目 | 値 |
|
||
|---|---|
|
||
| TenantId | 1 |
|
||
| Title | 【部署別】稟議改善 |
|
||
| ReferenceType | Results |
|
||
| ParentId | 319014（本システムで管理する10サイトの一つ「新・稟議申請」＝フォルダ型の親サイト） |
|
||
| InheritPermission | 319022（自サイトIDと同一＝権限は親から継承せず自サイトで保持） |
|
||
| Publish | false（外部公開なし） |
|
||
| DisableCrossSearch | false |
|
||
| Creator / Updator | 460 / 460 |
|
||
| CreatedTime | 2025-03-02T19:15:06 |
|
||
| SiteSettings.Version | 1.017 |
|
||
|
||
本サイトは `新・稟議申請`（319014）配下の子サイトであり、`ReferenceType: Results`（通常のレコード表）として稟議改善の取組み内容そのものを保持する実データテーブルである（319014自体はフォルダ型で実データを持たない）。
|
||
|
||
## 2. アクセス権限（Permissions）
|
||
|
||
`Permissions` は `種別,対象ID,権限レベル` の文字列配列で表現されている。権限値はビットフラグの加算方式のため、正確な意味は環境のロール定義に依存する。
|
||
|
||
| 種別 | 対象ID | 権限レベル |
|
||
|---|---|---|
|
||
| Group | 13 | 7 |
|
||
| Group | 27 | 7 |
|
||
| Group | 41 | 7 |
|
||
| User | 460 | 511 |
|
||
| User | 654 | 511 |
|
||
|
||
グループ41は、後述の「4. 項目定義」における`ClassC`（担当役員）の選択肢絞り込み条件、および「8. プロセス設定」の実行権限グループとしても繰り返し登場しており、本サイトにおける「担当役員」ロールを表す組織グループと推測される。
|
||
|
||
## 3. 画面構成
|
||
|
||
### 3.1 一覧画面（GridColumns）
|
||
|
||
| 順番 | 列名（内部） | 表示ラベル |
|
||
|---|---|---|
|
||
| 1 | ResultId | 標準ラベル（未設定） |
|
||
| 2 | Status | 標準ラベル（未設定＝「状態」） |
|
||
| 3 | ClassZ~319016,Class109 | リンク先サイト（319016）のClass109列の値を表示（ラベルは319016側の定義に依存し、本サイトでは未定義） |
|
||
| 4 | ClassZ~319016,Class110 | リンク先サイト（319016）のClass110列の値を表示（同上） |
|
||
| 5 | ClassZ~319016,Class111 | リンク先サイト（319016）のClass111列の値を表示（同上） |
|
||
| 6 | ClassZ~319016,Description110 | リンク先サイト（319016）のDescription110列の値を表示（同上） |
|
||
| 7 | ClassA | 部署 |
|
||
| 8 | TitleBody | 標準ラベル（未設定＝タイトル表示用の合成列） |
|
||
| 9 | Comments | 標準ラベル（未設定＝「コメント」） |
|
||
| 10 | ClassK | 確認者 |
|
||
| 11 | DateL | 全体共有日 |
|
||
| 12 | Updator | 標準ラベル（未設定＝「更新者」） |
|
||
| 13 | UpdatedTime | 標準ラベル（未設定＝「更新日時」） |
|
||
|
||
`ClassZ~319016,Class109` のような `{リンク元列}~{参照先SiteId},{参照先列}` 形式は、リンク列（`ClassZ`）経由で参照先サイト319016の特定列の値をそのままグリッドに表示するPleasanterの記法であり、`SiteSettings.Links` とは別に、319016という他サイトのSiteIdがGridColumns定義に直接埋め込まれている（詳細は7節）。
|
||
|
||
### 3.2 編集画面レイアウト（EditorColumnHash / Sections）
|
||
|
||
`EditorColumnHash.General`（タブ「General」のみ定義）:
|
||
|
||
| 順番 | 項目名（内部名） | ラベル名 |
|
||
|---|---|---|
|
||
| 1 | ResultId | 標準ラベル（未設定） |
|
||
| 2 | Ver | 標準ラベル（未設定） |
|
||
| 3 | Status | 標準ラベル（未設定） |
|
||
| 4 | ClassZ | 稟議 |
|
||
| 5 | Title | 標準ラベル（未設定＝「タイトル」） |
|
||
| 6 | ClassY | 取組み（Hide: true） |
|
||
| 7 | _Section-1 | ―（セクション「稟議改善への部署による取組み」開始） |
|
||
| 8 | ClassA | 部署 |
|
||
| 9 | Owner | 標準ラベル（未設定＝「担当者」） |
|
||
| 10 | ClassC | 担当役員 |
|
||
| 11 | Body | 取組み内容 |
|
||
| 12 | AttachmentsA | 参考資料 |
|
||
| 13 | _Section-3 | ―（セクション「取組みについての議事録 ※必須」開始） |
|
||
| 14 | ClassB | 参加者 |
|
||
| 15 | AttachmentsB | 議事録の要約 |
|
||
| 16 | _Section-2 | ―（セクション「役員確認」開始） |
|
||
| 17 | ClassK | 確認者 |
|
||
| 18 | DateK | 確認日 |
|
||
| 19 | DateL | 全体共有日 |
|
||
| 20 | Comments | 標準ラベル（未設定＝「コメント」） |
|
||
|
||
Sections配列（`SectionLatestId: 3`）:
|
||
|
||
| Id | ラベル | AllowExpand | Expand |
|
||
|---|---|---|---|
|
||
| 1 | 稟議改善への部署による取組み | false | true |
|
||
| 3 | 取組みについての議事録 ※必須 | false | true |
|
||
| 2 | 役員確認 | false | true |
|
||
|
||
Sections配列の並び順（Id 1→3→2）は `EditorColumnHash.General` 内の `_Section-N` の出現順とも一致しており、編集画面上ではID順ではなく「取組み内容」→「議事録」→「役員確認」の業務順に並ぶよう明示的に並び替えられている。
|
||
|
||
### 3.3 タイトル表示（TitleColumns / TitleSeparator）
|
||
|
||
`TitleColumns: ["ClassZ", "ClassA", "ClassY"]` を `TitleSeparator: " "`（半角スペース）で連結。
|
||
|
||
タイトル表示式: `[ClassZ（稟議）] [ClassA（部署）] [ClassY（取組み、既定値「の取組み」・非表示項目）]`
|
||
|
||
`ClassY` は編集画面上では非表示（Hide: true）だが `DefaultInput: "の取組み"` が初期値として自動投入され、タイトル生成時に「〇〇部署の取組み」のような文言を補うための裏方項目として使われていると推測される。
|
||
|
||
## 4. 項目定義（Columns）
|
||
|
||
| 列名（内部） | 種別 | 表示ラベル | 説明・入力ガイド | 備考 |
|
||
|---|---|---|---|---|
|
||
| ClassA | 文字列（分類） | 部署 | ― | `ChoicesText: [[Depts]]`（部署マスタ選択）、`DefaultInput: [[Self]]`（自分の所属部署を初期値）、`ExtendedControlCss: code-readonly2`（後述スタイルにより見た目上ロック）、`SearchType: PartialMatch` |
|
||
| Owner | ユーザー選択 | 標準ラベル（未設定＝「担当者」） | ― | `ExtendedControlCss: code-readonly2` |
|
||
| Body | 説明（本文・複数行文字列） | 取組み内容 | この稟議を今後起こさないようにするための取組内容。または取組へのアイディア、指摘など。 | `ExtendedFieldCss` / `ExtendedControlCss: textarea-sizing`（後述スタイルでテキストエリアを自動拡張） |
|
||
| ClassZ | 文字列（分類）＋リンク | 稟議 | ― | `ChoicesText: [[319016]]`（319016サイトのレコードから選択）、`Link: true`、`ValidateRequired: true`（必須）、`FieldCss: field-wide`、`UseSearch: true`、`SearchType: PartialMatch` |
|
||
| ResultId | 自動採番ID | 標準ラベル（未設定） | ― | `Hide: true` |
|
||
| Ver | システム標準項目（バージョン番号） | 標準ラベル（未設定） | ― | `Hide: true` |
|
||
| ClassY | 文字列（分類） | 取組み | ― | `DefaultInput: "の取組み"`、`Hide: true`（3.3節の通りタイトル合成用の裏方項目） |
|
||
| ClassB | 文字列（分類・複数選択） | 参加者 | ― | `ChoicesText: [[Users*]]`（ユーザー一覧から選択）、`MultipleSelections: true`、`UseSearch: true`、`FieldCss: field-wide` |
|
||
| AttachmentsA | 添付ファイル | 参考資料 | ― | ― |
|
||
| ClassK | 文字列（分類） | 確認者 | ― | `ChoicesText: [[Users*]]`、`ExtendedFieldCss` / `ExtendedControlCss: code-readonly2`、`GridDesign: [ClassK]\n[DateK]`（グリッド内で改行表示）、`SearchType: PartialMatch` |
|
||
| DateK | 日付 | 確認日 | ― | `EditorFormat: Ymdhms`（日時形式）、`ExtendedFieldCss` / `ExtendedControlCss: code-readonly2` |
|
||
| Status | 状態 | 標準ラベル（未設定＝「状態」） | ― | `ExtendedFieldCss` / `ExtendedControlCss: code-readonly2`。選択肢は下記の通り |
|
||
| ClassC | 文字列（分類） | 担当役員 | ― | `ChoicesText` はUsersテーブルへの絞り込みビュー定義（グループ41かつ有効ユーザーのみ、UserId昇順）、`ValidateRequired: true`（必須）、`SearchType: PartialMatch` |
|
||
| DateL | 日付 | 全体共有日 | ― | `EditorFormat: Ymdhms`、`NoWrap: true`、`ExtendedFieldCss` / `ExtendedControlCss: code-readonly2` |
|
||
| AttachmentsB | 添付ファイル | 議事録の要約 | ― | ― |
|
||
|
||
`Status` の選択肢（`ChoicesText`）:
|
||
|
||
| 値 | 表示名（一覧） | 表示名（短縮） | CSSクラス |
|
||
|---|---|---|---|
|
||
| 100 | 新規登録 | 新規 | status-new |
|
||
| 150 | 登録完了 | 完了 | status-yellow |
|
||
| 800 | 役員確認済み | 確認済 | status-purple |
|
||
| 900 | 全体共有済み | 共有済 | status-closed |
|
||
|
||
`Title` / `Comments` は `Columns` 配列に個別定義が無く、EditorColumnHash上でのみ使用される標準項目（ラベル未カスタマイズ）。
|
||
|
||
### 4.1 項目ごとの補足HTML（ExtendedHtmlAfterControl）
|
||
|
||
該当項目が存在しないため、この節は省略する。
|
||
|
||
## 5. 作成・更新権限（フィールド単位）
|
||
|
||
`PermissionForCreating` / `PermissionForUpdating` はいずれも同一の3項目に権限値4が設定されている。
|
||
|
||
| 列名（内部） | 表示ラベル | PermissionForCreating | PermissionForUpdating |
|
||
|---|---|---|---|
|
||
| ClassA | 部署 | 4 | 4 |
|
||
| Owner | 標準ラベル（担当者） | 4 | 4 |
|
||
| ClassB | 参加者 | 4 | 4 |
|
||
|
||
## 6. 集計設定（Aggregations）
|
||
|
||
| Id | GroupBy | Type | Target |
|
||
|---|---|---|---|
|
||
| 1 | ClassA（部署） | 0 | ―（未指定） |
|
||
|
||
`Target` が空のため、部署（ClassA）ごとの件数集計（Type: 0）と推測される。
|
||
|
||
## 7. 他サイト連携（Links / ルックアップ）
|
||
|
||
`SiteSettings.Links` に以下2件が定義されている。
|
||
|
||
| 起点列 | 参照先SiteId | 参照先の値→自コピー先 | JsonFormat |
|
||
|---|---|---|---|
|
||
| ClassZ | 319016（【ISO】稟議管理） | 319016のレコードをClassZ列でリンク選択（コピーではなく参照リンク） | ― |
|
||
| ClassC | 0（Usersマスタ、10サイトの対象外） | Usersテーブルをグループ41・有効ユーザーに絞り込んだビューから担当役員を選択 | true |
|
||
|
||
- **ClassZ→319016**: 「稟議」列（ClassZ）は【ISO】稟議管理（319016）のレコードを選択するリンク項目。3.1節のGridColumns（`ClassZ~319016,Class109` 等）は、このリンクを介して319016側の複数列（Class109, Class110, Class111, Description110）の値を一覧画面に直接表示しており、正式なLinks設定（ClassZ→319016）と組み合わせて機能する。
|
||
- **ClassC→Usersマスタ**: `SiteId: 0` はPleasanter予約のUsersマスタを指し、本システムで管理する10サイトの対象外。担当役員の選択肢をグループ41に絞り込むための設定であり、他サイトとのデータ連携ではない。
|
||
|
||
### 暗黙的なテーブル参照（ハードコードSiteId）の確認結果
|
||
|
||
- `manifest.json` の通り `ServerScripts` は0件であり、サーバースクリプトによる `items.Get(SiteId)` 等の暗黙参照は存在しない。
|
||
- クライアントスクリプト（`scripts/1_新規作成時子テーブルに留まる.js`）の内容を確認したが、他SiteIdのハードコード参照は無い。新規作成後のレスポンスからレコードIDを取得し、`items/{id}` へ遷移するのみで、他サイトを直接参照するコードではない。
|
||
- 上記のとおり、他サイト参照は `SiteSettings.Links`（ClassZ→319016）およびGridColumns内の `ClassZ~319016,...` 記法のみであり、いずれも正式な設定として現れている（Scripts/ServerScriptsでの隠れた参照は無し）。
|
||
|
||
### サイトツリー上の位置関係（ParentId）
|
||
|
||
本サイト（319022）の `ParentId` は 319014（新・稟議申請）。319014は本システムで管理する10サイトの一つで、実データを持たないフォルダ型サイトであり、319022はその配下の子サイトの一つ（他に319015・319016・319017も319014配下）として位置づけられる。
|
||
|
||
## 8. プロセス設定（Processes）
|
||
|
||
定義ファイル: [processes.json](../configs/site-319022_【部署別】稟議改善/processes.json)
|
||
|
||
| Id | Name / DisplayName | 実行条件（CurrentStatus→ChangedStatus） | 動作 | 成功メッセージ（ConfirmationMessage） |
|
||
|---|---|---|---|---|
|
||
| 1 | 登録完了 | 100（新規登録）→150（登録完了） | Body・AttachmentsB必須入力チェック後にステータス変更。通知あり（宛先: ClassC, Owner, ClassB／CC: toyokura@next-hd.co.jp, systemadmin@next-hd.co.jp） | 稟議への取組み内容の確認を依頼します。宜しいですか？ |
|
||
| 2 | 確認完了 | 150（登録完了）→800（役員確認済み） | Body必須入力チェック後、グループ41のみ実行可。DateK（確認日）＝実行時刻、ClassK（確認者）＝実行ユーザーを自動セット。通知あり（宛先同上） | 稟議改善への取組内容の確認を完了します。宜しいですか？ |
|
||
| 3 | 全体共有 | 800（役員確認済み）→900（全体共有済み） | DateL（全体共有日）＝実行時刻を自動セット。`View.Own: true` | この取組みを全体へ共有しました。 |
|
||
| 4 | 差戻し | -1（任意の状態）→100（新規登録） | グループ19・41のみ実行可。ステータスを新規登録に戻す | 差戻します。宜しいですか？ |
|
||
|
||
Process 1・2の通知メール（`Notifications`）は、稟議対象（ClassZ）・部署（ClassA）・参加者（ClassB）・取組み内容（Body）・担当役員/確認者・確認日等を本文に埋め込んだテンプレートで、宛先に固定のCCアドレス（toyokura@next-hd.co.jp, systemadmin@next-hd.co.jp）がハードコードされている。
|
||
|
||
## 9. スタイル（Styles）
|
||
|
||
| Id | Title | 適用範囲 | ファイル |
|
||
|---|---|---|---|
|
||
| 1 | 読み取り専用 | New, Edit | [1_読み取り専用.css](../configs/site-319022_【部署別】稟議改善/styles/1_読み取り専用.css) |
|
||
| 2 | 基本的なスタイル | New, Edit | [2_基本的なスタイル.css](../configs/site-319022_【部署別】稟議改善/styles/2_基本的なスタイル.css) |
|
||
| 3 | ガイド欄 | All | [3_ガイド欄.css](../configs/site-319022_【部署別】稟議改善/styles/3_ガイド欄.css) |
|
||
|
||
- Style 1「読み取り専用」: `.code-readonly` / `.code-readonly2` クラスに `pointer-events: none` と背景色・太字を適用し、対象コントロールをクリック不可（視覚的に読み取り専用）にする。4節で `ExtendedControlCss: code-readonly2` が指定されているClassA・Owner・ClassK・DateK・Status・DateLに適用される。
|
||
- Style 2「基本的なスタイル」: セクション見出しの拡大、`.textarea-sizing`（Body用テキストエリアの自動拡張）、`.field-normal` / `.field-wide` の行間・余白調整。
|
||
- Style 3「ガイド欄」: `#Guide` 内の `strong` / `h3` 要素を赤字にする（全画面適用）。GridGuide/EditorGuideの強調表示に対応。
|
||
|
||
## 10. スクリプト（Scripts）／サーバースクリプト（ServerScripts）
|
||
|
||
| Id | Title | 適用画面 | ファイル |
|
||
|---|---|---|---|
|
||
| 1 | 新規作成時子テーブルに留まる | New | [1_新規作成時子テーブルに留まる.js](../configs/site-319022_【部署別】稟議改善/scripts/1_新規作成時子テーブルに留まる.js) |
|
||
|
||
概要: 新規レコード作成完了後（`after_set_Create`）イベントで、通常の画面遷移（一覧への遷移等）を上書きし、APIレスポンスから新規作成レコードのIDを取得して `items/{id}` のURLへ直接遷移させるスクリプト。ParentId=319014配下の子サイトとして親レコードに紐づく形で開かれる運用を想定し、作成後もそのレコードの詳細画面（＝子テーブルのコンテキスト）に留まらせるための実装と推測される。他SiteIdのハードコード参照は無い。
|
||
|
||
`ServerScripts` は0件（`manifest.json` の `ServerScripts: []` の通り）。
|
||
|
||
## 11. その他設定
|
||
|
||
| 項目 | 値 |
|
||
|---|---|
|
||
| NoDisplayIfReadOnly | false |
|
||
| HideLink | 未設定（キー自体が存在しない） |
|
||
| SectionLatestId | 3 |
|
||
| AllowCopy | false |
|
||
| GridGuide | 設定あり（Markdown）。[GridGuide.html](../configs/site-319022_【部署別】稟議改善/html/GridGuide.html) |
|
||
| EditorGuide | 設定あり（GridGuideと同一内容）。[EditorGuide.html](../configs/site-319022_【部署別】稟議改善/html/EditorGuide.html) |
|
||
| CalendarGuide / CrosstabGuide / GanttGuide / BurnDownGuide / TimeSeriesGuide / AnalyGuide / KambanGuide / ImageLibGuide | いずれも空文字列（未設定） |
|
||
| Comments | `Data.Comments` は空配列 `[]`（コメント投稿実績なし）。編集画面には`Comments`欄が配置されており使用は可能 |
|
||
| StatusControls | Id1「読取り専用」：`Status: -1`（ワイルドカード）かつ`ColumnFilterHash.Status: ["800","900"]`の条件でBody・Owner・ClassA・ClassB・ClassC・ClassZをReadOnly化。役員確認済み（800）・全体共有済み（900）到達後は主要項目を編集不可にする実質的な確定ロック |
|
||
|
||
---
|
||
|
||
## 気になる点（レビュー観点）
|
||
|
||
- 4節・9節の`code-readonly2`はCSSの`pointer-events: none`のみによる見た目上のロックであり、Pleasanterの正式な項目単位アクセス権限（フィールドレベルパーミッション）による制御ではない。API経由の直接更新など、UIを介さない操作では制限されない可能性があり、真に確定させたい項目は11節の`StatusControls`（Status 800/900でReadOnly化）と役割分担されているかを確認したほうがよい。
|
||
- Process 1・2の通知CCアドレスに `toyokura@next-hd.co.jp` という特定個人のメールアドレスがハードコードされている。組織変更・退職時にメンテナンスが漏れるリスクがあるため、グループ宛先やロールベースの宛先に置き換えられないか要検討（機密情報ではないが運用上の懸念点）。
|
||
- Process 4「差戻し」は`CurrentStatus: -1`（任意の状態から実行可能）となっており、`ChangedStatus: 100`に戻す強い操作。グループ19・41に限定されてはいるが、900（全体共有済み）からもワンクリックで差戻せてしまう点は意図した仕様か確認したい。
|
||
- 3.1節のGridColumns内`ClassZ~319016,ClassNNN`が参照する319016側の列（Class109/110/111, Description110）のラベル名は本サイトのJSONからは分からない。319016（【ISO】稟議管理）の仕様書と突き合わせての確認を推奨する。
|
||
- `ClassC`（担当役員）の選択肢はグループ41ユーザーに絞り込まれているが、`Permissions`のグループ41にも編集権限(7)が付与されており、Process 2「確認完了」の実行権限もグループ41限定と一致している。設計として一貫しているが、グループ41のメンバー管理（人事異動時の更新）が本サイトの正しい運用に直結する点は留意事項として記載しておく。
|