@rashidee/co2 1.2.5

package/plugin/skills/conductor-feature-develop/references/implementation-domain-template.md

@@ -0,0 +1,131 @@
+# IMPLEMENTATION_MODULE.md Template
+
+Use this template when creating per-module implementation tracking files in Phase 3.
+
+---
+
+```markdown
+# Implementation - {Module Name}
+
+**Module**: {Module Name}
+**Layer**: {Layer}
+**Status**: IN PROGRESS
+**Started**: {YYYY-MM-DD}
+**Completed**: -
+
+---
+
+## Resources
+
+| Resource | Path |
+|----------|------|
+| User Stories | {Comma-separated IDs} |
+| Model | `model/{module-slug}/model.md` |
+| Schema | `model/{module-slug}/schemas.json` |
+| Specification | `specification/{module-slug}/SPEC.md` |
+| Test Spec | `test/{module-slug}/TEST_SPEC.md` |
+| Mockup | `mockup/{role}/content/{screen}.html` |
+
+---
+
+## Implementation Checklist
+
+- [ ] 1. Read and analyze module resources
+- [ ] 2. Implement document/entity classes
+- [ ] 3. Implement repository layer
+- [ ] 4. Implement service layer
+- [ ] 5. Implement MapStruct mappers (if applicable)
+- [ ] 6. Implement controller layer
+- [ ] 7. Implement JTE view templates
+- [ ] 8. Implement message listeners (if applicable)
+- [ ] 9. Implement scheduled jobs (if applicable)
+- [ ] 10. Write Playwright E2E tests
+- [ ] 11. Run E2E tests and verify
+- [ ] 12. Visual consistency testing (mockup vs application)
+- [ ] 13. Fix visual deviations (if any)
+- [ ] 14. Update tracking files
+
+---
+
+## Source Files Created
+
+| File | Purpose |
+|------|---------|
+{Populated as files are created during implementation}
+
+---
+
+## Implementation Log
+
+{Append entries as work progresses}
+
+### Step 1: Analyze Module Resources
+**{timestamp}** - Started
+
+Findings:
+- Collections: {list}
+- Key entities: {list}
+- User stories covered: {IDs}
+- Test scenarios count: {count}
+- Dependencies satisfied: {Yes/No — list any missing}
+
+---
+
+### Step 2: Document/Entity Classes
+**{timestamp}** - Started
+
+Files created:
+- `{package}/{ModuleEntity}.java`
+...
+
+---
+
+{Continue for each step...}
+
+### Step 11: E2E Test Results
+**{timestamp}** - Executed
+
+```
+Test results:
+  {count} passed
+  {count} failed
+  {count} skipped
+
+Failed tests (if any):
+  - {test name}: {failure reason}
+```
+
+### Resolution (if tests failed)
+**{timestamp}** - Fixed
+
+- Issue: {description}
+- Fix: {what was changed}
+- Re-run result: {pass/fail}
+
+---
+
+### Step 12: Visual Consistency Testing
+**{timestamp}** - Executed
+
+Screens compared against mockup baselines:
+
+| Screen | Mockup Source | App Route | Result | Notes |
+|--------|--------------|-----------|--------|-------|
+| {screen-name} | `mockup/{role}/content/{file}.html` | `/{app-route}` | PASS/FAIL | {deviation details if any} |
+
+Aesthetic checks:
+- [ ] Color scheme matches (backgrounds, borders, text, buttons)
+- [ ] Spacing/alignment matches (padding, margins, gaps)
+- [ ] Layout structure matches (grid/flex, sidebar/header/content)
+- [ ] Typography matches (font sizes, weights, line heights)
+- [ ] Component styling matches (buttons, tables, forms, cards)
+
+### Step 13: Visual Deviation Fixes (if any)
+**{timestamp}** - Fixed
+
+| Deviation | File Changed | Fix Applied |
+|-----------|-------------|-------------|
+| {e.g. "button color mismatch"} | `{jte/css file}` | {what was changed} |
+
+Re-run result: {pass/fail}
+```

package/plugin/skills/conductor-feature-develop/references/implementation-master-template.md

