create-einja-app 0.1.1

package/templates/turborepo-pandacss/packages/server-core/src/domain/entities/User.test.ts

@@ -0,0 +1,232 @@
+import { beforeAll, describe, expect, it } from "vitest";
+import { UserFactory, initialize } from "../../testing";
+import { User, type UserProps } from "./User";
+
+describe("User Entity", () => {
+	beforeAll(() => {
+		// ドメインエンティティのテストではPrismaクライアントは使用しないため、空のオブジェクトを渡す
+		// biome-ignore lint/suspicious/noExplicitAny: test fixture initialization
+		initialize({ prisma: {} as any });
+	});
+
+	describe("constructor", () => {
+		it("有効なプロパティでエンティティが生成される", async () => {
+			// Given
+			const props = await UserFactory.build();
+
+			// When
+			const user = new User(props);
+
+			// Then
+			expect(user.id).toBeDefined();
+			expect(user.email).toBeDefined();
+			expect(user.name).toBeDefined();
+			expect(user.status).toBeDefined();
+			expect(user.role).toBeDefined();
+			expect(user.createdAt).toBeInstanceOf(Date);
+			expect(user.lastLogin).toBeInstanceOf(Date);
+		});
+
+		it("nameがnullでもエンティティが生成される", async () => {
+			// Given
+			const props = await UserFactory.build({ name: null });
+
+			// When
+			const user = new User(props);
+
+			// Then
+			expect(user.name).toBeNull();
+		});
+
+		it("lastLoginがnullでもエンティティが生成される", async () => {
+			// Given
+			const props = await UserFactory.build({ lastLogin: null });
+
+			// When
+			const user = new User(props);
+
+			// Then
+			expect(user.lastLogin).toBeNull();
+		});
+
+		it("全てのstatus値でエンティティが生成される", async () => {
+			// Given & When & Then
+			const statuses = ["active", "inactive", "pending"] as const;
+			for (const status of statuses) {
+				const props = await UserFactory.build({ status });
+				const user = new User(props);
+				expect(user.status).toBe(status);
+			}
+		});
+
+		it("全てのrole値でエンティティが生成される", async () => {
+			// Given & When & Then
+			const roles = ["admin", "user", "moderator"] as const;
+			for (const role of roles) {
+				const props = await UserFactory.build({ role });
+				const user = new User(props);
+				expect(user.role).toBe(role);
+			}
+		});
+	});
+
+	describe("withLastLogin", () => {
+		it("最終ログイン日時を更新した新しいインスタンスを返す", async () => {
+			// Given
+			const props = await UserFactory.build({ lastLogin: null });
+			const originalUser = new User(props);
+			const newLoginTime = new Date("2025-01-03T12:00:00Z");
+
+			// When
+			const updatedUser = originalUser.withLastLogin(newLoginTime);
+
+			// Then
+			expect(updatedUser.lastLogin).toEqual(newLoginTime);
+			expect(updatedUser).not.toBe(originalUser);
+		});
+
+		it("元のインスタンスは変更されない（イミュータビリティ）", async () => {
+			// Given
+			const originalLastLogin = new Date("2025-01-02T00:00:00Z");
+			const props = await UserFactory.build({ lastLogin: originalLastLogin });
+			const originalUser = new User(props);
+			const newLoginTime = new Date("2025-01-03T12:00:00Z");
+
+			// When
+			originalUser.withLastLogin(newLoginTime);
+
+			// Then
+			expect(originalUser.lastLogin).toEqual(originalLastLogin);
+		});
+
+		it("他のプロパティは維持される", async () => {
+			// Given
+			const props = await UserFactory.build();
+			const originalUser = new User(props);
+			const newLoginTime = new Date("2025-01-03T12:00:00Z");
+
+			// When
+			const updatedUser = originalUser.withLastLogin(newLoginTime);
+
+			// Then
+			expect(updatedUser.id).toBe(originalUser.id);
+			expect(updatedUser.email).toBe(originalUser.email);
+			expect(updatedUser.name).toBe(originalUser.name);
+			expect(updatedUser.status).toBe(originalUser.status);
+			expect(updatedUser.role).toBe(originalUser.role);
+			expect(updatedUser.createdAt).toEqual(originalUser.createdAt);
+		});
+	});
+
+	describe("withStatus", () => {
+		it("ステータスを更新した新しいインスタンスを返す", async () => {
+			// Given
+			const props = await UserFactory.build({ status: "pending" });
+			const originalUser = new User(props);
+
+			// When
+			const updatedUser = originalUser.withStatus("active");
+
+			// Then
+			expect(updatedUser.status).toBe("active");
+			expect(updatedUser).not.toBe(originalUser);
+		});
+
+		it("元のインスタンスは変更されない（イミュータビリティ）", async () => {
+			// Given
+			const props = await UserFactory.build({ status: "pending" });
+			const originalUser = new User(props);
+
+			// When
+			originalUser.withStatus("active");
+
+			// Then
+			expect(originalUser.status).toBe("pending");
+		});
+	});
+
+	describe("withRole", () => {
+		it("ロールを更新した新しいインスタンスを返す", async () => {
+			// Given
+			const props = await UserFactory.build({ role: "user" });
+			const originalUser = new User(props);
+
+			// When
+			const updatedUser = originalUser.withRole("admin");
+
+			// Then
+			expect(updatedUser.role).toBe("admin");
+			expect(updatedUser).not.toBe(originalUser);
+		});
+
+		it("元のインスタンスは変更されない（イミュータビリティ）", async () => {
+			// Given
+			const props = await UserFactory.build({ role: "user" });
+			const originalUser = new User(props);
+
+			// When
+			originalUser.withRole("admin");
+
+			// Then
+			expect(originalUser.role).toBe("user");
+		});
+	});
+
+	describe("isActive", () => {
+		it("statusがactiveの場合、trueを返す", async () => {
+			// Given
+			const props = await UserFactory.build({ status: "active" });
+			const user = new User(props);
+
+			// When & Then
+			expect(user.isActive()).toBe(true);
+		});
+
+		it("statusがinactiveの場合、falseを返す", async () => {
+			// Given
+			const props = await UserFactory.build({ status: "inactive" });
+			const user = new User(props);
+
+			// When & Then
+			expect(user.isActive()).toBe(false);
+		});
+
+		it("statusがpendingの場合、falseを返す", async () => {
+			// Given
+			const props = await UserFactory.build({ status: "pending" });
+			const user = new User(props);
+
+			// When & Then
+			expect(user.isActive()).toBe(false);
+		});
+	});
+
+	describe("isAdmin", () => {
+		it("roleがadminの場合、trueを返す", async () => {
+			// Given
+			const props = await UserFactory.build({ role: "admin" });
+			const user = new User(props);
+
+			// When & Then
+			expect(user.isAdmin()).toBe(true);
+		});
+
+		it("roleがuserの場合、falseを返す", async () => {
+			// Given
+			const props = await UserFactory.build({ role: "user" });
+			const user = new User(props);
+
+			// When & Then
+			expect(user.isAdmin()).toBe(false);
+		});
+
+		it("roleがmoderatorの場合、falseを返す", async () => {
+			// Given
+			const props = await UserFactory.build({ role: "moderator" });
+			const user = new User(props);
+
+			// When & Then
+			expect(user.isAdmin()).toBe(false);
+		});
+	});
+});

