Add new frontend dashboard components and update scripts/schema

2025-01-17 15:21:19 -05:00
parent 609490895b
commit 48c7ab9134
14 changed files with 1451 additions and 92 deletions
--- a/inventory-server/db/metrics-schema.sql
+++ b/inventory-server/db/metrics-schema.sql
@@ -63,6 +63,10 @@ CREATE TABLE IF NOT EXISTS product_metrics (
    current_lead_time INT,
    target_lead_time INT,
    lead_time_status VARCHAR(20),
+    -- Forecast metrics
+    forecast_accuracy DECIMAL(5,2) DEFAULT NULL,
+    forecast_bias DECIMAL(5,2) DEFAULT NULL,
+    last_forecast_date DATE DEFAULT NULL,
    PRIMARY KEY (product_id),
    FOREIGN KEY (product_id) REFERENCES products(product_id) ON DELETE CASCADE,
    INDEX idx_metrics_revenue (total_revenue),
@@ -71,7 +75,8 @@ CREATE TABLE IF NOT EXISTS product_metrics (
    INDEX idx_metrics_turnover (turnover_rate),
    INDEX idx_metrics_last_calculated (last_calculated_at),
    INDEX idx_metrics_abc (abc_class),
-    INDEX idx_metrics_sales (daily_sales_avg, weekly_sales_avg, monthly_sales_avg)
+    INDEX idx_metrics_sales (daily_sales_avg, weekly_sales_avg, monthly_sales_avg),
+    INDEX idx_metrics_forecast (forecast_accuracy, forecast_bias)
 );

 -- New table for time-based aggregates
@@ -97,6 +102,20 @@ CREATE TABLE IF NOT EXISTS product_time_aggregates (
    INDEX idx_date (year, month)
 );

+-- Create vendor details table
+CREATE TABLE IF NOT EXISTS vendor_details (
+    vendor VARCHAR(100) NOT NULL,
+    contact_name VARCHAR(100),
+    email VARCHAR(100),
+    phone VARCHAR(20),
+    status VARCHAR(20) DEFAULT 'active',
+    notes TEXT,
+    created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    PRIMARY KEY (vendor),
+    INDEX idx_vendor_status (status)
+);
+
 -- New table for vendor metrics
 CREATE TABLE IF NOT EXISTS vendor_metrics (
    vendor VARCHAR(100) NOT NULL,
@@ -200,10 +219,95 @@ CREATE TABLE IF NOT EXISTS category_sales_metrics (
    INDEX idx_period (period_start, period_end)
 );

+-- New table for brand metrics
+CREATE TABLE IF NOT EXISTS brand_metrics (
+    brand VARCHAR(100) NOT NULL,
+    last_calculated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    -- Product metrics
+    product_count INT DEFAULT 0,
+    active_products INT DEFAULT 0,
+    -- Stock metrics
+    total_stock_units INT DEFAULT 0,
+    total_stock_cost DECIMAL(10,2) DEFAULT 0,
+    total_stock_retail DECIMAL(10,2) DEFAULT 0,
+    -- Sales metrics
+    total_revenue DECIMAL(10,2) DEFAULT 0,
+    avg_margin DECIMAL(5,2) DEFAULT 0,
+    growth_rate DECIMAL(5,2) DEFAULT 0,
+    PRIMARY KEY (brand),
+    INDEX idx_brand_metrics_last_calculated (last_calculated_at),
+    INDEX idx_brand_metrics_revenue (total_revenue),
+    INDEX idx_brand_metrics_growth (growth_rate)
+);
+
+-- New table for brand time-based metrics
+CREATE TABLE IF NOT EXISTS brand_time_metrics (
+    brand VARCHAR(100) NOT NULL,
+    year INT NOT NULL,
+    month INT NOT NULL,
+    -- Product metrics
+    product_count INT DEFAULT 0,
+    active_products INT DEFAULT 0,
+    -- Stock metrics
+    total_stock_units INT DEFAULT 0,
+    total_stock_cost DECIMAL(10,2) DEFAULT 0,
+    total_stock_retail DECIMAL(10,2) DEFAULT 0,
+    -- Sales metrics
+    total_revenue DECIMAL(10,2) DEFAULT 0,
+    avg_margin DECIMAL(5,2) DEFAULT 0,
+    PRIMARY KEY (brand, year, month),
+    INDEX idx_brand_date (year, month)
+);
+
+-- New table for sales forecasts
+CREATE TABLE IF NOT EXISTS sales_forecasts (
+    product_id BIGINT NOT NULL,
+    forecast_date DATE NOT NULL,
+    forecast_units DECIMAL(10,2) DEFAULT 0,
+    forecast_revenue DECIMAL(10,2) DEFAULT 0,
+    confidence_level DECIMAL(5,2) DEFAULT 0,
+    last_calculated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    PRIMARY KEY (product_id, forecast_date),
+    FOREIGN KEY (product_id) REFERENCES products(product_id) ON DELETE CASCADE,
+    INDEX idx_forecast_date (forecast_date),
+    INDEX idx_forecast_last_calculated (last_calculated_at)
+);
+
+-- New table for category forecasts
+CREATE TABLE IF NOT EXISTS category_forecasts (
+    category_id BIGINT NOT NULL,
+    forecast_date DATE NOT NULL,
+    forecast_units DECIMAL(10,2) DEFAULT 0,
+    forecast_revenue DECIMAL(10,2) DEFAULT 0,
+    confidence_level DECIMAL(5,2) DEFAULT 0,
+    last_calculated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    PRIMARY KEY (category_id, forecast_date),
+    FOREIGN KEY (category_id) REFERENCES categories(id) ON DELETE CASCADE,
+    INDEX idx_category_forecast_date (forecast_date),
+    INDEX idx_category_forecast_last_calculated (last_calculated_at)
+);
+
+-- Create table for sales seasonality factors
+CREATE TABLE IF NOT EXISTS sales_seasonality (
+    month INT NOT NULL,
+    seasonality_factor DECIMAL(5,3) DEFAULT 0,
+    last_updated TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    PRIMARY KEY (month),
+    CHECK (month BETWEEN 1 AND 12),
+    CHECK (seasonality_factor BETWEEN -1.0 AND 1.0)
+);
+
+-- Insert default seasonality factors (neutral)
+INSERT INTO sales_seasonality (month, seasonality_factor)
+VALUES 
+    (1, 0), (2, 0), (3, 0), (4, 0), (5, 0), (6, 0),
+    (7, 0), (8, 0), (9, 0), (10, 0), (11, 0), (12, 0)
+ON DUPLICATE KEY UPDATE last_updated = CURRENT_TIMESTAMP;
+
 -- Re-enable foreign key checks
 SET FOREIGN_KEY_CHECKS = 1;

-- Create view for inventory health (after all tables are created)
+-- Create view for inventory health
 CREATE OR REPLACE VIEW inventory_health AS
 WITH product_thresholds AS (
    SELECT 
@@ -298,77 +402,6 @@ LEFT JOIN
 WHERE 
    p.managing_stock = true;

-- Create view for sales trends analysis
-CREATE OR REPLACE VIEW product_sales_trends AS
-SELECT 
-    p.product_id,
-    p.SKU,
-    p.title,
-    COALESCE(SUM(o.quantity), 0) as total_sold,
-    COALESCE(AVG(o.quantity), 0) as avg_quantity_per_order,
-    COALESCE(COUNT(DISTINCT o.order_number), 0) as number_of_orders,
-    MIN(o.date) as first_sale_date,
-    MAX(o.date) as last_sale_date
-FROM 
-    products p
-LEFT JOIN 
-    orders o ON p.product_id = o.product_id
-WHERE 
-    o.canceled = false
-GROUP BY 
-    p.product_id, p.SKU, p.title; 
-
-- Create view for category sales trends
-CREATE OR REPLACE VIEW category_sales_trends AS
-SELECT 
-    c.id as category_id,
-    c.name as category_name,
-    p.brand,
-    COUNT(DISTINCT p.product_id) as num_products,
-    COALESCE(AVG(o.quantity), 0) as avg_daily_sales,
-    COALESCE(SUM(o.quantity), 0) as total_sold,
-    COALESCE(AVG(o.price), 0) as avg_price,
-    MIN(o.date) as first_sale_date,
-    MAX(o.date) as last_sale_date
-FROM 
-    categories c
-JOIN 
-    product_categories pc ON c.id = pc.category_id
-JOIN 
-    products p ON pc.product_id = p.product_id
-LEFT JOIN 
-    orders o ON p.product_id = o.product_id AND o.canceled = false
-GROUP BY 
-    c.id, c.name, p.brand; 
-
-- Create view for vendor performance trends
-CREATE OR REPLACE VIEW vendor_performance_trends AS
-SELECT 
-    v.vendor,
-    v.contact_name,
-    v.status,
-    vm.avg_lead_time_days,
-    vm.on_time_delivery_rate,
-    vm.order_fill_rate,
-    vm.total_orders,
-    vm.total_late_orders,
-    vm.total_purchase_value,
-    vm.avg_order_value,
-    vm.active_products,
-    vm.total_products,
-    vm.total_revenue,
-    vm.avg_margin_percent,
-    CASE 
-        WHEN vm.order_fill_rate >= 95 THEN 'Excellent'
-        WHEN vm.order_fill_rate >= 85 THEN 'Good'
-        WHEN vm.order_fill_rate >= 75 THEN 'Fair'
-        ELSE 'Poor'
-    END as performance_rating
-FROM 
-    vendor_details v
-LEFT JOIN 
-    vendor_metrics vm ON v.vendor = vm.vendor;
-
 -- Create view for category performance trends
 CREATE OR REPLACE VIEW category_performance_trends AS
 SELECT