ドキュメント トップ / json / staff
使い方ローカル前処理エンジンログイン / プランレビュアーポートフォリオ最適化マスタ整合性レビューCPOS 連携 (PAT)JSON 形式データ取扱方針デプロイCLI技術

staff.json — 職員・資格・常勤換算

事業所の職員(および外部有資格者)情報を扱う JSON。加算要件の配置判定(OR 条件・代替資格)に使う。

目的

いつ使うか

必須フィールド

パス 説明
_meta.schema string "staff"
office_code string 事業所コード
service_key string サービスキー
staff[] array 職員リスト(少なくとも 1 件)

staff[] の各要素:

パス 説明
staff_id string 匿名 ID(STAFF-001 推奨)
role string kango / kaigo / saseki / cm / shunin_cm / kinou_kunren / rihabilitation
qualifications[] string "看護師", "介護福祉士", "理学療法士"
fte number 常勤換算(例: 1.0 = 常勤、0.5 = 半常勤)
active boolean 在籍中かどうか

よく使う任意フィールド

パス 説明
is_joukin boolean 常勤かどうか
display_label string 画面表示用の匿名ラベル(架空職員A
kinzoku_years number 勤続年数(処遇改善加算等に使用)
senjuu boolean 専従かどうか
note string 補足(資格証エビデンスへの参照名など)

サンプル

{
  "_meta": {
    "schema": "staff",
    "schema_version": "1.0",
    "office_code": "DEMO-0004",
    "tenant_id": "cpos-default",
    "updated": "2026-05-07"
  },
  "service_key": "tsusho_kaigo",
  "sample_policy": "public_demo_synthetic",
  "staff": [
    {
      "staff_id": "STAFF-001",
      "display_label": "架空職員A",
      "role": "kango",
      "qualifications": ["看護師"],
      "fte": 1.0,
      "active": true,
      "is_joukin": true
    },
    {
      "staff_id": "STAFF-002",
      "display_label": "外部PT",
      "role": "kinou_kunren",
      "qualifications": ["理学療法士"],
      "fte": 0.2,
      "active": true,
      "is_joukin": false,
      "note": "外部 PT。機能訓練指導員 OR 条件を満たす"
    }
  ]
}

個人情報

安全策

サーバ側 dsl.buildFactsFromStaffDatasample_policy === 'public_demo_synthetic' でない場合に空ファクトを返します。これは「個人情報が含まれている可能性のあるファイル」を機械的にブロックするフェイルセーフです。

公開デモ・他社共有用には必ず "sample_policy": "public_demo_synthetic" を入れてください。

バリデーション

npm run validate:json -- --kind staff --input path/to/staff.json

スキーマ: staff.schema.json

CPOS から自動生成される場合のマッピング

CPOS の analysis-source を取り込むと、staffSummary.qualifiedPersonCountByProfessionfteByProfession から 合成 staff[] が自動生成されます。

CPOS staff.json
qualifiedPersonCountByProfession.nurse: 3 staff[]role=kango, qualifications=[看護師] × 3
fteByProfession.nurse: 2.4 fte=0.8(=2.4/3)
qualifiedPersonCountByProfession.physical_therapist: 1 role=rihabilitation, qualifications=[理学療法士]

詳しくは app/src/services/cpos/transform.jstransformStaffSummary() を参照。

よくあるエラー

エラー 対処
staff[] が空 1 件以上は必要
role 値違反 既定値(kango/kaigo/...)を使う
fte が文字列 数値で書く
個別資格名のスペル違い "看護師", "介護福祉士" の正字を使う

このドキュメントはリポジトリ docs/ 配下の Markdown を配信しています。