feat: implement barebones inventory, costing parity, navigation fixes, and Meez design polish

2026-08-17 10:49:03 -05:00
parent d378842b68
commit 685cf86819
40 changed files with 6132 additions and 1110 deletions
@@ -0,0 +1,36 @@
+# Workspace Navigation & Global Search
+
+Formulation provides a streamlined, fast, centralized directory for managing all culinary data across your operation.
+
+---
+
+## 1. Directory Workspace & Workspace Pills
+
+The home directory (`/app/`) categorizes items into distinct workspaces using top pill badges:
+
+- **Recipes** (Blue badge): Standalone formulas, prep recipes, and batch formulations.
+- **Ingredients** (Green badge): Raw culinary ingredients, allergens, density conversions, and supplier links.
+- **Recipe Books** (Purple badge): Curated collections and menus of recipes (e.g. *Dinner Menu*, *Cocktails*, *Bakery Line*).
+- **Purchase Items** (Cyan badge): Commercial vendor packages, invoice pack sizes, prices, and vendor SKUs.
+- **Inventory** (Teal badge): Active and past inventory count sessions with on-hand valuations.
+- **Archive** (Neutral link): Soft-deleted items ready for restoration or permanent purge.
+
+---
+
+## 2. Global Search & Autocompletion
+
+- **Omnibox Search**: Search across recipe titles, ingredient names, aliases, and purchase items simultaneously.
+- **Type Filtering**: Narrow search results by specific entity type directly from the search dropdown filter.
+- **Keyboard Navigation**:
+  - <kbd>Tab</kbd> / <kbd>Arrow Down</kbd>: Highlight matching search candidates.
+  - <kbd>Enter</kbd>: Open the selected recipe or ingredient detail card immediately.
+  - <kbd>Escape</kbd>: Clear search and close active popups.
+
+---
+
+## 3. Detail Utility Bar
+
+Every single item detail page features a fixed top utility bar containing:
+- **Workspace Breadcrumbs**: Direct navigation back to the active directory workspace.
+- **Global Search**: Search and jump to other items without returning to the home screen.
+- **New Action Button (`+ New`)**: Quick creation modal for recipes, ingredients, recipe books, or count sessions from anywhere in the app.