White Label Apps

.claude/skills/radzen-blazor/SKILL.md

@@ -353,6 +353,25 @@ Powerful grid with sorting, filtering, paging, editing, selection, grouping.
 </RadzenDataGridColumn>
 ```
 
+**⚠️ TItem="object" Pitfall:**
+When using `TItem="object"` for dynamic entity grids, `Property` binding does NOT work (causes blank cells). Use `Template` with reflection instead:
+```razor
+<RadzenDataGrid Data="@objectData" TItem="object">
+    <Columns>
+        <RadzenDataGridColumn TItem="object" Title="Name">
+            <Template Context="row">@GetPropertyValue(row, "Name")</Template>
+        </RadzenDataGridColumn>
+    </Columns>
+</RadzenDataGrid>
+
+@code {
+    object? GetPropertyValue(object? obj, string propertyName) =>
+        obj?.GetType().GetProperty(propertyName)?.GetValue(obj);
+}
+```
+
+For dynamic entities with many columns (200+), use **SmartDataGridObject** component which handles reflection and auto-limits visible columns.
+
 See [references/components-quick-ref.md](references/components-quick-ref.md) for complete DataGrid reference.
 
 ### RadzenDataList

.claude/skills/radzen-blazor/references/best-practices.md

@@ -113,6 +113,76 @@ Template columns disable some optimizations. Use Property when possible:
 </RadzenDataGridColumn>
 ```
 
+### Avoid TItem="object" with Property Binding
+**Critical gotcha:** Radzen's `Property` attribute uses compiled expressions that require knowing the type at compile time. When `TItem="object"`, the Property binding fails silently (blank cells):
+
+```razor
+@* BAD - Property binding doesn't work with TItem="object" *@
+<RadzenDataGrid Data="@objectData" TItem="object">
+    <Columns>
+        <RadzenDataGridColumn TItem="object" Property="Name" Title="Name" />
+    </Columns>
+</RadzenDataGrid>
+
+@* GOOD - Use Template with reflection for object-typed data *@
+<RadzenDataGrid Data="@objectData" TItem="object">
+    <Columns>
+        <RadzenDataGridColumn TItem="object" Title="Name">
+            <Template Context="row">
+                @GetPropertyValue(row, "Name")
+            </Template>
+        </RadzenDataGridColumn>
+    </Columns>
+</RadzenDataGrid>
+
+@code {
+    object? GetPropertyValue(object? obj, string propertyName)
+    {
+        if (obj == null) return null;
+        return obj.GetType()
+            .GetProperty(propertyName, BindingFlags.Public | BindingFlags.Instance)
+            ?.GetValue(obj);
+    }
+}
+
+@* BEST - Use strongly-typed generic when possible *@
+<RadzenDataGrid Data="@products" TItem="Product">
+    <Columns>
+        <RadzenDataGridColumn TItem="Product" Property="Name" Title="Name" />
+    </Columns>
+</RadzenDataGrid>
+```
+
+**When you must use `TItem="object"`** (e.g., dynamic entity grids):
+- Use `Template` instead of `Property` for column content
+- Access values via reflection in the template
+- Note: Sorting/filtering may not work without Property binding
+
+### Limit Visible Columns for Wide Tables
+Tables with many columns (50+) can overwhelm browsers and users. Use column limiting:
+
+```razor
+@* SmartDataGridObject automatically limits to 15 columns by default *@
+<SmartDataGridObject Data="@wideData"
+                     MaxVisibleColumns="20" />  @* Show 20 columns *@
+
+@* Set to 0 to show all columns (not recommended for 100+ columns) *@
+<SmartDataGridObject Data="@data"
+                     MaxVisibleColumns="0" />
+```
+
+**Column prioritization (automatic):**
+1. ID columns (e.g., `item_id`, `Id`) - shown first
+2. Code/number columns (e.g., `item_code`, `product_code`)
+3. Name/description columns (e.g., `item_name`, `description`)
+4. Status/active columns (e.g., `is_active`, `is_enabled`)
+5. All other columns alphabetically
+
+**When to override defaults:**
+- Use `ColumnOverrides` parameter for full control over which columns appear
+- Increase `MaxVisibleColumns` if users need more fields visible
+- For reporting/export, consider a separate view with all columns
+
 ### Reuse Grid References
 Store grid reference for programmatic control:
 
@@ -757,6 +827,8 @@ Use Radzen components, avoid raw HTML injection:
 - [ ] Add `<RadzenComponents />` in MainLayout
 - [ ] Use interactive render mode for components with events
 - [ ] Use server-side loading for large DataGrids
