{"slug":"strategy/business-strategy/DEVELOPER_ONBOARDING","title":"Developer Onboarding","section":"strategy","sectionLabel":"Strategy","status":"unclassified","type":"document","path":"strategy/business-strategy/DEVELOPER_ONBOARDING.mdx","bytes":4160,"description":null,"updated":null,"source":"integratewise/Integratewise-docs-wiki","content":"\n## Repository Structure\n\n```\nintegratewise-live/\n├── apps/web/          # React SPA (Vite + TailwindCSS)\n├── apps/desktop/      # Electron app\n├── apps/mobile/       # React Native (Expo)\n├── packages/          # Shared packages\n│   ├── types/         # TypeScript types (schema, entity360, sync)\n│   ├── lib/           # Shared utilities\n│   ├── connectors/    # 70+ connector implementations\n│   ├── accelerators/  # Domain accelerator sync scopes\n│   ├── config/        # Shared config\n│   ├── rbac/          # Role-based access control\n│   └── spineDb/      # Spine DB client wrappers\n├── services/          # Cloudflare Workers (21 services)\n│   ├── gateway/       # API gateway + routing\n│   ├── spine-v2/      # SSOT + Entity 360 API\n│   ├── normalizer/    # 8-stage pipeline + identity resolution\n│   ├── pipeline/      # Pipeline orchestration\n│   ├── knowledge/     # Context + memory + triage\n│   ├── think/         # AI reasoning + Twin triggers\n│   ├── act/           # Action execution\n│   ├── govern/        # Policy + approval gate\n│   ├── workflow/      # Real-time signals + Durable Objects\n│   ├── connector/     # Connector management\n│   ├── tenants/       # Tenant + OAuth management\n│   └── ...            # billing, admin, agents, etc.\n└── docs/              # Documentation\n```\n\n## Key Concepts\n\n1. **Schema as Backend IP**: Frontend never sees entity_type names. BFF transforms to organic labels.\n2. **Four Flows**: D resolves authority/bindings; A carries structured truth;\n   B carries context/evidence; C carries cognitive candidates.\n3. **Entity 360**: Single unified view. Twin reads only from here.\n4. **8-Stage Pipeline**: Every record passes through all 8 stages. No shortcuts.\n5. **Govern Gate**: Every autonomous action requires approval.\n\n## Surface Boundaries\n\n- The User Workbench is one projection-native work surface.\n- Twin is a silent contextual capability, not a sidebar, destination or separate\n  Workbench. It surfaces only through material context or the Four Buttons.\n- Governance is both a shared platform module and the hard execution gate.\n- Neon owns canonical tenant truth; D1/KV hold bounded reconstructable\n  operational state; R2 holds evidence bytes.\n- Department, industry and role select RBAC projections, KPIs, fields,\n  connectors and capabilities. They do not create physical schemas.\n- L1/L2/L4/L7 remain engineering genealogy and never appear in product UI.\n- The Twin is Cloudflare-native (`iw-agent-runtime`); there is no OpenWebUI in the product.\n- Twin runtime surfaces use Forest + Paper.\n\n## First Steps\n\n```bash\n# 1. Clone and install\ngit clone git@github.com:NirmalPrinceJ/integratewise-live.git\ncd integratewise-live\npnpm install\n\n# 2. Verify build\npnpm typecheck  # 31/31\n\n# 3. Run tests\npnpm test\n\n# 4. Start dev\npnpm dev\n\n# 5. Open web app\nopen http://localhost:3000\n```\n\n## Making Changes\n\n1. Create feature branch from main\n2. Make changes\n3. Run `pnpm typecheck` (must pass 31/31)\n4. Run `pnpm test`\n5. Push and create PR\n6. OpenClaw triage reviews\n7. Merge to main → auto-deploy\n\n## Important Files\n\n| File                                                      | Purpose                                     |\n| --------------------------------------------------------- | ------------------------------------------- |\n| `packages/types/src/schema.ts`                            | 12 domain spine configs, entity types       |\n| `packages/types/src/entity360.ts`                         | Entity 360 type definitions                 |\n| `services/spine-v2/src/index.ts`                          | Entity type → table routing (150+ types)    |\n| `services/think/src/twin-triggers.ts`                     | 10 Twin trigger definitions                 |\n| `services/normalizer/src/index.ts`                        | 8-stage pipeline + S7.5 identity resolution |\n| `apps/web/src/components/l1/workspace/content-router.tsx` | All UI module routing                       |\n"}