{"slug":"strategy/business-strategy/WORKSPACE_INTEGRATION_PLAN","title":"IntegrateWise Workspace Integration Plan","section":"strategy","sectionLabel":"Strategy","status":"unclassified","type":"document","path":"strategy/business-strategy/WORKSPACE_INTEGRATION_PLAN.mdx","bytes":8288,"description":null,"updated":null,"source":"integratewise/Integratewise-docs-wiki","content":"\n> **Tier C — Historical.** This document is a point-in-time snapshot preserved for reference. For current architecture, see [CANONICAL_PLATFORM_ARCHITECTURE.md](../architecture/CANONICAL_PLATFORM_ARCHITECTURE.md).\n\n## Repository Structure Overview\n\n```\n/Users/nirmal/Github/\n│\n├── integratewise-brainstroming/          ← ORIGINAL REPOSITORY\n│   ├── README.md\n│   ├── agents.md                         ← Canonical architecture spec\n│   ├── NAVIGATION.md\n│   ├── SYSTEM_SPECIFICATION.md\n│   │\n│   ├── apps/\n│   │   ├── frontend-figma/               ← 185+ components, Figma export\n│   │   │   ├── src/components/           ← Domain shells, UI components\n│   │   │   ├── src/supabase/             ← Database config\n│   │   │   └── ...\n│   │   ├── business-operations-design/\n│   │   └── business-operations-design-v2/\n│   │\n│   ├── docs/                             ← Infrastructure docs\n│   │   ├── INFRASTRUCTURE_MAPPING.md\n│   │   ├── DATABASE_SCHEMA.md\n│   │   └── ...\n│   │\n│   └── integratewise-complete/           ← CONSOLIDATED WORK\n│       ├── apps/web/                     ← Unified Vite app (our work)\n│       ├── sql-migrations/               ← 49 migrations\n│       └── ...\n│\n└── integratewise-live/                   ← CURRENT WORKING DIRECTORY\n    └── (symlinked to integratewise-complete)\n```\n\n---\n\n## Current State Analysis\n\n### Location 1: `integratewise-brainstroming/apps/frontend-figma/`\n\n**Status:** Original Figma export, 185+ components\n\n- ✅ Complete UI component library\n- ✅ Domain shells (5 domains)\n- ✅ Landing pages\n- ⚠️ Old architecture (pre-L0-L3)\n- ❌ Not bound to backend\n\n### Location 2: `integratewise-brainstroming/integratewise-complete/apps/web/`\n\n**Status:** Our consolidated work\n\n- ✅ Unified Vite + React app\n- ✅ 8 API modules (L3)\n- ✅ 8 React hooks (L2)\n- ✅ 6 app pages (partial L1)\n- ✅ 12 domain views\n- ✅ Auth system\n- ⚠️ Missing 9 L1 modules\n- ⚠️ Missing L0 onboarding\n\n---\n\n## Integration Strategy\n\n### Phase 1: Component Migration (From frontend-figma to web)\n\n**Source:** `apps/frontend-figma/src/components/`\n**Target:** `integratewise-complete/apps/web/src/components/`\n\n| Component Type                      | Count | Action                   |\n| ----------------------------------- | ----- | ------------------------ |\n| UI primitives (Button, Input, etc.) | 45    | ✅ Already have (shadcn) |\n| Domain shells                       | 5     | 🔄 Migrate and enhance   |\n| Layout components                   | 12    | 🔄 Review and adapt      |\n| Marketing sections                  | 24    | ✅ Already have          |\n| Utility components                  | 8     | 🔄 Migrate as needed     |\n\n**Migration Rules:**\n\n1. Keep shadcn/ui components (better maintained)\n2. Migrate domain-specific layouts\n3. Adapt Figma components to new data binding\n4. Preserve animations and interactions\n\n### Phase 2: Domain Shell Integration\n\n**Current (frontend-figma):** 5 domain shells\n\n- Account Success\n- RevOps\n- SalesOps\n- Personal\n- Marketing\n\n**Target (AGENTS.md):** 12 domain views\n\n- Customer Success ← Account Success\n- RevOps ← RevOps\n- Sales ← SalesOps\n- Marketing ← Marketing\n- Personal ← Personal\n- Product & Eng ← NEW\n- Finance ← NEW\n- Service ← NEW\n- Procurement ← NEW\n- IT Admin ← NEW\n- Education ← NEW\n- BizOps ← NEW\n\n**Action:** Expand 5 shells to 12, using existing as base\n\n### Phase 3: L0-L3 Wiring\n\n**Current State:**\n\n- L3: ✅ Complete (8 API modules)\n- L2: ⚠️ Partial (5 of 14 components)\n- L1: ⚠️ Partial (6 of 15 modules)\n- L0: ❌ Missing (login only)\n\n**Integration Work:**\n\n```\nfrontend-figma components\n    ↓ Extract domain layouts\nintegratewise-complete/apps/web\n    ↓ Wire to hooks\nHooks (useDomainEntities, etc.)\n    ↓ Call APIs\nAPI modules (entities, dashboard)\n    ↓ Query\nSupabase (spine_entities)\n```\n\n---\n\n## File Sync Strategy\n\n### Critical Files to Sync\n\n| File                      | Location                           | Action                    |\n| ------------------------- | ---------------------------------- | ------------------------- |\n| `agents.md`               | Root                               | ✅ Reference architecture |\n| `NAVIGATION.md`           | Root                               | ✅ Maintain navigation    |\n| `SYSTEM_SPECIFICATION.md` | Root                               | ✅ Reference spec         |\n| Domain shell components   | `apps/frontend-figma/`             | 🔄 Migrate to web app     |\n| UI components             | `apps/frontend-figma/`             | ⚠️ Review against shadcn  |\n| Marketing pages           | `apps/frontend-figma/`             | ✅ Already migrated       |\n| SQL migrations            | `integratewise-complete/`          | ✅ Current work           |\n| API modules               | `integratewise-complete/apps/web/` | ✅ Current work           |\n\n### One-Way Sync (Current Work → Main)\n\n```bash\n# From: integratewise-live/integratewise-complete/apps/web\n# To:   integratewise-brainstroming/integratewise-complete/apps/web\n\nrsync -av --progress \\\n  apps/web/src/lib/api/ \\\n  ../integratewise-brainstroming/integratewise-complete/apps/web/src/lib/api/\n\nrsync -av --progress \\\n  apps/web/src/hooks/ \\\n  ../integratewise-brainstroming/integratewise-complete/apps/web/src/hooks/\n\nrsync -av --progress \\\n  sql-migrations/ \\\n  ../integratewise-brainstroming/integratewise-complete/sql-migrations/\n```\n\n### Two-Way Sync (Components)\n\n```bash\n# Review and adapt Figma components\n# Manual process for domain shells\n```\n\n---\n\n## Recommended Workflow\n\n### For Testing Tomorrow:\n\n**Option A: Use Current Location (integratewise-live)**\n\n```bash\ncd /Users/nirmal/Github/integratewise-live/integratewise-complete/apps/web\n./scripts/quick-start.sh\n```\n\n- ✅ All our work is here\n- ✅ Latest bindings\n- ✅ Ready to test\n\n**Option B: Use Main Repository (integratewise-brainstroming)**\n\n```bash\ncd /Users/nirmal/Github/integratewise-brainstroming/integratewise-complete/apps/web\nnpm run dev\n```\n\n- ⚠️ Need to verify sync\n- ⚠️ May have older versions\n\n**Recommendation:** Option A for testing, sync to B after verification\n\n---\n\n## Consolidation Checklist\n\n### Pre-Test (Done)\n\n- ✅ Build succeeds\n- ✅ No errors\n- ✅ All imports work\n- ✅ 98% pre-flight score\n\n### Post-Test (After Tomorrow)\n\n- [ ] Sync working code to main repo\n- [ ] Migrate domain shells from frontend-figma\n- [ ] Build missing L1 modules\n- [ ] Build L0 onboarding\n- [ ] Complete L2 components\n\n### Final State (Target)\n\n```\nintegratewise-brainstroming/\n├── apps/\n│   ├── web/                    ← Unified app (merged)\n│   │   ├── src/components/     ← shadcn + migrated shells\n│   │   ├── src/lib/api/        ← L3 APIs\n│   │   ├── src/hooks/          ← L2 hooks\n│   │   └── ...\n│   └── frontend-figma/         ← Archive/reference\n├── docs/                       ← Infrastructure\n└── sql-migrations/             ← Database\n```\n\n---\n\n## Quick Commands\n\n### Test Current Work\n\n```bash\ncd /Users/nirmal/Github/integratewise-live\n./scripts/preflight-check.sh\n./scripts/quick-start.sh\n```\n\n### Sync to Main Repo\n\n```bash\ncd /Users/nirmal/Github/integratewise-live\nrsync -av integratewise-complete/apps/web/src/lib/api/ \\\n  ../integratewise-brainstroming/integratewise-complete/apps/web/src/lib/api/\n```\n\n### Reference Original Components\n\n```bash\ncd /Users/nirmal/Github/integratewise-brainstroming\nls apps/frontend-figma/src/components/domains/\n```\n\n---\n\n## Summary\n\n**Current Working Directory:** `integratewise-live` ← **TEST HERE**\n**Main Repository:** `integratewise-brainstroming` ← **SYNC HERE AFTER**\n**Original Components:** `apps/frontend-figma/` ← **MIGRATE FROM**\n\n**Workflow:**\n\n1. Test in `integratewise-live` tomorrow\n2. Fix any issues found\n3. Sync working code to main repo\n4. Migrate domain shells from frontend-figma\n5. Build missing modules\n\n**Status:** Ready for testing, components available for migration\n"}