From 3dd7c48b08ddd77baec19dbc6f9fc0946372fc75 Mon Sep 17 00:00:00 2001
From: Daan Meijer <daan@studioseptember.nl>
Date: Mon, 15 Jun 2026 23:22:08 +0200
Subject: [PATCH] feat: Implement Ledger alignment and correct corrective
 mutation authors in seeders

---
 app/Http/Requests/StoreLedgerRequest.php      |  1 +
 app/Models/Ledger.php                         |  1 +
 database/factories/LedgerFactory.php          |  1 +
 ..._211757_add_alignment_to_ledgers_table.php | 28 ++++++++++++
 database/seeders/DatabaseSeeder.php           | 13 ++++--
 resources/js/components/CreateLedgerForm.vue  | 28 ++++++++++++
 resources/js/components/LedgerList.vue        | 43 ++++++++++++++++++
 resources/js/components/MutationList.vue      | 26 +++++++++--
 resources/js/pages/Ledgers/Show.vue           | 44 +++++++++++++++++++
 9 files changed, 177 insertions(+), 8 deletions(-)
 create mode 100644 database/migrations/2026_06_15_211757_add_alignment_to_ledgers_table.php

diff --git a/app/Http/Requests/StoreLedgerRequest.php b/app/Http/Requests/StoreLedgerRequest.php
index 18a12d0..8f47082 100644
--- a/app/Http/Requests/StoreLedgerRequest.php
+++ b/app/Http/Requests/StoreLedgerRequest.php
@@ -27,6 +27,7 @@ class StoreLedgerRequest extends FormRequest
         return [
             'name' => ['required', 'string', 'max:255'],
             'rules' => ['nullable', 'string'],
+            'alignment' => ['required', 'string', 'in:positive,neutral,negative'],
             'media' => ['nullable', 'array'],
             'media.*' => ['file', 'mimes:jpg,jpeg,png,gif,mp4,mov,avi,webm', 'max:20480'],
         ];
diff --git a/app/Models/Ledger.php b/app/Models/Ledger.php
index cb49b0f..13a78f1 100644
--- a/app/Models/Ledger.php
+++ b/app/Models/Ledger.php
@@ -18,6 +18,7 @@ class Ledger extends Model
         'name',
         'rules',
         'score',
+        'alignment',
     ];
 
     public function dynamic(): BelongsTo
diff --git a/database/factories/LedgerFactory.php b/database/factories/LedgerFactory.php
index 107ae09..358d68c 100644
--- a/database/factories/LedgerFactory.php
+++ b/database/factories/LedgerFactory.php
@@ -30,6 +30,7 @@ class LedgerFactory extends Factory
             ]),
             'rules' => 'Scores are added by Doms and subtracted for protocol breaches.',
             'score' => 0,
+            'alignment' => 'neutral',
         ];
     }
 }
diff --git a/database/migrations/2026_06_15_211757_add_alignment_to_ledgers_table.php b/database/migrations/2026_06_15_211757_add_alignment_to_ledgers_table.php
new file mode 100644
index 0000000..54b5b46
--- /dev/null
+++ b/database/migrations/2026_06_15_211757_add_alignment_to_ledgers_table.php
@@ -0,0 +1,28 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('ledgers', function (Blueprint $table) {
+            $table->string('alignment')->default('neutral')->after('rules');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('ledgers', function (Blueprint $table) {
+            $table->dropColumn('alignment');
+        });
+    }
+};
diff --git a/database/seeders/DatabaseSeeder.php b/database/seeders/DatabaseSeeder.php
index 50ba27e..150359d 100644
--- a/database/seeders/DatabaseSeeder.php
+++ b/database/seeders/DatabaseSeeder.php
@@ -94,6 +94,7 @@ class DatabaseSeeder extends Seeder
                 'name' => 'Curfew Compliance',
                 'rules' => 'Must be in bed and checked in by 11:00 PM.',
                 'score' => 35,
