Laravel Kişisel Finans Panosu: Veritabanı Oluşturma

Paylaş

Her başarılı uygulama, sağlam bir veri modeline dayanır. Veritabanı şeması doğru değilse, güzel yazılmış kontrolörlerinizden, güzel Filament kaynaklarınıza kadar her şey yerçekimine karşı savaş vermek gibi hissedecektir.

<p>Bu derste kişisel finans uygulamamızın temel varlıklarını tanımlayacağız. Sadece tablolar oluşturmuyoruz; aynı zamanda alanımızın <em>kelime hazinesini</em> tanımlıyoruz.</p>

<h2>
    Varlıklar
</h2>

<p>Uygulamamızın, para giriş ve çıkışlarını izleyebilmesi için dört temel kavrama ihtiyacı var:</p>

<ol>
    <li><strong>Banka Hesapları</strong>: Paranın bulunduğu yer.</li>
    <li><strong>Kategoriler</strong>: Parayı sınıflandırma şeklimiz (örneğin, "Elektrik", "Yemek").</li>
    <li><strong>Bütçeler</strong>: Mali hedeflerimiz veya limitlerimiz.</li>
    <li><strong>İşlemler</strong>: Sistemin kalbi, harcama veya kazanma kaydı.</li>
</ol>

<h2>
    Artifaktları Oluşturma
</h2>

<p>Laravel, bu yapıları oluşturmayı oldukça kolaylaştırır. Her bir varlığımız için bir Model, bir Migration, bir Factory ve bir Seeder oluşturmamız gerekiyor. Her varlık için dört komut çalıştırmak yerine, <code>-mfs</code> bayraklarını kullanabiliriz.</p>

<p>Aşağıdaki komutları terminalinizde çalıştırın:</p>

<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>php artisan make:model Category <span class="nt">-mfs</span>

php artisan make:model Budget -mfs
php artisan make:model BankAccount -mfs
php artisan make:model Transaction -mfs

<p>Yeşil başarı mesajlarıyla karşılaşmalısınız. Artık dosyalarımız şekillendirilmek için hazır.</p>

<h2>
    "Down" Metotları Üzerine Not
</h2>

<p>Yeni migration dosyalarınızdan birini açın. Bir <code>up</code> metodu ve bir <code>down</code> metodu göreceksiniz.</p>

<p>Size asi bir şey yapmanızı isteyeceğim: <strong><code>down</code> metodunu silin.</strong></p>

<blockquote>
    <p>Neden? Bu projede, <strong>İleriyle Düzeltme</strong> stratejisini benimsiyoruz. Gerçek verilerle bir üretim ortamında migration geri almak (özellikle sütunları veya tabloları silen birini) yıkıcı ve risklidir. Gerçekten hata yaptığımızda, geri almak yerine <em>yeni bir</em> migration oluşturuyoruz. Bu, veritabanı geçmişimizi lineer ve doğru tutar.</p>
</blockquote>

<p>Bu nedenle, yeni migration dosyalarınızdan <code>public function down(): void</code> ifadesini silin. Bu, niyetimizi netleştirir: sadece ilerliyoruz.</p>

<h2>
    Şemayı Tanımlama
</h2>

<p>Tablolarımızın yapısını tanımlayalım.</p>

<h3>
    1. Enum'lar
</h3>

<p>Tablolara geçmeden önce, bir Bütçenin türünü tanımlamak için bir yola ihtiyacımız var. Aylık olarak sıfırladığımız sabit bir bütçe mi yoksa zamanla takip ettiğimiz bir sürenin bütçesi mi? Bunu, tür güvenliğini sağlamak için bir PHP Enum kullanarak yapalım.</p>

<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>php artisan make:enum Enums/BudgetType

<p><code>app/Enums/BudgetType.php</code> dosyasını düzenleyin:</p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code><span class="cp"><?php </span>

namespace App\Enums;

