How karimmalidev/qisto works
Qisto is an installment-sales management app with a React client and Express API. Users sign in, manage customers and products, and create installment contracts; the API also accepts and returns synchronized operations for customers, products, contracts, schedules, payments, and allocations. The client initializes a local database and exposes customer/product screens and contract creation. Source evidence is strongest for API composition, authentication, and sync dispatch; the README is empty, and several client feature files were not excerpted, so uncertain UI-to-service links are omitted.
Main entry points: main.tsx Client routing · app-container.ts Service composition · index.ts Local database · api-client.ts API client
Components 20
Client application
- Client routing
apps/client/src/main.tsx - Sign-in UI
apps/client/src/pages/login/login-page.tsx - Client auth state
apps/client/src/features/auth/auth-provider.tsx - Customer management
apps/client/src/pages/customers/customers-page.tsx - Product management
apps/client/src/pages/products/products-page.tsx - Contract creation
apps/client/src/pages/installment-contracts/create/create-installment-contract-page.tsx - Local database
apps/client/src/db/index.ts - API client
apps/client/src/api-client.ts
API and authentication
- HTTP application
apps/api/src/app.ts - API router
apps/api/src/app-router.ts - Service composition
apps/api/src/app-container.ts - Auth controller
apps/api/src/modules/auth/auth.controller.ts - Auth service
apps/api/src/modules/auth/auth.service.ts
Synchronization
- Sync controller
apps/api/src/modules/sync/sync.controller.ts - Sync service
apps/api/src/modules/sync/sync.service.ts - Operation dispatch
apps/api/src/modules/resources/operation.service.ts
Sales domain and persistence
- Resource upserts
apps/api/src/modules/resources - Server database
apps/api/src/db/schema.ts
Shared contracts
- Shared schemas
packages/schemas/src/schemas
Other components
- User
Connections 27
- User → Client routing: uses
- Client routing → Sign-in UI: routes to
apps/client/src/main.tsx - Client routing → Customer management: routes to
apps/client/src/main.tsx - Client routing → Product management: routes to
apps/client/src/main.tsx - Client routing → Contract creation: routes to
apps/client/src/main.tsx - Client routing → Local database: initializes
apps/client/src/main.tsx - HTTP application → API router: mounts
apps/api/src/app.ts - API router → Service composition: uses
apps/api/src/app-router.ts - Service composition → Auth controller: constructs
apps/api/src/app-container.ts - Service composition → Auth service: constructs
apps/api/src/app-container.ts - Service composition → Sync controller: constructs
apps/api/src/app-container.ts - Service composition → Sync service: constructs
apps/api/src/app-container.ts - Auth controller → Auth service: calls
apps/api/src/modules/auth/auth.controller.ts - Auth service → Server database: reads and writes
apps/api/src/modules/auth/auth.service.ts - Sync controller → Sync service: calls
apps/api/src/modules/sync/sync.controller.ts - Sync service → Operation dispatch: dispatches
apps/api/src/modules/sync/sync.service.ts - Operation dispatch → Resource upserts: dispatches upserts
apps/api/src/modules/resources/operation.service.ts - Operation dispatch → Server database: stores and queries
apps/api/src/modules/resources/operation.service.ts - Resource upserts → Server database: reads and writes
apps/api/src/modules/resources/installment-contract.service.ts - API client → HTTP application: sends requests
- API client → Client auth state: shares token store
apps/client/src/api-client.ts - Customer management → Local database: uses local data
- Product management → Local database: uses local data
- Contract creation → Local database: uses local data
- API client → Shared schemas: validates contracts
apps/client/src/api-client.ts - Auth controller → Shared schemas: parses login
apps/api/src/modules/auth/auth.controller.ts - Sync controller → Shared schemas: parses sync
apps/api/src/modules/sync/sync.controller.ts