\nnode -v\nnpm -v\n<\/pre>\n<\/code><\/p>\n 2. Proje Ba\u015flatma:<\/strong><\/p>\n Yeni bir proje klas\u00f6r\u00fc olu\u015fturun ve terminalde bu klas\u00f6re gidin:<\/p>\n \nmkdir mitsuki-gorev-yoneticisi\ncd mitsuki-gorev-yoneticisi\nnpm init -y\n<\/pre>\n<\/code><\/p>\n npm init -y<\/code> komutu, varsay\u0131lan ayarlarla bir package.json<\/code> dosyas\u0131 olu\u015fturacakt\u0131r.<\/p>\n 3. Mitsuki ve Yard\u0131mc\u0131 Paketlerin Kurulumu:<\/strong><\/p>\n Mitsuki'yi ve bir veritaban\u0131 adapt\u00f6r\u00fcn\u00fc (bu \u00f6rnekte SQLite kullanaca\u011f\u0131z, ancak konsept di\u011fer veritabanlar\u0131 i\u00e7in de benzerdir) projemize ekleyelim:<\/p>\n \nnpm install mitsuki-repo sqlite3\n<\/pre>\n<\/code><\/p>\n Burada mitsuki-repo<\/code>, bizim kurgusal Mitsuki Repository k\u00fct\u00fcphanemizdir ve sqlite3<\/code> ise veritaban\u0131 ba\u011flant\u0131s\u0131 i\u00e7in bir adapt\u00f6rd\u00fcr.<\/p>\n 4. Mitsuki Yap\u0131land\u0131rmas\u0131:<\/strong><\/p>\n Proje k\u00f6k dizininde config.js<\/code> ad\u0131nda bir dosya olu\u015ftural\u0131m. Bu dosya, Mitsuki'nin veritaban\u0131 ba\u011flant\u0131 ayarlar\u0131n\u0131 i\u00e7erecektir:<\/p>\n \n\/\/ config.js\nmodule.exports = {\n database: {\n client: 'sqlite3',\n connection: {\n filename: '.\/dev.sqlite3' \/\/ Veritaban\u0131 dosyas\u0131n\u0131n yolu\n },\n useNullAsDefault: true \/\/ SQLite i\u00e7in \u00f6nerilen ayar\n }\n};\n<\/pre>\n<\/code><\/p>\n Bu yap\u0131land\u0131rma, Mitsuki'ye SQLite veritaban\u0131 kullanaca\u011f\u0131n\u0131 ve veritaban\u0131 dosyas\u0131n\u0131n dev.sqlite3<\/code> ad\u0131yla proje klas\u00f6r\u00fcnde bulunaca\u011f\u0131n\u0131 s\u00f6yler.<\/p>\n 5. \u0130lk Model Tan\u0131m\u0131:<\/strong><\/p>\n Mitsuki, veritaban\u0131 tablolar\u0131n\u0131z\u0131 temsil eden modellere ihtiya\u00e7 duyar. models<\/code> ad\u0131nda bir klas\u00f6r olu\u015ftural\u0131m ve i\u00e7ine Task.js<\/code> ad\u0131nda bir dosya ekleyelim:<\/p>\n \n\/\/ models\/Task.js\nconst { Model } = require('mitsuki-repo');\n\nclass Task extends Model {\n static get tableName() {\n return 'tasks'; \/\/ Bu modelin e\u015fle\u015fti\u011fi veritaban\u0131 tablosu\n }\n\n static get jsonSchema() {\n return {\n type: 'object',\n required: ['title', 'status'],\n properties: {\n id: { type: 'integer' },\n title: { type: 'string', minLength: 3, maxLength: 255 },\n description: { type: 'string', maxLength: 1000 },\n status: { type: 'string', enum: ['pending', 'completed'], default: 'pending' },\n createdAt: { type: 'string', format: 'date-time' },\n updatedAt: { type: 'string', format: 'date-time' }\n }\n };\n }\n}\n\nmodule.exports = Task;\n<\/pre>\n<\/code><\/p>\n Bu kod blo\u011fu, Task<\/code> ad\u0131nda bir model tan\u0131mlar. tableName<\/code> \u00f6zelli\u011fi, modelin hangi veritaban\u0131 tablosuyla e\u015fle\u015fti\u011fini belirtir. jsonSchema<\/code> ise, bu model i\u00e7in temel veri do\u011frulama kurallar\u0131n\u0131 ve alan t\u00fcrlerini tan\u0131mlar. Bu \u015fema, verilerinizi veritaban\u0131na kaydetmeden \u00f6nce do\u011frulaman\u0131za yard\u0131mc\u0131 olur.<\/p>\n Vaka Analizi 1: G\u00f6rev Y\u00f6neticisi i\u00e7in \u00c7ekirdek Yap\u0131<\/strong><\/p>\n Yukar\u0131daki ad\u0131mlarla, basit bir g\u00f6rev y\u00f6neticisi uygulamas\u0131 i\u00e7in temel veri modelini ve Mitsuki yap\u0131land\u0131rmas\u0131n\u0131 tamamlad\u0131k. \u015eimdi, bu yap\u0131y\u0131 kullanarak g\u00f6revleri olu\u015fturmak, okumak, g\u00fcncellemek ve silmek i\u00e7in repository mant\u0131\u011f\u0131n\u0131 nas\u0131l kuraca\u011f\u0131m\u0131z\u0131 bir sonraki b\u00f6l\u00fcmlerde detayland\u0131raca\u011f\u0131z. \u00d6rne\u011fin, Task<\/code> modeli \u00fczerinden yeni g\u00f6revler ekleyebilecek, mevcut g\u00f6revleri listeleyebilecek veya durumlar\u0131n\u0131 g\u00fcncelleyebilece\u011fiz. Bu ba\u015flang\u0131\u00e7, t\u00fcm CRUD operasyonlar\u0131n\u0131n temelini olu\u015fturmaktad\u0131r ve uygulamam\u0131z\u0131n veri katman\u0131n\u0131 sa\u011flam bir \u015fekilde in\u015fa etmemizi sa\u011flayacakt\u0131r.<\/p>\n \u015eimdiye kadar yapt\u0131\u011f\u0131m\u0131z kurulum ile, veritaban\u0131 ba\u011flant\u0131s\u0131 ve model tan\u0131mlamas\u0131 haz\u0131r hale geldi. Bu sayede, i\u015f mant\u0131\u011f\u0131m\u0131z\u0131 do\u011frudan veritaban\u0131 i\u015flemleriyle kar\u0131\u015ft\u0131rmadan, temiz bir aray\u00fcz \u00fczerinden veri manip\u00fclasyonu yapabilece\u011fiz.<\/p>\n Temel CRUD Operasyonlar\u0131: Mitsuki ile Veri Yaratma (Create) ve Okuma (Read) \u0130\u015flemleri Nas\u0131l Yap\u0131l\u0131r?<\/h2>\nMitsuki Repositories'in en temel ve en s\u0131k kullan\u0131lan i\u015flevleri, veritaban\u0131na yeni kay\u0131tlar eklemek (Create) ve mevcut kay\u0131tlar\u0131 sorgulamak (Read) \u00fczerinedir. Bu b\u00f6l\u00fcmde, g\u00f6rev y\u00f6neticisi uygulamam\u0131z \u00fczerinden bu iki kritik operasyonu ad\u0131m ad\u0131m inceleyece\u011fiz. Her operasyon i\u00e7in kod \u00f6rnekleri ve ger\u00e7ek d\u00fcnya senaryolar\u0131 ile konuyu peki\u015ftirece\u011fiz.<\/p>\n Yeni Kay\u0131t Olu\u015fturma: create<\/code> Metodu ile Veritaban\u0131na Ekleme<\/h3>\nYeni bir g\u00f6rev kayd\u0131 olu\u015fturmak, uygulaman\u0131z\u0131n en s\u0131k ger\u00e7ekle\u015ftirece\u011fi i\u015flemlerden biridir. Mitsuki, modeliniz \u00fczerinden create<\/code> metodunu kullanarak bu i\u015flemi son derece basit ve g\u00fcvenli bir \u015fekilde yapman\u0131z\u0131 sa\u011flar. Veri olu\u015ftururken, daha \u00f6nce tan\u0131mlad\u0131\u011f\u0131m\u0131z jsonSchema<\/code> devreye girer ve verilerin do\u011frulu\u011funu otomatik olarak kontrol eder, b\u00f6ylece veritaban\u0131na hatal\u0131 veri giri\u015fini engelleriz.<\/p>\n \u00d6ncelikle, Mitsuki'yi yap\u0131land\u0131rd\u0131\u011f\u0131m\u0131z ana betik dosyam\u0131za (\u00f6rne\u011fin, app.js<\/code> veya index.js<\/code>) modelimizi ve yap\u0131land\u0131rmam\u0131z\u0131 dahil etmemiz gerekiyor:<\/p>\n \n\/\/ index.js\nconst { knex } = require('mitsuki-repo');\nconst config = require('.\/config');\nconst Task = require('.\/models\/Task');\n\n\/\/ Mitsuki'yi veritaban\u0131 konfig\u00fcrasyonu ile ba\u015flat\nTask.knex(knex(config.database));\n\nasync function main() {\n \/\/ Veritaban\u0131 tablosunu olu\u015ftur (e\u011fer yoksa)\n \/\/ Bu, \u00fcretim ortam\u0131nda migration'lar ile yap\u0131l\u0131r. Geli\u015ftirme i\u00e7in basitle\u015ftirildi.\n await knex(config.database).schema.createTableIfNotExists('tasks', table => {\n table.increments('id').primary();\n table.string('title').notNullable();\n table.text('description');\n table.string('status').defaultTo('pending').notNullable();\n table.timestamps(true, true); \/\/ createdAt ve updatedAt\n });\n\n console.log('Veritaban\u0131 tablosu haz\u0131r.');\n\n \/\/ Yeni bir g\u00f6rev olu\u015fturma \u00f6rne\u011fi\n try {\n const newTask = await Task.query().insert({\n title: 'Mitsuki Rehberini Yaz',\n description: 'Zero to Full CRUD teknik makalesini tamamla.',\n status: 'pending'\n });\n console.log('Yeni g\u00f6rev ba\u015far\u0131yla eklendi:', newTask.toJSON());\n\n const anotherTask = await Task.query().insert({\n title: 'Al\u0131\u015fveri\u015f Yap',\n description: 'S\u00fcpermarketten sebze ve meyve al.',\n status: 'pending'\n });\n console.log('Di\u011fer g\u00f6rev ba\u015far\u0131yla eklendi:', anotherTask.toJSON());\n } catch (error) {\n console.error('G\u00f6rev eklerken hata olu\u015ftu:', error.message);\n }\n}\n\nmain();\n<\/pre>\n<\/code><\/p>\n Yukar\u0131daki kodda, Task.query().insert()<\/code> metodu kullan\u0131larak veritaban\u0131na yeni bir g\u00f6rev kayd\u0131 eklenir. Mitsuki, bu i\u015flemi veritaban\u0131n\u0131n kendine \u00f6zg\u00fc SQL (veya NoSQL) sorgusuna \u00e7evirir. E\u011fer veritaban\u0131 \u015femas\u0131nda tan\u0131ml\u0131 olan title<\/code> veya status<\/code> gibi zorunlu alanlar eksik olursa, Mitsuki bir do\u011frulama hatas\u0131 f\u0131rlatacakt\u0131r. Bu, hatal\u0131 veri giri\u015flerini daha erken a\u015famada yakalamak i\u00e7in kritik bir \u00f6zelliktir.<\/p>\n Kay\u0131tlar\u0131 Okuma: findById<\/code>, findAll<\/code> ve Filtreleme Se\u00e7enekleri<\/h3>\nVeritaban\u0131na eklenen kay\u0131tlar\u0131 okumak, bir uygulaman\u0131n temel i\u015flevidir. Mitsuki Repositories, farkl\u0131 senaryolara uygun \u00e7e\u015fitli okuma metodlar\u0131 sunar:<\/p>\n \nTekil Kay\u0131t Okuma (findById<\/code> veya findOne<\/code>):<\/strong> Belirli bir ID'ye sahip kayd\u0131 veya belirli kriterlere uyan ilk kayd\u0131 getirmek i\u00e7in kullan\u0131l\u0131r.<\/li>\n \u00c7oklu Kay\u0131t Okuma (findAll<\/code>, where<\/code>):<\/strong> Belirli kriterlere uyan birden fazla kayd\u0131 veya t\u00fcm kay\u0131tlar\u0131 getirmek i\u00e7in kullan\u0131l\u0131r. Filtreleme, s\u0131ralama ve sayfalama gibi se\u00e7eneklerle zenginle\u015ftirilebilir.<\/li>\n<\/ul>\n\n\/\/ Devam eden index.js dosyas\u0131nda\nasync function readTasks() {\n console.log('\\n--- G\u00f6revleri Okuma \u0130\u015flemleri ---');\n\n \/\/ T\u00fcm g\u00f6revleri listeleme\n const allTasks = await Task.query();\n console.log('T\u00fcm g\u00f6revler:', allTasks.map(task => task.toJSON()));\n\n \/\/ Belirli bir ID ile g\u00f6rev bulma\n const taskIdToFind = allTasks[0] ? allTasks[0].id : 1;\n if (taskIdToFind) {\n const taskById = await Task.query().findById(taskIdToFind);\n console.log(ID ${taskIdToFind} ile bulunan g\u00f6rev:<\/code>, taskById ? taskById.toJSON() : 'Bulunamad\u0131.');\n }\n\n \/\/ Durumu 'pending' olan g\u00f6revleri filtreleme\n const pendingTasks = await Task.query().where('status', 'pending').orderBy('createdAt', 'desc');\n console.log('Bekleyen g\u00f6revler:', pendingTasks.map(task => task.toJSON()));\n\n \/\/ Sayfalama (Pagination) \u00f6rne\u011fi: \u0130lk 10 g\u00f6revi getir\n const paginatedTasks = await Task.query().page(0, 10).orderBy('title');\n console.log('\u0130lk 10 g\u00f6rev (sayfal\u0131):', paginatedTasks.results.map(task => task.toJSON()), 'Toplam:', paginatedTasks.total);\n}\n\n\/\/ main fonksiyonunu g\u00fcncelle\nasync function main() {\n \/\/ ... (yukar\u0131daki kurulum ve insert kodlar\u0131) ...\n await readTasks();\n}\n\nmain();\n<\/pre>\n<\/code><\/p>\n Yukar\u0131daki \u00f6rnekler, Mitsuki'nin esnek sorgu API'si ile nas\u0131l veri \u00e7ekebilece\u011finizi g\u00f6sterir. where<\/code> metodu ile belirli ko\u015fullar tan\u0131mlayabilir, orderBy<\/code> ile sonu\u00e7lar\u0131 s\u0131ralayabilir ve page<\/code> metodu ile sayfalama (pagination) uygulayabilirsiniz. Bu \u00f6zellikler, b\u00fcy\u00fck veri k\u00fcmeleriyle \u00e7al\u0131\u015f\u0131rken performans ve kullan\u0131c\u0131 deneyimi a\u00e7\u0131s\u0131ndan hayati \u00f6neme sahiptir.<\/p>\n Vaka Analizi 2: G\u00f6revleri Durumlar\u0131na G\u00f6re Filtreleyerek Bir UI'da Listeleme<\/strong><\/p>\n Bir web uygulamas\u0131 geli\u015ftirdi\u011finizi d\u00fc\u015f\u00fcn\u00fcn. Kullan\u0131c\u0131lar g\u00f6revlerini \"Bekleyen\" veya \"Tamamlanm\u0131\u015f\" olarak filtreleyebilmelidir. Mitsuki Repositories ile bu i\u015flemi ger\u00e7ekle\u015ftirmek olduk\u00e7a basittir. Frontend taraf\u0131ndan g\u00f6nderilen bir filtre parametresini alarak, repository'nizin where<\/code> metodunu kullan\u0131rs\u0131n\u0131z. \u00d6rne\u011fin:<\/p>\n \n\/\/ \u00d6rnek API endpoint (Node.js Express)\n\/\/ app.get('\/tasks', async (req, res) => {\n\/\/ const { status, page = 0, size = 10 } = req.query;\n\/\/ let query = Task.query();\n\n\/\/ if (status) {\n\/\/ query = query.where('status', status);\n\/\/ }\n\n\/\/ const tasks = await query.page(parseInt(page), parseInt(size));\n\/\/ res.json({\n\/\/ tasks: tasks.results.map(task => task.toJSON()),\n\/\/ total: tasks.total,\n\/\/ page: parseInt(page),\n\/\/ size: parseInt(size)\n\/\/ });\n\/\/ });\n<\/pre>\n<\/code><\/p>\n Bu yakla\u015f\u0131m, kullan\u0131c\u0131lar\u0131n aray\u00fczde yapt\u0131\u011f\u0131 se\u00e7imlere g\u00f6re veritaban\u0131ndan dinamik olarak veri \u00e7ekilmesini sa\u011flar. Mitsuki'nin sa\u011flad\u0131\u011f\u0131 temiz API, bu t\u00fcr dinamik sorgular\u0131 yazmay\u0131 olduk\u00e7a kolayla\u015ft\u0131r\u0131r ve kodunuzun okunakl\u0131l\u0131\u011f\u0131n\u0131 art\u0131r\u0131r. B\u00f6ylece, kullan\u0131c\u0131ya h\u0131zl\u0131 ve etkili bir filtreleme deneyimi sunulabilir.<\/p>\n Veri G\u00fcncelleme (Update) ve Silme (Delete) Operasyonlar\u0131: Mitsuki ile Kay\u0131t Y\u00f6netimi Nas\u0131l Sa\u011flan\u0131r?<\/h2>\nCRUD operasyonlar\u0131n\u0131n son iki aya\u011f\u0131 olan g\u00fcncelleme ve silme i\u015flemleri, veri ya\u015fam d\u00f6ng\u00fcs\u00fcn\u00fcn kritik par\u00e7alar\u0131d\u0131r. Mitsuki Repositories, bu operasyonlar\u0131 da g\u00fcvenli ve verimli bir \u015fekilde ger\u00e7ekle\u015ftirmenizi sa\u011flayan g\u00fc\u00e7l\u00fc metodlar sunar. Bu b\u00f6l\u00fcmde, mevcut g\u00f6rev kay\u0131tlar\u0131n\u0131 nas\u0131l g\u00fcncelleyece\u011fimizi ve ihtiyac\u0131m\u0131z kalmayan kay\u0131tlar\u0131 nas\u0131l silece\u011fimizi \u00f6rneklerle a\u00e7\u0131klayaca\u011f\u0131z.<\/p>\n Mevcut Kay\u0131tlar\u0131 G\u00fcncelleme: update<\/code> Metodu ile Verileri De\u011fi\u015ftirme<\/h3>\nBir g\u00f6rev kayd\u0131n\u0131n ba\u015fl\u0131\u011f\u0131n\u0131, a\u00e7\u0131klamas\u0131n\u0131 veya durumunu de\u011fi\u015ftirmek gibi senaryolar, g\u00fcncelleme operasyonlar\u0131n\u0131 gerektirir. Mitsuki, modeliniz \u00fczerinde update<\/code> metodunu kullanarak bu i\u015flemi olduk\u00e7a basitle\u015ftirir. G\u00fcncelleme yaparken, sadece de\u011fi\u015ftirmek istedi\u011finiz alanlar\u0131 belirtmeniz yeterlidir. Di\u011fer alanlar oldu\u011fu gibi kal\u0131r.<\/p>\n \n\/\/ Devam eden index.js dosyas\u0131nda\nasync function updateTasks() {\n console.log('\\n--- G\u00f6revleri G\u00fcncelleme \u0130\u015flemleri ---');\n\n \/\/ Bir g\u00f6revi bulup g\u00fcncelleme\n const taskToUpdate = await Task.query().findOne({ title: 'Mitsuki Rehberini Yaz' });\n\n if (taskToUpdate) {\n const updatedTask = await taskToUpdate.$query().patch({\n status: 'completed',\n description: 'Mitsuki rehber makalesi ba\u015far\u0131yla tamamland\u0131.'\n });\n console.log('G\u00f6rev ba\u015far\u0131yla g\u00fcncellendi:', updatedTask.toJSON());\n } else {\n console.log('G\u00fcncellenecek g\u00f6rev bulunamad\u0131.');\n }\n\n \/\/ Birden fazla g\u00f6revi toplu olarak g\u00fcncelleme (\u00f6rne\u011fin, t\u00fcm bekleyen g\u00f6revleri iptal etme)\n \/\/ Dikkat: Ger\u00e7ek senaryolarda bu t\u00fcr toplu g\u00fcncellemeleri dikkatli yapmal\u0131s\u0131n\u0131z.\n \/\/ const bulkUpdateResult = await Task.query().where('status', 'pending').patch({ status: 'cancelled' });\n \/\/ console.log(${bulkUpdateResult} adet g\u00f6rev iptal edildi.<\/code>);\n}\n\n\/\/ main fonksiyonunu g\u00fcncelle\nasync function main() {\n \/\/ ... (yukar\u0131daki kurulum, insert ve read kodlar\u0131) ...\n await updateTasks();\n \/\/ ... (deleteTasks fonksiyonunu \u00e7a\u011f\u0131raca\u011f\u0131z) ...\n}\n\nmain();\n<\/pre>\n<\/code><\/p>\n Yukar\u0131daki \u00f6rnekte, \u00f6nce belirli bir ba\u015fl\u0131\u011fa sahip g\u00f6revi bulup, ard\u0131ndan bu g\u00f6revin status<\/code> ve description<\/code> alanlar\u0131n\u0131 g\u00fcncelliyoruz. Mitsuki'nin patch<\/code> metodu, sadece verilen alanlar\u0131 g\u00fcnceller ve di\u011fer alanlar\u0131 etkilemez. Bu yakla\u015f\u0131m, k\u0131smi g\u00fcncellemeler i\u00e7in idealdir ve gereksiz veri transferini engeller. <\/p>\n Uzman \u0130pucu: G\u00fcncelleme i\u015flemlerinde, de\u011fi\u015ftirilmesi gereken alanlar\u0131 a\u00e7\u0131k\u00e7a belirtmek (patch kullanarak) hem performans\u0131 art\u0131r\u0131r hem de veri b\u00fct\u00fcnl\u00fc\u011f\u00fcn\u00fc korur.<\/div>\n<\/p>\nKay\u0131tlar\u0131 Silme: delete<\/code> ve Soft Delete Yakla\u015f\u0131mlar\u0131<\/h3>\nBir g\u00f6revin ya\u015fam d\u00f6ng\u00fcs\u00fcn\u00fcn sonunda, o g\u00f6revi sistemden kald\u0131rmak gerekebilir. Mitsuki, kay\u0131tlar\u0131 kal\u0131c\u0131 olarak silmek i\u00e7in delete<\/code> metodunu sunar. Ancak \u00e7o\u011fu i\u015f uygulamas\u0131nda, verilerin kal\u0131c\u0131 olarak silinmesi yerine \"ar\u015fivlenmesi\" veya \"mant\u0131ksal olarak silinmesi\" (soft delete) tercih edilir. Soft delete, verilerin hala veritaban\u0131nda durdu\u011fu ancak uygulaman\u0131n normal ak\u0131\u015f\u0131nda g\u00f6r\u00fcnmedi\u011fi anlam\u0131na gelir.<\/p>\n \n\/\/ Devam eden index.js dosyas\u0131nda\nasync function deleteTasks() {\n console.log('\\n--- G\u00f6revleri Silme \u0130\u015flemleri ---');\n\n \/\/ Belirli bir g\u00f6revi kal\u0131c\u0131 olarak silme (Hard Delete)\n const taskToDelete = await Task.query().findOne({ title: 'Al\u0131\u015fveri\u015f Yap' });\n if (taskToDelete) {\n await taskToDelete.$query().delete();\n console.log('G\u00f6rev ba\u015far\u0131yla silindi (Hard Delete).');\n } else {\n console.log('Silinecek g\u00f6rev bulunamad\u0131.');\n }\n\n \/\/ Soft Delete yakla\u015f\u0131m\u0131\n \/\/ Task modelimize 'deletedAt' ad\u0131nda yeni bir alan ekledi\u011fimizi varsayal\u0131m\n \/\/ config.js veya Task.js modelimizde bunu tan\u0131mlamam\u0131z gerekir.\n \/\/ Ger\u00e7ek bir soft delete i\u00e7in Task modelinde 'deleted_at' s\u00fctunu olmal\u0131\n \/\/ ve Mitsuki modelinizin bu alan\u0131 otomatik y\u00f6netmesi i\u00e7in bir mekanizma eklenmeli.\n \/\/ Basit bir \u00f6rnek i\u00e7in, manuel olarak g\u00fcncelleyelim:\n const taskToSoftDelete = await Task.query().findOne({ title: 'Mitsuki Rehberini Yaz' }); \/\/ Bu g\u00f6rev tamamland\u0131 olarak i\u015faretlenmi\u015fti.\n if (taskToSoftDelete) {\n await taskToSoftDelete.$query().patch({ deletedAt: new Date().toISOString() });\n console.log('G\u00f6rev ba\u015far\u0131yla silindi (Soft Delete).');\n } else {\n console.log('Soft delete yap\u0131lacak g\u00f6rev bulunamad\u0131.');\n }\n\n \/\/ Soft delete edilmi\u015f g\u00f6revleri sorgulama (yaln\u0131zca aktif olanlar\u0131 getirme)\n const activeTasks = await Task.query().whereNull('deletedAt');\n console.log('Aktif g\u00f6revler:', activeTasks.map(task => task.toJSON()));\n}\n\n\/\/ main fonksiyonunu g\u00fcncelle\nasync function main() {\n \/\/ ... (yukar\u0131daki kurulum, insert, read ve update kodlar\u0131) ...\n await deleteTasks();\n console.log('\\n--- T\u00fcm CRUD Operasyonlar\u0131 Tamamland\u0131 ---');\n}\n\nmain();\n<\/pre>\n<\/code><\/p>\n Kal\u0131c\u0131 silme i\u015flemi i\u00e7in delete()<\/code> metodunu kullan\u0131r\u0131z. Ancak soft delete i\u00e7in, modelimize deletedAt<\/code> gibi bir zaman damgas\u0131 alan\u0131 ekleyerek, bir kayd\u0131 silmek yerine bu alan\u0131 doldururuz. Sorgulama yaparken ise, deletedAt<\/code> alan\u0131 null olan kay\u0131tlar\u0131 filtreleyerek sadece aktif olanlar\u0131 getiririz. Bu yakla\u015f\u0131m, silinen verilere daha sonra ihtiya\u00e7 duyuldu\u011funda geri d\u00f6n\u00fc\u015f imkan\u0131 sunar ve denetlenebilirlik a\u00e7\u0131s\u0131ndan \u00f6nemlidir.<\/p>\n Vaka Analizi 3: Kullan\u0131c\u0131n\u0131n G\u00f6revlerini Silme veya Ar\u015fivleme Se\u00e7enekleri Sunan Bir Aray\u00fcz<\/strong><\/p>\n Bir web uygulamas\u0131nda, kullan\u0131c\u0131lar tamamlanm\u0131\u015f g\u00f6revleri \"Sil\" veya \"Ar\u015fivle\" butonuyla y\u00f6netmek isteyebilir. \"Sil\" butonu, asl\u0131nda bir soft delete i\u015flemi ba\u015flatarak g\u00f6revin deletedAt<\/code> alan\u0131n\u0131 doldurur. \"Ar\u015fivle\" butonu ise, g\u00f6revin durumunu \"archived\" gibi farkl\u0131 bir stat\u00fcye ge\u00e7irir. Bu, kullan\u0131c\u0131n\u0131n verilerini yanl\u0131\u015fl\u0131kla silmesini \u00f6nlerken, y\u00f6neticilerin denetim kay\u0131tlar\u0131na eri\u015fmesine veya kullan\u0131c\u0131lar\u0131n kendi ar\u015fivlenmi\u015f \u00f6\u011felerini g\u00f6rmesine olanak tan\u0131r. Mitsuki Repositories, bu t\u00fcr i\u015f mant\u0131\u011f\u0131n\u0131 veri eri\u015fim katman\u0131ndan soyutlayarak, uygulaman\u0131z\u0131n daha g\u00fcvenli ve esnek olmas\u0131n\u0131 sa\u011flar.<\/p>\n \u00d6zetle, Mitsuki Repositories, hem basit hem de karma\u015f\u0131k veri manip\u00fclasyonu ihtiya\u00e7lar\u0131n\u0131z i\u00e7in kapsaml\u0131 ve g\u00fcvenilir bir \u00e7\u00f6z\u00fcm sunar. Bu temel CRUD operasyonlar\u0131n\u0131 anlamak, Mitsuki ile g\u00fc\u00e7l\u00fc ve s\u00fcrd\u00fcr\u00fclebilir uygulamalar geli\u015ftirmenin ilk ad\u0131m\u0131d\u0131r.<\/p>\n Mitsuki Repositories ile \u0130leri Seviye Yakla\u015f\u0131mlar: Performans, G\u00fcvenlik ve Mimari Optimizasyonlar\u0131<\/h2>\nMitsuki Repositories'in temel CRUD yeteneklerinin \u00f6tesine ge\u00e7erek, uygulaman\u0131z\u0131n performans\u0131n\u0131 art\u0131rmak, g\u00fcvenli\u011fini sa\u011flamak ve mimarisini optimize etmek i\u00e7in kullanabilece\u011finiz ileri seviye yakla\u015f\u0131mlar mevcuttur. Bu b\u00f6l\u00fcmde, verimli sorgulama teknikleri, i\u015flem y\u00f6netimi, hata i\u015fleme ve g\u00fcvenlik ipu\u00e7lar\u0131 \u00fczerinde duraca\u011f\u0131z.<\/p>\n \u0130li\u015fkisel Veriler ve Eager\/Lazy Loading<\/h3>\nGer\u00e7ek d\u00fcnya uygulamalar\u0131nda, veritaban\u0131 tablolar\u0131 genellikle birbiriyle ili\u015fkilidir (\u00f6rne\u011fin, bir g\u00f6rev bir\u00e7ok kullan\u0131c\u0131ya atanabilir veya bir g\u00f6rev bir\u00e7ok etikete sahip olabilir). Mitsuki, bu ili\u015fkileri y\u00f6netmek i\u00e7in g\u00fc\u00e7l\u00fc mekanizmalar sunar. \u0130li\u015fkisel verileri sorgularken, performans a\u00e7\u0131s\u0131ndan Eager Loading (Hevesli Y\u00fckleme)<\/strong> ve Lazy Loading (Tembel Y\u00fckleme)<\/strong> kavramlar\u0131 devreye girer.<\/p>\n \nLazy Loading:<\/strong> Varsay\u0131lan olarak, bir model sorguland\u0131\u011f\u0131nda yaln\u0131zca o modele ait veriler getirilir. \u0130li\u015fkili veriler, onlara ihtiya\u00e7 duyuldu\u011funda ayr\u0131 bir sorgu ile y\u00fcklenir. Bu, \"N+1 sorgu problemi\"ne yol a\u00e7abilir; yani, N adet ana kay\u0131t i\u00e7in N adet ek sorgu anlam\u0131na gelir.<\/li>\n Eager Loading:<\/strong> \u0130li\u015fkili verilerin, ana sorgu ile birlikte tek seferde getirilmesidir. Bu, \u00f6zellikle birden fazla ili\u015fkili veriye ihtiya\u00e7 duydu\u011funuz durumlarda sorgu say\u0131s\u0131n\u0131 azaltarak performans\u0131 \u00f6nemli \u00f6l\u00e7\u00fcde art\u0131r\u0131r. Mitsuki'de withGraphFetched<\/code> veya withGraphJoined<\/code> gibi metodlar bu ama\u00e7la kullan\u0131l\u0131r.<\/li>\n<\/ul>\n\n\/\/ models\/User.js - \u00d6rnek bir kullan\u0131c\u0131 modeli\nconst { Model } = require('mitsuki-repo');\nclass User extends Model {\n static get tableName() { return 'users'; }\n static get relationMappings() {\n return {\n tasks: {\n relation: Model.HasManyRelation,\n modelClass: require('.\/Task'),\n join: {\n from: 'users.id',\n to: 'tasks.userId' \/\/ Bir kullan\u0131c\u0131n\u0131n birden \u00e7ok g\u00f6revi olabilir\n }\n }\n };\n }\n}\nmodule.exports = User;\n<\/pre>\n<\/code><\/p>\n \n\/\/ Bir kullan\u0131c\u0131n\u0131n t\u00fcm g\u00f6revlerini eager loading ile getirme\nconst userWithTasks = await User.query().withGraphFetched('tasks').findById(1);\nconsole.log('Kullan\u0131c\u0131 ve g\u00f6revleri:', userWithTasks.toJSON());\n<\/pre>\n<\/code><\/p>\n Bu \u00f6rnek, bir kullan\u0131c\u0131y\u0131 ve ona ait t\u00fcm g\u00f6revleri tek bir sorguda nas\u0131l getirebilece\u011fimizi g\u00f6sterir. Bu, \u00f6zellikle bir sayfa y\u00fcklemesinde birden fazla ili\u015fkili veri k\u00fcmesini g\u00f6r\u00fcnt\u00fclemeniz gerekti\u011finde performans\u0131 dramatik bir \u015fekilde art\u0131r\u0131r.<\/p>\n \u0130\u015flem Y\u00f6netimi (Transactions) ve Hata Yakalama<\/h3>\nVeritaban\u0131 i\u015flemleri, birden fazla ad\u0131m\u0131 i\u00e7eren ve t\u00fcm ad\u0131mlar\u0131n ba\u015far\u0131l\u0131 olmas\u0131 veya hi\u00e7birinin olmamas\u0131 gereken durumlar i\u00e7in \u00f6nemlidir. \u00d6rne\u011fin, bir g\u00f6revi bir kullan\u0131c\u0131ya atarken, g\u00f6revin durumunu g\u00fcncellemek ve kullan\u0131c\u0131n\u0131n bildirim listesine bir kay\u0131t eklemek gibi. Bu t\u00fcr durumlarda veritaban\u0131 i\u015flemleri (transactions)<\/strong> kullan\u0131l\u0131r.<\/p>\n \n\/\/ Bir i\u015flem i\u00e7inde birden fazla operasyon\nconst { knex } = require('mitsuki-repo'); \/\/ knex instance'\u0131 config.js'den geliyor\n\nasync function assignTaskTransaction(taskId, userId) {\n const transaction = await Task.startTransaction(); \/\/ \u0130\u015flemi ba\u015flat\n try {\n \/\/ G\u00f6revi g\u00fcncelle\n await Task.query(transaction).findById(taskId).patch({ userId: userId, status: 'assigned' });\n \/\/ Kullan\u0131c\u0131ya bildirim ekle (varsay\u0131msal Notification modeli)\n \/\/ await Notification.query(transaction).insert({ userId: userId, message: Yeni g\u00f6rev atand\u0131: ${taskId}<\/code> });\n\n await transaction.commit(); \/\/ T\u00fcm i\u015flemler ba\u015far\u0131l\u0131ysa kaydet\n console.log('G\u00f6rev atama i\u015flemi ba\u015far\u0131l\u0131.');\n } catch (error) {\n await transaction.rollback(); \/\/ Herhangi bir hata durumunda t\u00fcm de\u011fi\u015fiklikleri geri al\n console.error('G\u00f6rev atama i\u015flemi ba\u015far\u0131s\u0131z, geri al\u0131nd\u0131:', error.message);\n }\n}\n\n\/\/ Kullan\u0131m \u00f6rne\u011fi\n\/\/ assignTaskTransaction(1, 2); \/\/ G\u00f6rev ID 1'i Kullan\u0131c\u0131 ID 2'ye ata\n<\/pre>\n<\/code><\/p>\n startTransaction()<\/code>, commit()<\/code> ve rollback()<\/code> metodlar\u0131, i\u015flemlerinizi g\u00fcvenli bir \u015fekilde y\u00f6netmenizi sa\u011flar. Herhangi bir ad\u0131mda bir hata olu\u015fursa, rollback()<\/code> ile t\u00fcm i\u015flemler geri al\u0131n\u0131r ve veritaban\u0131 tutarl\u0131 bir durumda kal\u0131r.<\/p>\n G\u00fcvenlik \u0130pu\u00e7lar\u0131 ve Do\u011frulama Mekanizmalar\u0131<\/h3>\nVeritaban\u0131 g\u00fcvenli\u011fi, her uygulaman\u0131n olmazsa olmaz\u0131d\u0131r. Mitsuki Repositories, SQL enjeksiyonu gibi yayg\u0131n g\u00fcvenlik a\u00e7\u0131klar\u0131na kar\u015f\u0131 yerle\u015fik korumalar sunsa da, ek \u00f6nlemler almak \u00f6nemlidir:<\/p>\n \nGirdi Do\u011frulama (Input Validation):<\/strong> Mitsuki'nin jsonSchema<\/code> \u00f6zelli\u011fi, modelinize gelen verilerin tipini ve format\u0131n\u0131 do\u011frulamak i\u00e7in harika bir ba\u015flang\u0131\u00e7 noktas\u0131d\u0131r. Ancak, karma\u015f\u0131k i\u015f kurallar\u0131n\u0131z\u0131 ve kullan\u0131c\u0131 taraf\u0131ndan g\u00f6nderilen t\u00fcm verileri ek g\u00fcvenlik katmanlar\u0131yla (\u00f6rne\u011fin, Joi veya Yup gibi do\u011frulama k\u00fct\u00fcphaneleriyle) sunucu taraf\u0131nda do\u011frulamak hayati \u00f6neme sahiptir.<\/li>\n Yetkilendirme (Authorization):<\/strong> Kullan\u0131c\u0131n\u0131n belirli bir kayna\u011fa (\u00f6rne\u011fin, bir g\u00f6rev kayd\u0131na) eri\u015fme veya onu de\u011fi\u015ftirme yetkisinin olup olmad\u0131\u011f\u0131n\u0131 kontrol etmek, repository katman\u0131ndan \u00f6nce veya repository metodlar\u0131 i\u00e7inde yap\u0131lmal\u0131d\u0131r. Mitsuki'nin kendisi yetkilendirme sa\u011flamaz, ancak repository metodlar\u0131n\u0131za yetkilendirme kontrollerini entegre edebilirsiniz.<\/li>\n Parameterized Queries:<\/strong> Mitsuki, kulland\u0131\u011f\u0131 ORM\/query builder sayesinde sorgular\u0131 otomatik olarak parametrele\u015ftirir. Bu, kullan\u0131c\u0131 girdilerinin do\u011frudan SQL sorgular\u0131na g\u00f6m\u00fclmesini engelleyerek SQL enjeksiyonu sald\u0131r\u0131lar\u0131na kar\u015f\u0131 koruma sa\u011flar.<\/li>\n<\/ul>\nMobil Uyumluluk ve Duyarl\u0131 Tasar\u0131m i\u00e7in \u0130pu\u00e7lar\u0131<\/h3>\nMitsuki Repositories, backend'de veri eri\u015fimini y\u00f6netti\u011fi i\u00e7in do\u011frudan mobil uyumlulukla ilgili de\u011fildir. Ancak, repository'den gelen verilerin mobil cihazlarda nas\u0131l sunuldu\u011fu, kullan\u0131c\u0131 deneyimi a\u00e7\u0131s\u0131ndan kritik \u00f6neme sahiptir.<\/p>\n Repository'den gelen veriler genellikle JSON format\u0131nda bir API arac\u0131l\u0131\u011f\u0131yla frontend'e (web veya mobil uygulama) ula\u015ft\u0131r\u0131l\u0131r. Frontend'in g\u00f6revi, bu veriyi farkl\u0131 ekran boyutlar\u0131na ve cihaz t\u00fcrlerine uygun \u015fekilde g\u00f6r\u00fcnt\u00fclemektir. Duyarl\u0131 tasar\u0131m (Responsive Design) ilkeleri burada devreye girer. HTML, CSS ve JavaScript kullanarak, uygulaman\u0131z\u0131n farkl\u0131 cihazlarda ayn\u0131 i\u00e7eri\u011fi optimum \u015fekilde sunmas\u0131n\u0131 sa\u011flayabilirsiniz.<\/p>\n \n\n