package/templates/turborepo-pandacss/packages/server-core/src/domain/entities/User.ts

@@ -0,0 +1,105 @@
+/**
+ * User Entity
+ *
+ * ドメイン層のユーザーエンティティ。
+ * Prismaモデルから独立したドメインオブジェクトとして定義。
+ */
+
+export type UserStatus = "active" | "inactive" | "pending";
+
+export type UserRole = "admin" | "user" | "moderator";
+
+export interface UserProps {
+	readonly id: string;
+	readonly email: string;
+	readonly name: string | null;
+	readonly status: UserStatus;
+	readonly role: UserRole;
+	readonly createdAt: Date;
+	readonly lastLogin: Date | null;
+}
+
+/**
+ * ユーザーエンティティ
+ *
+ * イミュータブルなドメインオブジェクト。
+ * 状態変更は新しいインスタンスを生成することで行う。
+ */
+export class User {
+	readonly id: string;
+	readonly email: string;
+	readonly name: string | null;
+	readonly status: UserStatus;
+	readonly role: UserRole;
+	readonly createdAt: Date;
+	readonly lastLogin: Date | null;
+
+	constructor(props: UserProps) {
+		this.id = props.id;
+		this.email = props.email;
+		this.name = props.name;
+		this.status = props.status;
+		this.role = props.role;
+		this.createdAt = props.createdAt;
+		this.lastLogin = props.lastLogin;
+	}
+
+	/**
+	 * 最終ログイン日時を更新した新しいUserインスタンスを返す
+	 */
+	withLastLogin(loginTime: Date): User {
+		return new User({
+			id: this.id,
+			email: this.email,
+			name: this.name,
+			status: this.status,
+			role: this.role,
+			createdAt: this.createdAt,
+			lastLogin: loginTime,
+		});
+	}
+
+	/**
+	 * ステータスを更新した新しいUserインスタンスを返す
+	 */
+	withStatus(status: UserStatus): User {
+		return new User({
+			id: this.id,
+			email: this.email,
+			name: this.name,
+			status,
+			role: this.role,
+			createdAt: this.createdAt,
+			lastLogin: this.lastLogin,
+		});
+	}
+
+	/**
+	 * ロールを更新した新しいUserインスタンスを返す
+	 */
+	withRole(role: UserRole): User {
+		return new User({
+			id: this.id,
+			email: this.email,
+			name: this.name,
+			status: this.status,
+			role,
+			createdAt: this.createdAt,
+			lastLogin: this.lastLogin,
+		});
+	}
+
+	/**
+	 * アクティブなユーザーかどうか
+	 */
+	isActive(): boolean {
+		return this.status === "active";
+	}
+
+	/**
+	 * 管理者かどうか
+	 */
+	isAdmin(): boolean {
+		return this.role === "admin";
+	}
+}

