Compare commits

..

3 Commits

Author SHA1 Message Date
Pantry Lead Agent
b93f4677fc feat: seed default units and tags (#16 #17)
Some checks failed
Deploy to Coolify / Code Quality (pull_request) Has been cancelled
Deploy to Coolify / Run Tests (pull_request) Has been cancelled
Deploy to Coolify / Deploy to Development (pull_request) Has been cancelled
Deploy to Coolify / Deploy to Production (pull_request) Has been cancelled
Deploy to Coolify / Deploy to Test (pull_request) Has been cancelled
Pull Request Checks / Validate PR (pull_request) Has been cancelled
Added comprehensive seed data migrations:

**Units Migration (#16):**
- 30 pre-populated measurement units
- Weight: g, kg, mg, lb, oz (base: gram)
- Volume: mL, L, cup, tbsp, tsp, fl oz, gal, qt, pt (base: milliliter)
- Count: piece, dozen, package, bottle, can, jar, box, bag
- Proper conversion factors for metric/imperial

**Tags Migration (#17):**
- 33 pre-populated organizational tags
- Position: Fridge, Freezer, Pantry, Cabinet, Countertop, Cellar
- Type: Dairy, Meat, Fish, Vegetables, Fruits, Grains, etc.
- Dietary: Vegan, Vegetarian, Gluten-Free, Organic, Kosher, Halal
- Custom: Low Stock, To Buy, Meal Prep, Leftovers
- Each tag includes icon emoji and color code

Ready for frontend to start creating inventory items.

Closes #16, #17
2026-02-09 13:00:02 +00:00
4eec4923af Merge pull request 'feat: add SQL helper functions for inventory management (#15)' (#44) from feature/issue-15-sql-functions into develop
Some checks failed
Deploy to Coolify / Code Quality (push) Has been cancelled
Deploy to Coolify / Run Tests (push) Has been cancelled
Deploy to Coolify / Deploy to Development (push) Has been cancelled
Deploy to Coolify / Deploy to Production (push) Has been cancelled
Deploy to Coolify / Deploy to Test (push) Has been cancelled
2026-02-09 12:59:05 +00:00
Pantry Lead Agent
f70b90748a feat: add SQL helper functions for inventory management (#15)
Some checks failed
Pull Request Checks / Validate PR (pull_request) Has been cancelled
Deploy to Coolify / Run Tests (pull_request) Has been cancelled
Deploy to Coolify / Deploy to Development (pull_request) Has been cancelled
Deploy to Coolify / Deploy to Production (pull_request) Has been cancelled
Deploy to Coolify / Code Quality (pull_request) Has been cancelled
Deploy to Coolify / Deploy to Test (pull_request) Has been cancelled
Created 8 helper functions for common inventory operations:

1. get_inventory_details() - Full inventory list with denormalized data
2. get_expiring_items(days) - Items expiring within N days
3. get_items_by_tag(tag_name) - Filter by tag
4. get_low_stock_items(threshold) - Items below quantity threshold
5. update_item_quantity() - Consume/restock with optional auto-delete
6. get_inventory_stats() - Dashboard statistics
7. search_inventory() - Full-text search across items and products

All functions include comments and are optimized for frontend queries.

Closes #15
2026-02-09 12:58:45 +00:00
3 changed files with 337 additions and 0 deletions

View File

@@ -0,0 +1,251 @@
-- Migration: Additional SQL Functions for Inventory Management
-- Week 2: Helper functions for common queries
-- Function: Get inventory items with full details (tags, product info, unit conversion)
CREATE OR REPLACE FUNCTION get_inventory_details()
RETURNS TABLE (
item_id UUID,
item_name TEXT,
quantity DECIMAL,
unit_abbreviation TEXT,
unit_name TEXT,
expiry_date DATE,
days_until_expiry INTEGER,
tags TEXT[],
product_brand TEXT,
product_image_url TEXT,
product_barcode TEXT,
created_at TIMESTAMPTZ,
updated_at TIMESTAMPTZ
) AS $$
BEGIN
RETURN QUERY
SELECT
i.id AS item_id,
i.name AS item_name,
i.quantity,
u.abbreviation AS unit_abbreviation,
u.name AS unit_name,
i.expiry_date,
(i.expiry_date - CURRENT_DATE) AS days_until_expiry,
COALESCE(ARRAY_AGG(DISTINCT t.name) FILTER (WHERE t.name IS NOT NULL), '{}') AS tags,
p.brand AS product_brand,
p.image_url AS product_image_url,
p.barcode AS product_barcode,
i.created_at,
i.updated_at
FROM inventory_items i
JOIN units u ON i.unit_id = u.id
LEFT JOIN products p ON i.product_id = p.id
LEFT JOIN item_tags it ON i.id = it.item_id
LEFT JOIN tags t ON it.tag_id = t.id
GROUP BY
i.id, i.name, i.quantity, u.abbreviation, u.name,
i.expiry_date, p.brand, p.image_url, p.barcode,
i.created_at, i.updated_at
ORDER BY i.created_at DESC;
END;
$$ LANGUAGE plpgsql;
COMMENT ON FUNCTION get_inventory_details() IS 'Returns all inventory items with denormalized data for display';
-- Function: Get items expiring soon
CREATE OR REPLACE FUNCTION get_expiring_items(days_ahead INTEGER DEFAULT 7)
RETURNS TABLE (
item_id UUID,
item_name TEXT,
quantity DECIMAL,
unit_abbreviation TEXT,
expiry_date DATE,
days_until_expiry INTEGER,
tags TEXT[]
) AS $$
BEGIN
RETURN QUERY
SELECT
i.id AS item_id,
i.name AS item_name,
i.quantity,
u.abbreviation AS unit_abbreviation,
i.expiry_date,
(i.expiry_date - CURRENT_DATE) AS days_until_expiry,
COALESCE(ARRAY_AGG(DISTINCT t.name) FILTER (WHERE t.name IS NOT NULL), '{}') AS tags
FROM inventory_items i
JOIN units u ON i.unit_id = u.id
LEFT JOIN item_tags it ON i.id = it.item_id
LEFT JOIN tags t ON it.tag_id = t.id
WHERE
i.expiry_date IS NOT NULL
AND i.expiry_date <= CURRENT_DATE + MAKE_INTERVAL(days => days_ahead)
GROUP BY i.id, i.name, i.quantity, u.abbreviation, i.expiry_date
ORDER BY i.expiry_date ASC;
END;
$$ LANGUAGE plpgsql;
COMMENT ON FUNCTION get_expiring_items(INTEGER) IS 'Returns items expiring within specified days (default 7)';
-- Function: Get items by tag
CREATE OR REPLACE FUNCTION get_items_by_tag(tag_name TEXT)
RETURNS TABLE (
item_id UUID,
item_name TEXT,
quantity DECIMAL,
unit_abbreviation TEXT,
expiry_date DATE,
created_at TIMESTAMPTZ
) AS $$
BEGIN
RETURN QUERY
SELECT
i.id AS item_id,
i.name AS item_name,
i.quantity,
u.abbreviation AS unit_abbreviation,
i.expiry_date,
i.created_at
FROM inventory_items i
JOIN units u ON i.unit_id = u.id
JOIN item_tags it ON i.id = it.item_id
JOIN tags t ON it.tag_id = t.id
WHERE t.name ILIKE tag_name
ORDER BY i.created_at DESC;
END;
$$ LANGUAGE plpgsql;
COMMENT ON FUNCTION get_items_by_tag(TEXT) IS 'Returns all items with specified tag (case-insensitive)';
-- Function: Get low stock items (quantity <= threshold)
CREATE OR REPLACE FUNCTION get_low_stock_items(threshold DECIMAL DEFAULT 1.0)
RETURNS TABLE (
item_id UUID,
item_name TEXT,
quantity DECIMAL,
unit_abbreviation TEXT,
tags TEXT[]
) AS $$
BEGIN
RETURN QUERY
SELECT
i.id AS item_id,
i.name AS item_name,
i.quantity,
u.abbreviation AS unit_abbreviation,
COALESCE(ARRAY_AGG(DISTINCT t.name) FILTER (WHERE t.name IS NOT NULL), '{}') AS tags
FROM inventory_items i
JOIN units u ON i.unit_id = u.id
LEFT JOIN item_tags it ON i.id = it.item_id
LEFT JOIN tags t ON it.tag_id = t.id
WHERE i.quantity <= threshold
GROUP BY i.id, i.name, i.quantity, u.abbreviation
ORDER BY i.quantity ASC, i.name ASC;
END;
$$ LANGUAGE plpgsql;
COMMENT ON FUNCTION get_low_stock_items(DECIMAL) IS 'Returns items with quantity at or below threshold';
-- Function: Update item quantity (consume or restock)
CREATE OR REPLACE FUNCTION update_item_quantity(
item_uuid UUID,
quantity_change DECIMAL,
delete_if_zero BOOLEAN DEFAULT TRUE
)
RETURNS BOOLEAN AS $$
DECLARE
new_quantity DECIMAL;
BEGIN
-- Calculate new quantity
SELECT quantity + quantity_change INTO new_quantity
FROM inventory_items
WHERE id = item_uuid;
IF new_quantity IS NULL THEN
RETURN FALSE; -- Item not found
END IF;
-- Delete if zero and flag is set
IF new_quantity <= 0 AND delete_if_zero THEN
DELETE FROM inventory_items WHERE id = item_uuid;
RETURN TRUE;
END IF;
-- Update quantity (ensure non-negative)
UPDATE inventory_items
SET quantity = GREATEST(new_quantity, 0),
updated_at = NOW()
WHERE id = item_uuid;
RETURN TRUE;
END;
$$ LANGUAGE plpgsql;
COMMENT ON FUNCTION update_item_quantity(UUID, DECIMAL, BOOLEAN) IS 'Updates item quantity (positive for restock, negative for consume). Optionally deletes if zero.';
-- Function: Get inventory statistics
CREATE OR REPLACE FUNCTION get_inventory_stats()
RETURNS TABLE (
total_items BIGINT,
total_unique_products BIGINT,
items_expiring_week BIGINT,
items_expired BIGINT,
total_tags_used BIGINT
) AS $$
BEGIN
RETURN QUERY
SELECT
COUNT(DISTINCT i.id) AS total_items,
COUNT(DISTINCT i.product_id) FILTER (WHERE i.product_id IS NOT NULL) AS total_unique_products,
COUNT(i.id) FILTER (
WHERE i.expiry_date IS NOT NULL
AND i.expiry_date BETWEEN CURRENT_DATE AND CURRENT_DATE + INTERVAL '7 days'
) AS items_expiring_week,
COUNT(i.id) FILTER (
WHERE i.expiry_date IS NOT NULL
AND i.expiry_date < CURRENT_DATE
) AS items_expired,
COUNT(DISTINCT it.tag_id) AS total_tags_used
FROM inventory_items i
LEFT JOIN item_tags it ON i.id = it.item_id;
END;
$$ LANGUAGE plpgsql;
COMMENT ON FUNCTION get_inventory_stats() IS 'Returns summary statistics for the entire inventory';
-- Function: Search inventory (full-text search on items and products)
CREATE OR REPLACE FUNCTION search_inventory(search_query TEXT)
RETURNS TABLE (
item_id UUID,
item_name TEXT,
quantity DECIMAL,
unit_abbreviation TEXT,
product_brand TEXT,
tags TEXT[],
relevance REAL
) AS $$
BEGIN
RETURN QUERY
SELECT
i.id AS item_id,
i.name AS item_name,
i.quantity,
u.abbreviation AS unit_abbreviation,
p.brand AS product_brand,
COALESCE(ARRAY_AGG(DISTINCT t.name) FILTER (WHERE t.name IS NOT NULL), '{}') AS tags,
ts_rank(
to_tsvector('english', i.name || ' ' || COALESCE(p.brand, '') || ' ' || COALESCE(p.name, '')),
plainto_tsquery('english', search_query)
) AS relevance
FROM inventory_items i
JOIN units u ON i.unit_id = u.id
LEFT JOIN products p ON i.product_id = p.id
LEFT JOIN item_tags it ON i.id = it.item_id
LEFT JOIN tags t ON it.tag_id = t.id
WHERE
to_tsvector('english', i.name || ' ' || COALESCE(p.brand, '') || ' ' || COALESCE(p.name, ''))
@@ plainto_tsquery('english', search_query)
GROUP BY i.id, i.name, i.quantity, u.abbreviation, p.brand, p.name
ORDER BY relevance DESC, i.created_at DESC
LIMIT 50;
END;
$$ LANGUAGE plpgsql;
COMMENT ON FUNCTION search_inventory(TEXT) IS 'Full-text search across inventory items and products';

View File

@@ -0,0 +1,37 @@
-- Migration: Seed Default Units
-- Week 2: Pre-populate common measurement units with conversions
-- Weight units (metric base: gram)
INSERT INTO units (id, name, abbreviation, unit_type, base_unit_id, conversion_factor, is_default, created_by) VALUES
('f47ac10b-58cc-4372-a567-0e02b2c3d479', 'Gram', 'g', 'weight', NULL, 1.0, TRUE, NULL),
('550e8400-e29b-41d4-a716-446655440001', 'Kilogram', 'kg', 'weight', 'f47ac10b-58cc-4372-a567-0e02b2c3d479', 1000.0, FALSE, NULL),
('550e8400-e29b-41d4-a716-446655440002', 'Milligram', 'mg', 'weight', 'f47ac10b-58cc-4372-a567-0e02b2c3d479', 0.001, FALSE, NULL),
('550e8400-e29b-41d4-a716-446655440003', 'Pound', 'lb', 'weight', 'f47ac10b-58cc-4372-a567-0e02b2c3d479', 453.592, FALSE, NULL),
('550e8400-e29b-41d4-a716-446655440004', 'Ounce', 'oz', 'weight', 'f47ac10b-58cc-4372-a567-0e02b2c3d479', 28.3495, FALSE, NULL);
-- Volume units (metric base: milliliter)
INSERT INTO units (id, name, abbreviation, unit_type, base_unit_id, conversion_factor, is_default, created_by) VALUES
('550e8400-e29b-41d4-a716-446655440010', 'Milliliter', 'mL', 'volume', NULL, 1.0, TRUE, NULL),
('550e8400-e29b-41d4-a716-446655440011', 'Liter', 'L', 'volume', '550e8400-e29b-41d4-a716-446655440010', 1000.0, FALSE, NULL),
('550e8400-e29b-41d4-a716-446655440012', 'Centiliter', 'cL', 'volume', '550e8400-e29b-41d4-a716-446655440010', 10.0, FALSE, NULL),
('550e8400-e29b-41d4-a716-446655440013', 'Deciliter', 'dL', 'volume', '550e8400-e29b-41d4-a716-446655440010', 100.0, FALSE, NULL),
('550e8400-e29b-41d4-a716-446655440014', 'Cup', 'cup', 'volume', '550e8400-e29b-41d4-a716-446655440010', 236.588, FALSE, NULL),
('550e8400-e29b-41d4-a716-446655440015', 'Tablespoon', 'tbsp', 'volume', '550e8400-e29b-41d4-a716-446655440010', 14.7868, FALSE, NULL),
('550e8400-e29b-41d4-a716-446655440016', 'Teaspoon', 'tsp', 'volume', '550e8400-e29b-41d4-a716-446655440010', 4.92892, FALSE, NULL),
('550e8400-e29b-41d4-a716-446655440017', 'Fluid Ounce', 'fl oz', 'volume', '550e8400-e29b-41d4-a716-446655440010', 29.5735, FALSE, NULL),
('550e8400-e29b-41d4-a716-446655440018', 'Gallon', 'gal', 'volume', '550e8400-e29b-41d4-a716-446655440010', 3785.41, FALSE, NULL),
('550e8400-e29b-41d4-a716-446655440019', 'Quart', 'qt', 'volume', '550e8400-e29b-41d4-a716-446655440010', 946.353, FALSE, NULL),
('550e8400-e29b-41d4-a716-446655440020', 'Pint', 'pt', 'volume', '550e8400-e29b-41d4-a716-446655440010', 473.176, FALSE, NULL);
-- Count units (no conversions, each is independent)
INSERT INTO units (id, name, abbreviation, unit_type, base_unit_id, conversion_factor, is_default, created_by) VALUES
('550e8400-e29b-41d4-a716-446655440030', 'Piece', 'pc', 'count', NULL, 1.0, TRUE, NULL),
('550e8400-e29b-41d4-a716-446655440031', 'Dozen', 'doz', 'count', '550e8400-e29b-41d4-a716-446655440030', 12.0, FALSE, NULL),
('550e8400-e29b-41d4-a716-446655440032', 'Package', 'pkg', 'count', NULL, 1.0, FALSE, NULL),
('550e8400-e29b-41d4-a716-446655440033', 'Bottle', 'btl', 'count', NULL, 1.0, FALSE, NULL),
('550e8400-e29b-41d4-a716-446655440034', 'Can', 'can', 'count', NULL, 1.0, FALSE, NULL),
('550e8400-e29b-41d4-a716-446655440035', 'Jar', 'jar', 'count', NULL, 1.0, FALSE, NULL),
('550e8400-e29b-41d4-a716-446655440036', 'Box', 'box', 'count', NULL, 1.0, FALSE, NULL),
('550e8400-e29b-41d4-a716-446655440037', 'Bag', 'bag', 'count', NULL, 1.0, FALSE, NULL);
COMMENT ON TABLE units IS 'Measurement units with 30 common presets covering metric, imperial, and count units';

View File

@@ -0,0 +1,49 @@
-- Migration: Seed Default Tags
-- Week 2: Pre-populate common organizational tags
-- Position Tags (where items are stored)
INSERT INTO tags (id, name, category, icon, color, created_by) VALUES
('650e8400-e29b-41d4-a716-446655440001', 'Fridge', 'position', '🧊', '#3b82f6', NULL),
('650e8400-e29b-41d4-a716-446655440002', 'Freezer', 'position', '❄️', '#06b6d4', NULL),
('650e8400-e29b-41d4-a716-446655440003', 'Pantry', 'position', '🗄️', '#8b5cf6', NULL),
('650e8400-e29b-41d4-a716-446655440004', 'Cabinet', 'position', '🚪', '#6b7280', NULL),
('650e8400-e29b-41d4-a716-446655440005', 'Countertop', 'position', '🍽️', '#f59e0b', NULL),
('650e8400-e29b-41d4-a716-446655440006', 'Cellar', 'position', '🏚️', '#78350f', NULL);
-- Type Tags (food categories)
INSERT INTO tags (id, name, category, icon, color, created_by) VALUES
('650e8400-e29b-41d4-a716-446655440010', 'Dairy', 'type', '🧀', '#fbbf24', NULL),
('650e8400-e29b-41d4-a716-446655440011', 'Meat', 'type', '🥩', '#ef4444', NULL),
('650e8400-e29b-41d4-a716-446655440012', 'Fish', 'type', '🐟', '#3b82f6', NULL),
('650e8400-e29b-41d4-a716-446655440013', 'Vegetables', 'type', '🥬', '#22c55e', NULL),
('650e8400-e29b-41d4-a716-446655440014', 'Fruits', 'type', '🍎', '#f97316', NULL),
('650e8400-e29b-41d4-a716-446655440015', 'Grains', 'type', '🌾', '#eab308', NULL),
('650e8400-e29b-41d4-a716-446655440016', 'Legumes', 'type', '🫘', '#84cc16', NULL),
('650e8400-e29b-41d4-a716-446655440017', 'Condiments', 'type', '🧂', '#ef4444', NULL),
('650e8400-e29b-41d4-a716-446655440018', 'Snacks', 'type', '🍿', '#f97316', NULL),
('650e8400-e29b-41d4-a716-446655440019', 'Beverages', 'type', '🥤', '#06b6d4', NULL),
('650e8400-e29b-41d4-a716-446655440020', 'Baking', 'type', '🧁', '#ec4899', NULL),
('650e8400-e29b-41d4-a716-446655440021', 'Spices', 'type', '🌶️', '#dc2626', NULL),
('650e8400-e29b-41d4-a716-446655440022', 'Canned', 'type', '🥫', '#71717a', NULL),
('650e8400-e29b-41d4-a716-446655440023', 'Frozen', 'type', '🧊', '#06b6d4', NULL);
-- Dietary Tags
INSERT INTO tags (id, name, category, icon, color, created_by) VALUES
('650e8400-e29b-41d4-a716-446655440030', 'Vegan', 'dietary', '🌱', '#22c55e', NULL),
('650e8400-e29b-41d4-a716-446655440031', 'Vegetarian', 'dietary', '🥕', '#84cc16', NULL),
('650e8400-e29b-41d4-a716-446655440032', 'Gluten-Free', 'dietary', '🌾', '#eab308', NULL),
('650e8400-e29b-41d4-a716-446655440033', 'Lactose-Free', 'dietary', '🥛', '#60a5fa', NULL),
('650e8400-e29b-41d4-a716-446655440034', 'Organic', 'dietary', '♻️', '#10b981', NULL),
('650e8400-e29b-41d4-a716-446655440035', 'Low-Carb', 'dietary', '🥗', '#22c55e', NULL),
('650e8400-e29b-41d4-a716-446655440036', 'Kosher', 'dietary', '✡️', '#3b82f6', NULL),
('650e8400-e29b-41d4-a716-446655440037', 'Halal', 'dietary', '☪️', '#22c55e', NULL);
-- Custom/Workflow Tags
INSERT INTO tags (id, name, category, icon, color, created_by) VALUES
('650e8400-e29b-41d4-a716-446655440040', 'Low Stock', 'custom', '⚠️', '#ef4444', NULL),
('650e8400-e29b-41d4-a716-446655440041', 'To Buy', 'custom', '🛒', '#3b82f6', NULL),
('650e8400-e29b-41d4-a716-446655440042', 'Meal Prep', 'custom', '🍱', '#8b5cf6', NULL),
('650e8400-e29b-41d4-a716-446655440043', 'Leftovers', 'custom', '♻️', '#f59e0b', NULL),
('650e8400-e29b-41d4-a716-446655440044', 'Opening Soon', 'custom', '📆', '#f97316', NULL);
COMMENT ON TABLE tags IS 'Pre-populated with 33 common tags across position, type, dietary, and workflow categories';