feat: Add LESMEE database migration with hybrid key strategy

- Add 11 new Alembic migrations for LESMEE schema
- Create enums.py with 12 ENUM types
- Restructure models.py with domain-based organization
- Add complete LESMEE models file (lesmee_models_complete.py)
- Implement hybrid key strategy (INT for internal, UUID for public)
- Add 16 new tables: users, staff, customers, products, orders, workflow
- Include proper indexing and relationships

Author: VuQuoc18

backend/app/alembic/versions/03422fadcc73_create_performance_indexes_for_lesmee_.py

@@ -0,0 +1,42 @@
+"""Create performance indexes for LESMEE identity tables
+
+Revision ID: 03422fadcc73
+Revises: a4b98987c493
+Create Date: 2025-11-21 20:06:44.761814
+
+"""
+from alembic import op
+import sqlalchemy as sa
+import sqlmodel.sql.sqltypes
+
+
+# revision identifiers, used by Alembic.
+revision = '03422fadcc73'
+down_revision = 'a4b98987c493'
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    # Core identity indexes
+    op.execute("CREATE INDEX idx_staff_user_id ON staff(user_id);")
+    op.execute("CREATE INDEX idx_users_email ON users(email);")
+    op.execute("CREATE INDEX idx_users_user_type ON users(user_type);")
+    op.execute("CREATE INDEX idx_staff_role ON staff(role);")
+    op.execute("CREATE INDEX idx_staff_availability ON staff(is_available);")
+    op.execute("CREATE INDEX idx_customers_is_vip ON customers(is_vip);")
+
+
+def downgrade():
+    # Drop performance indexes
+    indexes_to_drop = [
+        'idx_customers_is_vip',
+        'idx_staff_availability',
+        'idx_staff_role',
+        'idx_users_user_type',
+        'idx_users_email',
+        'idx_staff_user_id'
+    ]
+
+    for index_name in indexes_to_drop:
+        op.execute(f"DROP INDEX IF EXISTS {index_name}")

backend/app/alembic/versions/1888a26586e5_create_lesmee_settings_and_audit_logs_.py

