fixes and additions

pom.xml

@@ -189,6 +189,14 @@
 <!--                    <compilerArgs>&#45;&#45;enable-preview</compilerArgs>-->
                 </configuration>
             </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-javadoc-plugin</artifactId>
+                <version>3.6.3</version>
+                <configuration>
+                    <failOnError>false</failOnError>
+                </configuration>
+            </plugin>
 
             <plugin>
                 <groupId>org.springframework.boot</groupId>

src/main/java/group/goforward/battlbuilder/catalog/classification/PlatformResolutionResult.java

@@ -2,7 +2,7 @@ package group.goforward.battlbuilder.catalog.classification;
 
 /**
  * Result returned by PlatformResolver.
- *
+ * <p>
  * Any of the fields may be null — the importer will only overwrite
  * product.platform, product.partRole, or product.configuration
  * when the returned value is non-null AND non-blank.

src/main/java/group/goforward/battlbuilder/catalog/classification/PlatformResolver.java

@@ -15,7 +15,7 @@ import java.util.regex.Pattern;
 /**
  * Resolves a product's PLATFORM (e.g. AR-15, AR-10, NOT-SUPPORTED)
  * using explicit DB-backed rules.
- *
+ * <p>
  * Conservative approach:
  * - If a rule matches, return its target_platform
  * - If nothing matches, return null and let the caller decide fallback behavior

src/main/java/group/goforward/battlbuilder/controllers/BuilderBootstrapController.java

@@ -26,7 +26,7 @@ public class BuilderBootstrapController {
 
     /**
      * Builder bootstrap payload.
-     *
+     * <p>
      * Returns:
      * - categories: ordered list for UI navigation
      * - partRoleMap: normalized partRole -> categorySlug (platform-scoped)

src/main/java/group/goforward/battlbuilder/controllers/ImportController.java

@@ -18,7 +18,7 @@ public class ImportController {
 
     /**
      * Full product + offer import for a merchant.
-     *
+     * <p>
      * POST /admin/imports/{merchantId}
      */
     @PostMapping("/{merchantId}")
