How kk666679/halal-logistics works
This repository presents a Halal logistics platform: users enter through a Next.js web application and use backend capabilities for identity, certification, products, shipment tracking, and trade compliance. The tree also contains an agent-communication orchestrator, AI-agent services, and blockchain services, reflecting documented analytics and transparency capabilities. The sampled backend shows controller-to-service and service-to-Prisma calls; README statements supply broader system relationships. Several listed capabilities have no sampled implementation, so their links are documented or left unverified rather than inferred from names.
Main entry points: app.module.ts Backend API · prisma.service.ts Prisma database access · agentRoutes.ts Agent request routing · layout.tsx Next.js application
Components 23
Web experience
- Next.js application
app/layout.tsx - Operations dashboard
app/dashboard/page.tsx - Certification UI
components/certification/certification-application-form.tsx - Shipment tracking UI
components/tracking/shipment-tracker.tsx
Platform API
- Backend API
backend/src/app.module.ts - Authentication
backend/src/auth/auth.service.ts - Prisma database access
backend/src/prisma/prisma.service.ts - Certification workflow
backend/src/certification/certification.controller.ts - Certification service
backend/src/certification/certification.service.ts - Product inventory
backend/src/products/products.controller.ts - Product service
backend/src/products/products.service.ts - Shipment tracking
backend/src/tracking/tracking.controller.ts - Tracking service
backend/src/tracking/tracking.service.ts
AI and agents
- Agent request routing
infrastructure/agent-communication/orchestrator/src/routes/agentRoutes.ts - Agent registry
infrastructure/agent-communication/orchestrator/src/services/AgentRegistryService.ts - Agent load balancing
infrastructure/agent-communication/orchestrator/src/services/LoadBalancerService.ts - Agent message broker
infrastructure/agent-communication/orchestrator/src/services/MessageBrokerService.ts - AI certification agent
services/ai-agents/certification/src/certification/certification.controller.ts - Quality control agent
services/ai-agents/quality-control/src/quality/quality.service.ts - Blockchain service
services/ai-agents/blockchain/src/blockchain/blockchain.service.ts
Trade integrations
- Customs reporting
infrastructure/government-apis/regulatory-reporting/src/routes/customsRoutes.ts
Other components
- Platform user
- Customs authority
Connections 24
- Platform user → Next.js application: uses
README.md - Next.js application → Backend API: calls API
README.md - Platform user → Operations dashboard: views operations
- Platform user → Certification UI: submits application
- Platform user → Shipment tracking UI: checks shipment
- Backend API → Authentication: provides auth
- Backend API → Certification workflow: routes certification
- Backend API → Product inventory: routes products
- Backend API → Shipment tracking: routes tracking
- Certification workflow → Certification service: calls
backend/src/certification/certification.controller.ts - Certification service → Prisma database access: queries
backend/src/certification/certification.service.ts - Authentication → Prisma database access: queries
backend/src/auth/auth.service.ts - Product inventory → Product service: calls
backend/src/products/products.controller.ts - Product service → Prisma database access: queries
backend/src/products/products.service.ts - Shipment tracking → Tracking service: calls
backend/src/tracking/tracking.controller.ts - Tracking service → Prisma database access: queries
backend/src/tracking/tracking.service.ts - Customs reporting → Customs authority: checks status
infrastructure/government-apis/regulatory-reporting/src/routes/customsRoutes.ts - Agent request routing → Agent registry: looks up agents
infrastructure/agent-communication/orchestrator/src/routes/agentRoutes.ts - Agent request routing → Agent load balancing: routes requests
infrastructure/agent-communication/orchestrator/src/routes/agentRoutes.ts - Agent request routing → Agent message broker: dispatches messages
infrastructure/agent-communication/orchestrator/src/routes/agentRoutes.ts - Backend API → Customs reporting: integrates trade
README.md - Backend API → AI certification agent: offers AI capability
README.md - Backend API → Quality control agent: offers AI capability
README.md - Backend API → Blockchain service: offers transparency
README.md