wad-lab 1.1.8 → 1.2.0

package/bin/index.js

@@ -42,7 +42,7 @@ const frontendOptions = [
 ];
 
 const templates = [
-  { name: 'all (Unpack All 54 Templates)', value: 'all' },
+  { name: 'all (Unpack All 56 Templates)', value: 'all' },
   { name: 'servlet-voter-eligibility (Name & Age Voting Eligibility Check)', value: 'servlet-voter-eligibility' },
   { name: 'fullstack-springboot-vue (Spring Boot: 2 Models, 2 Repos, 1 Service, 1 Controller + Selectable Vue 3 Axios Frontend)', value: 'fullstack-springboot-vue' },
   { name: 'springboot-2model-1controller-api (Spring Boot 1 Service, 1 Controller, 2 Models, 2 Repos)', value: 'springboot-2model-1controller-api' },
@@ -68,12 +68,14 @@ const templates = [
   { name: 'vue-todo-router (Router Multi-View Tasks)', value: 'vue-todo-router' },
   { name: 'vue-cart-router-pinia (Router + Pinia Shopping Cart)', value: 'vue-cart-router-pinia' },
   { name: 'html-css-js (Form Validation & DOM)', value: 'html-css-js' },
+  { name: 'html-css-styles (50 CSS properties showcase)', value: 'html-css-styles' },
   { name: 'servlet-basic (Tomcat GET + POST)', value: 'servlet-basic' },
   { name: 'servlet-jdbc (Tomcat + MySQL JDBC)', value: 'servlet-jdbc' },
   { name: 'servlet-flow (HelloServlet with GET/POST)', value: 'servlet-flow' },
   { name: 'servlet-session-tracking (HttpSession, Cookies, Redirect, URL Rewriting)', value: 'servlet-session-tracking' },
   { name: 'springboot-mongo-crud (4-Layer REST API)', value: 'springboot-mongo-crud' },
   { name: 'springboot-mongo-aggregation ($group, $sum, $avg, $sort)', value: 'springboot-mongo-aggregation' },
+  { name: 'springboot-mongo-aggregation-join ($lookup JOIN, @Query, @Aggregation)', value: 'springboot-mongo-aggregation-join' },
   { name: 'springboot-mockmvc (Controller Tests)', value: 'springboot-mockmvc' },
   { name: 'springboot-mongo-aggregation-mockmvc (Full Tests)', value: 'springboot-mongo-aggregation-mockmvc' },
   { name: 'game-rock-paper-scissors (Player vs Computer RPS)', value: 'game-rock-paper-scissors' },

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "wad-lab",
-  "version": "1.1.8",
+  "version": "1.2.0",
   "description": "Interactive CLI for WAD Lab starter templates compatible with Node 12+",
   "bin": {
-    "wad-lab": "./bin/index.js"
+    "wad-lab": "bin/index.js"
   },
   "engines": {
     "node": ">=12.0.0"

package/templates/html-css-styles/index.html

@@ -0,0 +1,109 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>CSS Styles Showcase</title>
+  <link rel="stylesheet" href="style.css">
+</head>
+<body>
+  <header class="site-header">
+    <h1 class="gradient-text">CSS Styles Showcase</h1>
+    <nav class="nav">
+      <a href="#box">Box</a><a href="#text">Text</a><a href="#layout">Layout</a>
+      <a href="#effects">Effects</a><a href="#anim">Animation</a><a href="#form">Form</a>
+    </nav>
+  </header>
+
+  <main class="container">
+
+    <section id="box">
+      <h2>1. Box model &amp; borders</h2>
+      <div class="grid">
+        <div class="card shadow">box-shadow</div>
+        <div class="card shadow-inset">inset box-shadow</div>
+        <div class="card shadow-multi">multiple shadows</div>
+        <div class="card rounded">border-radius</div>
+        <div class="card circle">circle</div>
+        <div class="card dashed">dashed border</div>
+        <div class="card outlined">outline + offset</div>
+        <div class="card padded">padding / margin</div>
+      </div>
+    </section>
+
+    <section id="text">
+      <h2>2. Typography</h2>
+      <p class="t-spacing">letter-spacing, word-spacing, line-height</p>
+      <p class="t-shadow">text-shadow</p>
+      <p class="t-upper">text-transform uppercase</p>
+      <p class="t-deco">text-decoration</p>
+      <p class="t-clamp">text-overflow ellipsis: this long line is cut off with three dots because of overflow hidden and white-space nowrap.</p>
+      <p class="t-indent">text-indent and text-align justify. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.</p>
+      <p class="t-weight">font-weight / font-style / font-variant</p>
+      <p class="gradient-text big">background-clip: text</p>
+    </section>
+
+    <section id="layout">
+      <h2>3. Layout</h2>
+      <h3>Flexbox (display, justify-content, align-items, gap, flex-wrap)</h3>
+      <div class="flex-demo"><div>1</div><div>2</div><div>3</div></div>
+      <h3>Grid (grid-template-columns, gap)</h3>
+      <div class="grid-demo"><div>A</div><div>B</div><div>C</div><div>D</div></div>
+      <h3>Position (relative / absolute / sticky) + z-index</h3>
+      <div class="pos-parent">relative parent<span class="badge">absolute</span></div>
+      <h3>Float</h3>
+      <div class="clearfix"><div class="float-box">float</div><p>Text wraps around the floated box. Use clearfix to contain floats.</p></div>
+      <h3>overflow</h3>
+      <div class="scroll-box"><p>overflow: auto gives a scrollbar when content is taller than the box. Keep adding lines so it overflows. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore.</p></div>
+    </section>
+
+    <section id="effects">
+      <h2>4. Colours, backgrounds &amp; effects</h2>
+      <div class="grid">
+        <div class="card bg-linear">linear-gradient</div>
+        <div class="card bg-radial">radial-gradient</div>
+        <div class="card bg-conic">conic-gradient</div>
+        <div class="card opacity">opacity</div>
+        <div class="card blur-glass">backdrop-filter (glass)</div>
+        <div class="card filter-fx">filter: grayscale + blur</div>
+        <div class="card transform-fx">transform: rotate/scale</div>
+        <div class="card clip">clip-path</div>
+        <div class="card cursor-demo">cursor: pointer</div>
+        <div class="card hover-lift">:hover lift</div>
+        <div class="card blend">mix-blend-mode</div>
+        <div class="card var-demo">CSS variables</div>
+      </div>
+    </section>
+
+    <section id="anim">
+      <h2>5. Transitions &amp; animations</h2>
+      <button class="btn">transition on hover</button>
+      <div class="spinner" title="@keyframes + animation"></div>
+      <div class="pulse">pulse</div>
+      <div class="bounce">bounce</div>
+    </section>
+
+    <section id="form">
+      <h2>6. Form &amp; table styling</h2>
+      <form class="form" onsubmit="return false">
+        <input type="text" placeholder="Focus me (outline, transition)">
+        <select><option>Select</option><option>Option 2</option></select>
+        <textarea rows="2" placeholder="resize: vertical"></textarea>
+        <label><input type="checkbox" checked> accent-color checkbox</label>
+        <button class="btn">Submit</button>
+      </form>
+      <table class="table">
+        <thead><tr><th>ID</th><th>Name</th><th>Score</th></tr></thead>
+        <tbody>
+          <tr><td>1</td><td>Asha</td><td>92</td></tr>
+          <tr><td>2</td><td>Ravi</td><td>85</td></tr>
+          <tr><td>3</td><td>Meena</td><td>78</td></tr>
+        </tbody>
+      </table>
+      <ul class="list"><li>list-style custom marker</li><li>::before / ::after pseudo-elements</li><li>:nth-child</li></ul>
+    </section>
+
+  </main>
+  <footer class="site-footer">position: sticky header &middot; media query: resize the window</footer>
+</body>
+</html>

package/templates/html-css-styles/style.css

@@ -0,0 +1,139 @@
+/* ===== CSS Styles Showcase: ~50 commonly asked properties, each tagged in a comment ===== */
+
+/* 1. CSS variables (custom properties) */
+:root {
+  --primary: #4f46e5;
+  --accent: #ec4899;
+  --bg: #f5f7fb;
+  --text: #1f2937;
+  --radius: 12px;
+}
+
+/* 2. universal reset + box-sizing */
+* { margin: 0; padding: 0; box-sizing: border-box; }
+
+html { scroll-behavior: smooth; }                         /* 3. scroll-behavior */
+
+body {
+  font-family: 'Segoe UI', Arial, sans-serif;             /* 4. font-family */
+  font-size: 16px;                                        /* 5. font-size */
+  line-height: 1.6;                                       /* 6. line-height */
+  color: var(--text);                                     /* 7. color */
+  background: var(--bg);                                  /* 8. background */
+}
+
+.container { max-width: 1000px; margin: 0 auto; padding: 20px; }   /* 9. max-width, margin auto */
+section { margin-bottom: 40px; }
+h2 { margin-bottom: 14px; border-bottom: 3px solid var(--primary); display: inline-block; }
+h3 { margin: 14px 0 6px; font-size: 1rem; color: #555; }
+
+/* ---------- Header / nav (position: sticky, z-index) ---------- */
+.site-header {
+  position: sticky; top: 0; z-index: 100;                 /* 10. position sticky, 11. z-index */
+  display: flex; justify-content: space-between; align-items: center;
+  padding: 12px 24px; background: white;
+  box-shadow: 0 2px 10px rgba(0,0,0,.15);                 /* 12. box-shadow */
+}
+.nav a {
+  text-decoration: none; color: var(--text);              /* 13. text-decoration */
+  margin-left: 16px; padding: 6px 10px; border-radius: 6px;
+  transition: background .3s, color .3s;                  /* 14. transition */
+}
+.nav a:hover { background: var(--primary); color: #fff; } /* 15. :hover */
+
+/* ---------- Cards / box model ---------- */
+.grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(190px, 1fr)); gap: 16px; } /* 16. grid */
+.card {
+  height: 110px; display: flex; align-items: center; justify-content: center;
+  text-align: center; background: #fff; padding: 12px;    /* 17. padding */
+  border: 1px solid #e5e7eb; border-radius: var(--radius);/* 18. border, 19. border-radius */
+  font-weight: 600;                                       /* 20. font-weight */
+}
+.shadow       { box-shadow: 0 8px 20px rgba(0,0,0,.2); }
+.shadow-inset { box-shadow: inset 0 0 15px rgba(0,0,0,.35); }
+.shadow-multi { box-shadow: 0 0 0 4px var(--primary), 0 0 0 8px var(--accent), 0 10px 25px rgba(0,0,0,.3); }
+.rounded      { border-radius: 30px; }
+.circle       { border-radius: 50%; width: 110px; margin: auto; }
+.dashed       { border: 3px dashed var(--accent); }       /* border-style */
+.outlined     { outline: 3px solid var(--primary); outline-offset: 5px; }  /* 21. outline, outline-offset */
+.padded       { padding: 24px; margin: 8px; background: #eef2ff; }
+
+/* ---------- Typography ---------- */
+.t-spacing { letter-spacing: 3px; word-spacing: 8px; line-height: 2; }     /* 22. letter/word-spacing */
+.t-shadow  { text-shadow: 2px 2px 4px rgba(0,0,0,.4); font-size: 1.6rem; } /* 23. text-shadow */
+.t-upper   { text-transform: uppercase; }                                  /* 24. text-transform */
+.t-deco    { text-decoration: underline wavy var(--accent); }
+.t-clamp   { white-space: nowrap; overflow: hidden; text-overflow: ellipsis; max-width: 380px; }  /* 25. text-overflow */
+.t-indent  { text-indent: 30px; text-align: justify; }                     /* 26. text-indent, text-align */
+.t-weight  { font-weight: 800; font-style: italic; font-variant: small-caps; }
+.big       { font-size: 2rem; }
+.gradient-text {
+  background: linear-gradient(90deg, var(--primary), var(--accent));       /* 27. linear-gradient */
+  -webkit-background-clip: text; background-clip: text;                    /* 28. background-clip */
+  -webkit-text-fill-color: transparent; color: transparent;
+}
+
+/* ---------- Layout ---------- */
+.flex-demo { display: flex; justify-content: space-around; align-items: center; gap: 10px; flex-wrap: wrap; }  /* 29. flexbox */
+.flex-demo div, .grid-demo div { background: var(--primary); color: #fff; padding: 20px; border-radius: 8px; flex: 1; text-align: center; }
+.grid-demo { display: grid; grid-template-columns: 2fr 1fr; gap: 10px; }
+.pos-parent { position: relative; height: 80px; background: #e0e7ff; padding: 10px; border-radius: 8px; }  /* 30. position relative */
+.badge { position: absolute; top: 8px; right: 8px; background: var(--accent); color: #fff; padding: 4px 10px; border-radius: 20px; font-size: .8rem; }  /* 31. absolute */
+.float-box { float: left; width: 90px; height: 70px; margin-right: 12px; background: var(--accent); color: #fff; display: flex; align-items: center; justify-content: center; }  /* 32. float */
+.clearfix::after { content: ""; display: table; clear: both; }            /* 33. pseudo-element + clear */
+.scroll-box { height: 70px; overflow: auto; border: 1px solid #ccc; padding: 8px; background: #fff; resize: both; }  /* 34. overflow, resize */
+
+/* ---------- Colours, backgrounds, effects ---------- */
+.bg-linear { background: linear-gradient(135deg, #667eea, #764ba2); color: #fff; }
+.bg-radial { background: radial-gradient(circle, #fbbf24, #ef4444); color: #fff; }        /* 35. radial-gradient */
+.bg-conic  { background: conic-gradient(from 0deg, #f43f5e, #3b82f6, #22c55e, #f43f5e); color: #fff; }  /* 36. conic-gradient */
+.opacity   { opacity: .5; }                                                               /* 37. opacity */
+.blur-glass { background: rgba(255,255,255,.25); backdrop-filter: blur(8px); border: 1px solid rgba(255,255,255,.5); }  /* 38. backdrop-filter */
+.filter-fx { filter: grayscale(80%) blur(1px); }                                          /* 39. filter */
+.transform-fx { transform: rotate(-4deg) scale(1.05); }                                   /* 40. transform */
+.clip { clip-path: polygon(50% 0, 100% 50%, 50% 100%, 0 50%); background: var(--primary); color: #fff; }  /* 41. clip-path */
+.cursor-demo { cursor: pointer; user-select: none; }                                      /* 42. cursor, user-select */
+.hover-lift { transition: transform .25s, box-shadow .25s; }
+.hover-lift:hover { transform: translateY(-8px); box-shadow: 0 14px 28px rgba(0,0,0,.25); }
+.blend { background: var(--accent); mix-blend-mode: multiply; }                           /* 43. mix-blend-mode */
+.var-demo { background: var(--primary); color: #fff; }
+
+/* ---------- Transitions & animations ---------- */
+.btn {
+  background: var(--primary); color: #fff; border: none; padding: 10px 22px;
+  border-radius: 8px; cursor: pointer; font-size: 1rem;
+  transition: all .3s ease;
+}
+.btn:hover { background: var(--accent); transform: scale(1.08); box-shadow: 0 6px 16px rgba(0,0,0,.3); }
+.btn:active { transform: scale(.97); }
+.spinner { width: 40px; height: 40px; border: 5px solid #ddd; border-top-color: var(--primary); border-radius: 50%; display: inline-block; vertical-align: middle; margin: 0 20px; animation: spin 1s linear infinite; }   /* 44. animation */
+@keyframes spin { to { transform: rotate(360deg); } }                                     /* 45. @keyframes */
+.pulse  { display: inline-block; padding: 10px 20px; background: var(--accent); color: #fff; border-radius: 8px; animation: pulse 1.5s ease-in-out infinite; }
+@keyframes pulse { 0%,100% { transform: scale(1); } 50% { transform: scale(1.15); } }
+.bounce { display: inline-block; margin-left: 20px; padding: 10px 20px; background: #10b981; color: #fff; border-radius: 8px; animation: bounce 1s infinite; }
+@keyframes bounce { 0%,100% { transform: translateY(0); } 50% { transform: translateY(-14px); } }
+
+/* ---------- Forms, tables, lists ---------- */
+.form { display: flex; flex-direction: column; gap: 10px; max-width: 360px; margin: 14px 0; }   /* flex-direction */
+.form input[type=text], .form select, .form textarea {
+  padding: 10px; border: 2px solid #d1d5db; border-radius: 8px; font: inherit; transition: border-color .2s, box-shadow .2s;
+}
+.form input:focus, .form textarea:focus { outline: none; border-color: var(--primary); box-shadow: 0 0 0 4px rgba(79,70,229,.2); }  /* :focus */
+.form textarea { resize: vertical; }
+.form input[type=checkbox] { accent-color: var(--accent); }                               /* 46. accent-color */
+.table { border-collapse: collapse; width: 100%; background: #fff; box-shadow: 0 2px 8px rgba(0,0,0,.1); }  /* 47. border-collapse */
+.table th, .table td { padding: 10px 14px; text-align: left; border-bottom: 1px solid #e5e7eb; }
+.table thead { background: var(--primary); color: #fff; }
+.table tbody tr:nth-child(even) { background: #f3f4f6; }                                  /* 48. :nth-child */
+.table tbody tr:hover { background: #e0e7ff; }
+.list { margin: 14px 0 0 22px; list-style: square; }                                      /* 49. list-style */
+.list li::marker { color: var(--accent); }                                                /* ::marker */
+.list li::before { content: ""; }                                                         /* ::before */
+
+.site-footer { text-align: center; padding: 20px; background: #111827; color: #9ca3af; }
+
+/* 50. Media query (responsive) */
+@media (max-width: 600px) {
+  .site-header { flex-direction: column; gap: 8px; }
+  .grid-demo { grid-template-columns: 1fr; }
+}

package/templates/springboot-mongo-aggregation-join/.mvn/wrapper/maven-wrapper.properties

@@ -0,0 +1,3 @@
+wrapperVersion=3.3.4
+distributionType=only-script
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.10.0/apache-maven-3.10.0-bin.zip

package/templates/springboot-mongo-aggregation-join/mvnw

@@ -0,0 +1,295 @@
+#!/bin/sh
+# ----------------------------------------------------------------------------
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+# ----------------------------------------------------------------------------
+
+# ----------------------------------------------------------------------------
+# Apache Maven Wrapper startup batch script, version 3.3.4
+#
+# Optional ENV vars
+# -----------------
+#   JAVA_HOME - location of a JDK home dir, required when download maven via java source
+#   MVNW_REPOURL - repo url base for downloading maven distribution
+#   MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven
+#   MVNW_VERBOSE - true: enable verbose log; debug: trace the mvnw script; others: silence the output
+# ----------------------------------------------------------------------------
+
+set -euf
+[ "${MVNW_VERBOSE-}" != debug ] || set -x
+
+# OS specific support.
+native_path() { printf %s\\n "$1"; }
+case "$(uname)" in
+CYGWIN* | MINGW*)
+  [ -z "${JAVA_HOME-}" ] || JAVA_HOME="$(cygpath --unix "$JAVA_HOME")"
+  native_path() { cygpath --path --windows "$1"; }
+  ;;
+esac
+
+# set JAVACMD and JAVACCMD
+set_java_home() {
+  # For Cygwin and MinGW, ensure paths are in Unix format before anything is touched
+  if [ -n "${JAVA_HOME-}" ]; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ]; then
+      # IBM's JDK on AIX uses strange locations for the executables
+      JAVACMD="$JAVA_HOME/jre/sh/java"
+      JAVACCMD="$JAVA_HOME/jre/sh/javac"
+    else
+      JAVACMD="$JAVA_HOME/bin/java"
+      JAVACCMD="$JAVA_HOME/bin/javac"
+
+      if [ ! -x "$JAVACMD" ] || [ ! -x "$JAVACCMD" ]; then
+        echo "The JAVA_HOME environment variable is not defined correctly, so mvnw cannot run." >&2
+        echo "JAVA_HOME is set to \"$JAVA_HOME\", but \"\$JAVA_HOME/bin/java\" or \"\$JAVA_HOME/bin/javac\" does not exist." >&2
+        return 1
+      fi
+    fi
+  else
+    JAVACMD="$(
+      'set' +e
+      'unset' -f command 2>/dev/null
+      'command' -v java
+    )" || :
+    JAVACCMD="$(
+      'set' +e
+      'unset' -f command 2>/dev/null
+      'command' -v javac
+    )" || :
+
+    if [ ! -x "${JAVACMD-}" ] || [ ! -x "${JAVACCMD-}" ]; then
+      echo "The java/javac command does not exist in PATH nor is JAVA_HOME set, so mvnw cannot run." >&2
+      return 1
+    fi
+  fi
+}
+
+# hash string like Java String::hashCode
+hash_string() {
+  str="${1:-}" h=0
+  while [ -n "$str" ]; do
+    char="${str%"${str#?}"}"
+    h=$(((h * 31 + $(LC_CTYPE=C printf %d "'$char")) % 4294967296))
+    str="${str#?}"
+  done
+  printf %x\\n $h
+}
+
+verbose() { :; }
+[ "${MVNW_VERBOSE-}" != true ] || verbose() { printf %s\\n "${1-}"; }
+
+die() {
+  printf %s\\n "$1" >&2
+  exit 1
+}
+
+trim() {
+  # MWRAPPER-139:
+  #   Trims trailing and leading whitespace, carriage returns, tabs, and linefeeds.
+  #   Needed for removing poorly interpreted newline sequences when running in more
+  #   exotic environments such as mingw bash on Windows.
+  printf "%s" "${1}" | tr -d '[:space:]'
+}
+
+scriptDir="$(dirname "$0")"
+scriptName="$(basename "$0")"
+
+# parse distributionUrl and optional distributionSha256Sum, requires .mvn/wrapper/maven-wrapper.properties
+while IFS="=" read -r key value; do
+  case "${key-}" in
+  distributionUrl) distributionUrl=$(trim "${value-}") ;;
+  distributionSha256Sum) distributionSha256Sum=$(trim "${value-}") ;;
+  esac
+done <"$scriptDir/.mvn/wrapper/maven-wrapper.properties"
+[ -n "${distributionUrl-}" ] || die "cannot read distributionUrl property in $scriptDir/.mvn/wrapper/maven-wrapper.properties"
+
+case "${distributionUrl##*/}" in
+maven-mvnd-*bin.*)
+  MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/
+  case "${PROCESSOR_ARCHITECTURE-}${PROCESSOR_ARCHITEW6432-}:$(uname -a)" in
+  *AMD64:CYGWIN* | *AMD64:MINGW*) distributionPlatform=windows-amd64 ;;
+  :Darwin*x86_64) distributionPlatform=darwin-amd64 ;;
+  :Darwin*arm64) distributionPlatform=darwin-aarch64 ;;
+  :Linux*x86_64*) distributionPlatform=linux-amd64 ;;
+  *)
+    echo "Cannot detect native platform for mvnd on $(uname)-$(uname -m), use pure java version" >&2
+    distributionPlatform=linux-amd64
+    ;;
+  esac
+  distributionUrl="${distributionUrl%-bin.*}-$distributionPlatform.zip"
+  ;;
+maven-mvnd-*) MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/ ;;
+*) MVN_CMD="mvn${scriptName#mvnw}" _MVNW_REPO_PATTERN=/org/apache/maven/ ;;
+esac
+
+# apply MVNW_REPOURL and calculate MAVEN_HOME
+# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-<version>,maven-mvnd-<version>-<platform>}/<hash>
+[ -z "${MVNW_REPOURL-}" ] || distributionUrl="$MVNW_REPOURL$_MVNW_REPO_PATTERN${distributionUrl#*"$_MVNW_REPO_PATTERN"}"
+distributionUrlName="${distributionUrl##*/}"
+distributionUrlNameMain="${distributionUrlName%.*}"
+distributionUrlNameMain="${distributionUrlNameMain%-bin}"
+MAVEN_USER_HOME="${MAVEN_USER_HOME:-${HOME}/.m2}"
+MAVEN_HOME="${MAVEN_USER_HOME}/wrapper/dists/${distributionUrlNameMain-}/$(hash_string "$distributionUrl")"
+
+exec_maven() {
+  unset MVNW_VERBOSE MVNW_USERNAME MVNW_PASSWORD MVNW_REPOURL || :
+  exec "$MAVEN_HOME/bin/$MVN_CMD" "$@" || die "cannot exec $MAVEN_HOME/bin/$MVN_CMD"
+}
+
+if [ -d "$MAVEN_HOME" ]; then
+  verbose "found existing MAVEN_HOME at $MAVEN_HOME"
+  exec_maven "$@"
+fi
+
+case "${distributionUrl-}" in
+*?-bin.zip | *?maven-mvnd-?*-?*.zip) ;;
+*) die "distributionUrl is not valid, must match *-bin.zip or maven-mvnd-*.zip, but found '${distributionUrl-}'" ;;
+esac
+
+# prepare tmp dir
+if TMP_DOWNLOAD_DIR="$(mktemp -d)" && [ -d "$TMP_DOWNLOAD_DIR" ]; then
+  clean() { rm -rf -- "$TMP_DOWNLOAD_DIR"; }
+  trap clean HUP INT TERM EXIT
+else
+  die "cannot create temp dir"
+fi
+
+mkdir -p -- "${MAVEN_HOME%/*}"
+
+# Download and Install Apache Maven
+verbose "Couldn't find MAVEN_HOME, downloading and installing it ..."
+verbose "Downloading from: $distributionUrl"
+verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName"
+
+# select .zip or .tar.gz
+if ! command -v unzip >/dev/null; then
+  distributionUrl="${distributionUrl%.zip}.tar.gz"
+  distributionUrlName="${distributionUrl##*/}"
+fi
+
+# verbose opt
+__MVNW_QUIET_WGET=--quiet __MVNW_QUIET_CURL=--silent __MVNW_QUIET_UNZIP=-q __MVNW_QUIET_TAR=''
+[ "${MVNW_VERBOSE-}" != true ] || __MVNW_QUIET_WGET='' __MVNW_QUIET_CURL='' __MVNW_QUIET_UNZIP='' __MVNW_QUIET_TAR=v
+
+# normalize http auth
+case "${MVNW_PASSWORD:+has-password}" in
+'') MVNW_USERNAME='' MVNW_PASSWORD='' ;;
+has-password) [ -n "${MVNW_USERNAME-}" ] || MVNW_USERNAME='' MVNW_PASSWORD='' ;;
+esac
+
+if [ -z "${MVNW_USERNAME-}" ] && command -v wget >/dev/null; then
+  verbose "Found wget ... using wget"
+  wget ${__MVNW_QUIET_WGET:+"$__MVNW_QUIET_WGET"} "$distributionUrl" -O "$TMP_DOWNLOAD_DIR/$distributionUrlName" || die "wget: Failed to fetch $distributionUrl"
+elif [ -z "${MVNW_USERNAME-}" ] && command -v curl >/dev/null; then
+  verbose "Found curl ... using curl"
+  curl ${__MVNW_QUIET_CURL:+"$__MVNW_QUIET_CURL"} -f -L -o "$TMP_DOWNLOAD_DIR/$distributionUrlName" "$distributionUrl" || die "curl: Failed to fetch $distributionUrl"
+elif set_java_home; then
+  verbose "Falling back to use Java to download"
+  javaSource="$TMP_DOWNLOAD_DIR/Downloader.java"
+  targetZip="$TMP_DOWNLOAD_DIR/$distributionUrlName"
+  cat >"$javaSource" <<-END
+	public class Downloader extends java.net.Authenticator
+	{
+	  protected java.net.PasswordAuthentication getPasswordAuthentication()
+	  {
+	    return new java.net.PasswordAuthentication( System.getenv( "MVNW_USERNAME" ), System.getenv( "MVNW_PASSWORD" ).toCharArray() );
+	  }
+	  public static void main( String[] args ) throws Exception
+	  {
+	    setDefault( new Downloader() );
+	    java.nio.file.Files.copy( java.net.URI.create( args[0] ).toURL().openStream(), java.nio.file.Paths.get( args[1] ).toAbsolutePath().normalize() );
+	  }
+	}
+	END
+  # For Cygwin/MinGW, switch paths to Windows format before running javac and java
+  verbose " - Compiling Downloader.java ..."
+  "$(native_path "$JAVACCMD")" "$(native_path "$javaSource")" || die "Failed to compile Downloader.java"
+  verbose " - Running Downloader.java ..."
+  "$(native_path "$JAVACMD")" -cp "$(native_path "$TMP_DOWNLOAD_DIR")" Downloader "$distributionUrl" "$(native_path "$targetZip")"
+fi
+
+# If specified, validate the SHA-256 sum of the Maven distribution zip file
+if [ -n "${distributionSha256Sum-}" ]; then
+  distributionSha256Result=false
+  if [ "$MVN_CMD" = mvnd.sh ]; then
+    echo "Checksum validation is not supported for maven-mvnd." >&2
+    echo "Please disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2
+    exit 1
+  elif command -v sha256sum >/dev/null; then
+    if echo "$distributionSha256Sum  $TMP_DOWNLOAD_DIR/$distributionUrlName" | sha256sum -c - >/dev/null 2>&1; then
+      distributionSha256Result=true
+    fi
+  elif command -v shasum >/dev/null; then
+    if echo "$distributionSha256Sum  $TMP_DOWNLOAD_DIR/$distributionUrlName" | shasum -a 256 -c >/dev/null 2>&1; then
+      distributionSha256Result=true
+    fi
+  else
+    echo "Checksum validation was requested but neither 'sha256sum' or 'shasum' are available." >&2
+    echo "Please install either command, or disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2
+    exit 1
+  fi
+  if [ $distributionSha256Result = false ]; then
+    echo "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised." >&2
+    echo "If you updated your Maven version, you need to update the specified distributionSha256Sum property." >&2
+    exit 1
+  fi
+fi
+
+# unzip and move
+if command -v unzip >/dev/null; then
+  unzip ${__MVNW_QUIET_UNZIP:+"$__MVNW_QUIET_UNZIP"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -d "$TMP_DOWNLOAD_DIR" || die "failed to unzip"
+else
+  tar xzf${__MVNW_QUIET_TAR:+"$__MVNW_QUIET_TAR"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -C "$TMP_DOWNLOAD_DIR" || die "failed to untar"
+fi
+
+# Find the actual extracted directory name (handles snapshots where filename != directory name)
+actualDistributionDir=""
+
+# First try the expected directory name (for regular distributions)
+if [ -d "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain" ]; then
+  if [ -f "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain/bin/$MVN_CMD" ]; then
+    actualDistributionDir="$distributionUrlNameMain"
+  fi
+fi
+
+# If not found, search for any directory with the Maven executable (for snapshots)
+if [ -z "$actualDistributionDir" ]; then
+  # enable globbing to iterate over items
+  set +f
+  for dir in "$TMP_DOWNLOAD_DIR"/*; do
+    if [ -d "$dir" ]; then
+      if [ -f "$dir/bin/$MVN_CMD" ]; then
+        actualDistributionDir="$(basename "$dir")"
+        break
+      fi
+    fi
+  done
+  set -f
+fi
+
+if [ -z "$actualDistributionDir" ]; then
+  verbose "Contents of $TMP_DOWNLOAD_DIR:"
+  verbose "$(ls -la "$TMP_DOWNLOAD_DIR")"
+  die "Could not find Maven distribution directory in extracted archive"
+fi
+
+verbose "Found extracted Maven distribution directory: $actualDistributionDir"
+printf %s\\n "$distributionUrl" >"$TMP_DOWNLOAD_DIR/$actualDistributionDir/mvnw.url"
+mv -- "$TMP_DOWNLOAD_DIR/$actualDistributionDir" "$MAVEN_HOME" || [ -d "$MAVEN_HOME" ] || die "fail to move MAVEN_HOME"
+
+clean || :
+exec_maven "$@"

package/templates/springboot-mongo-aggregation-join/mvnw.cmd

@@ -0,0 +1,189 @@
+<# : batch portion
+@REM ----------------------------------------------------------------------------
+@REM Licensed to the Apache Software Foundation (ASF) under one
+@REM or more contributor license agreements.  See the NOTICE file
+@REM distributed with this work for additional information
+@REM regarding copyright ownership.  The ASF licenses this file
+@REM to you under the Apache License, Version 2.0 (the
+@REM "License"); you may not use this file except in compliance
+@REM with the License.  You may obtain a copy of the License at
+@REM
+@REM    http://www.apache.org/licenses/LICENSE-2.0
+@REM
+@REM Unless required by applicable law or agreed to in writing,
+@REM software distributed under the License is distributed on an
+@REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+@REM KIND, either express or implied.  See the License for the
+@REM specific language governing permissions and limitations
+@REM under the License.
+@REM ----------------------------------------------------------------------------
+
+@REM ----------------------------------------------------------------------------
+@REM Apache Maven Wrapper startup batch script, version 3.3.4
+@REM
+@REM Optional ENV vars
+@REM   MVNW_REPOURL - repo url base for downloading maven distribution
+@REM   MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven
+@REM   MVNW_VERBOSE - true: enable verbose log; others: silence the output
+@REM ----------------------------------------------------------------------------
+
+@IF "%__MVNW_ARG0_NAME__%"=="" (SET __MVNW_ARG0_NAME__=%~nx0)
+@SET __MVNW_CMD__=
+@SET __MVNW_ERROR__=
+@SET __MVNW_PSMODULEP_SAVE=%PSModulePath%
+@SET PSModulePath=
+@FOR /F "usebackq tokens=1* delims==" %%A IN (`powershell -noprofile "& {$scriptDir='%~dp0'; $script='%__MVNW_ARG0_NAME__%'; icm -ScriptBlock ([Scriptblock]::Create((Get-Content -Raw '%~f0'))) -NoNewScope}"`) DO @(
+  IF "%%A"=="MVN_CMD" (set __MVNW_CMD__=%%B) ELSE IF "%%B"=="" (echo %%A) ELSE (echo %%A=%%B)
+)
+@SET PSModulePath=%__MVNW_PSMODULEP_SAVE%
+@SET __MVNW_PSMODULEP_SAVE=
+@SET __MVNW_ARG0_NAME__=
+@SET MVNW_USERNAME=
+@SET MVNW_PASSWORD=
+@IF NOT "%__MVNW_CMD__%"=="" ("%__MVNW_CMD__%" %*)
+@echo Cannot start maven from wrapper >&2 && exit /b 1
+@GOTO :EOF
+: end batch / begin powershell #>
+
+$ErrorActionPreference = "Stop"
+if ($env:MVNW_VERBOSE -eq "true") {
+  $VerbosePreference = "Continue"
+}
+
+# calculate distributionUrl, requires .mvn/wrapper/maven-wrapper.properties
+$distributionUrl = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionUrl
+if (!$distributionUrl) {
+  Write-Error "cannot read distributionUrl property in $scriptDir/.mvn/wrapper/maven-wrapper.properties"
+}
+
+switch -wildcard -casesensitive ( $($distributionUrl -replace '^.*/','') ) {
+  "maven-mvnd-*" {
+    $USE_MVND = $true
+    $distributionUrl = $distributionUrl -replace '-bin\.[^.]*$',"-windows-amd64.zip"
+    $MVN_CMD = "mvnd.cmd"
+    break
+  }
+  default {
+    $USE_MVND = $false
+    $MVN_CMD = $script -replace '^mvnw','mvn'
+    break
+  }
+}
+
+# apply MVNW_REPOURL and calculate MAVEN_HOME
+# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-<version>,maven-mvnd-<version>-<platform>}/<hash>
+if ($env:MVNW_REPOURL) {
+  $MVNW_REPO_PATTERN = if ($USE_MVND -eq $False) { "/org/apache/maven/" } else { "/maven/mvnd/" }
+  $distributionUrl = "$env:MVNW_REPOURL$MVNW_REPO_PATTERN$($distributionUrl -replace "^.*$MVNW_REPO_PATTERN",'')"
+}
+$distributionUrlName = $distributionUrl -replace '^.*/',''
+$distributionUrlNameMain = $distributionUrlName -replace '\.[^.]*$','' -replace '-bin$',''
+
+$MAVEN_M2_PATH = "$HOME/.m2"
+if ($env:MAVEN_USER_HOME) {
+  $MAVEN_M2_PATH = "$env:MAVEN_USER_HOME"
+}
+
+if (-not (Test-Path -Path $MAVEN_M2_PATH)) {
+    New-Item -Path $MAVEN_M2_PATH -ItemType Directory | Out-Null
+}
+
+$MAVEN_WRAPPER_DISTS = $null
+if ((Get-Item $MAVEN_M2_PATH).Target[0] -eq $null) {
+  $MAVEN_WRAPPER_DISTS = "$MAVEN_M2_PATH/wrapper/dists"
+} else {
+  $MAVEN_WRAPPER_DISTS = (Get-Item $MAVEN_M2_PATH).Target[0] + "/wrapper/dists"
+}
+
+$MAVEN_HOME_PARENT = "$MAVEN_WRAPPER_DISTS/$distributionUrlNameMain"
+$MAVEN_HOME_NAME = ([System.Security.Cryptography.SHA256]::Create().ComputeHash([byte[]][char[]]$distributionUrl) | ForEach-Object {$_.ToString("x2")}) -join ''
+$MAVEN_HOME = "$MAVEN_HOME_PARENT/$MAVEN_HOME_NAME"
+
+if (Test-Path -Path "$MAVEN_HOME" -PathType Container) {
+  Write-Verbose "found existing MAVEN_HOME at $MAVEN_HOME"
+  Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD"
+  exit $?
+}
+
+if (! $distributionUrlNameMain -or ($distributionUrlName -eq $distributionUrlNameMain)) {
+  Write-Error "distributionUrl is not valid, must end with *-bin.zip, but found $distributionUrl"
+}
+
+# prepare tmp dir
+$TMP_DOWNLOAD_DIR_HOLDER = New-TemporaryFile
+$TMP_DOWNLOAD_DIR = New-Item -Itemtype Directory -Path "$TMP_DOWNLOAD_DIR_HOLDER.dir"
+$TMP_DOWNLOAD_DIR_HOLDER.Delete() | Out-Null
+trap {
+  if ($TMP_DOWNLOAD_DIR.Exists) {
+    try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null }
+    catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" }
+  }
+}
+
+New-Item -Itemtype Directory -Path "$MAVEN_HOME_PARENT" -Force | Out-Null
+
+# Download and Install Apache Maven
+Write-Verbose "Couldn't find MAVEN_HOME, downloading and installing it ..."
+Write-Verbose "Downloading from: $distributionUrl"
+Write-Verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName"
+
+$webclient = New-Object System.Net.WebClient
+if ($env:MVNW_USERNAME -and $env:MVNW_PASSWORD) {
+  $webclient.Credentials = New-Object System.Net.NetworkCredential($env:MVNW_USERNAME, $env:MVNW_PASSWORD)
+}
+[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
+$webclient.DownloadFile($distributionUrl, "$TMP_DOWNLOAD_DIR/$distributionUrlName") | Out-Null
+
+# If specified, validate the SHA-256 sum of the Maven distribution zip file
+$distributionSha256Sum = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionSha256Sum
+if ($distributionSha256Sum) {
+  if ($USE_MVND) {
+    Write-Error "Checksum validation is not supported for maven-mvnd. `nPlease disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties."
+  }
+  Import-Module $PSHOME\Modules\Microsoft.PowerShell.Utility -Function Get-FileHash
+  if ((Get-FileHash "$TMP_DOWNLOAD_DIR/$distributionUrlName" -Algorithm SHA256).Hash.ToLower() -ne $distributionSha256Sum) {
+    Write-Error "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised. If you updated your Maven version, you need to update the specified distributionSha256Sum property."
+  }
+}
+
+# unzip and move
+Expand-Archive "$TMP_DOWNLOAD_DIR/$distributionUrlName" -DestinationPath "$TMP_DOWNLOAD_DIR" | Out-Null
+
+# Find the actual extracted directory name (handles snapshots where filename != directory name)
+$actualDistributionDir = ""
+
+# First try the expected directory name (for regular distributions)
+$expectedPath = Join-Path "$TMP_DOWNLOAD_DIR" "$distributionUrlNameMain"
+$expectedMvnPath = Join-Path "$expectedPath" "bin/$MVN_CMD"
+if ((Test-Path -Path $expectedPath -PathType Container) -and (Test-Path -Path $expectedMvnPath -PathType Leaf)) {
+  $actualDistributionDir = $distributionUrlNameMain
+}
+
+# If not found, search for any directory with the Maven executable (for snapshots)
+if (!$actualDistributionDir) {
+  Get-ChildItem -Path "$TMP_DOWNLOAD_DIR" -Directory | ForEach-Object {
+    $testPath = Join-Path $_.FullName "bin/$MVN_CMD"
+    if (Test-Path -Path $testPath -PathType Leaf) {
+      $actualDistributionDir = $_.Name
+    }
+  }
+}
+
+if (!$actualDistributionDir) {
+  Write-Error "Could not find Maven distribution directory in extracted archive"
+}
+
+Write-Verbose "Found extracted Maven distribution directory: $actualDistributionDir"
+Rename-Item -Path "$TMP_DOWNLOAD_DIR/$actualDistributionDir" -NewName $MAVEN_HOME_NAME | Out-Null
+try {
+  Move-Item -Path "$TMP_DOWNLOAD_DIR/$MAVEN_HOME_NAME" -Destination $MAVEN_HOME_PARENT | Out-Null
+} catch {
+  if (! (Test-Path -Path "$MAVEN_HOME" -PathType Container)) {
+    Write-Error "fail to move MAVEN_HOME"
+  }
+} finally {
+  try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null }
+  catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" }
+}
+
+Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD"

package/templates/springboot-mongo-aggregation-join/pom.xml

@@ -0,0 +1,91 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+	<modelVersion>4.0.0</modelVersion>
+	<parent>
+		<groupId>org.springframework.boot</groupId>
+		<artifactId>spring-boot-starter-parent</artifactId>
+		<version>4.1.1</version>
+		<relativePath/>
+	</parent>
+	<groupId>com.example</groupId>
+	<artifactId>springboot-mongo-aggregation-join</artifactId>
+	<version>0.0.1-SNAPSHOT</version>
+	<properties>
+		<java.version>21</java.version>
+	</properties>
+	<dependencies>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-data-mongodb</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-webmvc</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.projectlombok</groupId>
+			<artifactId>lombok</artifactId>
+			<optional>true</optional>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-test</artifactId>
+			<scope>test</scope>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-data-mongodb-test</artifactId>
+			<scope>test</scope>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-webmvc-test</artifactId>
+			<scope>test</scope>
+		</dependency>
+	</dependencies>
+	<build>
+		<plugins>
+			<plugin>
+				<groupId>org.springframework.boot</groupId>
+				<artifactId>spring-boot-maven-plugin</artifactId>
+			</plugin>
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-compiler-plugin</artifactId>
+				<executions>
+					<execution>
+						<id>default-compile</id>
+						<phase>compile</phase>
+						<goals>
+							<goal>compile</goal>
+						</goals>
+						<configuration>
+							<annotationProcessorPaths>
+								<path>
+									<groupId>org.projectlombok</groupId>
+									<artifactId>lombok</artifactId>
+								</path>
+							</annotationProcessorPaths>
+						</configuration>
+					</execution>
+					<execution>
+						<id>default-testCompile</id>
+						<phase>test-compile</phase>
+						<goals>
+							<goal>testCompile</goal>
+						</goals>
+						<configuration>
+							<annotationProcessorPaths>
+								<path>
+									<groupId>org.projectlombok</groupId>
+									<artifactId>lombok</artifactId>
+								</path>
+							</annotationProcessorPaths>
+						</configuration>
+					</execution>
+				</executions>
+			</plugin>
+		</plugins>
+	</build>
+</project>

package/templates/springboot-mongo-aggregation-join/src/main/java/com/example/joinagg/JoinAggApplication.java

@@ -0,0 +1,36 @@
+package com.example.joinagg;
+
+import com.example.joinagg.model.Customer;
+import com.example.joinagg.model.Order;
+import com.example.joinagg.repository.CustomerRepository;
+import com.example.joinagg.repository.OrderRepository;
+import org.springframework.boot.CommandLineRunner;
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.context.annotation.Bean;
+
+@SpringBootApplication
+public class JoinAggApplication {
+    public static void main(String[] args) {
+        SpringApplication.run(JoinAggApplication.class, args);
+    }
+
+    // Seed sample data (only when collections are empty)
+    @Bean
+    CommandLineRunner seed(CustomerRepository c, OrderRepository o) {
+        return args -> {
+            if (c.count() == 0) {
+                c.save(new Customer("c1", "Asha", "Chennai"));
+                c.save(new Customer("c2", "Ravi", "Mumbai"));
+                c.save(new Customer("c3", "Meena", "Chennai"));
+            }
+            if (o.count() == 0) {
+                o.save(new Order(null, "c1", "Laptop", 55000, "DELIVERED"));
+                o.save(new Order(null, "c1", "Mouse", 700, "DELIVERED"));
+                o.save(new Order(null, "c2", "Phone", 30000, "PENDING"));
+                o.save(new Order(null, "c3", "Monitor", 12000, "DELIVERED"));
+                o.save(new Order(null, "c3", "Keyboard", 2500, "PENDING"));
+            }
+        };
+    }
+}

package/templates/springboot-mongo-aggregation-join/src/main/java/com/example/joinagg/controller/JoinController.java

@@ -0,0 +1,33 @@
+package com.example.joinagg.controller;
+
+import com.example.joinagg.model.CustomerTotal;
+import com.example.joinagg.model.Order;
+import com.example.joinagg.model.OrderWithCustomer;
+import com.example.joinagg.repository.OrderRepository;
+import com.example.joinagg.service.JoinService;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+@RestController
+@RequestMapping("/api")
+@CrossOrigin(origins = "*")
+public class JoinController {
+    @Autowired private JoinService service;
+    @Autowired private OrderRepository repo;
+
+    // --- via MongoTemplate ---
+    @GetMapping("/join/orders")             public List<OrderWithCustomer> join()            { return service.ordersWithCustomers(); }
+    @GetMapping("/join/orders/city/{city}") public List<OrderWithCustomer> byCity(@PathVariable String city) { return service.ordersByCity(city); }
+    @GetMapping("/join/total")              public List<CustomerTotal> total()               { return service.totalPerCustomer(); }
+
+    // --- via @Aggregation on repository ---
+    @GetMapping("/agg/join")                public List<OrderWithCustomer> aggJoin()         { return repo.joinOrdersWithCustomers(); }
+    @GetMapping("/agg/join/{status}")       public List<OrderWithCustomer> aggJoin(@PathVariable String status) { return repo.joinByStatus(status); }
+    @GetMapping("/agg/total")               public List<CustomerTotal> aggTotal()            { return repo.totalSpentPerCustomer(); }
+
+    // --- via @Query ---
+    @GetMapping("/query/status/{s}")        public List<Order> byStatus(@PathVariable String s) { return repo.findByStatusQuery(s); }
+    @GetMapping("/query/gt/{amt}")          public List<Order> gt(@PathVariable double amt)  { return repo.findAmountGreaterThan(amt); }
+}

package/templates/springboot-mongo-aggregation-join/src/main/java/com/example/joinagg/model/Customer.java

@@ -0,0 +1,14 @@
+package com.example.joinagg.model;
+
+import lombok.*;
+import org.springframework.data.annotation.Id;
+import org.springframework.data.mongodb.core.mapping.Document;
+
+@Data @NoArgsConstructor @AllArgsConstructor
+@Document(collection = "customers")
+public class Customer {
+    @Id
+    private String id;
+    private String name;
+    private String city;
+}

package/templates/springboot-mongo-aggregation-join/src/main/java/com/example/joinagg/model/CustomerTotal.java

@@ -0,0 +1,11 @@
+package com.example.joinagg.model;
+
+import lombok.*;
+
+// Result of JOIN + GROUP: total spent per customer
+@Data @NoArgsConstructor @AllArgsConstructor
+public class CustomerTotal {
+    private String customerName;
+    private double totalSpent;
+    private int orderCount;
+}

package/templates/springboot-mongo-aggregation-join/src/main/java/com/example/joinagg/model/Order.java

@@ -0,0 +1,16 @@
+package com.example.joinagg.model;
+
+import lombok.*;
+import org.springframework.data.annotation.Id;
+import org.springframework.data.mongodb.core.mapping.Document;
+
+@Data @NoArgsConstructor @AllArgsConstructor
+@Document(collection = "orders")
+public class Order {
+    @Id
+    private String id;
+    private String customerId;   // foreign key -> customers._id
+    private String product;
+    private double amount;
+    private String status;
+}

package/templates/springboot-mongo-aggregation-join/src/main/java/com/example/joinagg/model/OrderWithCustomer.java

@@ -0,0 +1,14 @@
+package com.example.joinagg.model;
+
+import lombok.*;
+
+// Result of orders JOIN customers
+@Data @NoArgsConstructor @AllArgsConstructor
+public class OrderWithCustomer {
+    private String id;
+    private String product;
+    private double amount;
+    private String status;
+    private String customerName;
+    private String city;
+}

package/templates/springboot-mongo-aggregation-join/src/main/java/com/example/joinagg/repository/CustomerRepository.java

@@ -0,0 +1,9 @@
+package com.example.joinagg.repository;
+
+import com.example.joinagg.model.Customer;
+import org.springframework.data.mongodb.repository.MongoRepository;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public interface CustomerRepository extends MongoRepository<Customer, String> {
+}

package/templates/springboot-mongo-aggregation-join/src/main/java/com/example/joinagg/repository/OrderRepository.java

@@ -0,0 +1,73 @@
+package com.example.joinagg.repository;
+
+import com.example.joinagg.model.CustomerTotal;
+import com.example.joinagg.model.Order;
+import com.example.joinagg.model.OrderWithCustomer;
+import org.springframework.data.mongodb.repository.Aggregation;
+import org.springframework.data.mongodb.repository.MongoRepository;
+import org.springframework.data.mongodb.repository.Query;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+
+@Repository
+public interface OrderRepository extends MongoRepository<Order, String> {
+
+    // ---------- @Query (plain filters) ----------
+    @Query("{ 'status': ?0 }")
+    List<Order> findByStatusQuery(String status);
+
+    @Query("{ 'amount': { $gt: ?0 } }")
+    List<Order> findAmountGreaterThan(double amount);
+
+    @Query("{ 'amount': { $gte: ?0, $lte: ?1 } }")
+    List<Order> findAmountBetween(double min, double max);
+
+    @Query("{ $and: [ { 'status': ?0 }, { 'amount': { $gt: ?1 } } ] }")
+    List<Order> findByStatusAndMinAmount(String status, double min);
+
+    @Query("{ 'product': { $regex: ?0, $options: 'i' } }")
+    List<Order> searchByProduct(String regex);
+
+    @Query(value = "{ 'status': ?0 }", count = true)
+    long countByStatusQuery(String status);
+
+    @Query(value = "{ 'status': ?0 }", sort = "{ 'amount': -1 }")
+    List<Order> findByStatusSorted(String status);
+
+    @Query(value = "{ }", fields = "{ 'product': 1, 'amount': 1 }")
+    List<Order> findOnlyProductAndAmount();
+
+    // ---------- @Aggregation (JOIN with $lookup) ----------
+    @Aggregation(pipeline = {
+        "{ $lookup: { from: 'customers', localField: 'customerId', foreignField: '_id', as: 'customer' } }",
+        "{ $unwind: '$customer' }",
+        "{ $project: { product: 1, amount: 1, status: 1, customerName: '$customer.name', city: '$customer.city' } }"
+    })
+    List<OrderWithCustomer> joinOrdersWithCustomers();
+
+    // JOIN + filter (use ?0 placeholders inside pipeline stages)
+    @Aggregation(pipeline = {
+        "{ $match: { status: ?0 } }",
+        "{ $lookup: { from: 'customers', localField: 'customerId', foreignField: '_id', as: 'customer' } }",
+        "{ $unwind: '$customer' }",
+        "{ $project: { product: 1, amount: 1, status: 1, customerName: '$customer.name', city: '$customer.city' } }"
+    })
+    List<OrderWithCustomer> joinByStatus(String status);
+
+    // JOIN + GROUP: total spent per customer
+    @Aggregation(pipeline = {
+        "{ $lookup: { from: 'customers', localField: 'customerId', foreignField: '_id', as: 'customer' } }",
+        "{ $unwind: '$customer' }",
+        "{ $group: { _id: '$customer.name', totalSpent: { $sum: '$amount' }, orderCount: { $sum: 1 } } }",
+        "{ $project: { _id: 0, customerName: '$_id', totalSpent: 1, orderCount: 1 } }",
+        "{ $sort: { totalSpent: -1 } }"
+    })
+    List<CustomerTotal> totalSpentPerCustomer();
+
+    // Plain group (no join) returning a scalar-ish result
+    @Aggregation(pipeline = {
+        "{ $group: { _id: '$status', total: { $sum: '$amount' } } }"
+    })
+    List<org.bson.Document> totalByStatus();
+}

package/templates/springboot-mongo-aggregation-join/src/main/java/com/example/joinagg/service/JoinService.java

@@ -0,0 +1,58 @@
+package com.example.joinagg.service;
+
+import com.example.joinagg.model.CustomerTotal;
+import com.example.joinagg.model.OrderWithCustomer;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.data.domain.Sort;
+import org.springframework.data.mongodb.core.MongoTemplate;
+import org.springframework.data.mongodb.core.aggregation.Aggregation;
+import org.springframework.data.mongodb.core.query.Criteria;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+
+import static org.springframework.data.mongodb.core.aggregation.Aggregation.*;
+
+/** Same JOINs as OrderRepository, but built with the Aggregation Java API (MongoTemplate). */
+@Service
+public class JoinService {
+    @Autowired
+    private MongoTemplate mongoTemplate;
+
+    // orders JOIN customers  (SQL: SELECT ... FROM orders o JOIN customers c ON o.customerId = c.id)
+    public List<OrderWithCustomer> ordersWithCustomers() {
+        Aggregation agg = newAggregation(
+            lookup("customers", "customerId", "_id", "customer"),
+            unwind("customer"),
+            project("product", "amount", "status")
+                .and("customer.name").as("customerName")
+                .and("customer.city").as("city")
+        );
+        return mongoTemplate.aggregate(agg, "orders", OrderWithCustomer.class).getMappedResults();
+    }
+
+    // JOIN + WHERE city = ?
+    public List<OrderWithCustomer> ordersByCity(String city) {
+        Aggregation agg = newAggregation(
+            lookup("customers", "customerId", "_id", "customer"),
+            unwind("customer"),
+            match(Criteria.where("customer.city").is(city)),
+            project("product", "amount", "status")
+                .and("customer.name").as("customerName")
+                .and("customer.city").as("city")
+        );
+        return mongoTemplate.aggregate(agg, "orders", OrderWithCustomer.class).getMappedResults();
+    }
+
+    // JOIN + GROUP BY customer
+    public List<CustomerTotal> totalPerCustomer() {
+        Aggregation agg = newAggregation(
+            lookup("customers", "customerId", "_id", "customer"),
+            unwind("customer"),
+            group("customer.name").sum("amount").as("totalSpent").count().as("orderCount"),
+            project("totalSpent", "orderCount").and("_id").as("customerName"),
+            sort(Sort.Direction.DESC, "totalSpent")
+        );
+        return mongoTemplate.aggregate(agg, "orders", CustomerTotal.class).getMappedResults();
+    }
+}

package/templates/springboot-mongo-aggregation-join/src/main/resources/application.properties

@@ -0,0 +1,4 @@
+spring.application.name=springboot-mongo-aggregation-join
+server.port=8080
+spring.data.mongodb.uri=mongodb://localhost:27017/my_crud_db
+spring.data.mongodb.database=my_crud_db