How amirelhalabi/liratek works
LiraTek is a point-of-sale and inventory system for phone and electronics shops, shipped as an offline-first Electron app and a multi-tenant web app. Staff use the renderer to manage stock, sell products and services, handle customer sessions and debts, and review financial records. Electron IPC and web REST are alternate transports into shared business logic and tenant-scoped SQLite storage; web tenancy adds host resolution and subscription entitlements. The README documents major capabilities, but many feature implementations were not sampled, so their internal links are omitted.
Main entry points: SessionCheckoutService.ts Customer Sessions · App.tsx React Renderer · sessionHandlers.ts IPC Handlers · server.ts REST Server
Components 18
Shop Applications
- React Renderer
frontend/src/app/App.tsx
Request Transports
- Electron Main
electron-app/main.ts - IPC Handlers
electron-app/handlers/sessionHandlers.ts - REST Server
backend/src/server.ts
Business Capabilities
- POS Sales
frontend/src/features/sales/pages/POS/index.tsx - Inventory
frontend/src/features/inventory/pages/Inventory/ProductList.tsx - Financial Services
frontend/src/features/recharge/pages/Recharge/index.tsx - Customer Sessions
packages/core/src/services/SessionCheckoutService.ts - Clients And Debts
packages/core/src/repositories/ClientRepository.ts - Transactions And Audit
packages/core/src/repositories/TransactionRepository.ts - Daily Closing
frontend/src/features/closing/pages/Checkpoint/index.tsx - Reports And Profits
electron-app/services/ReportService.ts
Tenant Platform
- Tenant Admin
frontend/src/features/admin/pages/Tenants/index.tsx - Tenant Resolution
backend/src/middleware/tenantHost.ts - Tenant Provisioning
packages/core/src/services/TenantStorageProvisioner.ts
Shared Core And Storage
- Tenant Context
packages/core/src/db/tenantContext.ts - SQLite Storage
packages/core/src/db/connection.ts
Other components
- Shop Staff
Connections 21
- Shop Staff → React Renderer: uses
README.md - React Renderer → IPC Handlers: desktop IPC
README.md - React Renderer → REST Server: web REST
README.md - Electron Main → IPC Handlers: registers handlers
electron-app/main.ts - IPC Handlers → Customer Sessions: checks out basket
electron-app/handlers/sessionHandlers.ts - REST Server → Tenant Resolution: resolves host
- Shop Staff → POS Sales: sells goods
README.md - Shop Staff → Inventory: manages stock
README.md - Shop Staff → Financial Services: records services
README.md - Shop Staff → Customer Sessions: pools purchases
README.md - Shop Staff → Clients And Debts: manages accounts
README.md - Shop Staff → Transactions And Audit: reviews transactions
README.md - Shop Staff → Daily Closing: closes day
README.md - Shop Staff → Reports And Profits: reviews results
README.md - Customer Sessions → POS Sales: dispatches items
packages/core/src/services/SessionCheckoutService.ts - Customer Sessions → Transactions And Audit: records transactions
packages/core/src/services/SessionCheckoutService.ts - Customer Sessions → Clients And Debts: resolves client
packages/core/src/services/SessionCheckoutService.ts - Tenant Admin → Tenant Provisioning: creates tenants
- Tenant Provisioning → SQLite Storage: seeds tenant data
packages/core/src/services/TenantStorageProvisioner.ts - Tenant Resolution → Tenant Context: sets tenant context
- Tenant Context → SQLite Storage: scopes queries
packages/core/src/db/tenantContext.ts