+- [ ] **Avoid `TItem="object"` with Property binding** - use Template with reflection instead
+- [ ] **Limit visible columns for wide tables** (50+ columns) - use MaxVisibleColumns
 - [ ] Validate forms before submission
 - [ ] Handle dialog results (check for null)
 - [ ] Use appropriate notification durations and severities

.claude/skills/radzen-blazor/references/components-quick-ref.md

@@ -92,6 +92,58 @@
 
 ---
 
+## SmartDataGridObject (Project Component)
+
+Custom component for dynamic entity grids with `TItem="object"`. Handles reflection-based property access and auto-limits columns for wide tables (200+ columns).
+
+### Key Parameters
+- `Data` - IEnumerable<object> data source
+- `MaxVisibleColumns` - Max columns to display (default: 15, set to 0 for unlimited)
+- `ColumnOverrides` - Custom column configuration (IEnumerable<ColumnConfig>)
+- `AllowFiltering` - Enable filtering (default: true)
+- `AllowSorting` - Enable sorting (default: true)
+- `AllowPaging` - Enable pagination (default: true)
+- `AllowInlineEdit` - Enable inline editing (default: false)
+- `AllowEdit` - Show edit button in actions column (default: false)
+- `AllowDelete` - Show delete button in actions column (default: false)
+- `ShowActionColumn` - Show actions column (default: false)
+- `OnRowUpdate`, `OnRowCreate`, `OnRowDelete`, `OnRowEdit` - Event callbacks
+
+### Usage
+```razor
+@* Basic usage - auto-discovers columns, limits to 15 *@
+<SmartDataGridObject Data="@entityData" />
+
+@* Show more columns *@
+<SmartDataGridObject Data="@entityData"
+                     MaxVisibleColumns="25" />
+
+@* Show all columns (use with caution for wide tables) *@
+<SmartDataGridObject Data="@entityData"
+                     MaxVisibleColumns="0" />
+
+@* With editing *@
+<SmartDataGridObject Data="@entityData"
+                     AllowInlineEdit="true"
+                     OnRowUpdate="@HandleUpdate" />
+```
+
+### Column Prioritization (Automatic)
+When limiting columns, SmartDataGridObject prioritizes:
+1. ID columns (`_id`, `Id`) - shown first
+2. Code/number columns (`code`, `codenum`, `number`)
+3. Name/description columns (`name`, `descrip`, `title`)
+4. Status columns (`active`, `status`, `enabled`)
+5. All other columns alphabetically
+
+### Footer Display
+Shows row count and hidden column info:
+```
+Showing 3 records    (15 of 265 columns shown)
+```
+
+---
+
 ## RadzenStack
 
 ### Parameters

.dockerignore

@@ -0,0 +1,26 @@
+# Developer-local config files (contain localhost connection strings - must not override Docker env vars)
+appsettings.Local.json
+appsettings.*.Local.json
+.env.local
+.envrc
+.env
+
+# Secrets
+secrets.json
+*.pfx
+*.key
+
+# Build artifacts (Docker build stage handles these itself)
+**/bin/
+**/obj/
+
+# Test projects (not needed in production image)
+tests/
+
+# Documentation
+*.md
+DOCKER_SETUP_CONTEXT.md
+
+# Git
+.git/
+.gitignore

.env.example

@@ -0,0 +1,9 @@
+# SQL Server password for Docker Compose
+# Change this to a secure password!
+SA_PASSWORD=YourStrongPassword123!
+
+# Optional: Override ASPNETCORE_ENVIRONMENT
+# ASPNETCORE_ENVIRONMENT=Production
+
+# Optional: Override app ports (default: 7012 for HTTPS, 5210 for HTTP)
+# Leave blank to use defaults

.gitignore

@@ -463,8 +463,9 @@ Thumbs.db
 ehthumbs.db
 ehthumbs_vista.db
 
-# Dump file
+# Dump type files
 *.stackdump
+*.patch
 
 # Folder config file
 [Dd]esktop.ini
@@ -490,8 +491,13 @@ $RECYCLE.BIN/
 
 # Project and App Specific
 .env.local
+appsettings.Local.json
 tmp/
 specs/
+dotnetwebapp.conf
+dotnetwebapp.crt
+dotnetwebapp.key
+dev.log
 # Generated YAML files (regenerated from pipeline)
 app.yaml
 data.yaml

ARCHITECTURE_SUMMARY.md

@@ -1,7 +1,7 @@
 # DotNetWebApp Architecture Summary
 
-**Last Updated:** 2026-01-27
-**Status:** Architecture finalized; Phase 1 & Phase 2B complete
+**Last Updated:** 2026-02-02
+**Status:** Architecture finalized; Phase 1, Phase 2B, Phase 3+4, and WAMS Phase 1 MVP complete
 
 ---
 
