How fabielone/business-suite works
Zut CRM is an unfinished modular business-operations suite; the current client workflows are fictional demos, not live synchronized accounts. The principal documented flow is a person using a platform client to work with local/offline records and retry queued commands against the API, where authentication, membership, permissions and domain handlers govern accepted changes stored in PostgreSQL. The graph preserves CRM, production/work, money, teams, time and automation capabilities. Client-to-live-server wiring is intentionally omitted because the README says sign-in and live synchronization are unfinished; some unsampled subsystem links are likewise omitted.
Main entry points: commands.ts Domain commands · app.ts Fastify API · database.ts Database adapter · OperationsApp.tsx Operations workspace
Components 28
Platform clients
- Browser app
apps/web/src/App.tsx - Operations workspace
apps/web/src/operations/OperationsApp.tsx - Operations pages
apps/web/src/operations/pages.tsx - Automation settings UI
apps/web/src/operations/Automations.tsx - Desktop shell
apps/desktop/src/main.ts - Mobile app
apps/mobile/src/App.tsx
Offline runtime
- Browser offline adapter
apps/web/src/offline.ts - Shared sync queue
packages/offline/src/index.ts - Browser local store
apps/web/src/operations/client.ts - Mobile sync client
apps/mobile/src/client.ts - SQLite store
apps/mobile/src/sqliteStore.ts
API and persistence
- Fastify API
apps/api/src/app.ts - JWT verification
apps/api/src/auth.ts - Membership and scope
apps/api/src/context.ts - Job handlers
apps/api/src/jobs.ts - Expense handlers
apps/api/src/expenses.ts - Operations handlers
apps/api/src/operations.ts - Database adapter
apps/api/src/database.ts
Business domain
- Domain commands
packages/core/src/operations/commands.ts - Business records
packages/core/src/operations/types.ts - CRM and intake
packages/core/src/operations/intake.ts - Production workflow
packages/core/src/operations/production.ts - Automations
packages/core/src/operations/automations.ts - Teams and queues
packages/core/src/operations/teams.ts - Money calculations
packages/core/src/operations/calculations.ts - Time tracking
packages/core/src/operations/time.ts
External services
- PostgreSQL
Other components
- Business user
Connections 33
- Business user → Browser app: uses
README.md - Business user → Mobile app: uses
README.md - Business user → Desktop shell: uses
README.md - Browser app → Browser offline adapter: uses
apps/web/src/App.tsx - Browser app → Operations workspace: renders
apps/web/src/main.tsx - Operations workspace → Operations pages: renders
apps/web/src/operations/OperationsApp.tsx - Operations workspace → Automation settings UI: renders
apps/web/src/operations/OperationsApp.tsx - Operations workspace → Browser local store: uses
apps/web/src/operations/OperationsApp.tsx - Browser offline adapter → Shared sync queue: uses
- Mobile app → Mobile sync client: uses
apps/mobile/src/App.tsx - Mobile sync client → Shared sync queue: uses
apps/mobile/src/client.ts - Mobile sync client → SQLite store: persists locally
apps/mobile/src/client.ts - Fastify API → JWT verification: verifies identity
apps/api/src/app.ts - Fastify API → Membership and scope: runs in scope
apps/api/src/app.ts - Fastify API → Job handlers: dispatches jobs
apps/api/src/app.ts - Fastify API → Expense handlers: dispatches expenses
apps/api/src/app.ts - Membership and scope → Database adapter: queries
apps/api/src/context.ts - Job handlers → Database adapter: queries
apps/api/src/jobs.ts - Expense handlers → Database adapter: queries
apps/api/src/expenses.ts - Fastify API → Operations handlers: dispatches operations
apps/api/src/app.ts - Operations handlers → Database adapter: queries
apps/api/src/operations.ts - Database adapter → PostgreSQL: queries
apps/api/src/database.ts - Domain commands → Business records: uses contracts
packages/core/src/operations/commands.ts - Domain commands → CRM and intake: uses intake rules
packages/core/src/operations/commands.ts - Domain commands → Production workflow: uses production rules
packages/core/src/operations/commands.ts - Domain commands → Automations: runs automation rules
packages/core/src/operations/commands.ts - Domain commands → Teams and queues: uses queue rules
packages/core/src/operations/commands.ts - Domain commands → Money calculations: uses calculations
packages/core/src/operations/commands.ts - Browser local store → Domain commands: executes commands
apps/web/src/operations/client.ts - Production workflow → Money calculations: uses calculations
packages/core/src/operations/production.ts - Automations → Production workflow: reads orders
packages/core/src/operations/automations.ts - Automations → Teams and queues: checks queues
packages/core/src/operations/automations.ts - Business user → Time tracking: records work