feat(vendors): add Vendors as first-class browsable tab

Vendors were previously only accessible through quote and service log forms.
Now they have their own tab with full CRUD, inline editing, and aggregate
counts (quotes + service log entries per vendor).

Data layer:
- GetVendor, CreateVendor, UpdateVendor store methods
- CountQuotesByVendor, CountServiceLogsByVendor batch-count helpers

App layer:
- tabVendors TabKind, formVendor FormKind
- vendorHandler implementing TabHandler (no delete -- vendors are referenced by FKs)
- vendorColumnSpecs: ID, Name, Contact, Email, Phone, Website, Quotes, Jobs
- Vendor add/edit/inline forms with vendorFormData
- Quotes tab Vendor column now links to Vendors tab (m:1 FK with enter-to-jump)

Tests:
- 11 new app tests (tab existence, index, kind string, column specs, rows,
  handler, delete/restore errors, navigation, column kinds, FK link, form data)
- 3 new data tests (vendor CRUD, count quotes by vendor, count service logs by vendor)

Docs:
- New vendors.md guide page
- Updated concepts.md, quotes.md, README, website with vendor tab references

[VENDORS-TAB]

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: cpcloud

README.md

@@ -21,6 +21,7 @@ Your house is quietly plotting to break while you sleep -- and you're dreaming a
 - **What if we finally did the backyard?** Projects from napkin sketch to completion -- or graceful abandonment.
 - **How much would it actually cost to...** Quotes side by side, vendor history, and the math you need to actually decide.
 - **Is the dishwasher still under warranty?** Appliance tracking with purchase dates, warranty windows, and linked maintenance.
+- **Who did we use last time?** A dedicated vendor directory with contact info, quote counts, and job history across all your projects and maintenance.
 
 ## Install
 

docs/content/getting-started/concepts.md

@@ -138,17 +138,19 @@ keep it running.
 
 ## Vendors
 
-Vendors are shared entities created through the Quotes and Service Log forms.
-When you add a quote or service log entry, you type a vendor name; micasa
-finds or creates the vendor record. Vendors have name, contact name, email,
-phone, website, and notes.
+Vendors are people and companies you hire. They have their own tab showing
+name, contact, email, phone, website, plus aggregate counts: how many quotes
+and service log entries reference each vendor.
+
+Vendors are also created implicitly through the Quotes and Service Log forms --
+type a vendor name and micasa finds or creates the record.
 
 ### Why this matters
 
 Because vendors are shared, updating a vendor's phone number **in one place**
-updates it everywhere. You won't end up with "Acme Plumbing" and
-"Acme Plumbing LLC" as two separate contacts -- micasa matches on name and
-reuses the existing record.
+updates it everywhere. The Vendors tab gives you a bird's-eye view of everyone
+you've worked with and how often, while the `Vendor` column on the Quotes tab
+is a **live link** -- press `enter` to jump to that vendor's record.
 
 ## Relationships
 

docs/content/guide/quotes.md

@@ -26,7 +26,7 @@ is linked to a project.
 |-------:|------|-------------|-------|
 | `ID` | auto | Auto-assigned | Read-only |
 | `Project` | select | Linked project | Shows as `m:1` link -- press `enter` to jump |
-| `Vendor` | text | Vendor name | Required. Find-or-create: typing a name that exists reuses it |
+| `Vendor` | text | Vendor name | Required. Shows as `m:1` link -- press `enter` to jump to vendor |
 | `Total` | money | Total quote amount | Required |
 | `Labor` | money | Labor portion | Optional |
 | `Mat` | money | Materials portion | Optional |

docs/content/guide/vendors.md

