feat: PC相談室カルテ集約のドメインモデルを追加

src/domain/aggregates/index.ts

@@ -1,2 +1,3 @@
 export * from "./event";
+export * from "./karte";
 export * from "./member";

src/domain/aggregates/karte/Client.ts

@@ -0,0 +1,37 @@
+import type { Affiliation } from "#domain/shared";
+import type { StudentId } from "#domain/shared";
+
+/** 学生の相談者 */
+type StudentClient = {
+	readonly type: "student";
+	/** 学籍番号 */
+	readonly studentId: StudentId;
+	/** 氏名 */
+	readonly name: string;
+	/** 所属 */
+	readonly affiliation: Affiliation;
+};
+
+/** 教員の相談者 */
+type TeacherClient = {
+	readonly type: "teacher";
+	/** 氏名 */
+	readonly name: string;
+};
+
+/** 職員の相談者 */
+type StaffClient = {
+	readonly type: "staff";
+	/** 氏名 */
+	readonly name: string;
+};
+
+/** その他の相談者（学外者など） */
+type OtherClient = {
+	readonly type: "other";
+	/** 氏名 */
+	readonly name: string;
+};
+
+/** 相談者 — PC相談室に相談を持ち込んだ人 */
+export type Client = StudentClient | TeacherClient | StaffClient | OtherClient;

src/domain/aggregates/karte/Consent.ts

@@ -0,0 +1,12 @@
+/**
+ * 同意事項
+ *
+ * カルテ記録における免責同意と情報公開同意をまとめた値オブジェクト。
+ * カルテは同意なしでも作成できるため、各フィールドはbooleanで表現する。
+ */
+export type Consent = {
+	/** 免責同意 */
+	readonly liabilityConsent: boolean;
+	/** 情報公開同意 */
+	readonly disclosureConsent: boolean;
+};

src/domain/aggregates/karte/Consultation.ts

@@ -0,0 +1,18 @@
+import type { NonEmptyArray } from "#domain/base/NonEmptyArray";
+import type { ConsultationCategory } from "./ConsultationCategory";
+import type { Recorded } from "./Recorded";
+
+/**
+ * 相談事
+ *
+ * 相談者が持ち込んだトラブルの内容をまとめた値オブジェクト。
+ * カテゴリ・対象機器は過去データで未記録の場合がある。
+ */
+export type Consultation = {
+	/** 相談カテゴリ（複数選択可） */
+	readonly categories: Recorded<NonEmptyArray<ConsultationCategory>>;
+	/** 対象機器 */
+	readonly targetDevice: Recorded<string>;
+	/** トラブル詳細 */
+	readonly troubleDetails: string;
+};

src/domain/aggregates/karte/ConsultationCategory.ts

@@ -0,0 +1,62 @@
+/**
+ * 相談カテゴリ — PC相談室で扱うトラブルの分類タグ
+ *
+ * IDと表示名のペアで構成され、追加はできるが削除はできない（履歴整合性のため）。
+ */
+export type ConsultationCategory = {
+	/** カテゴリID */
+	readonly id: ConsultationCategoryId;
+	/** 表示名 */
+	readonly displayName: string;
+};
+
+/** 定義済みカテゴリID */
+export type ConsultationCategoryId =
+	| "wifi_eduroam"
+	| "wifi_success"
+	| "wifi_smartphone"
+	| "usage_mac"
+	| "usage_fs"
+	| "usage_vpn"
+	| "usage_mail"
+	| "usage_gakujo"
+	| "usage_onedrive"
+	| "usage_printer"
+	| "usage_vm"
+	| "usage_ms_software"
+	| "hardware_pc"
+	| "problem_credential"
+	| "problem_windows"
+	| "problem_linux"
+	| "programming"
+	| "rent"
+	| "other";
+
+/** 定義済みカテゴリ一覧 */
+export const CONSULTATION_CATEGORIES: readonly ConsultationCategory[] = [
+	{ id: "wifi_eduroam", displayName: "eduroamに対する接続方法の相談" },
+	{ id: "wifi_success", displayName: "SUCCESSに対する接続方法の相談" },
+	{
+		id: "wifi_smartphone",
+		displayName: "スマホからのWiFi接続方法に関する相談",
+	},
+	{ id: "usage_mac", displayName: "MacOSの使い方に関する相談" },
+	{ id: "usage_fs", displayName: "FSの使い方に関する相談" },
+	{ id: "usage_vpn", displayName: "VPNの使い方に関する相談" },
+	{ id: "usage_mail", displayName: "メールの使い方に関する相談" },
+	{ id: "usage_gakujo", displayName: "学情の使い方に関する相談" },
+	{ id: "usage_onedrive", displayName: "OneDriveの使い方に関する相談" },
+	{ id: "usage_printer", displayName: "プリンタの使い方に関する相談" },
+	{ id: "usage_vm", displayName: "Virtual Machineに関する相談" },
+	{
+		id: "usage_ms_software",
+		displayName: "Microsoftのソフトウェアに関する相談",
+	},
+	{ id: "hardware_pc", displayName: "PCのハードウェアに関する問題の相談" },
+	{ id: "problem_credential", displayName: "資格情報に関する相談" },
+	{ id: "problem_windows", displayName: "Windowsに関する問題" },
+	{ id: "problem_linux", displayName: "Linuxに関する問題" },
+	{ id: "programming", displayName: "プログラミングに関する相談" },
+	{ id: "rent", displayName: "貸し出しに関する相談" },
+	{ id: "other", displayName: "その他の相談" },
+] as const;