@@ -0,0 +1,88 @@
+"""Create LESMEE Settings and Audit Logs tables
+
+Revision ID: 1888a26586e5
+Revises: afa0d7780e75
+Create Date: 2025-11-21 20:15:15.383638
+
+"""
+from alembic import op
+import sqlalchemy as sa
+import sqlmodel.sql.sqltypes
+
+
+# revision identifiers, used by Alembic.
+revision = '1888a26586e5'
+down_revision = 'afa0d7780e75'
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    # Settings table
+    op.execute("""
+    CREATE TABLE settings (
+        key VARCHAR(100) PRIMARY KEY,
+        value TEXT,
+        description TEXT,
+        updated_at TIMESTAMPTZ DEFAULT NOW()
+    );
+    """)
+
+    # Audit logs table
+    op.execute("""
+    CREATE TABLE audit_logs (
+        id SERIAL PRIMARY KEY,
+        user_id INT REFERENCES users(id),
+        action_type VARCHAR(50) NOT NULL,
+        table_name VARCHAR(100),
+        record_id VARCHAR(50),
+        old_values JSONB,
+        new_values JSONB,
+        ip_address VARCHAR(45),
+        created_at TIMESTAMPTZ DEFAULT NOW()
+    );
+    """)
+
+    # Create indexes for audit logs
+    op.execute("CREATE INDEX idx_audit_logs_created_at ON audit_logs(created_at DESC);")
+    op.execute("CREATE INDEX idx_audit_logs_user_action ON audit_logs(user_id, action_type);")
+    op.execute("CREATE INDEX idx_audit_logs_table_name ON audit_logs(table_name);")
+
+    # Additional performance indexes
+    op.execute("CREATE INDEX idx_orders_status_deadline ON orders(status, deadline_at);")
+    op.execute("CREATE INDEX idx_orders_customer_product ON orders(customer_id, product_id);")
+    op.execute("CREATE INDEX idx_orders_created_at ON orders(ordered_at DESC);")
+    op.execute("CREATE INDEX idx_order_items_status ON order_items(status);")
+    op.execute("CREATE INDEX idx_order_items_staff ON order_items(assigned_staff_id);")
+    op.execute("CREATE INDEX idx_work_assignments_type_status ON work_assignments(work_type, status);")
+    op.execute("CREATE INDEX idx_work_assignments_assigned_at ON work_assignments(assigned_at DESC);")
+    op.execute("CREATE INDEX idx_work_assignments_completion ON work_assignments(completed_at);")
+    op.execute("CREATE INDEX idx_commissions_staff_type ON commissions(staff_id, commission_type);")
+    op.execute("CREATE INDEX idx_commissions_paid_status ON commissions(is_paid);")
+    op.execute("CREATE INDEX idx_staff_department ON staff(department);")
+    op.execute("CREATE INDEX idx_customers_vip_status ON customers(is_vip);")
+
+
+def downgrade():
+    # Drop additional performance indexes
+    op.execute("DROP INDEX IF EXISTS idx_customers_vip_status")
+    op.execute("DROP INDEX IF EXISTS idx_staff_department")
+    op.execute("DROP INDEX IF EXISTS idx_commissions_paid_status")
+    op.execute("DROP INDEX IF EXISTS idx_commissions_staff_type")
+    op.execute("DROP INDEX IF EXISTS idx_work_assignments_completion")
+    op.execute("DROP INDEX IF EXISTS idx_work_assignments_assigned_at")
+    op.execute("DROP INDEX IF EXISTS idx_work_assignments_type_status")
+    op.execute("DROP INDEX IF EXISTS idx_order_items_staff")
+    op.execute("DROP INDEX IF EXISTS idx_order_items_status")
+    op.execute("DROP INDEX IF EXISTS idx_orders_created_at")
+    op.execute("DROP INDEX IF EXISTS idx_orders_customer_product")
+    op.execute("DROP INDEX IF EXISTS idx_orders_status_deadline")
+
+    # Drop audit log indexes
+    op.execute("DROP INDEX IF EXISTS idx_audit_logs_table_name")
+    op.execute("DROP INDEX IF EXISTS idx_audit_logs_user_action")
+    op.execute("DROP INDEX IF EXISTS idx_audit_logs_created_at")
+
+    # Drop tables
+    op.execute("DROP TABLE IF EXISTS audit_logs")
+    op.execute("DROP TABLE IF EXISTS settings")

backend/app/alembic/versions/61e21c4d3142_add_uuid_extension_for_lesmee_schema.py

@@ -0,0 +1,28 @@
+"""Add UUID extension for LESMEE schema
+
+Revision ID: 61e21c4d3142
+Revises: b2374a5f43e5
+Create Date: 2025-11-21 20:03:26.490669
+
+"""
+from alembic import op
+import sqlalchemy as sa
+import sqlmodel.sql.sqltypes
+
+
+# revision identifiers, used by Alembic.
+revision = '61e21c4d3142'
+down_revision = 'b2374a5f43e5'
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    # Create UUID extension for UUID generation functions
+    op.execute('CREATE EXTENSION IF NOT EXISTS "uuid-ossp"')
+
+
+def downgrade():
+    # Note: Extensions can't be dropped if they're in use
+    # This will be handled in final rollback
+    pass

backend/app/alembic/versions/7941988f444a_create_lesmee_users_table_with_int_.py