@@ -176,6 +176,51 @@
 
 **Note:** Phase 3 (read-only patterns) and Phase 4 (editable patterns) are combined into a single PR.
 
+### ✅ WAMS Phase 1 COMPLETED - Web App Management System MVP (2026-02-02)
+
+**Goal:** Implement core scheduling system following proven patterns from InventoryPicking and Allocation
+
+**Status:** ✅ COMPLETED - Full MVP with 39-column grid, status workflow, AppID grouping, and soft delete
+
+**Key Features Delivered:**
+- ✅ 39-column RadzenDataGrid with order type classification (SO, PO)
+- ✅ Status workflow state machine (NA → CheckIn → Loading → Unloading → Shipped → Received)
+- ✅ AppID batch operations (orders with same AppID move together)
+- ✅ Soft delete pattern (type + 10, reversible with undelete)
+- ✅ Personnel assignment (forklift operators filtered by warehouse)
+- ✅ Color coding by order type and status
+- ✅ Multi-warehouse support (Chicago=3, NYC=92)
+- ✅ Comprehensive seed data (15 test orders covering all scenarios)
+
+**Architecture:**
+- Single service pattern following InventoryPicking (WAMSService + validators)
+- Hybrid EF Core (writes) + Dapper (reads) with SecondaryDbContext (WEBAPPMisc database)
+- Keyed dependency injection: `[FromKeyedServices("Secondary")]` IDapperQueryService
+- Static classifier (WAMSOrderTypeClassifier) + color service (WAMSColorCodingService)
+- Two validators: StatusTransitionValidator (state machine) + DeleteValidator (security)
+
+**Files Created (13 new files):**
+1. `Services/WAMS/Models/WAMSModels.cs` - All models, enums, requests, responses
+2. `Services/WAMS/WAMSOrderTypeClassifier.cs` - Static classification helper
+3. `Services/WAMS/Validators/StatusTransitionValidator.cs` - State machine validation
+4. `Services/WAMS/Validators/DeleteValidator.cs` - Delete authorization
+5. `Services/WAMS/WAMSColorCodingService.cs` - Type and status colors
+6. `Services/WAMS/IWAMSService.cs` - Service interface (10 methods)
+7. `Services/WAMS/WAMSService.cs` - Service implementation
+8. `Controllers/WAMSController.cs` - REST API (10 endpoints)
+9. `Components/Pages/WAMS/Index.razor` - Main UI with 39-column grid
+10-13. Test files (4 files with 105 unit tests)
+
+**Testing:**
+- ✅ **105 WAMS unit tests** (22 validator + 25 delete + 43 color + 15 service)
+- ✅ **582 total tests passing** (up from 467 = +115 new tests)
+- ✅ Clean build (0 warnings, 0 errors)
+- ✅ API integration verified with curl tests
+- ✅ UI displaying data correctly
+
+**Deferred to Production:**
+- BOL generation, Excel export, email notifications, auto-refresh timers, daily reset
+
 ### 🔄 Future: Validation Pipeline (1 day) - As Needed
 
 **Goal:** Robust tenant isolation for multiple schemas

AppsYamlGenerator/Program.cs

@@ -39,21 +39,30 @@
 
     // Read appsettings.json and extract Applications section
     Console.WriteLine($"Reading appsettings.json: {appSettingsAbsPath}");
-    var config = new ConfigurationBuilder()
-        .AddJsonFile(appSettingsAbsPath)
-        .Build();
+    var configBuilder = new ConfigurationBuilder()
+        .AddJsonFile(appSettingsAbsPath);
+
+    // Also read appsettings.Local.json if it exists (for local overrides)
+    var localSettingsPath = Path.Combine(Path.GetDirectoryName(appSettingsAbsPath)!, "appsettings.Local.json");
+    if (File.Exists(localSettingsPath))
+    {
+        Console.WriteLine($"Found appsettings.Local.json, merging Applications...");
+        configBuilder.AddJsonFile(localSettingsPath);
+    }
+
+    var config = configBuilder.Build();
 
     var applicationsSection = config.GetSection("Applications");
     var applications = new List<ApplicationInfo>();
 
     if (applicationsSection.Exists())
     {
         applicationsSection.Bind(applications);
-        Console.WriteLine($"Found {applications.Count} application(s) in appsettings.json");
+        Console.WriteLine($"Found {applications.Count} application(s) in configuration");
     }
     else
     {
-        Console.WriteLine("Warning: No Applications section found in appsettings.json");
+        Console.WriteLine("Warning: No Applications section found in configuration");
     }
 
     // Read data.yaml and extract DataModel section