@@ -0,0 +1,89 @@
+# IMPLEMENTATION_MASTER.md Template
+
+Use this template when creating the master implementation tracking file in Phase 1.
+
+---
+
+```markdown
+# Implementation Master - {Application Name}
+
+**Started**: {YYYY-MM-DD}
+**Source Code**: `{source-code-path}/`
+**Context**: `{context-path}/`
+**Status**: IN PROGRESS
+
+---
+
+## Execution Order
+
+{Copy verbatim from TEST_PLAN.md Section 5 "Execution Order"}
+
+---
+
+## Pre-Implementation (Scaffolding)
+
+| Task | Status | Notes |
+|------|--------|-------|
+| Project skeleton (Maven/Gradle) | PENDING | |
+| Build configuration (pom.xml) | PENDING | |
+| Application configuration (YAML) | PENDING | |
+| Security configuration (Keycloak) | PENDING | |
+| JTE layouts + shared partials | PENDING | |
+| UI components (Tailwind) | PENDING | |
+| JS + CSS structure | PENDING | |
+| Data access configuration | PENDING | |
+| Error handling | PENDING | |
+| Theming | PENDING | |
+| Pagination support | PENDING | |
+| Messaging (RabbitMQ) config | PENDING | |
+| Scheduling (Quartz/Batch) config | PENDING | |
+| Playwright E2E project setup | PENDING | |
+| Application compiles + starts | PENDING | |
+
+---
+
+## Module Implementation Status
+
+| # | Module | Layer | Status | Started | Completed | Notes |
+|---|--------|-------|--------|---------|-----------|-------|
+{For each module in execution order:}
+| {n} | {Module Name} | {Layer} | PENDING | - | - | |
+
+---
+
+## Module Details
+
+{For each module in execution order:}
+
+### {n}. {Module Name}
+
+**Layer**: {Layer}
+**Dependencies**: {List from TEST_PLAN.md}
+
+**Resources**:
+
+| Resource | Path | Exists |
+|----------|------|--------|
+| User Stories | {IDs} | Yes |
+| Model | `model/{module-slug}/model.md` | {Yes/No} |
+| Schema | `model/{module-slug}/schemas.json` | {Yes/No} |
+| Specification | `specification/{module-slug}/SPEC.md` | {Yes/No} |
+| Test Spec | `test/{module-slug}/TEST_SPEC.md` | {Yes/No} |
+| Mockup | `mockup/{role}/content/{screen}.html` | {Yes/No} |
+
+**Test Summary** (from TEST_SPEC.md):
+- Total scenarios: {count}
+- Seeding strategy: {strategy from TEST_PLAN.md}
+
+---
+```
+
+## Status Values
+
+| Status | Meaning |
+|--------|---------|
+| PENDING | Not yet started |
+| IN PROGRESS | Currently being implemented |
+| COMPLETED | Implementation done, tests passing |
+| BLOCKED | Cannot proceed due to dependency or issue |
+| FAILED | Tests failing, needs investigation |

package/plugin/skills/conductor-feature-develop/references/playwright-setup.md