+                'alignment' => 'positive',
             ]);
 
             $cleaningLedger = Ledger::create([
@@ -101,6 +102,7 @@ class DatabaseSeeder extends Seeder
                 'name' => 'Dungeon Cleaning',
                 'rules' => 'Earn +10 to +20 points for cleaning/setup. Penalty -10 for disorganization.',
                 'score' => 45,
+                'alignment' => 'neutral',
             ]);
 
             $etiquetteLedger = Ledger::create([
@@ -108,6 +110,7 @@ class DatabaseSeeder extends Seeder
                 'name' => 'Protocol & Etiquette',
                 'rules' => 'Address others by correct titles. -5 per infraction.',
                 'score' => -15,
+                'alignment' => 'negative',
             ]);
 
             // Seed Curfew Mutations
@@ -168,7 +171,7 @@ class DatabaseSeeder extends Seeder
 
             Mutation::create([
                 'ledger_id' => $cleaningLedger->id,
-                'user_id' => $bob->id,
+                'user_id' => $alice->id,
                 'type' => 'penalty',
                 'amount' => -10,
                 'description' => 'Left keys in the locks unmonitored',
@@ -209,7 +212,7 @@ class DatabaseSeeder extends Seeder
             // Seed Etiquette Mutations
             Mutation::create([
                 'ledger_id' => $etiquetteLedger->id,
-                'user_id' => $bob->id,
+                'user_id' => $alice->id,
                 'type' => 'penalty',
                 'amount' => -5,
                 'description' => 'Interrupted Domina Alice during daily instructions',
@@ -218,7 +221,7 @@ class DatabaseSeeder extends Seeder
 
             Mutation::create([
                 'ledger_id' => $etiquetteLedger->id,
-                'user_id' => $bob->id,
+                'user_id' => $alice->id,
                 'type' => 'penalty',
                 'amount' => -10,
                 'description' => 'Forgot correct posture during morning roll call',
@@ -227,7 +230,7 @@ class DatabaseSeeder extends Seeder
 
             Mutation::create([
                 'ledger_id' => $etiquetteLedger->id,
-                'user_id' => $bob->id,
+                'user_id' => $alice->id,
                 'type' => 'penalty',
                 'amount' => -5,
                 'description' => 'Spoke out of turn in general chat',
@@ -288,6 +291,7 @@ class DatabaseSeeder extends Seeder
                 'name' => 'Kitchen Chores',
                 'rules' => 'Scores for dishwashing, trash duty, and deep oven cleaning.',
                 'score' => 40,
+                'alignment' => 'positive',
             ]);
 
             $coffeeLedger = Ledger::create([
@@ -295,6 +299,7 @@ class DatabaseSeeder extends Seeder
                 'name' => 'Coffee Machine Maintenance',
                 'rules' => ' refill beans and descale monthly.',
                 'score' => 10,
+                'alignment' => 'neutral',
             ]);
 
             // Seed Chores Mutations
diff --git a/resources/js/components/CreateLedgerForm.vue b/resources/js/components/CreateLedgerForm.vue
index ad3a427..463ff2e 100644
--- a/resources/js/components/CreateLedgerForm.vue
+++ b/resources/js/components/CreateLedgerForm.vue
@@ -9,6 +9,7 @@ const props = defineProps<{
 const form = useForm({
     name: '',
     rules: '',
+    alignment: 'neutral',
     media: [] as File[],
 });
 
@@ -80,6 +81,29 @@ function submit() {
                         </div>
                     </div>
 
+                    <div class="c-create-ledger-form__field">
+                        <label
+                            for="alignment"
+                            class="c-create-ledger-form__label"
+                            >Alignment</label
+                        >
+                        <select
+                            v-model="form.alignment"
+                            id="alignment"
+                            class="c-create-ledger-form__select"
+                        >
+                            <option value="positive">Positive (Higher Score is Better)</option>
+                            <option value="neutral">Neutral (Frictionless / Standard)</option>
+                            <option value="negative">Negative (Lower Score is Better / Demerits)</option>
+                        </select>
+                        <div
+                            v-if="form.errors.alignment"
+                            class="c-create-ledger-form__error"
+                        >
+                            {{ form.errors.alignment }}
+                        </div>
+                    </div>
+
                     <!-- Media Uploads for Ledgers -->
                     <div class="c-create-ledger-form__field">
                         <label
@@ -170,6 +194,10 @@ function submit() {
     @apply mt-1 block w-full rounded-md border border-gray-300 shadow-sm focus:border-indigo-500 focus:ring-indigo-500 dark:border-gray-700 dark:bg-gray-900 dark:text-gray-300 dark:focus:border-indigo-600 dark:focus:ring-indigo-600;
 }
 
+.c-create-ledger-form__select {
+    @apply mt-1 block w-full rounded-md border border-gray-300 bg-white p-2 text-sm shadow-sm focus:border-indigo-500 focus:ring-indigo-500 dark:border-gray-700 dark:bg-gray-900 dark:text-gray-300 dark:focus:border-indigo-600 dark:focus:ring-indigo-600;
+}
+
 .c-create-ledger-form__file-input {
     @apply mt-1 block w-full text-sm text-neutral-500 file:mr-4 file:rounded-md file:border-0 file:bg-indigo-50 file:px-4 file:py-2 file:text-xs file:font-semibold file:text-indigo-700 hover:file:bg-indigo-100;
 }
diff --git a/resources/js/components/LedgerList.vue b/resources/js/components/LedgerList.vue
index 1852596..668f840 100644
--- a/resources/js/components/LedgerList.vue
+++ b/resources/js/components/LedgerList.vue
@@ -8,6 +8,7 @@ defineProps<{
         id: number;
         name: string;
         score: number;
+        alignment: string;
         media?: Array<{ id: number; url: string; mime_type: string }>;
     }>;
 }>();
@@ -41,6 +42,28 @@ defineProps<{
                         Score: {{ ledger.score }}
                     </p>
 
+                    <!-- Ledger Alignment Badge -->
+                    <div class="c-ledger-list__alignment-wrapper">
+                        <span
+                            v-if="ledger.alignment === 'positive'"
+                            class="c-ledger-list__alignment-badge c-ledger-list__alignment-badge--positive"
+                        >
+                            ▲ Higher is Better
+                        </span>
+                        <span
+                            v-else-if="ledger.alignment === 'negative'"
+                            class="c-ledger-list__alignment-badge c-ledger-list__alignment-badge--negative"
+                        >
+                            ▼ Lower is Better
+                        </span>
+                        <span
+                            v-else
+                            class="c-ledger-list__alignment-badge c-ledger-list__alignment-badge--neutral"
+                        >
+                            ◆ Neutral
+                        </span>
+                    </div>
+
                     <!-- Ledger Media Thumbnails -->
                     <div
                         v-if="ledger.media && ledger.media.length > 0"
@@ -103,6 +126,26 @@ defineProps<{
     @apply mt-2 text-sm text-gray-600 dark:text-gray-400;
 }
 
+.c-ledger-list__alignment-wrapper {
+    @apply mt-2 flex items-center;
+}
+
+.c-ledger-list__alignment-badge {
+    @apply text-[10px] font-semibold uppercase tracking-wide px-1.5 py-0.5 rounded;
+}
+
+.c-ledger-list__alignment-badge--positive {
+    @apply text-green-600 bg-green-50/50 dark:text-green-400 dark:bg-green-950/20;
+}
+
+.c-ledger-list__alignment-badge--negative {
+    @apply text-red-600 bg-red-50/50 dark:text-red-400 dark:bg-red-950/20;
+}
+
+.c-ledger-list__alignment-badge--neutral {
+    @apply text-gray-500 bg-gray-50/50 dark:text-gray-400 dark:bg-neutral-800/20;
+}
+
 .c-ledger-list__media-list {
     @apply mt-2 flex flex-wrap gap-1;
 }
diff --git a/resources/js/components/MutationList.vue b/resources/js/components/MutationList.vue
index 2fd7ccc..ea6a99b 100644
--- a/resources/js/components/MutationList.vue
+++ b/resources/js/components/MutationList.vue
@@ -6,6 +6,7 @@ import Chat from '@/components/Chat.vue';
 const props = defineProps<{
     dynamicId: number;
     ledgerId: number;
+    ledgerAlignment?: string;
     mutations: Array<{
         id: number;
         user_id: number;
@@ -44,6 +45,22 @@ function isOwnerUser(userId: number): boolean {
 
     return participant?.pivot?.role === 'owner';
 }
+
+function getAmountClass(amount: number): string {
+    const alignment = props.ledgerAlignment || 'neutral';
+
+    if (alignment === 'positive') {
+        return amount > 0 ? 'c-mutation-list__item-amount--positive' : 'c-mutation-list__item-amount--negative';
+    }
+
+    if (alignment === 'negative') {
+        // Lower is better: negative amount is positive/favorable, positive amount is negative/unfavorable
+        return amount < 0 ? 'c-mutation-list__item-amount--positive' : 'c-mutation-list__item-amount--negative';
+    }
+
+    // Neutral alignment
+    return 'c-mutation-list__item-amount--neutral';
+}
 </script>
 
 <template>
@@ -69,10 +86,7 @@ function isOwnerUser(userId: number): boolean {
                         </span>
                         <div class="c-mutation-list__item-meta">
                             <span
-                                :class="{
-                                    'c-mutation-list__item-amount--positive': mutation.amount > 0,
-                                    'c-mutation-list__item-amount--negative': mutation.amount < 0,
-                                }"
+                                :class="getAmountClass(mutation.amount)"
                                 class="c-mutation-list__item-amount"
                             >
                                 {{ mutation.amount > 0 ? '+' : ''
@@ -210,6 +224,10 @@ function isOwnerUser(userId: number): boolean {
     @apply text-red-500;
 }
 
+.c-mutation-list__item-amount--neutral {
+    @apply text-gray-500 dark:text-gray-400;
+}
+
 .c-mutation-list__item-status {
     @apply rounded px-1.5 py-0.5 text-[10px] font-medium tracking-wider uppercase;
 }
diff --git a/resources/js/pages/Ledgers/Show.vue b/resources/js/pages/Ledgers/Show.vue
index 06c17cb..bee6f0e 100644
--- a/resources/js/pages/Ledgers/Show.vue
+++ b/resources/js/pages/Ledgers/Show.vue
@@ -22,6 +22,7 @@ const props = defineProps<{
         name: string;
         score: number;
         rules: string;
+        alignment: string;
         media?: Array<{ id: number; url: string; mime_type: string }>;
         mutations: Array<{
             id: number;
@@ -175,6 +176,28 @@ function isOwnerUser(userId: number): boolean {
                         {{ ledger.rules }}
                     </p>
 
+                    <!-- Ledger Alignment Badge / Subtitle -->
+                    <div class="c-ledger-show__alignment-wrapper">
+                        <span
+                            v-if="ledger.alignment === 'positive'"
+                            class="c-ledger-show__alignment-badge c-ledger-show__alignment-badge--positive"
+                        >
+                            ▲ Positive Alignment — A higher score is better.
+                        </span>
+                        <span
+                            v-else-if="ledger.alignment === 'negative'"
+                            class="c-ledger-show__alignment-badge c-ledger-show__alignment-badge--negative"
+                        >
+                            ▼ Negative Alignment — A lower score is better (demerits / infractions).
+                        </span>
+                        <span
+                            v-else
+                            class="c-ledger-show__alignment-badge c-ledger-show__alignment-badge--neutral"
+                        >
+                            ◆ Neutral Alignment — Scorekeeping neutral.
+                        </span>
+                    </div>
+
                     <!-- Ledger Descriptive Media -->
                     <div
                         v-if="ledger.media && ledger.media.length > 0"
@@ -219,6 +242,7 @@ function isOwnerUser(userId: number): boolean {
                 :mutations="ledger.mutations"
                 :participants="dynamic.participants"
                 :is-owner="isOwner"
+                :ledger-alignment="ledger.alignment"
                 @open-lightbox="openLightbox"
             />
         </div>
@@ -296,6 +320,26 @@ function isOwnerUser(userId: number): boolean {
     @apply mt-2 text-sm text-gray-600 dark:text-gray-400;
 }
 
+.c-ledger-show__alignment-wrapper {
+    @apply mt-3 flex items-center;
+}
+
+.c-ledger-show__alignment-badge {
+    @apply text-xs font-semibold uppercase tracking-wide px-2.5 py-1 rounded;
+}
+
+.c-ledger-show__alignment-badge--positive {
+    @apply text-green-600 bg-green-50/50 dark:text-green-400 dark:bg-green-950/20;
+}
+
+.c-ledger-show__alignment-badge--negative {
+    @apply text-red-600 bg-red-50/50 dark:text-red-400 dark:bg-red-950/20;
+}
+
+.c-ledger-show__alignment-badge--neutral {
+    @apply text-gray-500 bg-gray-50/50 dark:text-gray-400 dark:bg-neutral-800/20;
+}
+
 .c-ledger-show__media-list {
     @apply mt-4 flex flex-wrap gap-3;
 }