enum BudgetType: string
{
case Reset = ‘reset’;
case Rollover = ‘rollover’;

<span class="k">public</span> <span class="k">function</span> <span class="n">getLabel</span><span class="p">():</span> <span class="kt">string</span>
<span class="p">{</span>
    <span class="k">return</span> <span class="k">match</span> <span class="p">(</span><span class="nv">$this</span><span class="p">)</span> <span class="p">{</span>
        <span class="k">self</span><span class="o">::</span><span class="nc">Reset</span> <span class="o">=&gt;</span> <span class="s1">'Reset'</span><span class="p">,</span>
        <span class="k">self</span><span class="o">::</span><span class="nc">Rollover</span> <span class="o">=&gt;</span> <span class="s1">'Rollover'</span><span class="p">,</span>
    <span class="p">};</span>
<span class="p">}</span>

}

<h3>
    2. Migrations
</h3>

<p>Artık <code>up</code> metotlarımızı dolduralım.</p>

<p><strong><code>create_categories_table.php</code></strong><br/>Kategoriler basittir. Bir isimleri vardır ve bir kullanıcıya aittir.</p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code><span class="nc">Schema</span><span class="o">::</span><span class="nf">create</span><span class="p">(</span><span class="s1">'categories'</span><span class="p">,</span> <span class="k">function</span> <span class="p">(</span><span class="kt">Blueprint</span> <span class="nv">$table</span><span class="p">)</span> <span class="p">{</span>
<span class="nv">$table</span><span class="o">-&gt;</span><span class="nf">id</span><span class="p">();</span>
<span class="nv">$table</span><span class="o">-&gt;</span><span class="nf">foreignId</span><span class="p">(</span><span class="s1">'user_id'</span><span class="p">)</span><span class="o">-&gt;</span><span class="nf">constrained</span><span class="p">()</span><span class="o">-&gt;</span><span class="nf">cascadeOnDelete</span><span class="p">();</span>
<span class="nv">$table</span><span class="o">-&gt;</span><span class="nf">string</span><span class="p">(</span><span class="s1">'name'</span><span class="p">);</span>
<span class="nv">$table</span><span class="o">-&gt;</span><span class="nf">timestamps</span><span class="p">();</span>

<span class="nv">$table</span><span class="o">-&gt;</span><span class="nf">unique</span><span class="p">([</span><span class="s1">'user_id'</span><span class="p">,</span> <span class="s1">'name'</span><span class="p">]);</span>

});

<p><strong><code>create_budgets_table.php</code></strong><br/>Bir bütçe, belirli bir periodo izlemek için bir limit tutar.</p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code><span class="nc">Schema</span><span class="o">::</span><span class="nf">create</span><span class="p">(</span><span class="s1">'budgets'</span><span class="p">,</span> <span class="k">function</span> <span class="p">(</span><span class="kt">Blueprint</span> <span class="nv">$table</span><span class="p">)</span> <span class="p">{</span>
<span class="nv">$table</span><span class="o">-&gt;</span><span class="nf">id</span><span class="p">();</span>
<span class="nv">$table</span><span class="o">-&gt;</span><span class="nf">foreignId</span><span class="p">(</span><span class="s1">'user_id'</span><span class="p">)</span><span class="o">-&gt;</span><span class="nf">constrained</span><span class="p">()</span><span class="o">-&gt;</span><span class="nf">cascadeOnDelete</span><span class="p">();</span>
<span class="nv">$table</span><span class="o">-&gt;</span><span class="nf">string</span><span class="p">(</span><span class="s1">'name'</span><span class="p">);</span>
<span class="nv">$table</span><span class="o">-&gt;</span><span class="nf">integer</span><span class="p">(</span><span class="s1">'amount'</span><span class="p">)</span><span class="o">-&gt;</span><span class="k">default</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span>
<span class="nv">$table</span><span class="o">-&gt;</span><span class="nf">string</span><span class="p">(</span><span class="s1">'type'</span><span class="p">)</span><span class="o">-&gt;</span><span class="k">default</span><span class="p">(</span><span class="s1">'fixed'</span><span class="p">);</span>
<span class="nv">$table</span><span class="o">-&gt;</span><span class="nf">timestamps</span><span class="p">();</span>
<span class="nv">$table</span><span class="o">-&gt;</span><span class="nf">unique</span><span class="p">([</span><span class="s1">'user_id'</span><span class="p">,</span> <span class="s1">'name'</span><span class="p">]);</span>

});