@@ -0,0 +1,46 @@
+"""Create LESMEE Users table with INT primary key
+
+Revision ID: 7941988f444a
+Revises: e39fd2ea2f5f
+Create Date: 2025-11-21 20:06:06.762394
+
+"""
+from alembic import op
+import sqlalchemy as sa
+import sqlmodel.sql.sqltypes
+
+
+# revision identifiers, used by Alembic.
+revision = '7941988f444a'
+down_revision = 'e39fd2ea2f5f'
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    op.execute("""
+    CREATE TABLE users (
+        id SERIAL PRIMARY KEY,
+        email VARCHAR(255) UNIQUE NOT NULL,
+        password_hash VARCHAR(255) NOT NULL,
+        full_name VARCHAR(255),
+        phone VARCHAR(50),
+        user_type user_role_type NOT NULL DEFAULT 'customer',
+        is_active BOOLEAN DEFAULT TRUE,
+        last_login_at TIMESTAMPTZ,
+        created_at TIMESTAMPTZ DEFAULT NOW(),
+        updated_at TIMESTAMPTZ DEFAULT NOW()
+    );
+    """)
+
+    # Create trigger for updated_at
+    op.execute("""
+    CREATE TRIGGER update_users_modtime
+    BEFORE UPDATE ON users
+    FOR EACH ROW EXECUTE PROCEDURE update_modified_column();
+    """)
+
+
+def downgrade():
+    op.execute("DROP TRIGGER IF EXISTS update_users_modtime ON users")
+    op.execute("DROP TABLE IF EXISTS users")

backend/app/alembic/versions/7d93e3488432_create_lesmee_products_and_product_.py

@@ -0,0 +1,66 @@
+"""Create LESMEE Products and Product Options tables
+
+Revision ID: 7d93e3488432
+Revises: 03422fadcc73
+Create Date: 2025-11-21 20:11:01.140758
+
+"""
+from alembic import op
+import sqlalchemy as sa
+import sqlmodel.sql.sqltypes
+
+
+# revision identifiers, used by Alembic.
+revision = '7d93e3488432'
+down_revision = '03422fadcc73'
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    # Products table
+    op.execute("""
+    CREATE TABLE products (
+        id SERIAL PRIMARY KEY,
+        name VARCHAR(255) NOT NULL,
+        slug VARCHAR(255) UNIQUE,
+        base_price NUMERIC(19, 4) NOT NULL DEFAULT 0,
+        category VARCHAR(100),
+        description TEXT,
+        is_active BOOLEAN DEFAULT TRUE,
+        commission_config JSONB DEFAULT '{}',
+        metadata JSONB DEFAULT '{}',
+        created_at TIMESTAMPTZ DEFAULT NOW(),
+        updated_at TIMESTAMPTZ DEFAULT NOW()
+    );
+    """)
+
+    # Product options table
+    op.execute("""
+    CREATE TABLE product_options (
+        id SERIAL PRIMARY KEY,
+        product_id INT NOT NULL REFERENCES products(id),
+        option_name VARCHAR(255) NOT NULL,
+        is_required BOOLEAN DEFAULT FALSE,
+        price_adjustment NUMERIC(19, 4) DEFAULT 0,
+        option_values JSONB,
+        created_at TIMESTAMPTZ DEFAULT NOW()
+    );
+    """)
+
+    # Create trigger
+    op.execute("CREATE TRIGGER update_products_modtime BEFORE UPDATE ON products FOR EACH ROW EXECUTE PROCEDURE update_modified_column();")
+
+    # Create indexes
+    op.execute("CREATE INDEX idx_products_category ON products(category);")
+    op.execute("CREATE INDEX idx_products_is_active ON products(is_active);")
+    op.execute("CREATE INDEX idx_product_options_product_id ON product_options(product_id);")
+
+
+def downgrade():
+    op.execute("DROP INDEX IF EXISTS idx_product_options_product_id")
+    op.execute("DROP INDEX IF EXISTS idx_products_is_active")
+    op.execute("DROP INDEX IF EXISTS idx_products_category")
+    op.execute("DROP TRIGGER IF EXISTS update_products_modtime ON products")
+    op.execute("DROP TABLE IF EXISTS product_options")
+    op.execute("DROP TABLE IF EXISTS products")

backend/app/alembic/versions/94d2d958190e_create_lesmee_staff_and_staff_finances_.py