src/domain/aggregates/karte/FollowUp.ts

@@ -0,0 +1,7 @@
+/** 後処理 — 相談対応後のアクション */
+export type FollowUp =
+	| "技術部"
+	| "生協"
+	| "情報基盤センター"
+	| "見送り"
+	| "その他";

src/domain/aggregates/karte/Karte.ts

@@ -0,0 +1,184 @@
+import type { NonEmptyArray } from "#domain/base/NonEmptyArray";
+import type { Client } from "./Client";
+import type { Consent } from "./Consent";
+import type { Consultation } from "./Consultation";
+import type { ConsultationCategory } from "./ConsultationCategory";
+import type { FollowUp } from "./FollowUp";
+import type { KarteId } from "./KarteId";
+import { type Recorded, recorded } from "./Recorded";
+import type { Resolution } from "./Resolution";
+import type { SupportRecord } from "./SupportRecord";
+import type { WorkDuration } from "./WorkDuration";
+
+/** 新規作成時の解決ステータス — 後処理は必須 */
+type CompleteResolution =
+	| { readonly type: "resolved" }
+	| {
+			readonly type: "unresolved";
+			readonly followUp: FollowUp;
+	  };
+
+/**
+ * カルテの内容を表す入力型
+ *
+ * create/correctの共通部分。全フィールドが完全に揃った状態を要求する。
+ * Recorded型は使わず、生の値を受け取る。
+ */
+type KarteContentProps = {
+	readonly consultedAt: Date;
+	readonly client: Client;
+	readonly consent: Consent;
+	readonly consultation: {
+		readonly categories: NonEmptyArray<ConsultationCategory>;
+		readonly targetDevice: string;
+		readonly troubleDetails: string;
+	};
+	readonly supportRecord: {
+		readonly assignedMemberIds: NonEmptyArray<string>;
+		readonly content: string;
+		readonly resolution: CompleteResolution;
+		readonly workDuration: WorkDuration;
+	};
+};
+
+/** 新規カルテ作成時の入力型 */
+type KarteCreationProps = KarteContentProps & { readonly id: KarteId };
+
+/** 永続化データからの復元時の入力型 */
+type KarteReconstructProps = {
+	readonly id: KarteId;
+	readonly recordedAt: Date;
+	readonly consultedAt: Recorded<Date>;
+	readonly lastUpdatedAt: Date;
+	readonly client: Recorded<Client>;
+	readonly consent: Consent;
+	readonly consultation: Consultation;
+	readonly supportRecord: SupportRecord;
+};
+
+/**
+ * カルテ集約ルート
+ *
+ * PC相談室での相談記録を表す。
+ * 同意事項・相談事・対応記録という3つのドメイン概念で構成される。
+ * 作成時に全データが揃うイミュータブルな記録であり、
+ * 修正は correct() による明示的な訂正操作のみ許可する。
+ *
+ * 過去データでは一部フィールドが未記録（Recorded型のnotRecorded）の場合がある。
+ * 新規作成時は create() により全フィールドの完全性を保証する。
+ */
+export class Karte {
+	/**
+	 * Dateはミュータブルなため、privateで保持しgetterで防御的コピーを返す。
+	 * readonlyは再代入を防ぐが、Date.setTime()等の破壊的メソッドは防げない。
+	 */
+	private readonly _recordedAt: Date;
+	private readonly _lastUpdatedAt: Date;
+
+	private constructor(
+		public readonly id: KarteId,
+		recordedAt: Date,
+		/** 相談日時 */
+		public readonly consultedAt: Recorded<Date>,
+		lastUpdatedAt: Date,
+		/** 相談者 */
+		public readonly client: Recorded<Client>,
+		/** 同意事項 */
+		public readonly consent: Consent,
+		/** 相談事 */
+		public readonly consultation: Consultation,
+		/** 対応記録 */
+		public readonly supportRecord: SupportRecord,
+	) {
+		this._recordedAt = recordedAt;
+		this._lastUpdatedAt = lastUpdatedAt;
+	}
+
+	/** 記録日時 */
+	get recordedAt(): Date {
+		return new Date(this._recordedAt);
+	}
+
+	/** 最終更新日時 */
+	get lastUpdatedAt(): Date {
+		return new Date(this._lastUpdatedAt);
+	}
+
+	/** 新規カルテの作成 — 全フィールド完全であることを型で保証する */
+	static create(props: KarteCreationProps): Karte {
+		const now = Date.now();
+		return new Karte(
+			props.id,
+			new Date(now),
+			recorded(props.consultedAt),
+			new Date(now),
+			recorded(props.client),
+			props.consent,
+			toConsultation(props),
+			toSupportRecord(props),
+		);
+	}
+
+	/** 永続化データからの復元 — バリデーションなし */
+	static reconstruct(props: KarteReconstructProps): Karte {
+		return new Karte(
+			props.id,
+			props.recordedAt,
+			props.consultedAt,
+			props.lastUpdatedAt,
+			props.client,
+			props.consent,
+			props.consultation,
+			props.supportRecord,
+		);
+	}
+
+	/**
+	 * カルテの訂正
+	 *
+	 * 記録ミスの修正など、既存カルテの内容を訂正した新しいインスタンスを返す。
+	 * recordedAt（元の記録日時）は保持し、lastUpdatedAt を現在時刻に更新する。
+	 * 完全な生の値を受け取り、不変条件は型で保証する。
+	 */
+	correct(props: KarteContentProps): Karte {
+		return new Karte(
+			this.id,
+			this.recordedAt,
+			recorded(props.consultedAt),
+			new Date(),
+			recorded(props.client),
+			props.consent,
+			toConsultation(props),
+			toSupportRecord(props),
+		);
+	}
+}
+
+/** 生の入力から Consultation（Recorded付き）を構築する */
+function toConsultation(props: KarteContentProps): Consultation {
+	return {
+		categories: recorded(props.consultation.categories),
+		targetDevice: recorded(props.consultation.targetDevice),
+		troubleDetails: props.consultation.troubleDetails,
+	};
+}
+
+/** 生の入力から SupportRecord（Recorded付き）を構築する */
+function toSupportRecord(props: KarteContentProps): SupportRecord {
+	return {
+		assignedMemberIds: recorded(props.supportRecord.assignedMemberIds),
+		content: props.supportRecord.content,
+		resolution: recorded(toRecordedResolution(props.supportRecord.resolution)),
+		workDuration: recorded(props.supportRecord.workDuration),
+	};
+}
+
+function toRecordedResolution(complete: CompleteResolution): Resolution {
+	if (complete.type === "resolved") {
+		return { type: "resolved" };
+	}
+	return {
+		type: "unresolved",
+		followUp: recorded(complete.followUp),
+	};
+}