<p><strong><code>create_bank_accounts_table.php</code></strong><br/>Fiziksel veya dijital bir hesabı temsil eder.</p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code><span class="nc">Schema</span><span class="o">::</span><span class="nf">create</span><span class="p">(</span><span class="s1">'bank_accounts'</span><span class="p">,</span> <span class="k">function</span> <span class="p">(</span><span class="kt">Blueprint</span> <span class="nv">$table</span><span class="p">)</span> <span class="p">{</span>
<span class="nv">$table</span><span class="o">-&gt;</span><span class="nf">id</span><span class="p">();</span>
<span class="nv">$table</span><span class="o">-&gt;</span><span class="nf">foreignId</span><span class="p">(</span><span class="s1">'user_id'</span><span class="p">)</span><span class="o">-&gt;</span><span class="nf">constrained</span><span class="p">()</span><span class="o">-&gt;</span><span class="nf">cascadeOnDelete</span><span class="p">();</span>
<span class="nv">$table</span><span class="o">-&gt;</span><span class="nf">string</span><span class="p">(</span><span class="s1>'name'</span><span class="p">);</span>
<span class="nv">$table</span><span class="o">-&gt;</span><span class="nf">unsignedBigInteger</span><span class="p">(</span><span class="s1>'balance'</span><span class="p">)</span><span class="o">-&gt;</span><span class="k">default</span><span class="p">(</span><span class="mi>0</span><span class="p">);</span>
<span class="nv">$table</span><span class="o">-&gt;</span><span class="nf">timestamps</span><span class="p">();</span>

<span class="nv">$table</span><span class="o">-&gt;</span><span class="nf">unique</span><span class="p">([</span><span class="s1>'user_id'</span><span class="p">,</span> <span class="s1>'name'</span><span class="p">]);</span>

});

<p><strong><code>create_transactions_table.php</code></strong><br/>Evrenimizin merkezi. Her şeyi birbirine bağlar.</p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code><span class="nc">Schema</span><span class="o">::</span><span class="nf">create</span><span class="p">(</span><span class="s1>'transactions'</span><span class="p">,</span> <span class="k">function</span> <span class="p">(</span><span class="kt">Blueprint</span> <span class="nv">$table</span><span class="p">)</span> <span class="p">{</span>
<span class="nv">$table</span><span class="o">-></span><span class="nf">id</span><span class="p">();</span>
<span class="nv">$table</span><span class="o">-></span><span class="nf">foreignId</span><span class="p">(</span><span class="s1>'user_id'</span><span class="p">)</span><span class="o">-></span><span class="nf">constrained</span><span class="p">()</span><span class="o">-></span><span class="nf">cascadeOnDelete</span><span class="p">();</span>
<span class="nv">$table</span><span class="o">-></span><span class="nf">foreignId</span><span class="p">(</span><span class="s1>'bank_account_id'</span><span class="p">)</span><span class="o">-></span><span class="nf">constrained</span><span class="p">()</span><span class="o">-></span><span class="nf">cascadeOnDelete</span><span class="p">();</span>
<span class="nv">$table</span><span class="o">-></span><span class="nf">string</span><span class="p">(</span><span class="s1>'description'</span><span class="p">);</span>
<span class="nv">$table</span><span class="o">-></span><span class="nf">foreignId</span><span class="p">(</span><span class="s1>'category_id'</span><span class="p">)</span><span class="o">-></span><span class="nf">constrained</span><span class="p">()</span><span class="o">-></span><span class="nf">cascadeOnDelete</span><span class="p">();</span>
<span class="nv">$table</span><span class="o">-></span><span class="nf">foreignId</span><span class="p">(</span><span class="s1>'budget_id'</span><span class="p">)</span><span class="o">-></span><span class="nf">constrained</span><span class="p">()</span><span class="o">-></span><span class="nf">cascadeOnDelete</span><span class="p">();</span>
<span class="nv">$table</span><span class="o">-></span><span class="nb">date</span><span class="p">(</span><span class="s1>'date'</span><span class="p">);</span>
<span class="nv">$table</span><span class="o">-></span><span class="nf">text</span><span class="p">(</span><span class="s1>'note'</span><span class="p">)-></span><span class="nf">nullable</span><span class="p">();</span>
<span class="nv">$table</span><span class="o">-></span><span class="nf">unsignedInteger</span><span class="p">(</span><span class="s1>'amount'</span><span class="p">);</span>
<span class="nv">$table</span><span class="o">-></span><span class="nf">timestamps</span><span class="p">();</span>

});