Skip to content
JMS Docs

BusinessManager

BusinessManager

Section titled “BusinessManager”

Status: In progress

Purpose

Section titled “Purpose”

Manages business records, overview listings, and detailed per-business workflows (documents, contacts, implementation, team, and related detail tabs).

Entry Points

Section titled “Entry Points”
  • Module folder: src/modules/BusinessManager
  • Module entry: src/modules/BusinessManager/index.tsx
  • Registry key: business

State Model

Section titled “State Model”

BusinessManager/index.tsx uses nuqs query param id to switch modes:

  • no id -> home/list view
  • id present -> details view wrapped in BusinessProvider

This creates deep-linkable details behavior while keeping list/details in one module.

Key Areas

Section titled “Key Areas”
  • components/Home/* for business list/overview
  • components/BusinessDetails/* for detail workspace
  • context/BusinessProvider.tsx for business-specific context
  • context/businessStepper.ts for multi-step flows

Shared Primitive Usage

Section titled “Shared Primitive Usage”
  • TabManager
  • DynamicTable
  • MultiStepForm/stepper patterns
  • multiple reusable cards/list primitives

Risks and Regression Areas

Section titled “Risks and Regression Areas”
  • query-param/list-details synchronization
  • context lifecycle when switching selected business id
  • detail-tab behavior drift across nested detail components

Documentation TODO

Section titled “Documentation TODO”
  • Add exact details-tab map and responsibilities
  • Add business details data contract and fetch lifecycle
  • Add QA checklist for list -> details -> back transitions