PJR-S64H 用語集 gl-common に記帳と起票を加える
1. 概要
起票(1 件の項目を新しく作ること)と記帳(起票・状態遷移・結論の記録・commit を含む、台帳への書き込み全般。register の Waza としての呼び名)の使い分けを、用語集 gl-common に定義する
2. 完了条件
docs/ja/product/010-business-specs/060-glossary/gl-common.yamlに次の 2 語を加えている。id 用語 englishName 定義 relatedTerms tm-filing起票 filing登録簿に 1 件の項目を新しく作ること。 register addに当たるtm-register、tm-record-keepingtm-record-keeping記帳 record-keeping登録簿へ書き込むこと全般。起票、状態遷移、結論の記録、commit を含む。 registerの技(Waza)としての呼び名でもあるtm-register、tm-filing起票が記帳の一部であることが、定義または
notesから読み取れる。記帳の定義が、prj-0001:pjr-9g9y-practice-execution-terminology と PJR-34F2 で決まった技の名前と矛盾しない(specdojo:specdojo-overview-guide の「
registerを『記帳』と呼びます」)。relatedTermsとcategoryが用語集の中の ID を指す(PJR-CF15 の検証が通る)。用語集の schema の検証(
npm run validate:schema)とnpm run lint:mdが通る。
3. 作業内容
| No | 作業 | 担当 | 状態 | メモ |
|---|---|---|---|---|
| 1 | 2 語を gl-common.yaml に加えて検証する | BA | done | tm-filing(起票)と tm-record-keeping(記帳)の 2 語を追加済み |
4. 対応結果
docs/ja/product/010-business-specs/060-glossary/gl-common.yamlにtm-filing(起票 /filing)とtm-record-keeping(記帳 /record-keeping)の 2 語を追加した。tm-filingは「登録簿に 1 件の項目を新しく作ること。register addに当たる」と定義し、notesで「記帳の一部」であることを明記。tm-record-keepingは「起票・状態遷移・結論の記録・commit を含む登録簿への書き込み全般」と定義し、「register の技(Waza)としての呼び名でもある」と明記した。- 起票が記帳の一部であることは、両方の
definitionに加えてnotes(tm-filing: 「起票は必ず記帳に含まれる」、tm-record-keeping: 「起票は記帳の一部」)から読み取れる。 - specdojo:specdojo-overview-guide の『register を「記帳」と呼びます』と矛盾しないよう、
tm-record-keepingのnotesにその文言の一致を明記した。 categoryは両方ともtm-exec-log(実行記録)に指定し、relatedTermsはtm-registerと互い。これらはgl-common.yaml内の既存 ID を指すため、PJR-CF15 の relatedTerms・category 検証(validate:schemaのglossary-references)の対象を満たす。npx prettier --writeは変更なし(既存スタイルと一致)を通せた。
5. 関連ドキュメント
- [[prj-0002:pjr-hepk-lp-content]]: 記帳と起票の使い分けが問われた LP の項目。
- prj-0001:pjr-9g9y-practice-execution-terminology: 体系の用語の決定。
- prj-0001:pjr-qd81-gl-common: 用語集 gl-common を作成した項目。