[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AKAZ85TH2G47K6EQGQ2C9B":3,"skill-same:01M7AKAZ85TH2G47K6EQGQ2C9B":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7AKAZ85TH2G47K6EQGQ2C9B","kotlin-exposed-patterns",null,"JetBrains Exposed ORM パターン（DSL クエリ、DAO パターン、トランザクション、HikariCP 接続プーリング、Flyway マイグレーション、リポジトリパターンを含む）。","Cyrilthetecchieee\u002Fcyril-code-","Cyrilthetecchieee","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F219787998?v=4","01M7AF0MMMKRAA0H61XMJPV92H","Julian Cyril D ","01M7AF0MQ10AVG6QJQ1C2BC0F5",2,"MIT","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Fja-JP\u002Fskills\u002Fkotlin-exposed-patterns\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: kotlin-exposed-patterns\ndescription: JetBrains Exposed ORM パターン（DSL クエリ、DAO パターン、トランザクション、HikariCP 接続プーリング、Flyway マイグレーション、リポジトリパターンを含む）。\norigin: ECC\n---\n\n# Kotlin Exposed パターン\n\nJetBrains Exposed ORM を使用したデータベースアクセスの包括的なパターン（DSL クエリ、DAO、トランザクション、プロダクション対応の設定を含む）。\n\n## 使用するタイミング\n\n- Exposed を使用したデータベースアクセスの設定\n- Exposed DSL または DAO を使用した SQL クエリの作成\n- HikariCP を使用した接続プーリングの設定\n- Flyway を使用したデータベースマイグレーションの作成\n- Exposed を使用したリポジトリパターンの実装\n- JSON カラムと複雑なクエリの処理\n\n## 動作の仕組み\n\nExposed は 2 つのクエリスタイルを提供します: 直接 SQL に似た表現のための DSL と、エンティティライフサイクル管理のための DAO です。HikariCP は `HikariConfig` を通じて設定された再利用可能なデータベース接続のプールを管理します。Flyway はスタートアップ時にバージョン管理された SQL マイグレーションスクリプトを実行してスキーマを同期させます。すべてのデータベース操作はコルーチンの安全性とアトミシティのために `newSuspendedTransaction` ブロック内で実行されます。リポジトリパターンはビジネスロジックをデータレイヤーから切り離し、テストがインメモリ H2 データベースを使用できるようにします。\n\n## 使用例\n\n### DSL クエリ\n\n```kotlin\nsuspend fun findUserById(id: UUID): UserRow? =\n    newSuspendedTransaction {\n        UsersTable.selectAll()\n            .where { UsersTable.id eq id }\n            .map { it.toUser() }\n            .singleOrNull()\n    }\n```\n\n### DAO エンティティの使用\n\n```kotlin\nsuspend fun createUser(request: CreateUserRequest): User =\n    newSuspendedTransaction {\n        UserEntity.new {\n            name = request.name\n            email = request.email\n            role = request.role\n        }.toModel()\n    }\n```\n\n### HikariCP 設定\n\n```kotlin\nval hikariConfig = HikariConfig().apply {\n    driverClassName = config.driver\n    jdbcUrl = config.url\n    username = config.username\n    password = config.password\n    maximumPoolSize = config.maxPoolSize\n    isAutoCommit = false\n    transactionIsolation = \"TRANSACTION_READ_COMMITTED\"\n    validate()\n}\n```\n\n## データベースセットアップ\n\n### HikariCP 接続プーリング\n\n```kotlin\n\u002F\u002F DatabaseFactory.kt\nobject DatabaseFactory {\n    fun create(config: DatabaseConfig): Database {\n        val hikariConfig = HikariConfig().apply {\n            driverClassName = config.driver\n            jdbcUrl = config.url\n            username = config.username\n            password = config.password\n            maximumPoolSize = config.maxPoolSize\n            isAutoCommit = false\n            transactionIsolation = \"TRANSACTION_READ_COMMITTED\"\n            validate()\n        }\n\n        return Database.connect(HikariDataSource(hikariConfig))\n    }\n}\n\ndata class DatabaseConfig(\n    val url: String,\n    val driver: String = \"org.postgresql.Driver\",\n    val username: String = \"\",\n    val password: String = \"\",\n    val maxPoolSize: Int = 10,\n)\n```\n\n### Flyway マイグレーション\n\n```kotlin\n\u002F\u002F FlywayMigration.kt\nfun runMigrations(config: DatabaseConfig) {\n    Flyway.configure()\n        .dataSource(config.url, config.username, config.password)\n        .locations(\"classpath:db\u002Fmigration\")\n        .baselineOnMigrate(true)\n        .load()\n        .migrate()\n}\n\n\u002F\u002F アプリケーションスタートアップ\nfun Application.module() {\n    val config = DatabaseConfig(\n        url = environment.config.property(\"database.url\").getString(),\n        username = environment.config.property(\"database.username\").getString(),\n        password = environment.config.property(\"database.password\").getString(),\n    )\n    runMigrations(config)\n    val database = DatabaseFactory.create(config)\n    \u002F\u002F ...\n}\n```\n\n### マイグレーションファイル\n\n```sql\n-- src\u002Fmain\u002Fresources\u002Fdb\u002Fmigration\u002FV1__create_users.sql\nCREATE TABLE users (\n    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),\n    name VARCHAR(100) NOT NULL,\n    email VARCHAR(255) NOT NULL UNIQUE,\n    role VARCHAR(20) NOT NULL DEFAULT 'USER',\n    metadata JSONB,\n    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),\n    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()\n);\n\nCREATE INDEX idx_users_email ON users(email);\nCREATE INDEX idx_users_role ON users(role);\n```\n\n## テーブル定義\n\n### DSL スタイルのテーブル\n\n```kotlin\n\u002F\u002F tables\u002FUsersTable.kt\nobject UsersTable : UUIDTable(\"users\") {\n    val name = varchar(\"name\", 100)\n    val email = varchar(\"email\", 255).uniqueIndex()\n    val role = enumerationByName\u003CRole>(\"role\", 20)\n    val metadata = jsonb\u003CUserMetadata>(\"metadata\", Json.Default).nullable()\n    val createdAt = timestampWithTimeZone(\"created_at\").defaultExpression(CurrentTimestampWithTimeZone)\n    val updatedAt = timestampWithTimeZone(\"updated_at\").defaultExpression(CurrentTimestampWithTimeZone)\n}\n\nobject OrdersTable : UUIDTable(\"orders\") {\n    val userId = uuid(\"user_id\").references(UsersTable.id)\n    val status = enumerationByName\u003COrderStatus>(\"status\", 20)\n    val totalAmount = long(\"total_amount\")\n    val currency = varchar(\"currency\", 3)\n    val createdAt = timestampWithTimeZone(\"created_at\").defaultExpression(CurrentTimestampWithTimeZone)\n}\n\nobject OrderItemsTable : UUIDTable(\"order_items\") {\n    val orderId = uuid(\"order_id\").references(OrdersTable.id, onDelete = ReferenceOption.CASCADE)\n    val productId = uuid(\"product_id\")\n    val quantity = integer(\"quantity\")\n    val unitPrice = long(\"unit_price\")\n}\n```\n\n### 複合テーブル\n\n```kotlin\nobject UserRolesTable : Table(\"user_roles\") {\n    val userId = uuid(\"user_id\").references(UsersTable.id, onDelete = ReferenceOption.CASCADE)\n    val roleId = uuid(\"role_id\").references(RolesTable.id, onDelete = ReferenceOption.CASCADE)\n    override val primaryKey = PrimaryKey(userId, roleId)\n}\n```\n\n## DSL クエリ\n\n### 基本的な CRUD\n\n```kotlin\n\u002F\u002F 挿入\nsuspend fun insertUser(name: String, email: String, role: Role): UUID =\n    newSuspendedTransaction {\n        UsersTable.insertAndGetId {\n            it[UsersTable.name] = name\n            it[UsersTable.email] = email\n            it[UsersTable.role] = role\n        }.value\n    }\n\n\u002F\u002F ID で選択\nsuspend fun findUserById(id: UUID): UserRow? =\n    newSuspendedTransaction {\n        UsersTable.selectAll()\n            .where { UsersTable.id eq id }\n            .map { it.toUser() }\n            .singleOrNull()\n    }\n\n\u002F\u002F 条件付き選択\nsuspend fun findActiveAdmins(): List\u003CUserRow> =\n    newSuspendedTransaction {\n        UsersTable.selectAll()\n            .where { (UsersTable.role eq Role.ADMIN) }\n            .orderBy(UsersTable.name)\n            .map { it.toUser() }\n    }\n\n\u002F\u002F 更新\nsuspend fun updateUserEmail(id: UUID, newEmail: String): Boolean =\n    newSuspendedTransaction {\n        UsersTable.update({ UsersTable.id eq id }) {\n            it[email] = newEmail\n            it[updatedAt] = CurrentTimestampWithTimeZone\n        } > 0\n    }\n\n\u002F\u002F 削除\nsuspend fun deleteUser(id: UUID): Boolean =\n    newSuspendedTransaction {\n        UsersTable.deleteWhere { UsersTable.id eq id } > 0\n    }\n\n\u002F\u002F 行マッピング\nprivate fun ResultRow.toUser() = UserRow(\n    id = this[UsersTable.id].value,\n    name = this[UsersTable.name],\n    email = this[UsersTable.email],\n    role = this[UsersTable.role],\n    metadata = this[UsersTable.metadata],\n    createdAt = this[UsersTable.createdAt],\n    updatedAt = this[UsersTable.updatedAt],\n)\n```\n\n### 高度なクエリ\n\n```kotlin\n\u002F\u002F JOIN クエリ\nsuspend fun findOrdersWithUser(userId: UUID): List\u003COrderWithUser> =\n    newSuspendedTransaction {\n        (OrdersTable innerJoin UsersTable)\n            .selectAll()\n            .where { OrdersTable.userId eq userId }\n            .orderBy(OrdersTable.createdAt, SortOrder.DESC)\n            .map { row ->\n                OrderWithUser(\n                    orderId = row[OrdersTable.id].value,\n                    status = row[OrdersTable.status],\n                    totalAmount = row[OrdersTable.totalAmount],\n                    userName = row[UsersTable.name],\n                )\n            }\n    }\n\n\u002F\u002F 集計\nsuspend fun countUsersByRole(): Map\u003CRole, Long> =\n    newSuspendedTransaction {\n        UsersTable\n            .select(UsersTable.role, UsersTable.id.count())\n            .groupBy(UsersTable.role)\n            .associate { row ->\n                row[UsersTable.role] to row[UsersTable.id.count()]\n            }\n    }\n\n\u002F\u002F サブクエリ\nsuspend fun findUsersWithOrders(): List\u003CUserRow> =\n    newSuspendedTransaction {\n        UsersTable.selectAll()\n            .where {\n                UsersTable.id inSubQuery\n                    OrdersTable.select(OrdersTable.userId).withDistinct()\n            }\n            .map { it.toUser() }\n    }\n\n\u002F\u002F LIKE とパターンマッチング — ワイルドカードインジェクションを防ぐため常にユーザー入力をエスケープ\nprivate fun escapeLikePattern(input: String): String =\n    input.replace(\"\\\\\", \"\\\\\\\\\").replace(\"%\", \"\\\\%\").replace(\"_\", \"\\\\_\")\n\nsuspend fun searchUsers(query: String): List\u003CUserRow> =\n    newSuspendedTransaction {\n        val sanitized = escapeLikePattern(query.lowercase())\n        UsersTable.selectAll()\n            .where {\n                (UsersTable.name.lowerCase() like \"%${sanitized}%\") or\n                    (UsersTable.email.lowerCase() like \"%${sanitized}%\")\n            }\n            .map { it.toUser() }\n    }\n```\n\n### ページネーション\n\n```kotlin\ndata class Page\u003CT>(\n    val data: List\u003CT>,\n    val total: Long,\n    val page: Int,\n    val limit: Int,\n) {\n    val totalPages: Int get() = ((total + limit - 1) \u002F limit).toInt()\n    val hasNext: Boolean get() = page \u003C totalPages\n    val hasPrevious: Boolean get() = page > 1\n}\n\nsuspend fun findUsersPaginated(page: Int, limit: Int): Page\u003CUserRow> =\n    newSuspendedTransaction {\n        val total = UsersTable.selectAll().count()\n        val data = UsersTable.selectAll()\n            .orderBy(UsersTable.createdAt, SortOrder.DESC)\n            .limit(limit)\n            .offset(((page - 1) * limit).toLong())\n            .map { it.toUser() }\n\n        Page(data = data, total = total, page = page, limit = limit)\n    }\n```\n\n### バッチ操作\n\n```kotlin\n\u002F\u002F バッチ挿入\nsuspend fun insertUsers(users: List\u003CCreateUserRequest>): List\u003CUUID> =\n    newSuspendedTransaction {\n        UsersTable.batchInsert(users) { user ->\n            this[UsersTable.name] = user.name\n            this[UsersTable.email] = user.email\n            this[UsersTable.role] = user.role\n        }.map { it[UsersTable.id].value }\n    }\n\n\u002F\u002F アップサート（競合時に挿入または更新）\nsuspend fun upsertUser(id: UUID, name: String, email: String) {\n    newSuspendedTransaction {\n        UsersTable.upsert(UsersTable.email) {\n            it[UsersTable.id] = EntityID(id, UsersTable)\n            it[UsersTable.name] = name\n            it[UsersTable.email] = email\n            it[updatedAt] = CurrentTimestampWithTimeZone\n        }\n    }\n}\n```\n\n## DAO パターン\n\n### エンティティ定義\n\n```kotlin\n\u002F\u002F entities\u002FUserEntity.kt\nclass UserEntity(id: EntityID\u003CUUID>) : UUIDEntity(id) {\n    companion object : UUIDEntityClass\u003CUserEntity>(UsersTable)\n\n    var name by UsersTable.name\n    var email by UsersTable.email\n    var role by UsersTable.role\n    var metadata by UsersTable.metadata\n    var createdAt by UsersTable.createdAt\n    var updatedAt by UsersTable.updatedAt\n\n    val orders by OrderEntity referrersOn OrdersTable.userId\n\n    fun toModel(): User = User(\n        id = id.value,\n        name = name,\n        email = email,\n        role = role,\n        metadata = metadata,\n        createdAt = createdAt,\n        updatedAt = updatedAt,\n    )\n}\n\nclass OrderEntity(id: EntityID\u003CUUID>) : UUIDEntity(id) {\n    companion object : UUIDEntityClass\u003COrderEntity>(OrdersTable)\n\n    var user by UserEntity referencedOn OrdersTable.userId\n    var status by OrdersTable.status\n    var totalAmount by OrdersTable.totalAmount\n    var currency by OrdersTable.currency\n    var createdAt by OrdersTable.createdAt\n\n    val items by OrderItemEntity referrersOn OrderItemsTable.orderId\n}\n```\n\n### DAO 操作\n\n```kotlin\nsuspend fun findUserByEmail(email: String): User? =\n    newSuspendedTransaction {\n        UserEntity.find { UsersTable.email eq email }\n            .firstOrNull()\n            ?.toModel()\n    }\n\nsuspend fun createUser(request: CreateUserRequest): User =\n    newSuspendedTransaction {\n        UserEntity.new {\n            name = request.name\n            email = request.email\n            role = request.role\n        }.toModel()\n    }\n\nsuspend fun updateUser(id: UUID, request: UpdateUserRequest): User? =\n    newSuspendedTransaction {\n        UserEntity.findById(id)?.apply {\n            request.name?.let { name = it }\n            request.email?.let { email = it }\n            updatedAt = OffsetDateTime.now(ZoneOffset.UTC)\n        }?.toModel()\n    }\n```\n\n## トランザクション\n\n### サスペンドトランザクションのサポート\n\n```kotlin\n\u002F\u002F 良い例: コルーチンサポートのために newSuspendedTransaction を使用\nsuspend fun performDatabaseOperation(): Result\u003CUser> =\n    runCatching {\n        newSuspendedTransaction {\n            val user = UserEntity.new {\n                name = \"Alice\"\n                email = \"alice@example.com\"\n            }\n            \u002F\u002F このブロック内のすべての操作はアトミック\n            user.toModel()\n        }\n    }\n\n\u002F\u002F 良い例: セーブポイントによるネストされたトランザクション\nsuspend fun transferFunds(fromId: UUID, toId: UUID, amount: Long) {\n    newSuspendedTransaction {\n        val from = UserEntity.findById(fromId) ?: throw NotFoundException(\"User $fromId not found\")\n        val to = UserEntity.findById(toId) ?: throw NotFoundException(\"User $toId not found\")\n\n        \u002F\u002F デビット\n        from.balance -= amount\n        \u002F\u002F クレジット\n        to.balance += amount\n\n        \u002F\u002F 両方が成功するか両方が失敗するか\n    }\n}\n```\n\n### トランザクション分離\n\n```kotlin\nsuspend fun readCommittedQuery(): List\u003CUser> =\n    newSuspendedTransaction(transactionIsolation = Connection.TRANSACTION_READ_COMMITTED) {\n        UserEntity.all().map { it.toModel() }\n    }\n\nsuspend fun serializableOperation() {\n    newSuspendedTransaction(transactionIsolation = Connection.TRANSACTION_SERIALIZABLE) {\n        \u002F\u002F クリティカルな操作のための最も厳格な分離レベル\n    }\n}\n```\n\n## リポジトリパターン\n\n### インターフェース定義\n\n```kotlin\ninterface UserRepository {\n    suspend fun findById(id: UUID): User?\n    suspend fun findByEmail(email: String): User?\n    suspend fun findAll(page: Int, limit: Int): Page\u003CUser>\n    suspend fun search(query: String): List\u003CUser>\n    suspend fun create(request: CreateUserRequest): User\n    suspend fun update(id: UUID, request: UpdateUserRequest): User?\n    suspend fun delete(id: UUID): Boolean\n    suspend fun count(): Long\n}\n```\n\n### Exposed 実装\n\n```kotlin\nclass ExposedUserRepository(\n    private val database: Database,\n) : UserRepository {\n\n    override suspend fun findById(id: UUID): User? =\n        newSuspendedTransaction(db = database) {\n            UsersTable.selectAll()\n                .where { UsersTable.id eq id }\n                .map { it.toUser() }\n                .singleOrNull()\n        }\n\n    override suspend fun findByEmail(email: String): User? =\n        newSuspendedTransaction(db = database) {\n            UsersTable.selectAll()\n                .where { UsersTable.email eq email }\n                .map { it.toUser() }\n                .singleOrNull()\n        }\n\n    override suspend fun findAll(page: Int, limit: Int): Page\u003CUser> =\n        newSuspendedTransaction(db = database) {\n            val total = UsersTable.selectAll().count()\n            val data = UsersTable.selectAll()\n                .orderBy(UsersTable.createdAt, SortOrder.DESC)\n                .limit(limit)\n                .offset(((page - 1) * limit).toLong())\n                .map { it.toUser() }\n            Page(data = data, total = total, page = page, limit = limit)\n        }\n\n    override suspend fun search(query: String): List\u003CUser> =\n        newSuspendedTransaction(db = database) {\n            val sanitized = escapeLikePattern(query.lowercase())\n            UsersTable.selectAll()\n                .where {\n                    (UsersTable.name.lowerCase() like \"%${sanitized}%\") or\n                        (UsersTable.email.lowerCase() like \"%${sanitized}%\")\n                }\n                .orderBy(UsersTable.name)\n                .map { it.toUser() }\n        }\n\n    override suspend fun create(request: CreateUserRequest): User =\n        newSuspendedTransaction(db = database) {\n            UsersTable.insert {\n                it[name] = request.name\n                it[email] = request.email\n                it[role] = request.role\n            }.resultedValues!!.first().toUser()\n        }\n\n    override suspend fun update(id: UUID, request: UpdateUserRequest): User? =\n        newSuspendedTransaction(db = database) {\n            val updated = UsersTable.update({ UsersTable.id eq id }) {\n                request.name?.let { name -> it[UsersTable.name] = name }\n                request.email?.let { email -> it[UsersTable.email] = email }\n                it[updatedAt] = CurrentTimestampWithTimeZone\n            }\n            if (updated > 0) findById(id) else null\n        }\n\n    override suspend fun delete(id: UUID): Boolean =\n        newSuspendedTransaction(db = database) {\n            UsersTable.deleteWhere { UsersTable.id eq id } > 0\n        }\n\n    override suspend fun count(): Long =\n        newSuspendedTransaction(db = database) {\n            UsersTable.selectAll().count()\n        }\n\n    private fun ResultRow.toUser() = User(\n        id = this[UsersTable.id].value,\n        name = this[UsersTable.name],\n        email = this[UsersTable.email],\n        role = this[UsersTable.role],\n        metadata = this[UsersTable.metadata],\n        createdAt = this[UsersTable.createdAt],\n        updatedAt = this[UsersTable.updatedAt],\n    )\n}\n```\n\n## JSON カラム\n\n### kotlinx.serialization を使用した JSONB\n\n```kotlin\n\u002F\u002F JSONB のカスタムカラム型\ninline fun \u003Creified T : Any> Table.jsonb(\n    name: String,\n    json: Json,\n): Column\u003CT> = registerColumn(name, object : ColumnType\u003CT>() {\n    override fun sqlType() = \"JSONB\"\n\n    override fun valueFromDB(value: Any): T = when (value) {\n        is String -> json.decodeFromString(value)\n        is PGobject -> {\n            val jsonString = value.value\n                ?: throw IllegalArgumentException(\"PGobject value is null for column '$name'\")\n            json.decodeFromString(jsonString)\n        }\n        else -> throw IllegalArgumentException(\"Unexpected value: $value\")\n    }\n\n    override fun notNullValueToDB(value: T): Any =\n        PGobject().apply {\n            type = \"jsonb\"\n            this.value = json.encodeToString(value)\n        }\n})\n\n\u002F\u002F テーブルでの使用\n@Serializable\ndata class UserMetadata(\n    val preferences: Map\u003CString, String> = emptyMap(),\n    val tags: List\u003CString> = emptyList(),\n)\n\nobject UsersTable : UUIDTable(\"users\") {\n    val metadata = jsonb\u003CUserMetadata>(\"metadata\", Json.Default).nullable()\n}\n```\n\n## Exposed でのテスト\n\n### テスト用インメモリデータベース\n\n```kotlin\nclass UserRepositoryTest : FunSpec({\n    lateinit var database: Database\n    lateinit var repository: UserRepository\n\n    beforeSpec {\n        database = Database.connect(\n            url = \"jdbc:h2:mem:test;DB_CLOSE_DELAY=-1;MODE=PostgreSQL\",\n            driver = \"org.h2.Driver\",\n        )\n        transaction(database) {\n            SchemaUtils.create(UsersTable)\n        }\n        repository = ExposedUserRepository(database)\n    }\n\n    beforeTest {\n        transaction(database) {\n            UsersTable.deleteAll()\n        }\n    }\n\n    test(\"create and find user\") {\n        val user = repository.create(CreateUserRequest(\"Alice\", \"alice@example.com\"))\n\n        user.name shouldBe \"Alice\"\n        user.email shouldBe \"alice@example.com\"\n\n        val found = repository.findById(user.id)\n        found shouldBe user\n    }\n\n    test(\"findByEmail returns null for unknown email\") {\n        val result = repository.findByEmail(\"unknown@example.com\")\n        result.shouldBeNull()\n    }\n\n    test(\"pagination works correctly\") {\n        repeat(25) { i ->\n            repository.create(CreateUserRequest(\"User $i\", \"user$i@example.com\"))\n        }\n\n        val page1 = repository.findAll(page = 1, limit = 10)\n        page1.data shouldHaveSize 10\n        page1.total shouldBe 25\n        page1.hasNext shouldBe true\n\n        val page3 = repository.findAll(page = 3, limit = 10)\n        page3.data shouldHaveSize 5\n        page3.hasNext shouldBe false\n    }\n})\n```\n\n## Gradle 依存関係\n\n```kotlin\n\u002F\u002F build.gradle.kts\ndependencies {\n    \u002F\u002F Exposed\n    implementation(\"org.jetbrains.exposed:exposed-core:1.0.0\")\n    implementation(\"org.jetbrains.exposed:exposed-dao:1.0.0\")\n    implementation(\"org.jetbrains.exposed:exposed-jdbc:1.0.0\")\n    implementation(\"org.jetbrains.exposed:exposed-kotlin-datetime:1.0.0\")\n    implementation(\"org.jetbrains.exposed:exposed-json:1.0.0\")\n\n    \u002F\u002F データベースドライバー\n    implementation(\"org.postgresql:postgresql:42.7.5\")\n\n    \u002F\u002F 接続プーリング\n    implementation(\"com.zaxxer:HikariCP:6.2.1\")\n\n    \u002F\u002F マイグレーション\n    implementation(\"org.flywaydb:flyway-core:10.22.0\")\n    implementation(\"org.flywaydb:flyway-database-postgresql:10.22.0\")\n\n    \u002F\u002F テスト\n    testImplementation(\"com.h2database:h2:2.3.232\")\n}\n```\n\n## クイックリファレンス: Exposed パターン\n\n| パターン | 説明 |\n|---------|------|\n| `object Table : UUIDTable(\"name\")` | UUID 主キーを持つテーブルを定義 |\n| `newSuspendedTransaction { }` | コルーチン安全なトランザクションブロック |\n| `Table.selectAll().where { }` | 条件付きクエリ |\n| `Table.insertAndGetId { }` | 挿入して生成された ID を返す |\n| `Table.update({ condition }) { }` | 一致する行を更新 |\n| `Table.deleteWhere { }` | 一致する行を削除 |\n| `Table.batchInsert(items) { }` | 効率的なバルク挿入 |\n| `innerJoin` \u002F `leftJoin` | テーブルの結合 |\n| `orderBy` \u002F `limit` \u002F `offset` | ソートとページネーション |\n| `count()` \u002F `sum()` \u002F `avg()` | 集計関数 |\n\n**覚えておくこと**: シンプルなクエリには DSL スタイルを、エンティティライフサイクル管理が必要な場合は DAO スタイルを使用してください。コルーチンサポートには必ず `newSuspendedTransaction` を使用し、テスト可能性のためにデータベース操作をリポジトリインターフェースの後ろにラップしてください。\n","# Kotlin Exposed パターン\n\nJetBrains Exposed ORM を使用したデータベースアクセスの包括的なパターン（DSL クエリ、DAO、トランザクション、プロダクション対応の設定を含む）。\n\n## 使用するタイミング\n\n- Exposed を使用したデータベースアクセスの設定\n- Exposed DSL または DAO を使用した SQL クエリの作成\n- HikariCP を使用した接続プーリングの設定\n- Flyway を使用したデータベースマイグレーションの作成\n- Exposed を使用したリポジトリパターンの実装\n- JSON カラムと複雑なクエリの処理\n\n## 動作の仕組み\n\nExposed は 2 つのクエリスタイルを提供します: 直接 SQL に似た表現のための DSL と、エンティティライフサイクル管理のための DAO です。HikariCP は `HikariConfig` を通じて設定された再利用可能なデータベース接続のプールを管理します。Flyway はスタートアップ時にバージョン管理された SQL マイグレーションスクリプトを実行してスキーマを同期させます。すべてのデータベース操作はコルーチンの安全性とアトミシティのために `newSuspendedTransaction` ブロック内で実行されます。リポジトリパターンはビジネスロジックをデータレイヤーから切り離し、テストがインメモリ H2 データベースを使用できるようにします。\n\n## 使用例\n\n### DSL クエリ\n\n```kotlin\nsuspend fun findUserById(id: UUID): UserRow? =\n    newSuspendedTransaction {\n        UsersTable.selectAll()\n            .where { UsersTable.id eq id }\n            .map { it.toUser() }\n            .singleOrNull()\n    }\n```\n\n### DAO エンティティの使用\n\n```kotlin\nsuspend fun createUser(request: CreateUserRequest): User =\n    newSuspendedTransaction {\n        UserEntity.new {\n            name = request.name\n            email = request.email\n            role = request.role\n        }.toModel()\n    }\n```\n\n### HikariCP 設定\n\n```kotlin\nval hikariConfig = HikariConfig().apply {\n    driverClassName = config.driver\n    jdbcUrl = config.url\n    username = config.username\n    password = config.password\n    maximumPoolSize = config.maxPoolSize\n    isAutoCommit = false\n    transactionIsolation = \"TRANSACTION_READ_COMMITTED\"\n    validate()\n}\n```\n\n## データベースセットアップ\n\n### HikariCP 接続プーリング\n\n```kotlin\n\u002F\u002F DatabaseFactory.kt\nobject DatabaseFactory {\n    fun create(config: DatabaseConfig): Database {\n        val hikariConfig = HikariConfig().apply {\n            driverClassName = config.driver\n            jdbcUrl = config.url\n            username = config.username\n            password = config.password\n            maximumPoolSize = config.maxPoolSize\n            isAutoCommit = false\n            transactionIsolation = \"TRANSACTION_READ_COMMITTED\"\n            validate()\n        }\n\n        return Database.connect(HikariDataSource(hikariConfig))\n    }\n}\n\ndata class DatabaseConfig(\n    val url: String,\n    val driver: String = \"org.postgresql.Driver\",\n    val username: String = \"\",\n    val password: String = \"\",\n    val maxPoolSize: Int = 10,\n)\n```\n\n### Flyway マイグレーション\n\n```kotlin\n\u002F\u002F FlywayMigration.kt\nfun runMigrations(config: DatabaseConfig) {\n    Flyway.configure()\n        .dataSource(config.url, config.username, config.password)\n        .locations(\"classpath:db\u002Fmigration\")\n        .baselineOnMigrate(true)\n        .load()\n        .migrate()\n}\n\n\u002F\u002F アプリケーションスタートアップ\nfun Application.module() {\n    val config = DatabaseConfig(\n        url = environment.config.property(\"database.url\").getString(),\n        username = environment.config.property(\"database.username\").getString(),\n        password = environment.config.property(\"database.password\").getString(),\n    )\n    runMigrations(config)\n    val database = DatabaseFactory.create(config)\n    \u002F\u002F ...\n}\n```\n\n### マイグレーションファイル\n\n```sql\n-- src\u002Fmain\u002Fresources\u002Fdb\u002Fmigration\u002FV1__create_users.sql\nCREATE TABLE users (\n    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),\n    name VARCHAR(100) NOT NULL,\n    email VARCHAR(255) NOT NULL UNIQUE,\n    role VARCHAR(20) NOT NULL DEFAULT 'USER',\n    metadata JSONB,\n    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),\n    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()\n);\n\nCREATE INDEX idx_users_email ON users(email);\nCREATE INDEX idx_users_role ON users(role);\n```\n\n## テーブル定義\n\n### DSL スタイルのテーブル\n\n```kotlin\n\u002F\u002F tables\u002FUsersTable.kt\nobject UsersTable : UUIDTable(\"users\") {\n    val name = varchar(\"name\", 100)\n    val email = varchar(\"email\", 255).uniqueIndex()\n    val role = enumerationByName\u003CRole>(\"role\", 20)\n    val metadata = jsonb\u003CUserMetadata>(\"metadata\", Json.Default).nullable()\n    val createdAt = timestampWithTimeZone(\"created_at\").defaultExpression(CurrentTimestampWithTimeZone)\n    val updatedAt = timestampWithTimeZone(\"updated_at\").defaultExpression(CurrentTimestampWithTimeZone)\n}\n\nobject OrdersTable : UUIDTable(\"orders\") {\n    val userId = uuid(\"user_id\").references(UsersTable.id)\n    val status = enumerationByName\u003COrderStatus>(\"status\", 20)\n    val totalAmount = long(\"total_amount\")\n    val currency = varchar(\"currency\", 3)\n    val createdAt = timestampWithTimeZone(\"created_at\").defaultExpression(CurrentTimestampWithTimeZone)\n}\n\nobject OrderItemsTable : UUIDTable(\"order_items\") {\n    val orderId = uuid(\"order_id\").references(OrdersTable.id, onDelete = ReferenceOption.CASCADE)\n    val productId = uuid(\"product_id\")\n    val quantity = integer(\"quantity\")\n    val unitPrice = long(\"unit_price\")\n}\n```\n\n### 複合テーブル\n\n```kotlin\nobject UserRolesTable : Table(\"user_roles\") {\n    val userId = uuid(\"user_id\").references(UsersTable.id, onDelete = ReferenceOption.CASCADE)\n    val roleId = uuid(\"role_id\").references(RolesTable.id, onDelete = ReferenceOption.CASCADE)\n    override val primaryKey = PrimaryKey(userId, roleId)\n}\n```\n\n## DSL クエリ\n\n### 基本的な CRUD\n\n```kotlin\n\u002F\u002F 挿入\nsuspend fun insertUser(name: String, email: String, role: Role): UUID =\n    newSuspendedTransaction {\n        UsersTable.insertAndGetId {\n            it[UsersTable.name] = name\n            it[UsersTable.email] = email\n            it[UsersTable.role] = role\n        }.value\n    }\n\n\u002F\u002F ID で選択\nsuspend fun findUserById(id: UUID): UserRow? =\n    newSuspendedTransaction {\n        UsersTable.selectAll()\n            .where { UsersTable.id eq id }\n            .map { it.toUser() }\n            .singleOrNull()\n    }\n\n\u002F\u002F 条件付き選択\nsuspend fun findActiveAdmins(): List\u003CUserRow> =\n    newSuspendedTransaction {\n        UsersTable.selectAll()\n            .where { (UsersTable.role eq Role.ADMIN) }\n            .orderBy(UsersTable.name)\n            .map { it.toUser() }\n    }\n\n\u002F\u002F 更新\nsuspend fun updateUserEmail(id: UUID, newEmail: String): Boolean =\n    newSuspendedTransaction {\n        UsersTable.update({ UsersTable.id eq id }) {\n            it[email] = newEmail\n            it[updatedAt] = CurrentTimestampWithTimeZone\n        } > 0\n    }\n\n\u002F\u002F 削除\nsuspend fun deleteUser(id: UUID): Boolean =\n    newSuspendedTransaction {\n        UsersTable.deleteWhere { UsersTable.id eq id } > 0\n    }\n\n\u002F\u002F 行マッピング\nprivate fun ResultRow.toUser() = UserRow(\n    id = this[UsersTable.id].value,\n    name = this[UsersTable.name],\n    email = this[UsersTable.email],\n    role = this[UsersTable.role],\n    metadata = this[UsersTable.metadata],\n    createdAt = this[UsersTable.createdAt],\n    updatedAt = this[UsersTable.updatedAt],\n)\n```\n\n### 高度なクエリ\n\n```kotlin\n\u002F\u002F JOIN クエリ\nsuspend fun findOrdersWithUser(userId: UUID): List\u003COrderWithUser> =\n    newSuspendedTransaction {\n        (OrdersTable innerJoin UsersTable)\n            .selectAll()\n            .where { OrdersTable.userId eq userId }\n            .orderBy(OrdersTable.createdAt, SortOrder.DESC)\n            .map { row ->\n                OrderWithUser(\n                    orderId = row[OrdersTable.id].value,\n                    status = row[OrdersTable.status],\n                    totalAmount = row[OrdersTable.totalAmount],\n                    userName = row[UsersTable.name],\n                )\n            }\n    }\n\n\u002F\u002F 集計\nsuspend fun countUsersByRole(): Map\u003CRole, Long> =\n    newSuspendedTransaction {\n        UsersTable\n            .select(UsersTable.role, UsersTable.id.count())\n            .groupBy(UsersTable.role)\n            .associate { row ->\n                row[UsersTable.role] to row[UsersTable.id.count()]\n            }\n    }\n\n\u002F\u002F サブクエリ\nsuspend fun findUsersWithOrders(): List\u003CUserRow> =\n    newSuspendedTransaction {\n        UsersTable.selectAll()\n            .where {\n                UsersTable.id inSubQuery\n                    OrdersTable.select(OrdersTable.userId).withDistinct()\n            }\n            .map { it.toUser() }\n    }\n\n\u002F\u002F LIKE とパターンマッチング — ワイルドカードインジェクションを防ぐため常にユーザー入力をエスケープ\nprivate fun escapeLikePattern(input: String): String =\n    input.replace(\"\\\\\", \"\\\\\\\\\").replace(\"%\", \"\\\\%\").replace(\"_\", \"\\\\_\")\n\nsuspend fun searchUsers(query: String): List\u003CUserRow> =\n    newSuspendedTransaction {\n        val sanitized = escapeLikePattern(query.lowercase())\n        UsersTable.selectAll()\n            .where {\n                (UsersTable.name.lowerCase() like \"%${sanitized}%\") or\n                    (UsersTable.email.lowerCase() like \"%${sanitized}%\")\n            }\n            .map { it.toUser() }\n    }\n```\n\n### ページネーション\n\n```kotlin\ndata class Page\u003CT>(\n    val data: List\u003CT>,\n    val total: Long,\n    val page: Int,\n    val limit: Int,\n) {\n    val totalPages: Int get() = ((total + limit - 1) \u002F limit).toInt()\n    val hasNext: Boolean get() = page \u003C totalPages\n    val hasPrevious: Boolean get() = page > 1\n}\n\nsuspend fun findUsersPaginated(page: Int, limit: Int): Page\u003CUserRow> =\n    newSuspendedTransaction {\n        val total = UsersTable.selectAll().count()\n        val data = UsersTable.selectAll()\n            .orderBy(UsersTable.createdAt, SortOrder.DESC)\n            .limit(limit)\n            .offset(((page - 1) * limit).toLong())\n            .map { it.toUser() }\n\n        Page(data = data, total = total, page = page, limit = limit)\n    }\n```\n\n### バッチ操作\n\n```kotlin\n\u002F\u002F バッチ挿入\nsuspend fun insertUsers(users: List\u003CCreateUserRequest>): List\u003CUUID> =\n    newSuspendedTransaction {\n        UsersTable.batchInsert(users) { user ->\n            this[UsersTable.name] = user.name\n            this[UsersTable.email] = user.email\n            this[UsersTable.role] = user.role\n        }.map { it[UsersTable.id].value }\n    }\n\n\u002F\u002F アップサート（競合時に挿入または更新）\nsuspend fun upsertUser(id: UUID, name: String, email: String) {\n    newSuspendedTransaction {\n        UsersTable.upsert(UsersTable.email) {\n            it[UsersTable.id] = EntityID(id, UsersTable)\n            it[UsersTable.name] = name\n            it[UsersTable.email] = email\n            it[updatedAt] = CurrentTimestampWithTimeZone\n        }\n    }\n}\n```\n\n## DAO パターン\n\n### エンティティ定義\n\n```kotlin\n\u002F\u002F entities\u002FUserEntity.kt\nclass UserEntity(id: EntityID\u003CUUID>) : UUIDEntity(id) {\n    companion object : UUIDEntityClass\u003CUserEntity>(UsersTable)\n\n    var name by UsersTable.name\n    var email by UsersTable.email\n    var role by UsersTable.role\n    var metadata by UsersTable.metadata\n    var createdAt by UsersTable.createdAt\n    var updatedAt by UsersTable.updatedAt\n\n    val orders by OrderEntity referrersOn OrdersTable.userId\n\n    fun toModel(): User = User(\n        id = id.value,\n        name = name,\n        email = email,\n        role = role,\n        metadata = metadata,\n        createdAt = createdAt,\n        updatedAt = updatedAt,\n    )\n}\n\nclass OrderEntity(id: EntityID\u003CUUID>) : UUIDEntity(id) {\n    companion object : UUIDEntityClass\u003COrderEntity>(OrdersTable)\n\n    var user by UserEntity referencedOn OrdersTable.userId\n    var status by OrdersTable.status\n    var totalAmount by OrdersTable.totalAmount\n    var currency by OrdersTable.currency\n    var createdAt by OrdersTable.createdAt\n\n    val items by OrderItemEntity referrersOn OrderItemsTable.orderId\n}\n```\n\n### DAO 操作\n\n```kotlin\nsuspend fun findUserByEmail(email: String): User? =\n    newSuspendedTransaction {\n        UserEntity.find { UsersTable.email eq email }\n            .firstOrNull()\n            ?.toModel()\n    }\n\nsuspend fun createUser(request: CreateUserRequest): User =\n    newSuspendedTransaction {\n        UserEntity.new {\n            name = request.name\n            email = request.email\n            role = request.role\n        }.toModel()\n    }\n\nsuspend fun updateUser(id: UUID, request: UpdateUserRequest): User? =\n    newSuspendedTransaction {\n        UserEntity.findById(id)?.apply {\n            request.name?.let { name = it }\n            request.email?.let { email = it }\n            updatedAt = OffsetDateTime.now(ZoneOffset.UTC)\n        }?.toModel()\n    }\n```\n\n## トランザクション\n\n### サスペンドトランザクションのサポート\n\n```kotlin\n\u002F\u002F 良い例: コルーチンサポートのために newSuspendedTransaction を使用\nsuspend fun performDatabaseOperation(): Result\u003CUser> =\n    runCatching {\n        newSuspendedTransaction {\n            val user = UserEntity.new {\n                name = \"Alice\"\n                email = \"alice@example.com\"\n            }\n            \u002F\u002F このブロック内のすべての操作はアトミック\n            user.toModel()\n        }\n    }\n\n\u002F\u002F 良い例: セーブポイントによるネストされたトランザクション\nsuspend fun transferFunds(fromId: UUID, toId: UUID, amount: Long) {\n    newSuspendedTransaction {\n        val from = UserEntity.findById(fromId) ?: throw NotFoundException(\"User $fromId not found\")\n        val to = UserEntity.findById(toId) ?: throw NotFoundException(\"User $toId not found\")\n\n        \u002F\u002F デビット\n        from.balance -= amount\n        \u002F\u002F クレジット\n        to.balance += amount\n\n        \u002F\u002F 両方が成功するか両方が失敗するか\n    }\n}\n```\n\n### トランザクション分離\n\n```kotlin\nsuspend fun readCommittedQuery(): List\u003CUser> =\n    newSuspendedTransaction(transactionIsolation = Connection.TRANSACTION_READ_COMMITTED) {\n        UserEntity.all().map { it.toModel() }\n    }\n\nsuspend fun serializableOperation() {\n    newSuspendedTransaction(transactionIsolation = Connection.TRANSACTION_SERIALIZABLE) {\n        \u002F\u002F クリティカルな操作のための最も厳格な分離レベル\n    }\n}\n```\n\n## リポジトリパターン\n\n### インターフェース定義\n\n```kotlin\ninterface UserRepository {\n    suspend fun findById(id: UUID): User?\n    suspend fun findByEmail(email: String): User?\n    suspend fun findAll(page: Int, limit: Int): Page\u003CUser>\n    suspend fun search(query: String): List\u003CUser>\n    suspend fun create(request: CreateUserRequest): User\n    suspend fun update(id: UUID, request: UpdateUserRequest): User?\n    suspend fun delete(id: UUID): Boolean\n    suspend fun count(): Long\n}\n```\n\n### Exposed 実装\n\n```kotlin\nclass ExposedUserRepository(\n    private val database: Database,\n) : UserRepository {\n\n    override suspend fun findById(id: UUID): User? =\n        newSuspendedTransaction(db = database) {\n            UsersTable.selectAll()\n                .where { UsersTable.id eq id }\n                .map { it.toUser() }\n                .singleOrNull()\n        }\n\n    override suspend fun findByEmail(email: String): User? =\n        newSuspendedTransaction(db = database) {\n            UsersTable.selectAll()\n                .where { UsersTable.email eq email }\n                .map { it.toUser() }\n                .singleOrNull()\n        }\n\n    override suspend fun findAll(page: Int, limit: Int): Page\u003CUser> =\n        newSuspendedTransaction(db = database) {\n            val total = UsersTable.selectAll().count()\n            val data = UsersTable.selectAll()\n                .orderBy(UsersTable.createdAt, SortOrder.DESC)\n                .limit(limit)\n                .offset(((page - 1) * limit).toLong())\n                .map { it.toUser() }\n            Page(data = data, total = total, page = page, limit = limit)\n        }\n\n    override suspend fun search(query: String): List\u003CUser> =\n        newSuspendedTransaction(db = database) {\n            val sanitized = escapeLikePattern(query.lowercase())\n            UsersTable.selectAll()\n                .where {\n                    (UsersTable.name.lowerCase() like \"%${sanitized}%\") or\n                        (UsersTable.email.lowerCase() like \"%${sanitized}%\")\n                }\n                .orderBy(UsersTable.name)\n                .map { it.toUser() }\n        }\n\n    override suspend fun create(request: CreateUserRequest): User =\n        newSuspendedTransaction(db = database) {\n            UsersTable.insert {\n                it[name] = request.name\n                it[email] = request.email\n                it[role] = request.role\n            }.resultedValues!!.first().toUser()\n        }\n\n    override suspend fun update(id: UUID, request: UpdateUserRequest): User? =\n        newSuspendedTransaction(db = database) {\n            val updated = UsersTable.update({ UsersTable.id eq id }) {\n                request.name?.let { name -> it[UsersTable.name] = name }\n                request.email?.let { email -> it[UsersTable.email] = email }\n                it[updatedAt] = CurrentTimestampWithTimeZone\n            }\n            if (updated > 0) findById(id) else null\n        }\n\n    override suspend fun delete(id: UUID): Boolean =\n        newSuspendedTransaction(db = database) {\n            UsersTable.deleteWhere { UsersTable.id eq id } > 0\n        }\n\n    override suspend fun count(): Long =\n        newSuspendedTransaction(db = database) {\n            UsersTable.selectAll().count()\n        }\n\n    private fun ResultRow.toUser() = User(\n        id = this[UsersTable.id].value,\n        name = this[UsersTable.name],\n        email = this[UsersTable.email],\n        role = this[UsersTable.role],\n        metadata = this[UsersTable.metadata],\n        createdAt = this[UsersTable.createdAt],\n        updatedAt = this[UsersTable.updatedAt],\n    )\n}\n```\n\n## JSON カラム\n\n### kotlinx.serialization を使用した JSONB\n\n```kotlin\n\u002F\u002F JSONB のカスタムカラム型\ninline fun \u003Creified T : Any> Table.jsonb(\n    name: String,\n    json: Json,\n): Column\u003CT> = registerColumn(name, object : ColumnType\u003CT>() {\n    override fun sqlType() = \"JSONB\"\n\n    override fun valueFromDB(value: Any): T = when (value) {\n        is String -> json.decodeFromString(value)\n        is PGobject -> {\n            val jsonString = value.value\n                ?: throw IllegalArgumentException(\"PGobject value is null for column '$name'\")\n            json.decodeFromString(jsonString)\n        }\n        else -> throw IllegalArgumentException(\"Unexpected value: $value\")\n    }\n\n    override fun notNullValueToDB(value: T): Any =\n        PGobject().apply {\n            type = \"jsonb\"\n            this.value = json.encodeToString(value)\n        }\n})\n\n\u002F\u002F テーブルでの使用\n@Serializable\ndata class UserMetadata(\n    val preferences: Map\u003CString, String> = emptyMap(),\n    val tags: List\u003CString> = emptyList(),\n)\n\nobject UsersTable : UUIDTable(\"users\") {\n    val metadata = jsonb\u003CUserMetadata>(\"metadata\", Json.Default).nullable()\n}\n```\n\n## Exposed でのテスト\n\n### テスト用インメモリデータベース\n\n```kotlin\nclass UserRepositoryTest : FunSpec({\n    lateinit var database: Database\n    lateinit var repository: UserRepository\n\n    beforeSpec {\n        database = Database.connect(\n            url = \"jdbc:h2:mem:test;DB_CLOSE_DELAY=-1;MODE=PostgreSQL\",\n            driver = \"org.h2.Driver\",\n        )\n        transaction(database) {\n            SchemaUtils.create(UsersTable)\n        }\n        repository = ExposedUserRepository(database)\n    }\n\n    beforeTest {\n        transaction(database) {\n            UsersTable.deleteAll()\n        }\n    }\n\n    test(\"create and find user\") {\n        val user = repository.create(CreateUserRequest(\"Alice\", \"alice@example.com\"))\n\n        user.name shouldBe \"Alice\"\n        user.email shouldBe \"alice@example.com\"\n\n        val found = repository.findById(user.id)\n        found shouldBe user\n    }\n\n    test(\"findByEmail returns null for unknown email\") {\n        val result = repository.findByEmail(\"unknown@example.com\")\n        result.shouldBeNull()\n    }\n\n    test(\"pagination works correctly\") {\n        repeat(25) { i ->\n            repository.create(CreateUserRequest(\"User $i\", \"user$i@example.com\"))\n        }\n\n        val page1 = repository.findAll(page = 1, limit = 10)\n        page1.data shouldHaveSize 10\n        page1.total shouldBe 25\n        page1.hasNext shouldBe true\n\n        val page3 = repository.findAll(page = 3, limit = 10)\n        page3.data shouldHaveSize 5\n        page3.hasNext shouldBe false\n    }\n})\n```\n\n## Gradle 依存関係\n\n```kotlin\n\u002F\u002F build.gradle.kts\ndependencies {\n    \u002F\u002F Exposed\n    implementation(\"org.jetbrains.exposed:exposed-core:1.0.0\")\n    implementation(\"org.jetbrains.exposed:exposed-dao:1.0.0\")\n    implementation(\"org.jetbrains.exposed:exposed-jdbc:1.0.0\")\n    implementation(\"org.jetbrains.exposed:exposed-kotlin-datetime:1.0.0\")\n    implementation(\"org.jetbrains.exposed:exposed-json:1.0.0\")\n\n    \u002F\u002F データベースドライバー\n    implementation(\"org.postgresql:postgresql:42.7.5\")\n\n    \u002F\u002F 接続プーリング\n    implementation(\"com.zaxxer:HikariCP:6.2.1\")\n\n    \u002F\u002F マイグレーション\n    implementation(\"org.flywaydb:flyway-core:10.22.0\")\n    implementation(\"org.flywaydb:flyway-database-postgresql:10.22.0\")\n\n    \u002F\u002F テスト\n    testImplementation(\"com.h2database:h2:2.3.232\")\n}\n```\n\n## クイックリファレンス: Exposed パターン\n\n| パターン | 説明 |\n|---------|------|\n| `object Table : UUIDTable(\"name\")` | UUID 主キーを持つテーブルを定義 |\n| `newSuspendedTransaction { }` | コルーチン安全なトランザクションブロック |\n| `Table.selectAll().where { }` | 条件付きクエリ |\n| `Table.insertAndGetId { }` | 挿入して生成された ID を返す |\n| `Table.update({ condition }) { }` | 一致する行を更新 |\n| `Table.deleteWhere { }` | 一致する行を削除 |\n| `Table.batchInsert(items) { }` | 効率的なバルク挿入 |\n| `innerJoin` \u002F `leftJoin` | テーブルの結合 |\n| `orderBy` \u002F `limit` \u002F `offset` | ソートとページネーション |\n| `count()` \u002F `sum()` \u002F `avg()` | 集計関数 |\n\n**覚えておくこと**: シンプルなクエリには DSL スタイルを、エンティティライフサイクル管理が必要な場合は DAO スタイルを使用してください。コルーチンサポートには必ず `newSuspendedTransaction` を使用し、テスト可能性のためにデータベース操作をリポジトリインターフェースの後ろにラップしてください。\n",{"name":5,"origin":24,"description":7},"ECC","main","57e7aa6b6e03bce1a7d7862ba9c2ec312f7f19b5","src\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Fja-JP\u002Fskills\u002Fkotlin-exposed-patterns",0,"https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee","https:\u002F\u002Fwithcyril.me\u002F","Hi, I’m Julian Cyril D, a Computer Science and Business Systems student at PSNACET.\r\nI’m passionate about full-stack development, UI\u002FUX design, and building sma","2026-11-04 23:28:50",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add Cyrilthetecchieee\u002Fcyril-code- --skill kotlin-exposed-patterns",{"tool":40,"command":41},"bunx","bunx skills add Cyrilthetecchieee\u002Fcyril-code- --skill kotlin-exposed-patterns",{"tool":43,"command":44},"pnpm","pnpm dlx skills add Cyrilthetecchieee\u002Fcyril-code- --skill kotlin-exposed-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Fja-JP\u002Fskills\u002Fkotlin-exposed-patterns\u002FSKILL.md",true,[],[49,58,65,73,80,87],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":53,"licenseFileUrl":54,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":19},"01M7AQV6CYX8RMC78420V9WZ62","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fwebapp-testing\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M7AQV2895N3S1MEX6K76G6G2","youtube-downloader","Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fvideo-downloader\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":53,"licenseFileUrl":69,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7AQTRNX62DNKVZ5GXEHRBKB","theme-factory","Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors\u002Ffonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftheme-factory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftheme-factory\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7AQTNNVHAAN9H6DA8T6ZVE0","template-skill","Replace with description of the skill and when Claude should use it.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftemplate-skill\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7AQTJ3MQ6AKX152MEX2MYCC","tailored-resume-generator","Analyzes job descriptions and generates tailored resumes that highlight relevant experience, skills, and achievements to maximize interview chances","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftailored-resume-generator\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":53,"licenseFileUrl":91,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7AQTD7D5MYET2YWG7HG9WM3","slack-gif-creator","Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives. This skill applies when users request animated GIFs or emoji animations for Slack from descriptions like \"make me a GIF for Slack of X doing Y\".","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fslack-gif-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fslack-gif-creator\u002FSKILL.md",[],[]]