How stefan-garofalo/foodwise works
Foodwise is a personal food-inventory web app intended to track expiration dates, reduce waste, and suggest recipes. The visible product workflow covers signing in, reaching protected settings, and managing user-specific categories; the API and database provide the supporting settings and category operations. The README documents inventory and recipe capabilities, but the supplied source excerpts do not show their runtime workflows, so only the ingredient data model is represented. Edges are limited to documented or indexed references and explicit excerpts; backend routing details are not shown.
Main entry points: context.ts API context · client.ts Database client · server.ts Authentication · index.ts Backend API
Components 24
Web experience
- Login page
apps/frontend/app/[lang]/(public)/login/page.tsx - Auth route
apps/frontend/app/api/auth/[...all]/route.ts - Protected app
apps/frontend/app/[lang]/(protected)/page.tsx - Category settings UI
apps/frontend/app/[lang]/(protected)/settings/categories/page.tsx - Category create form
apps/frontend/features/users/settings/categories/create/form/index.tsx - Server tRPC client
apps/frontend/modules/trpc/server.tsx - tRPC transport
apps/frontend/modules/trpc/lib/clients.ts - Inventory and recipes
Identity
- Authentication
packages/auth/src/server.ts - Auth database
API services
- Backend API
apps/backend/src/index.ts - API context
packages/api/src/trpc/context.ts - User settings service
packages/api/src/features/users/service.ts - User settings repository
packages/api/src/features/users/repository.ts - Settings router
packages/api/src/features/users/modules/settings/router.ts - Category router
packages/api/src/features/users/modules/settings/modules/categories/router.ts - Category service
packages/api/src/features/users/modules/settings/modules/categories/service.ts - Category repository
packages/api/src/features/users/modules/settings/modules/categories/repository.ts - Generic CRUD
packages/api/src/lib/crud/service.ts
Data model
- Database client
packages/db/src/client.ts - User settings schema
packages/db/src/schema/users/settings/categories.ts - Ingredient schema
packages/db/src/schema/ingredients.ts - SQLite database
Other components
- Foodwise user
Connections 26
- Foodwise user → Login page: signs in
apps/frontend/app/[lang]/(public)/login/page.tsx - Login page → Auth route: submits auth
- Auth route → Authentication: handles auth
- Authentication → Auth database: uses LibSQL
packages/auth/src/server.ts - Foodwise user → Protected app: uses app
- Protected app → Category settings UI: opens settings
- Category settings UI → Category create form: offers create
- Server tRPC client → API context: creates context
apps/frontend/modules/trpc/server.tsx - Server tRPC client → Backend API: targets API
- Backend API → Authentication: uses auth
- Backend API → API context: uses API
- API context → Database client: uses database
packages/api/src/trpc/context.ts - API context → Authentication: checks sessions
packages/api/src/trpc/context.ts - Settings router → Category router: registers categories
packages/api/src/features/users/modules/settings/router.ts - Settings router → Generic CRUD: builds procedures
packages/api/src/features/users/modules/settings/router.ts - Category router → Category service: routes calls
packages/api/src/features/users/modules/settings/modules/categories/router.ts - Category service → Category repository: delegates create
packages/api/src/features/users/modules/settings/modules/categories/service.ts - Category repository → User settings repository: loads settings
packages/api/src/features/users/modules/settings/modules/categories/repository.ts - Category repository → Generic CRUD: creates category
packages/api/src/features/users/modules/settings/modules/categories/repository.ts - User settings service → User settings repository: reads settings
packages/api/src/features/users/service.ts - User settings repository → Database client: queries settings
packages/api/src/features/users/repository.ts - Database client → User settings schema: loads schemas
packages/db/src/client.ts - Database client → SQLite database: connects
- User settings schema → Ingredient schema: relates categories
packages/db/src/schema/users/settings/categories.ts - Inventory and recipes → Ingredient schema: documents inventory
README.md - Inventory and recipes → Foodwise user: serves
README.md