@@ -29,7 +29,7 @@ public class ImportController {
 
     /**
      * Offers-only sync (price/stock) for a merchant.
-     *
+     * <p>
      * POST /admin/imports/{merchantId}/offers-only
      */
     @PostMapping("/{merchantId}/offers-only")

src/main/java/group/goforward/battlbuilder/controllers/ProductController.java

@@ -10,14 +10,14 @@ import java.util.List;
 
 /**
  * LEGACY CONTROLLER (Deprecated)
- *
+ * <p>
  * Do not add new features here.
  * Canonical API lives in ProductV1Controller (/api/v1/products).
- *
+ * <p>
  * This exists only to keep older clients working temporarily.
  * Disable by default using:
  *   app.api.legacy.enabled=false
- *
+ * <p>
  * NOTE:
  * Even when disabled, Spring still compiles this class. So it must not reference
  * missing services/methods.

src/main/java/group/goforward/battlbuilder/controllers/admin/AdminBetaInviteController.java

@@ -16,7 +16,14 @@ public class AdminBetaInviteController {
         this.betaInviteService = betaInviteService;
     }
 
-    // POST /api/v1/admin/beta/invites/send?limit=25&dryRun=true&tokenMinutes=30
+    /**
+     * //api/v1/admin/beta/invites/send?limit=25&dryRun=true&tokenMinutes=30
+     * @param limit
+     * @param dryRun
+     * @param tokenMinutes
+     * @return
+     */
+
     @PostMapping("/invites/send")
     public InviteBatchResponse sendInvites(
             @RequestParam(defaultValue = "0") int limit,

src/main/java/group/goforward/battlbuilder/controllers/admin/AdminDashboardController.java

@@ -1,7 +1,7 @@
 package group.goforward.battlbuilder.controllers.admin;
 
 import group.goforward.battlbuilder.services.admin.impl.AdminDashboardService;
-import group.goforward.battlbuilder.web.dto.AdminDashboardOverviewDto;
+import group.goforward.battlbuilder.web.dto.admin.AdminDashboardOverviewDto;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestMapping;

src/main/java/group/goforward/battlbuilder/controllers/admin/AdminPlatformController.java

@@ -1,4 +1,4 @@
-package group.goforward.battlbuilder.controllers;
+package group.goforward.battlbuilder.controllers.admin;
 
 import group.goforward.battlbuilder.model.Platform;
 import group.goforward.battlbuilder.repos.PlatformRepository;

src/main/java/group/goforward/battlbuilder/controllers/admin/MerchantAdminController.java

@@ -1,5 +1,5 @@
 // MerchantAdminController.java
-package group.goforward.battlbuilder.controllers;
+package group.goforward.battlbuilder.controllers.admin;
 
 import org.springframework.web.bind.annotation.CrossOrigin;
 import org.springframework.web.bind.annotation.GetMapping;

src/main/java/group/goforward/battlbuilder/controllers/admin/PlatformViewController.java

@@ -1,4 +1,4 @@
-package group.goforward.battlbuilder.controllers;
+package group.goforward.battlbuilder.controllers.admin;
 
 import org.springframework.stereotype.Controller;
 import org.springframework.web.bind.annotation.GetMapping;

src/main/java/group/goforward/battlbuilder/controllers/api/BrandController.java

@@ -1,4 +1,4 @@
-package group.goforward.battlbuilder.controllers;
+package group.goforward.battlbuilder.controllers.api;
 
 import group.goforward.battlbuilder.model.Brand;
 import group.goforward.battlbuilder.repos.BrandRepository;

src/main/java/group/goforward/battlbuilder/controllers/api/StateController.java

@@ -1,4 +1,4 @@
-package group.goforward.battlbuilder.controllers;
+package group.goforward.battlbuilder.controllers.api;
 
 import group.goforward.battlbuilder.model.State;
 import group.goforward.battlbuilder.repos.StateRepository;

src/main/java/group/goforward/battlbuilder/controllers/api/UserController.java

@@ -1,4 +1,4 @@
-package group.goforward.battlbuilder.controllers;
+package group.goforward.battlbuilder.controllers.api;
 
 import group.goforward.battlbuilder.model.User;
 import group.goforward.battlbuilder.repos.UserRepository;

src/main/java/group/goforward/battlbuilder/dto/package_info.java

@@ -1,11 +1,11 @@
 
-/**
+/*
- * Web admin DTOs package for the BattlBuilder application.
+  Web admin DTOs package for the BattlBuilder application.
- * <p>
+  <p>
- * Contains Data Transfer Objects specific to administrative
+  Contains Data Transfer Objects specific to administrative
- * operations including user management, mappings, and platform configuration.
+  operations including user management, mappings, and platform configuration.
- * 
+
- * @author Forward Group, LLC
+  @author Forward Group, LLC
  * @version 1.0
  * @since 2025-12-10
  */

src/main/java/group/goforward/battlbuilder/model/BuildProfile.java

@@ -8,7 +8,7 @@ import java.time.OffsetDateTime;
 /**
  * build_profiles
  * 1:1 with builds (build_id is both PK and FK)
- *
+ * <p>
  * Dev notes:
  * - This is the "feed/meta" table for Option B (caliber, class, cover image, tags, etc.)
  * - Keep it lightweight. Anything social (votes/comments/media) lives elsewhere.

src/main/java/group/goforward/battlbuilder/repos/ProductRepository.java

@@ -32,7 +32,7 @@ public interface ProductRepository
      * Catalog mapping UI:
      * Returns raw categories for a given merchant + optional platform/q filter,
      * along with current merchant_category_map state and canonical category name.
-     *
+     * <p>
      * Row shape MUST match MappingAdminService mapping:
      *  r[0] merchantId (Integer)
      *  r[1] merchantName (String)

src/main/java/group/goforward/battlbuilder/repos/catalog/spec/CatalogProductSpecifications.java

@@ -1,4 +1,4 @@
-package group.goforward.battlbuilder.repos.spec;
+package group.goforward.battlbuilder.repos.catalog.spec;
 
 import group.goforward.battlbuilder.model.Product;
 import group.goforward.battlbuilder.model.ProductStatus;

src/main/java/group/goforward/battlbuilder/services/CurrentUserService.java

@@ -1,4 +1,4 @@
-package group.goforward.battlbuilder.security;
+package group.goforward.battlbuilder.services;
 
 import group.goforward.battlbuilder.model.User;
 import group.goforward.battlbuilder.repos.UserRepository;

src/main/java/group/goforward/battlbuilder/services/admin/impl/AdminDashboardService.java

@@ -4,7 +4,7 @@ import group.goforward.battlbuilder.model.ImportStatus;
 import group.goforward.battlbuilder.repos.MerchantCategoryMapRepository;
 import group.goforward.battlbuilder.repos.MerchantRepository;
 import group.goforward.battlbuilder.repos.ProductRepository;
-import group.goforward.battlbuilder.web.dto.AdminDashboardOverviewDto;
+import group.goforward.battlbuilder.web.dto.admin.AdminDashboardOverviewDto;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 

src/main/java/group/goforward/battlbuilder/services/impl/BuildServiceImpl.java

@@ -8,7 +8,7 @@ import group.goforward.battlbuilder.repos.BuildItemRepository;
 import group.goforward.battlbuilder.repos.BuildProfileRepository;
 import group.goforward.battlbuilder.repos.BuildRepository;
 import group.goforward.battlbuilder.repos.ProductOfferRepository;
-import group.goforward.battlbuilder.security.CurrentUserService;
+import group.goforward.battlbuilder.services.CurrentUserService;
 import group.goforward.battlbuilder.services.BuildService;
 import group.goforward.battlbuilder.web.dto.BuildDto;
 import group.goforward.battlbuilder.web.dto.BuildFeedCardDto;

src/main/java/group/goforward/battlbuilder/services/impl/CatalogQueryServiceImpl.java

@@ -4,7 +4,7 @@ import group.goforward.battlbuilder.model.Product;
 import group.goforward.battlbuilder.model.ProductOffer;
 import group.goforward.battlbuilder.repos.ProductOfferRepository;
 import group.goforward.battlbuilder.repos.ProductRepository;
-import group.goforward.battlbuilder.repos.spec.CatalogProductSpecifications;
+import group.goforward.battlbuilder.repos.catalog.spec.CatalogProductSpecifications;
 import group.goforward.battlbuilder.services.CatalogQueryService;
 import group.goforward.battlbuilder.web.dto.ProductSummaryDto;
 import group.goforward.battlbuilder.web.dto.catalog.CatalogProductIdsRequest;

src/main/java/group/goforward/battlbuilder/services/impl/MerchantFeedImportServiceImpl.java

@@ -40,14 +40,14 @@ import java.time.Instant;
 
 /**
  * MerchantFeedImportServiceImpl
- *
+ * <p>
  * RESPONSIBILITIES:
  * - Read merchant product feeds (CSV/TSV/etc)
  * - Normalize product data into Product entities
  * - Resolve PLATFORM (AR-15, AR-10, NOT-SUPPORTED)
  * - Infer part roles (temporary heuristic)
  * - Upsert Product + ProductOffer rows
- *
+ * <p>
  * NON-GOALS:
  * - Perfect classification (that’s iterative)
  * - UI-level filtering (handled later)

src/main/java/group/goforward/battlbuilder/services/utils/Snippet.java

@@ -0,0 +1,11 @@
+/**
+ * Services package for the BattlBuilder application.
+ * <p>
+ * Contains business logic service classes for product management,
+ * category classification, mapping recommendations, and merchant operations.
+ * 
+ * @author Forward Group, LLC
+ * @version 1.0
+ * @since 2025-12-10
+ */
+package group.goforward.battlbuilder.services.utils;

src/main/java/group/goforward/battlbuilder/utils/ApiResponse.java

@@ -3,7 +3,9 @@ package group.goforward.battlbuilder.utils;
 import java.time.LocalDateTime;
 
 /**
- * @param <T>
+ * Standard API response wrapper.
+ *
+ * @param <T> the type of the data payload
  */
 public class ApiResponse<T> {
 

src/main/java/group/goforward/battlbuilder/web/dto/BuildFeedCardDto.java

@@ -6,7 +6,7 @@ import java.util.UUID;
 /**
  * Contract for /builds feed cards.
  * Matches the Next.js BuildsPage expectations.
- *
+ * <p>
  * Dev Notes:
  * - We are using Option 2 for money: price is INTEGER CENTS (not dollars).
  *   Example: $19.99 -> 1999
@@ -38,7 +38,7 @@ public class BuildFeedCardDto {
     /**
      * Estimated build price in CENTS (Option 2).
      * Example: 245000 == $2,450.00
-     *
+     * <p>
      * IMPORTANT:
      * - UI must divide by 100 for display.
      * - Keep nullable optional; treat null as 0 in the UI.

src/main/java/group/goforward/battlbuilder/web/dto/UpdateBuildRequest.java

@@ -5,7 +5,7 @@ import java.util.List;
 /**
  * Request DTO for creating/updating Build + items.
  * Keeps entity fields protected from client-side overposting.
- *
+ * <p>
  * NOTE:
  * - We reuse this for BOTH create (POST /me) and update (PUT /me/{uuid}) for MVP speed.
  */

src/main/java/group/goforward/battlbuilder/web/dto/admin/AdminDashboardOverviewDto.java

@@ -1,4 +1,4 @@
-package group.goforward.battlbuilder.web.dto;
+package group.goforward.battlbuilder.web.dto.admin;
 
 public class AdminDashboardOverviewDto {
 

src/main/java/group/goforward/battlbuilder/web/dto/admin/AdminProductSearchRequest.java

@@ -5,8 +5,10 @@ import group.goforward.battlbuilder.model.ProductStatus;
 import group.goforward.battlbuilder.model.ProductVisibility;
 
 /**
- * Bound from query params on:
+ * Request DTO for searching products in the admin panel.
- * GET /api/v1/admin/products?platform=AR-15&q=mini&visibility=PUBLIC...
+ * <p>
+ * Example:
+ * GET /api/v1/admin/products?platform=AR-15&amp;q=mini&amp;visibility=PUBLIC
  */
 public class AdminProductSearchRequest {
 

src/main/java/group/goforward/battlbuilder/web/dto/auth/package_info.java

@@ -1,11 +1,11 @@
 
-/**
+/*
- * Web authentication DTOs package for the BattlBuilder application.
+  Web authentication DTOs package for the BattlBuilder application.
- * <p>
+  <p>
- * Contains Data Transfer Objects for authentication operations
+  Contains Data Transfer Objects for authentication operations
- * including login requests, registration, and authentication responses.
+  including login requests, registration, and authentication responses.
- * 
+
- * @author Forward Group, LLC
+  @author Forward Group, LLC
  * @version 1.0
  * @since 2025-12-10
  */