Passistant

Overview

The intention of this application, when completed, is be personal for things that I want to automate:

• Meal planning and shopping list generation
  • For a family of four that two children and two adults with dietary requirements of vegetarian and low FODMAP
  • Meals consists of a vegetarian protein source for one adult and meat protein source for the other adult and children
• Daily read/watch list generation from pre-saved articles/blog and latest videos from a YouTube subscriptions

Prerequisites

• .NET 10 SDK
• .NET Aspire workload (dotnet workload install aspire)
• Docker Desktop (for PostgreSQL and Keycloak containers)

Running the Application

Execute the following in a terminal at the root of this Git repository:

aspire run

This will start the .NET Aspire dashboard and orchestrate the following services:

• Keycloak - Authentication and authorization server
  • Realm: passistant
  • Client: passistant-mealplanning-web
  • Default admin credentials (development/test only): admin / !MySuperStrongPassword123!
• PostgreSQL - Database server
  • Includes PgWeb for database management (development only)
  • Database: meal-planner-database

Build

Build the solution:

dotnet build --configuration Release --nologo

Structure

• src/Passistant.AppHost/ - .NET Aspire orchestration entry point
  • Program.cs - Service configuration and orchestration
  • keycloak/passistant-realm.json - Keycloak realm configuration
• src/Passistant.Common/ - Shared constants and utilities
  • ServiceNames.cs - Service name constants
  • Environments.cs - Environment configuration helpers
• tests/ - Test projects (empty initially)