src/domain/aggregates/karte/KarteId.ts

@@ -0,0 +1,6 @@
+/** カルテID — カルテを一意に識別するブランド型 */
+export type KarteId = string & { readonly __brand: unique symbol };
+
+export function karteId(value: string): KarteId {
+	return value as KarteId;
+}

src/domain/aggregates/karte/KarteRepository.ts

@@ -0,0 +1,7 @@
+import type { Karte } from "./Karte";
+import type { KarteId } from "./KarteId";
+
+export interface KarteRepository {
+	findById(id: KarteId): Promise<Karte | null>;
+	save(karte: Karte): Promise<void>;
+}

src/domain/aggregates/karte/Recorded.ts

@@ -0,0 +1,22 @@
+/**
+ * 記録有無を明示する型
+ *
+ * FDM原則に従い、null/undefinedに意味を持たせない。
+ * 過去データで記録されていない可能性があるフィールドに使用する。
+ */
+export type Recorded<T> =
+	| {
+			readonly type: "recorded";
+			readonly value: T;
+	  }
+	| { readonly type: "notRecorded" };
+
+/** 記録済みの値を生成する */
+export function recorded<T>(value: T): Recorded<T> {
+	return { type: "recorded", value };
+}
+
+/** 未記録を生成する */
+export function notRecorded<T>(): Recorded<T> {
+	return { type: "notRecorded" };
+}

src/domain/aggregates/karte/Resolution.ts

@@ -0,0 +1,16 @@
+import type { FollowUp } from "./FollowUp";
+import type { Recorded } from "./Recorded";
+
+/**
+ * 解決ステータス — 相談が解決したかどうか
+ *
+ * 未解決の場合、後処理は過去データでは未記録の場合がある。
+ * FDM原則に従い、Recorded型で明示する。
+ */
+export type Resolution =
+	| { readonly type: "resolved" }
+	| {
+			readonly type: "unresolved";
+			/** 後処理 */
+			readonly followUp: Recorded<FollowUp>;
+	  };