How mittai17/foodpack-ai works
FoodPack AI is a decision-support platform for selecting food packaging. Users enter commodity, storage, transport, shelf-life and objective details in the web or mobile client; the API derives packaging requirements, scores and ranks validated candidates, persists the analysis, and can optionally generate a plain-English explanation. Food and material browsing, saved projects, and transport-risk assessment are additional product capabilities. The README documents the recommendation stages and integrations; unsampled subsystems are represented only where the tree or README supports them.
Main entry points: recommendation.service.ts Recommendation coordinator · analysis.service.ts Analysis workflow · page.tsx Web app · analysis.controller.ts Analysis routes
Components 22
User applications
- Web app
apps/web/src/app/(app)/analysis/new/page.tsx - Mobile app
mobile/app/analysis/wizard/step-4-review.tsx
API and catalog
- REST API
apps/api/src/main.ts - Analysis routes
apps/api/src/analysis/analysis.controller.ts - Analysis workflow
apps/api/src/analysis/analysis.service.ts - Food catalog
apps/api/src/foods/foods.service.ts - Material catalog
apps/api/src/materials/materials.service.ts - Saved projects
apps/api/src/projects/projects.service.ts
Recommendation engine
- Requirement derivation
apps/api/src/recommendation/services/requirement-engine.service.ts - Candidate generation
apps/api/src/recommendation/services/candidate-generator.service.ts - Candidate scoring
apps/api/src/recommendation/services/scoring.service.ts - Objective ranking
apps/api/src/recommendation/services/optimization.service.ts - Recommendation coordinator
apps/api/src/recommendation/recommendation.service.ts
Data and explanation
- PostgreSQL
- Explanation service
apps/api/src/ai/ai.service.ts
Transport assessment
- Transport dashboard
apps/web/src/app/(app)/transport/transport-dashboard.tsx - Transport risk engine
apps/web/src/lib/transport/transport-engine.ts
Other components
- User
- Gemini API
- Mapbox
- Open-Meteo
- Supabase Auth
Connections 26
- User → Web app: enters analysis
- User → Mobile app: enters analysis
- Web app → REST API: REST requests
- Mobile app → REST API: submits analysis
mobile/app/analysis/wizard/step-4-review.tsx - REST API → Analysis routes: routes requests
- Analysis routes → Analysis workflow: calls
apps/api/src/analysis/analysis.controller.ts - Analysis workflow → Recommendation coordinator: runs recommendation
apps/api/src/analysis/analysis.service.ts - Analysis workflow → PostgreSQL: persists analysis
- Analysis workflow → PostgreSQL: reads analysis
- Recommendation coordinator → Requirement derivation: derives requirements
- Recommendation coordinator → Candidate generation: generates candidates
- Recommendation coordinator → Candidate scoring: scores candidates
- Recommendation coordinator → Objective ranking: ranks candidates
- Recommendation coordinator → PostgreSQL: persists results
- Recommendation coordinator → Explanation service: requests explanation
- Explanation service → Gemini API: generates prose
- Web app → Supabase Auth: authenticates
- Analysis routes → Food catalog
- Web app → Transport dashboard: views transport
- Transport dashboard → Transport risk engine: assesses risk
- Transport risk engine → Mapbox: uses route data
apps/web/src/lib/transport/transport-engine.ts - Transport risk engine → Open-Meteo: uses forecast data
apps/web/src/lib/transport/transport-engine.ts - Analysis workflow → Saved projects
- Food catalog → PostgreSQL: reads catalog
- Material catalog → PostgreSQL: reads catalog
- Saved projects → PostgreSQL: stores projects