Tandem is an AI-powered household wellness and management platform that helps couples and families manage their finances, health, and goals together. Built with Laravel and advanced AI technology, it combines expense tracking, mood monitoring, nutrition management, goal achievement, and intelligent automation in one comprehensive system.

The platform features AI agent assistance for personalized household advice, intelligent mood analysis with emotional insights, AI coaching for goal achievement, smart meal planning with recipe suggestions, automated shopping lists, and weekly AI-generated summaries. With real-time notifications, gamification, and multi-user household management, Tandem transforms everyday household tasks into a collaborative, data-driven experience that promotes financial health, emotional wellness, and shared success.

Component Diagram

ER Diagram

📊 View Interactive ER Diagram on dbdiagram.io (Recommended for better visibility)

Click image above to view full size, or use the dbdiagram.io link for the interactive version

Main features

• AI Agent Coach: A RAG-powered assistant that uses your household's historical data to provide personalized advice and goal coaching.

• AI Date Night: Generates personalized date ideas (Activity + Meal) based on budget, partner moods, and available pantry items.

• AI Health Logger: Converts natural language text (e.g., "I ran 5km") into structured health metrics and mood entries automatically.

• Auto Order Shopping List: Intelligently parses your shopping list, identifies needed items, and "orders" them (restocks) directly into your pantry inventory.

• AI Weekly Summary & Nutrition Coach: Provides AI-generated weekly insights on household activity and personalized nutrition advice based on your logs.

• AI Mood Annotations: Automatically analyzes journal entries to generate emotional insights and pattern recognition.

• n8n Automation Workflow: Automatically triggers weekly insight reports by processing household data into analytics graphs, generating PDFs, backing them up to Google Drive for recovery, emailing them to households, and scheduling calendar reminders to review their insights.

User Screens

Login	Register & Household Setup

Dashboard	Goals

Pantry	Meal Planner

Recipes	Habits

Budget	Mood Timeline

Analytics

Sexy Features

AI Agent Coach

AI Date Night

AI Health Logger	Auto Order Shopping List

AI Weekly Summary & Nutrition Coach

AI Mood Annotations

n8n Workflow	Email Notification Result

Calendar Event Result	Google Drive PDF Result

Services	Validation	Controllers

Tests

Test Results

CI/CD

CI/CD Workflow

CI/CD Pipeline

GitHub Actions:

• CI Backend: Runs PHPUnit (Laravel) tests on TandemServer changes using PHP 8.2 & MySQL 5.7.
• CI Frontend: Runs Build and Dependency checks on TandemClient changes using Node 20.
• CD Production: Automatically deploys main branch to AWS EC2.

Postman API Validation	CI/CD Pipeline Results

Deployment Strategy:

Note

I originally planned to use Docker for deployment, but due to hardware limitations with local virtualization, we switched to a direct server setup instead.

• Automated git pull from origin main.
• Backend:
  • Dependency updates (composer install --no-dev)
  • Database migrations (php artisan migrate --force)
  • Cache optimization (config:cache, route:cache, view:cache)
  • Service restart (php8.2-fpm)
• Frontend:
  • Dependency updates (npm install)
  • Production build (npm run build)
  • Server reload (nginx)