@@ -0,0 +1,52 @@
++++
+title = "Vendors"
+weight = 7
+description = "Browse and manage your vendors."
+linkTitle = "Vendors"
++++
+
+The Vendors tab gives you a single view of everyone you've hired or gotten
+quotes from.
+
+## Columns
+
+| Column | Type | Description | Notes |
+|-------:|------|-------------|-------|
+| `ID` | auto | Auto-assigned | Read-only |
+| `Name` | text | Company or person name | Required, unique |
+| `Contact` | text | Contact person | Optional |
+| `Email` | text | Email address | Optional |
+| `Phone` | text | Phone number | Optional |
+| `Website` | text | URL | Optional |
+| `Quotes` | count | Number of linked quotes | Read-only |
+| `Jobs` | count | Number of linked service log entries | Read-only |
+
+## How vendors are created
+
+Vendors can be created in two ways:
+
+1. **Directly** on the Vendors tab: enter Edit mode (`i`), press `a`
+2. **Implicitly** when adding a quote or service log entry -- type a vendor
+   name and micasa finds or creates the record
+
+## Editing a vendor
+
+Navigate to the Vendors tab, enter Edit mode (`i`), and press `e` on the
+cell you want to change. Edits to a vendor's contact info propagate to all
+quotes and service log entries that reference that vendor.
+
+## Cross-tab navigation
+
+The `Vendor` column on the Quotes tab is a live `m:1` link. Press `enter` on
+a vendor name in the Quotes table to jump to that vendor's row in the Vendors
+tab.
+
+## Counts
+
+The `Quotes` and `Jobs` columns show how many quotes and service log entries
+reference each vendor. These are read-only aggregate counts.
+
+## No deletion
+
+Vendors cannot be deleted because they are referenced by quotes and service
+log entries. If you need to retire a vendor, add a note to their record.

internal/app/forms.go

@@ -90,6 +90,15 @@ type serviceLogFormData struct {
 	Notes             string
 }
 
+type vendorFormData struct {
+	Name        string
+	ContactName string
+	Email       string
+	Phone       string
+	Website     string
+	Notes       string
+}
+
 type applianceFormData struct {
 	Name           string
 	Brand          string
@@ -528,6 +537,115 @@ func (m *Model) parseApplianceFormData() (data.Appliance, error) {
 	}, nil
 }
 
