MiknasTrading/docs/superpowers/specs/2026-06-01-vat-rfq-design.md

VAT Settings + RFQ Per-Item Vatable Checkbox — Design Spec

Date: 2026-06-01 Status: Approved

---

Overview

Two connected features:

1. Global VAT setting — Admin sets a VAT rate (%) once in Settings. Stored in the existing settings key/value table as vat_rate.
2. Per-item vatable checkbox on RFQ portal — When a supplier fills in their quote, each item row has a "VAT?" checkbox. Ticking it applies the global VAT rate to that item's total. The footer shows a live breakdown: Subtotal → VAT → Grand Total. Everything is stored against the quote on submission.

---

1. VAT Global Setting

Route & Controller

• GET settings/vat → VatSettingController@index — renders the VAT settings page
• POST settings/vat → VatSettingController@update — saves the rate via AJAX, returns JSON

Storage

• Uses the existing Setting model (settings table, key/value pairs)
• Key: vat_rate, value: decimal string e.g. "10" for 10%
• Default when not set: 0

View: resources/views/settings/vat.blade.php

• Extends layouts.app
• Single card with a number input: "VAT Rate (%)" — accepts decimals (e.g. 5, 10, 14.5)
• Save button submits via fetch() AJAX (no page reload, per project rules)
• Shows current saved value on load
• Success/error feedback via showToast()

Sidebar

• Add "VAT Settings" link under the @role('Admin') System section in layouts/app.blade.php
• Active state: request()->routeIs('settings.vat')

---

2. RFQ Portal — Per-Item Vatable Checkbox

Database

• New migration: add is_vatable boolean (default false) to supplier_quote_items table
• SupplierQuoteItem::$fillable gains is_vatable

Controller: RfqPortalController

show() method:

• Load VAT rate: $vatRate = (float) Setting::get('vat_rate', 0)
• Pass $vatRate to rfq.show view

submit() method:

• Add validation rule: 'items.*.is_vatable' => ['nullable', 'boolean']
• When creating each SupplierQuoteItem, set is_vatable from submitted checkbox value
• Calculate VAT: sum of (unit_price × quantity) for vatable items × vatRate / 100
• Store total_amount on SupplierQuote as the VAT-inclusive grand total

View: resources/views/rfq/show.blade.php

Table header — add "VAT?" column:

# | Description | Qty | Unit | Unit Price (BD) | VAT? | Total (BD)

Each item row — add checkbox cell:

<input type="checkbox" name="items[N][is_vatable]" value="1"
       onchange="calcRow(N, qty)" style="accent-color:#2563eb;width:16px;height:16px;">

Footer — replace single "Grand Total" row with three rows:

Subtotal (before VAT):   BD  XXX.XXX
VAT (10%):               BD  XXX.XXX   ← hidden when vatRate is 0
Grand Total:             BD  XXX.XXX

JavaScript calcRow() update:

• Each row calculates its own total (unit_price × qty), unchanged
• recalcTotals() called after every row change:
  • Sums all row totals → subtotal
  • Sums row totals for checked (vatable) rows × vatRate/100 → vatAmount
  • grand = subtotal + vatAmount
  • Updates subtotal, VAT, and grand total display elements
• VAT rate injected as a JS variable: var _vatRate = {{ $vatRate }};
• VAT row is hidden when _vatRate === 0

Mobile stacked layout

On mobile (≤640px), the table renders as cards. The VAT checkbox appears as a labelled row inside each card.

---

3. Data Flow Summary

Admin sets vat_rate = 10 in settings/vat
         ↓
RfqPortalController::show() reads vat_rate, passes to view
         ↓
Supplier ticks VAT on items 1 and 3
         ↓
JS: subtotal = sum(all items), vat = sum(vatable items) × 0.10, grand = subtotal + vat
         ↓
Supplier submits form
         ↓
RfqPortalController::submit():
  - stores is_vatable per SupplierQuoteItem
  - total_amount on SupplierQuote = subtotal + vat (VAT-inclusive)

---

4. Files Touched

File	Change
routes/web.php	Add GET/POST settings/vat routes
app/Http/Controllers/Settings/VatSettingController.php	New controller
resources/views/settings/vat.blade.php	New view
resources/views/layouts/app.blade.php	Add sidebar link
database/migrations/..._add_is_vatable_to_supplier_quote_items.php	New migration
app/Models/SupplierQuoteItem.php	Add is_vatable to $fillable
app/Http/Controllers/Purchase/RfqPortalController.php	Load VAT rate, store is_vatable, calc VAT total
resources/views/rfq/show.blade.php	Add checkbox column, VAT footer breakdown, JS update

---

5. Out of Scope

• Showing VAT breakdown on the internal quote comparison view (can be added later)
• Per-supplier or per-item VAT rates (single global rate only)
• VAT registration numbers