@@ -0,0 +1,55 @@
+"""Create LESMEE Staff and Staff_Finances tables
+
+Revision ID: 94d2d958190e
+Revises: 7941988f444a
+Create Date: 2025-11-21 20:06:21.436135
+
+"""
+from alembic import op
+import sqlalchemy as sa
+import sqlmodel.sql.sqltypes
+
+
+# revision identifiers, used by Alembic.
+revision = '94d2d958190e'
+down_revision = '7941988f444a'
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    # Staff table
+    op.execute("""
+    CREATE TABLE staff (
+        id SERIAL PRIMARY KEY,
+        user_id INT UNIQUE NOT NULL REFERENCES users(id),
+        employee_code VARCHAR(50) UNIQUE,
+        role staff_role_type NOT NULL,
+        department VARCHAR(100),
+        skill_level INT DEFAULT 1,
+        is_available BOOLEAN DEFAULT TRUE,
+        created_at TIMESTAMPTZ DEFAULT NOW(),
+        updated_at TIMESTAMPTZ DEFAULT NOW()
+    );
+    """)
+
+    # Staff finances table
+    op.execute("""
+    CREATE TABLE staff_finances (
+        staff_id INT PRIMARY KEY REFERENCES staff(id),
+        base_salary NUMERIC(19, 4) DEFAULT 0,
+        bank_name VARCHAR(255),
+        bank_account VARCHAR(50),
+        tax_code VARCHAR(50),
+        updated_at TIMESTAMPTZ DEFAULT NOW()
+    );
+    """)
+
+    # Create trigger for staff table
+    op.execute("CREATE TRIGGER update_staff_modtime BEFORE UPDATE ON staff FOR EACH ROW EXECUTE PROCEDURE update_modified_column();")
+
+
+def downgrade():
+    op.execute("DROP TRIGGER IF EXISTS update_staff_modtime ON staff")
+    op.execute("DROP TABLE IF EXISTS staff_finances")
+    op.execute("DROP TABLE IF EXISTS staff")

backend/app/alembic/versions/a1fd466d2512_create_lesmee_invoices_table_for_.py

@@ -0,0 +1,47 @@
+"""Create LESMEE Invoices table for financial management
+
+Revision ID: a1fd466d2512
+Revises: cf2ea22e8259
+Create Date: 2025-11-21 20:11:37.396093
+
+"""
+from alembic import op
+import sqlalchemy as sa
+import sqlmodel.sql.sqltypes
+
+
+# revision identifiers, used by Alembic.
+revision = 'a1fd466d2512'
+down_revision = 'cf2ea22e8259'
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    op.execute("""
+    CREATE TABLE invoices (
+        id UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+        order_id UUID NOT NULL REFERENCES orders(id),
+        invoice_number VARCHAR(50) UNIQUE,
+        amount NUMERIC(19, 4) NOT NULL,
+        status invoice_status_type DEFAULT 'draft',
+        issue_date TIMESTAMPTZ DEFAULT NOW(),
+        due_date TIMESTAMPTZ,
+        paid_date TIMESTAMPTZ,
+        commission_snapshot JSONB DEFAULT '{}',
+        created_at TIMESTAMPTZ DEFAULT NOW(),
+        updated_at TIMESTAMPTZ DEFAULT NOW()
+    );
+    """)
+
+    # Create trigger and indexes
+    op.execute("CREATE TRIGGER update_invoices_modtime BEFORE UPDATE ON invoices FOR EACH ROW EXECUTE PROCEDURE update_modified_column();")
+    op.execute("CREATE INDEX idx_invoices_order_id ON invoices(order_id);")
+    op.execute("CREATE INDEX idx_invoices_status ON invoices(status);")
+
+
+def downgrade():
+    op.execute("DROP INDEX IF EXISTS idx_invoices_status")
+    op.execute("DROP INDEX IF EXISTS idx_invoices_order_id")
+    op.execute("DROP TRIGGER IF EXISTS update_invoices_modtime ON invoices")
+    op.execute("DROP TABLE IF EXISTS invoices")