+func (m *Model) startVendorForm() {
+	values := &vendorFormData{}
+	m.openVendorForm(values)
+}
+
+func (m *Model) startEditVendorForm(id uint) error {
+	vendor, err := m.store.GetVendor(id)
+	if err != nil {
+		return fmt.Errorf("load vendor: %w", err)
+	}
+	values := vendorFormValues(vendor)
+	m.editID = &id
+	m.openVendorForm(values)
+	return nil
+}
+
+func (m *Model) openVendorForm(values *vendorFormData) {
+	form := huh.NewForm(
+		huh.NewGroup(
+			huh.NewInput().
+				Title("Name").
+				Placeholder("Acme Plumbing").
+				Value(&values.Name).
+				Validate(requiredText("name")),
+			huh.NewInput().Title("Contact name").Value(&values.ContactName),
+			huh.NewInput().Title("Email").Value(&values.Email),
+			huh.NewInput().Title("Phone").Value(&values.Phone),
+			huh.NewInput().Title("Website").Value(&values.Website),
+			huh.NewText().Title("Notes").Value(&values.Notes),
+		),
+	)
+	applyFormDefaults(form)
+	m.prevMode = m.mode
+	m.mode = modeForm
+	m.formKind = formVendor
+	m.form = form
+	m.formData = values
+	m.snapshotForm()
+}
+
+func (m *Model) submitVendorForm() error {
+	vendor, err := m.parseVendorFormData()
+	if err != nil {
+		return err
+	}
+	return m.store.CreateVendor(vendor)
+}
+
+func (m *Model) submitEditVendorForm(id uint) error {
+	vendor, err := m.parseVendorFormData()
+	if err != nil {
+		return err
+	}
+	vendor.ID = id
+	return m.store.UpdateVendor(vendor)
+}
+
+func (m *Model) parseVendorFormData() (data.Vendor, error) {
+	values, ok := m.formData.(*vendorFormData)
+	if !ok {
+		return data.Vendor{}, fmt.Errorf("unexpected vendor form data")
+	}
+	return data.Vendor{
+		Name:        strings.TrimSpace(values.Name),
+		ContactName: strings.TrimSpace(values.ContactName),
+		Email:       strings.TrimSpace(values.Email),
+		Phone:       strings.TrimSpace(values.Phone),
+		Website:     strings.TrimSpace(values.Website),
+		Notes:       strings.TrimSpace(values.Notes),
+	}, nil
+}
+
+func (m *Model) inlineEditVendor(id uint, col int) error {
+	vendor, err := m.store.GetVendor(id)
+	if err != nil {
+		return fmt.Errorf("load vendor: %w", err)
+	}
+	values := vendorFormValues(vendor)
+	// Column mapping: 0=ID, 1=Name, 2=Contact, 3=Email, 4=Phone, 5=Website, 6=Quotes(ro), 7=Jobs(ro)
+	var field huh.Field
+	switch col {
+	case 1:
+		field = huh.NewInput().Title("Name").Value(&values.Name).Validate(requiredText("name"))
+	case 2:
+		field = huh.NewInput().Title("Contact name").Value(&values.ContactName)
+	case 3:
+		field = huh.NewInput().Title("Email").Value(&values.Email)
+	case 4:
+		field = huh.NewInput().Title("Phone").Value(&values.Phone)
+	case 5:
+		field = huh.NewInput().Title("Website").Value(&values.Website)
+	default:
+		return m.startEditVendorForm(id)
+	}
+	m.openInlineEdit(id, formVendor, field, values)
+	return nil
+}
+
+func vendorFormValues(vendor data.Vendor) *vendorFormData {
+	return &vendorFormData{
+		Name:        vendor.Name,
+		ContactName: vendor.ContactName,
+		Email:       vendor.Email,
+		Phone:       vendor.Phone,
+		Website:     vendor.Website,
+		Notes:       vendor.Notes,
+	}
+}
+
 func (m *Model) inlineEditProject(id uint, col int) error {
 	project, err := m.store.GetProject(id)
 	if err != nil {

internal/app/handlers.go

@@ -500,3 +500,80 @@ func (h serviceLogHandler) Snapshot(store *data.Store, id uint) (undoEntry, bool
 }
 
 func (serviceLogHandler) SyncFixedValues(_ *Model, _ []columnSpec) {}
+
+// ---------------------------------------------------------------------------
+// vendorHandler
+// ---------------------------------------------------------------------------
+
+type vendorHandler struct{}
+
+func (vendorHandler) FormKind() FormKind { return formVendor }
+
+func (vendorHandler) Load(
+	store *data.Store,
+	_ bool,
+) ([]table.Row, []rowMeta, [][]cell, error) {
+	vendors, err := store.ListVendors()
+	if err != nil {
+		return nil, nil, nil, err
+	}
+	ids := make([]uint, len(vendors))
+	for i, v := range vendors {
+		ids[i] = v.ID
+	}
+	quoteCounts, err := store.CountQuotesByVendor(ids)
+	if err != nil {
+		quoteCounts = map[uint]int{}
+	}
+	jobCounts, err := store.CountServiceLogsByVendor(ids)
+	if err != nil {
+		jobCounts = map[uint]int{}
+	}
+	rows, meta, cellRows := vendorRows(vendors, quoteCounts, jobCounts)
+	return rows, meta, cellRows, nil
+}
+
+func (vendorHandler) Delete(_ *data.Store, _ uint) error {
+	return fmt.Errorf("vendors cannot be deleted (referenced by quotes and service logs)")
+}
+
+func (vendorHandler) Restore(_ *data.Store, _ uint) error {
+	return fmt.Errorf("vendors do not support soft-delete")
+}
+
+func (vendorHandler) StartAddForm(m *Model) error {
+	m.startVendorForm()
+	return nil
+}
+
+func (vendorHandler) StartEditForm(m *Model, id uint) error {
+	return m.startEditVendorForm(id)
+}
+
+func (vendorHandler) InlineEdit(m *Model, id uint, col int) error {
+	return m.inlineEditVendor(id, col)
+}
+
+func (vendorHandler) SubmitForm(m *Model) error {
+	if m.editID != nil {
+		return m.submitEditVendorForm(*m.editID)
+	}
+	return m.submitVendorForm()
+}
+
+func (vendorHandler) Snapshot(store *data.Store, id uint) (undoEntry, bool) {
+	vendor, err := store.GetVendor(id)
+	if err != nil {
+		return undoEntry{}, false
+	}
+	return undoEntry{
+		Description: fmt.Sprintf("vendor %q", vendor.Name),
+		FormKind:    formVendor,
+		EntityID:    id,
+		Restore: func() error {
+			return store.UpdateVendor(vendor)
+		},
+	}, true
+}
+
+func (vendorHandler) SyncFixedValues(_ *Model, _ []columnSpec) {}

internal/app/model.go

@@ -1049,6 +1049,8 @@ func tabIndex(kind TabKind) int {
 		return 2
 	case tabAppliances:
 		return 3
+	case tabVendors:
+		return 4
 	default:
 		return 0
 	}