package/templates/turborepo-pandacss/packages/server-core/src/domain/repository-interfaces/IUserRepository.ts

@@ -0,0 +1,101 @@
+/**
+ * IUserRepository
+ *
+ * ユーザーリポジトリのインターフェース。
+ * Domain層で定義し、Infrastructure層で実装する。
+ */
+
+import type { Result } from "../../core/result";
+import type { User, UserRole, UserStatus } from "../entities/User";
+
+/**
+ * ユーザー検索条件
+ */
+export interface UserSearchCriteria {
+	/** ユーザーID */
+	readonly id?: string;
+	/** メールアドレス */
+	readonly email?: string;
+	/** ステータス */
+	readonly status?: UserStatus;
+	/** ロール */
+	readonly role?: UserRole;
+	/** 検索テキスト（名前やメールアドレスに対する部分一致） */
+	readonly search?: string;
+}
+
+/**
+ * ページネーションオプション
+ */
+export interface PaginationOptions {
+	/** ページ番号（1始まり） */
+	readonly page?: number;
+	/** 1ページあたりの件数 */
+	readonly limit?: number;
+}
+
+/**
+ * ページネーション付きの結果
+ */
+export interface PaginatedResult<T> {
+	/** 結果アイテム */
+	readonly items: readonly T[];
+	/** 総件数 */
+	readonly total: number;
+	/** 現在のページ番号 */
+	readonly page: number;
+	/** 1ページあたりの件数 */
+	readonly limit: number;
+	/** 総ページ数 */
+	readonly totalPages: number;
+}
+
+/**
+ * ユーザーリポジトリインターフェース
+ */
+export interface IUserRepository {
+	/**
+	 * 検索条件に基づいてユーザーを検索する
+	 *
+	 * @param criteria - 検索条件
+	 * @param pagination - ページネーションオプション
+	 * @returns ページネーション付きのユーザーリスト
+	 */
+	search(
+		criteria: UserSearchCriteria,
+		pagination?: PaginationOptions,
+	): Promise<Result<PaginatedResult<User>, Error>>;
+
+	/**
+	 * 検索条件に一致する単一のユーザーを取得する
+	 *
+	 * @param criteria - 検索条件
+	 * @returns 見つかったユーザー、または見つからない場合はnull
+	 */
+	find(criteria: UserSearchCriteria): Promise<Result<User | null, Error>>;
+
+	/**
+	 * IDでユーザーを取得する
+	 *
+	 * @param id - ユーザーID
+	 * @returns 見つかったユーザー、または見つからない場合はnull
+	 */
+	findById(id: string): Promise<Result<User | null, Error>>;
+
+	/**
+	 * メールアドレスでユーザーを取得する
+	 *
+	 * @param email - メールアドレス
+	 * @returns 見つかったユーザー、または見つからない場合はnull
+	 */
+	findByEmail(email: string): Promise<Result<User | null, Error>>;
+
+	/**
+	 * ユーザーの最終ログイン日時を更新する
+	 *
+	 * @param id - ユーザーID
+	 * @param loginTime - ログイン日時
+	 * @returns 成功時はvoid、失敗時はエラー
+	 */
+	updateLastLogin(id: string, loginTime: Date): Promise<Result<void, Error>>;
+}

package/templates/turborepo-pandacss/packages/server-core/src/infrastructure/database/client.ts

@@ -0,0 +1,15 @@
+import { PrismaClient } from "@prisma/client";
+
+const globalForPrisma = globalThis as unknown as {
+	prisma: PrismaClient | undefined;
+};
+
+export const prisma =
+	globalForPrisma.prisma ??
+	new PrismaClient({
+		log: ["query"],
+	});
+
+if (process.env.NODE_ENV !== "production") globalForPrisma.prisma = prisma;
+
+export * from "@prisma/client";