From a50685ec695d6b50f28c2e6774962b59d4f9ecc0 Mon Sep 17 00:00:00 2001
From: Alireza Hassani <alirezahassani@Meshkees-Mac-mini.local>
Date: Tue, 11 Aug 2026 15:23:56 +0330
Subject: [PATCH] Gate Finance behind a super-admin business module.

Add finance to the modules picker and hide sidebar, home tile, and customer invoice actions when it is disabled.

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 apps/business/src/components/Sidebar.tsx      |  1 +
 apps/business/src/pages/CustomersPage.tsx     | 26 ++++++++++++-------
 apps/business/src/pages/HomePage.tsx          |  1 +
 apps/business/src/utils/businessModules.ts    |  1 +
 apps/super-admin/src/utils/businessModules.ts |  2 ++
 docs/PROJECT_CONTEXT.md                       |  2 +-
 6 files changed, 22 insertions(+), 11 deletions(-)

diff --git a/apps/business/src/components/Sidebar.tsx b/apps/business/src/components/Sidebar.tsx
index d09e1bb..a944cf8 100644
--- a/apps/business/src/components/Sidebar.tsx
+++ b/apps/business/src/components/Sidebar.tsx
@@ -142,6 +142,7 @@ export function Sidebar() {
         icon: Wallet,
         labelKey: 'nav.finance',
         basePath: '/finance',
+        moduleId: 'finance',
         children: [
           { labelKey: 'nav.finance.overview', to: '/finance' },
           { labelKey: 'nav.finance.invoices', to: '/invoices' },
diff --git a/apps/business/src/pages/CustomersPage.tsx b/apps/business/src/pages/CustomersPage.tsx
index 901ec11..bbbceca 100644
--- a/apps/business/src/pages/CustomersPage.tsx
+++ b/apps/business/src/pages/CustomersPage.tsx
@@ -12,6 +12,7 @@ import { Pagination } from '../components/Pagination'
 import { ToggleSwitch } from '../components/ToggleSwitch'
 import { Tooltip } from '../components/Tooltip'
 import { useAuth } from '../context/AuthContext'
+import { useTenantBranding } from '../context/TenantBrandingContext'
 import { useToast } from '../context/ToastContext'
 import { useT } from '../i18n/useT'
 import type { BusinessMessageKey } from '../i18n/messages'
@@ -26,6 +27,7 @@ import {
   type CustomerAccessFilter,
   type CustomersListResponse,
 } from '../services/customerService'
+import { hasBusinessModule } from '../utils/businessModules'
 import { formatIrtPrice } from '../utils/irtPrice'
 import { textLocaleAttrs } from '../utils/textLocale'
 import filterStyles from '../components/ListFiltersPanel.module.css'
@@ -74,7 +76,9 @@ export function CustomersPage() {
   const navigate = useNavigate()
   const { locale } = useLocale()
   const { user: authUser } = useAuth()
+  const { enabledModules } = useTenantBranding()
   const { showToast } = useToast()
+  const financeEnabled = hasBusinessModule(enabledModules, 'finance')
   const [data, setData] = useState<CustomersListResponse | null>(null)
   const [loading, setLoading] = useState(false)
   const [error, setError] = useState('')
@@ -537,16 +541,18 @@ export function CustomersPage() {
                               <Pencil size={15} />
                             </button>
                           </Tooltip>
-                          <Tooltip label={t('customers.invoices')}>
-                            <button
-                              type="button"
-                              className={styles.actionBtn}
-                              onClick={() => handleViewInvoices(customer)}
-                              aria-label={t('customers.invoices')}
-                            >
-                              <Receipt size={15} />
-                            </button>
-                          </Tooltip>
+                          {financeEnabled ? (
+                            <Tooltip label={t('customers.invoices')}>
+                              <button
+                                type="button"
+                                className={styles.actionBtn}
+                                onClick={() => handleViewInvoices(customer)}
+                                aria-label={t('customers.invoices')}
+                              >
+                                <Receipt size={15} />
+                              </button>
+                            </Tooltip>
+                          ) : null}
                           <Tooltip label={t('customers.sms')}>
                             <button
                               type="button"
diff --git a/apps/business/src/pages/HomePage.tsx b/apps/business/src/pages/HomePage.tsx
index 7fa01dd..1f76fdc 100644
--- a/apps/business/src/pages/HomePage.tsx
+++ b/apps/business/src/pages/HomePage.tsx
@@ -75,6 +75,7 @@ const sections: {
     descKey: 'home.card.finance.desc',
     linkKey: 'home.card.finance.link',
     href: '/finance',
+    moduleId: 'finance',
   },
   {
     icon: FileText,
diff --git a/apps/business/src/utils/businessModules.ts b/apps/business/src/utils/businessModules.ts
index e20c1a4..e4967d4 100644
--- a/apps/business/src/utils/businessModules.ts
+++ b/apps/business/src/utils/businessModules.ts
@@ -6,6 +6,7 @@ export const BUSINESS_DASHBOARD_MODULE_IDS = [
   'blog',
   'warehouse',
   'videos',
+  'finance',
 ] as const
 
 /** Optional customer-dashboard modules. Always-on: home, profile, addresses, orders, favorites. */
diff --git a/apps/super-admin/src/utils/businessModules.ts b/apps/super-admin/src/utils/businessModules.ts
index 655f6dd..5b7d970 100644
--- a/apps/super-admin/src/utils/businessModules.ts
+++ b/apps/super-admin/src/utils/businessModules.ts
@@ -6,6 +6,7 @@ export const BUSINESS_DASHBOARD_MODULE_IDS = [
   'blog',
   'warehouse',
   'videos',
+  'finance',
 ] as const
 
 /** Optional customer-dashboard modules. Always-on: home, profile, addresses, orders, favorites. */
@@ -32,6 +33,7 @@ export const BUSINESS_DASHBOARD_MODULE_LABELS: Record<
   blog: 'Blog',
   warehouse: 'Warehouse',
   videos: 'Videos',
+  finance: 'Finance',
 }
 
 export const CUSTOMER_MODULE_LABELS: Record<CustomerModuleId, string> = {
diff --git a/docs/PROJECT_CONTEXT.md b/docs/PROJECT_CONTEXT.md
index 98a7824..1121605 100644
--- a/docs/PROJECT_CONTEXT.md
+++ b/docs/PROJECT_CONTEXT.md
@@ -272,7 +272,7 @@ Products accept optional `brandId` on create/update.
 
 ### Business settings
 - `GET/PATCH /businesses/:businessId/settings` — `branding`, `dashboard`, `store`, `modules`
-- `modules.enabled`: optional modules — business: `products`, `store`, `portfolio`, `blog`, `warehouse`, `videos`; customer: `customer_products`. Missing key → all business modules enabled (legacy); customer modules stay opt-in. Super-admin only for modules PATCH.
+- `modules.enabled`: optional modules — business: `products`, `store`, `portfolio`, `blog`, `warehouse`, `videos`, `finance`; customer: `customer_products`. Missing key → all business modules enabled (legacy); customer modules stay opt-in. Super-admin only for modules PATCH.
 - `modules.charts`: two home chart slots (`none`, `orders_30d`, `customers_joined_1y`, `blog_views_30d`, `products_added_1y`); `none` hides that slot; defaults orders + customers.
 - Always-on (not in modules list): business — customers, website, profile, settings, home; customer — home, profile, addresses, orders, favorites
 - Tenant public: `GET /tenants/:host` includes `enabledModules` + `homeCharts`