@@ -0,0 +1,224 @@
+# Playwright E2E Test Setup Reference
+
+## Project Initialization
+
+```bash
+mkdir -p <source-code-path>/e2e
+cd <source-code-path>/e2e
+npm init -y
+npm install -D @playwright/test
+npx playwright install chromium
+```
+
+## playwright.config.ts
+
+```typescript
+import { defineConfig } from '@playwright/test';
+
+export default defineConfig({
+  testDir: './tests',
+  fullyParallel: false,        // Sequential — module order matters
+  forbidOnly: true,
+  retries: 1,
+  workers: 1,                  // Single worker — tests share state
+  reporter: [['html'], ['list']],
+  use: {
+    baseURL: 'http://localhost:8080',
+    trace: 'on-first-retry',
+    screenshot: 'only-on-failure',
+  },
+  projects: [
+    {
+      name: 'chromium',
+      use: { browserName: 'chromium' },
+    },
+  ],
+});
+```
+
+## Helper: Login Utility
+
+```typescript
+// e2e/helpers/auth.ts
+import { Page } from '@playwright/test';
+
+export async function login(page: Page, username: string, password: string) {
+  await page.goto('/');
+  // Keycloak login page
+  await page.fill('#username', username);
+  await page.fill('#password', password);
+  await page.click('#kc-login');
+  await page.waitForURL('**/dashboard**');
+}
+```
+
+## Helper: Data Seeding via CLI
+
+```typescript
+// e2e/helpers/seed.ts
+import { execSync } from 'child_process';
+
+export function seedMongo(script: string) {
+  execSync(`mongosh "mongodb://localhost:27017/urp-hub-middleware" --eval '${script}'`, {
+    timeout: 30000,
+  });
+}
+
+export function publishRabbitMQ(exchange: string, routingKey: string, payload: object) {
+  const json = JSON.stringify(payload).replace(/'/g, "'\\''");
+  execSync(
+    `rabbitmqadmin --host=localhost --port=15672 --username=guest --password=guest ` +
+    `publish exchange=${exchange} routing_key=${routingKey} payload='${json}'`,
+    { timeout: 30000 }
+  );
+}
+
+export function keycloakAdmin(command: string) {
+  execSync(`hub_single_sign_on/kcadm.bat ${command}`, { timeout: 30000 });
+}
+```
+
+## Test File Pattern
+
+```typescript
+// e2e/tests/<module-slug>.spec.ts
+import { test, expect } from '@playwright/test';
+import { login } from '../helpers/auth';
+import { seedMongo } from '../helpers/seed';
+
+test.describe('<Module Name>', () => {
+
+  test.beforeAll(async () => {
+    // Run seeding script from TEST_SPEC.md Section 4
+    seedMongo(`
+      db.<collection>.insertMany([...]);
+    `);
+  });
+
+  // NO afterAll cleanup — test data persists for downstream modules
+
+  test('<SCENARIO-ID>: <description>', async ({ page }) => {
+    await login(page, 'hub_admin_test', 'Test@1234');
+    // Steps from TEST_SPEC.md scenarios
+  });
+});
+```
+
+## Helper: Visual Comparison Utilities
+
+```typescript
+// e2e/helpers/visual.ts
+import { Page, expect } from '@playwright/test';
+import { execSync } from 'child_process';
+import path from 'path';
+
+// The shared Mockup Hub serves ALL applications' mockups from <root>/mockup.
+// Screens live under /{app_slug}/{role}/{page}. The hub port is configurable
+// (PORT env / mockup.config.json), so read the base URL from config.
+// TEST_MOCKUP_BASE_URL example: http://localhost:3000/hub_middleware
+const MOCKUP_BASE_URL = process.env.TEST_MOCKUP_BASE_URL || 'http://localhost:3000/<app_slug>';
+const VISUAL_BASELINES_DIR = path.resolve(__dirname, '..', 'visual-baselines');
+
+/**
+ * Start the shared Mockup Hub in the background.
+ * hubDir is <root>/mockup — the hub is zero-dependency (no npm install needed).
+ * Call this in beforeAll of visual tests if baselines need capturing.
+ */
+export function startMockupServer(hubDir: string): void {
+  // Start in background — the hub stays alive for the test suite
+  execSync(`cd "${hubDir}" && npm start &`, { timeout: 10000 });
+  // Give the hub time to start
+  execSync('sleep 2');
+}
+
+/**
+ * Capture a baseline screenshot from the Mockup Hub.
+ * The hub must be running (default port 3000) and MOCKUP_BASE_URL must include
+ * the app slug prefix.
+ */
+export async function captureMockupBaseline(
+  page: Page,
+  mockupRoute: string,
+  module: string,
+  screenName: string
+): Promise<void> {
+  await page.goto(`${MOCKUP_BASE_URL}${mockupRoute}`);
+  await page.waitForLoadState('networkidle');
+
+  const screenshotPath = path.join(VISUAL_BASELINES_DIR, module, `${screenName}.png`);
+  await page.screenshot({ path: screenshotPath, fullPage: true });
+}
+
+/**
+ * Compare the Spring application screen against a mockup baseline.
+ * Uses Playwright's toHaveScreenshot with relaxed thresholds to allow
+ * content differences while catching aesthetic deviations (colors,
+ * alignment, padding, margins, layout structure).
+ */
+export async function compareWithMockup(
+  page: Page,
+  appRoute: string,
+  snapshotName: string
+): Promise<void> {
+  await page.goto(appRoute);
+  await page.waitForLoadState('networkidle');
+
+  await expect(page).toHaveScreenshot(snapshotName, {
+    maxDiffPixelRatio: 0.15,   // Up to 15% pixel difference (content varies)
+    threshold: 0.3,            // Per-pixel color threshold (0=exact, 1=any)
+    animations: 'disabled',
+    fullPage: true,
+  });
+}
+```
+
+## Visual Test File Pattern
+
+```typescript
+// e2e/tests/<module-slug>.visual.spec.ts
+import { test, expect } from '@playwright/test';
+import { loginAs } from '../helpers/auth';
+
+test.describe('<Module Name> - Visual Consistency', () => {
+
+  test('<screen-name> layout matches mockup', async ({ page }) => {
+    await loginAs(page, '<role>');
+    await page.goto('<app-route>');
+    await page.waitForLoadState('networkidle');
+
+    // Compares against snapshot — on first run, generates baseline
+    // Threshold allows content differences but catches styling issues:
+    // - Colors (backgrounds, borders, text, buttons)
+    // - Spacing (padding, margins, gaps)
+    // - Layout (grid/flex arrangement, proportions)
+    // - Typography (font sizes, weights — relative, not exact)
+    await expect(page).toHaveScreenshot('<module>-<screen>.png', {
+      maxDiffPixelRatio: 0.15,
+      threshold: 0.3,
+      animations: 'disabled',
+    });
+  });
+});
+```
+
+## Running Tests
+
+```bash
+# Run specific module functional tests
+cd <source-code-path>/e2e && npx playwright test tests/<module-slug>.spec.ts
+
+# Run specific module visual tests
+cd <source-code-path>/e2e && npx playwright test tests/<module-slug>.visual.spec.ts
+
+# Run all tests in order
+cd <source-code-path>/e2e && npx playwright test
+
+# Update visual snapshots (after reviewing and approving changes)
+cd <source-code-path>/e2e && npx playwright test tests/<module-slug>.visual.spec.ts --update-snapshots
+
+# Run with headed browser (for debugging)
+cd <source-code-path>/e2e && npx playwright test tests/<module-slug>.spec.ts --headed
+
+# View HTML report
+cd <source-code-path>/e2e && npx playwright show-report
+```