@team-codeme/crud-forge 0.0.0-stage → 1.0.0

package/QA/TESTCASES.md

@@ -0,0 +1,65 @@
+# CRUDForge test cases
+
+Automated cases are tagged `[auto]`. Manual / MCP exploration is tagged `[manual]`.
+
+## Auth
+
+| ID | Title | Steps | Expected | Tag |
+|---|---|---|---|---|
+| AUTH-01 | Sign in with demo credentials | Open `/auth/sign-in`. Confirm email is prefilled. Click Sign in. | Lands on `/admin` (welcome or dashboard). | [auto] |
+| AUTH-02 | Sign-in page branding | Open `/auth/sign-in`. | CRUDForge logo/copy visible. Primary button uses Fuse root theme. | [auto] |
+
+## Navigation
+
+| ID | Title | Steps | Expected | Tag |
+|---|---|---|---|---|
+| NAV-01 | Open Books | After sign-in go to `/admin/book` or click Books. | Heading Book Management. New button visible. Rows load. | [auto] |
+| NAV-02 | Open Authors | Go to `/admin/author` or click Authors. | Heading Author Management. New button visible. | [auto] |
+
+## List
+
+| ID | Title | Steps | Expected | Tag |
+|---|---|---|---|---|
+| LIST-01 | Mock rows render | Open Books. | At least one title like `Mock title`. Pagination shows a total. | [auto] |
+| LIST-02 | Pagination | Open Books. Change page or items per page if 12+ rows. | Page changes without blanking the table. | [auto] |
+| LIST-03 | Pin row | Click pin on first row. | Pin icon stays active / row stays pinned on refresh of the table. | [auto] |
+| LIST-04 | Flag row | Open flag menu, pick a color. | Flag icon color updates. | [auto] |
+| LIST-05 | Export control | Look for export FAB. | Export menu offers filtered and all. | [auto] |
+
+## Search
+
+| ID | Title | Steps | Expected | Tag |
+|---|---|---|---|---|
+| SEARCH-01 | Field search controls | Open Books. | Search-by combobox and Search placeholder are visible. | [auto] |
+| SEARCH-02 | Search by title | Set search-by Title. Type `Mock title 1`. | Matching titles stay (`1`, `10`, `11`, `12`); `Mock title 2` drops. | [auto] |
+
+## Filter
+
+| ID | Title | Steps | Expected | Tag |
+|---|---|---|---|---|
+| FILTER-01 | Open filter drawer | Click funnel button. | Advanced Filters drawer opens from the start side. | [auto] |
+| FILTER-02 | Apply and close | Set a title contains filter if exposed. Apply. | Drawer closes. List reflects filter. | [auto] |
+
+## Forms (sidebar mode)
+
+| ID | Title | Steps | Expected | Tag |
+|---|---|---|---|---|
+| FORM-01 | New opens sidebar | Click New on Books. | URL stays on `/admin/book`. Drawer `.cforge-form-drawer` shows New Book. | [auto] |
+| FORM-02 | Edit opens sidebar | Click Edit. Confirm. | URL is not `/:id/edit`. Same drawer shows Edit Book. | [auto] |
+| FORM-03 | New validation | Open New. Submit empty required title. | Save stays disabled or shows required error. No navigation. | [auto] |
+| FORM-04 | New cancel | Open New. Click Cancel. | Drawer closes. Still on list. | [auto] |
+| FORM-05 | Author new sidebar | On Authors click New. | Sidebar New Author, not `/author/new`. | [auto] |
+
+## Detail and delete
+
+| ID | Title | Steps | Expected | Tag |
+|---|---|---|---|---|
+| DETAIL-01 | View details | Click View Details on first book. | `/admin/book/:id/view` shows Book Details and Back. | [auto] |
+| DETAIL-02 | Back from detail | Click Back. | Returns to Book list. | [auto] |
+| DELETE-01 | Delete confirm cancel | Click Delete. Click Cancel. | Dialog closes. Row still present. | [auto] |
+
+## Card view
+
+| ID | Title | Steps | Expected | Tag |
+|---|---|---|---|---|
+| CARD-01 | Toggle card view | Click Switch to Card View. | Cards render. Edit on a card still opens the sidebar. | [auto] |

package/QA/TODO.md

@@ -0,0 +1,14 @@
+# QA agent todo
+
+Use this list when starting or resuming a CRUDForge QA session.
+
+- [x] Confirm `e2e/.app` exists and `npm run e2e:serve` is healthy on :4200
+- [x] Run `npm run test:e2e` (automated AUTH/NAV/LIST/SEARCH/FILTER/FORM/DETAIL/DELETE/CARD)
+- [x] Record automated results in `QA/RESULTS.md`
+- [x] Fix DEF-01 (detail Back 404) and DEF-02 (missing aria-labels); retest
+- [x] Walk branding, pin, flag, export, filter apply (now automated)
+- [x] Author new-form parity (FORM-05 passed)
+- [x] File S1/S2 defects against `src/templates/**` (DEF-01)
+- [x] Clean `e2e:prepare` is not required for this pass (`e2e/.app` already has the template fixes; regenerate only after the next template batch)
+- [x] Keep `node test/verify.js` in mind when templates change
+- [x] Update the QA canvas with the latest pass counts

package/QA/pmb-dev/README.md

@@ -0,0 +1,49 @@
+# Config-driven PMB development QA
+
+Initialize a project using the checkout's CLI:
+
+```bash
+node cli.js init /path/to/testing-area/crudforge-app
+```
+
+Edit `crudforge-app/config/crudforge.config.yml` and `crudforge-app/gdl/example.gdl`, then run:
+
+```bash
+CRUDFORGE_TESTING_AREA=/path/to/testing-area ./run-config-tests.sh validate
+CRUDFORGE_TESTING_AREA=/path/to/testing-area ./run-config-tests.sh generate
+CRUDFORGE_TESTING_AREA=/path/to/testing-area ./run-config-tests.sh ci
+```
+
+The default testing area is `/Users/abdulla/Work/CRUD-FORDGE-SETUP/crud-fordge-testing-area`.
+Alternatively set `CRUDFORGE_PROJECT_DIR` to any initialized project directory.
+Paths in the config are relative to that project. Keep `output.directory: .`.
+The runner honors the configuration's overwrite policy. For an intentionally disposable QA
+app, explicitly set `CRUDFORGE_OVERWRITE_POLICY=overwrite` when regenerating it.
+
+This folder's `config/config.yml` and `gdl/i.gdl` are optional PMB development input templates.
+For a new project, use the PMB template as its `config/crudforge.config.yml` and place `i.gdl`
+in its `gdl/` folder. Review existing inputs before replacing them. Do not retain two competing
+configuration files: discovery prefers `config/crudforge.config.yml` over `config/config.yml`.
+Previously created sibling `config/` and `gdl/` folders are not automatically moved or deleted.
+Move your chosen inputs into the project, update `output.directory` to `.`, and keep
+`input.file: ./gdl/i.gdl` when using this template.
+
+PMB's `set-env.js` only stamps build IDs. These templates use the settings from
+`src/environments/environment.development.ts` and `proxy.dev.conf.json`:
+
+- Realm: `PMB-DEV`; public SPA client: `admin-portal`.
+- OIDC and admin gateway: `http://62.84.188.166:31698`.
+- Session idle timeout: 15 minutes.
+- Service targets and rewrite paths: PMB development proxy settings, including aliases.
+
+Both generated proxy files use development services. No confidential client secret,
+operator password, secondary DAD login, or Keycloak provisioning is included.
+The Book/Author GDL exercises generation; its endpoints are not verified PMB APIs.
+Replace it with your domain schema and set `api.microservice` accordingly.
+
+Use Node 24+ and run `npm ci` in the CRUDForge checkout first. CI mode validates inputs,
+runs generator regression tests, generates the app, installs app dependencies on first use,
+and runs `build:dev`. After app dependencies change, run `npm ci` in the app to refresh them.
+It does not log in or run live browser/API tests. The existing `test-run.sh` remains a separate
+mock/live Playwright workflow with its own QA settings. For manual inspection, run
+`npm run dev` inside the generated app.

package/QA/pmb-dev/config/config.yml

@@ -0,0 +1,152 @@
+# PMB development snapshot from environment.development.ts + proxy.dev.conf.json.
+# set-env.js only stamps build IDs. No confidential client or user credentials copied.
+# Both generated proxy files intentionally use DEV targets; this is a test app.
+# Paths resolve from the project root. Example GDL uses pmb-reference-module.
+project:
+  name: PMB Development Generator QA
+input:
+  file: ./gdl/i.gdl
+  type: gdl
+output:
+  directory: .
+  overwritePolicy: fail
+  structure: shared-central
+  embedConfig: true
+validation: true
+dryRun: false
+fuse:
+  enabled: true
+  cleanLayout: true
+  includePrebuilt: false
+git:
+  enabled: false
+api:
+  baseUrl: /api
+  microservice: pmb-reference-module
+  services:
+    pmb-tracebility-module:
+      dev: http://62.84.188.166:31725
+      prod: http://62.84.188.166:31725
+      pathRewrite: /pmb-tracebility-module
+    pmb-identity-access-module:
+      dev: http://62.84.188.166:31704
+      prod: http://62.84.188.166:31704
+      pathRewrite: /pmb-identity-access-module
+    identityaccessmodule:
+      dev: http://62.84.188.166:31704
+      prod: http://62.84.188.166:31704
+      pathRewrite: /pmb-identity-access-module
+    pmb-referenceModule:
+      dev: http://62.84.188.166:31707
+      prod: http://62.84.188.166:31707
+      pathRewrite: /pmb-reference-module
+    pmb-referencemodule:
+      dev: http://62.84.188.166:31707
+      prod: http://62.84.188.166:31707
+      pathRewrite: /pmb-reference-module
+    pmb-reference-module:
+      dev: http://62.84.188.166:31707
+      prod: http://62.84.188.166:31707
+      pathRewrite: /pmb-reference-module
+    pmb-warehouse-module:
+      dev: http://62.84.188.166:31710
+      prod: http://62.84.188.166:31710
+      pathRewrite: /pmb-warehouse-module
+    pmb-warehousemodule:
+      dev: http://62.84.188.166:31710
+      prod: http://62.84.188.166:31710
+      pathRewrite: /pmb-warehouse-module
+    pmb-document-module:
+      dev: http://62.84.188.166:31719
+      prod: http://62.84.188.166:31719
+      pathRewrite: /pmb-document-module
+    paymentmodule:
+      dev: http://62.84.188.166:31734
+      prod: http://62.84.188.166:31734
+      pathRewrite: /pmb-payment-module
+    pmb-paymentmodule:
+      dev: http://62.84.188.166:31734
+      prod: http://62.84.188.166:31734
+      pathRewrite: /pmb-payment-module
+    pmb-payment-module:
+      dev: http://62.84.188.166:31734
+      prod: http://62.84.188.166:31734
+      pathRewrite: /pmb-payment-module
+    pmb-approvalModule:
+      dev: http://62.84.188.166:31701
+      prod: http://62.84.188.166:31701
+      pathRewrite: /pmb-approvalModule
+    pmb-approvalmodule:
+      dev: http://62.84.188.166:31701
+      prod: http://62.84.188.166:31701
+      pathRewrite: /pmb-approvalModule
+    pmb-notification-module:
+      dev: http://62.84.188.166:31737
+      prod: http://62.84.188.166:31737
+      pathRewrite: /pmb-notification-module
+    pmb-notificationmodule:
+      dev: http://62.84.188.166:31737
+      prod: http://62.84.188.166:31737
+      pathRewrite: /pmb-notification-module
+    pmb-notificationModule:
+      dev: http://62.84.188.166:31737
+      prod: http://62.84.188.166:31737
+      pathRewrite: /pmb-notification-module
+    notificationmodule:
+      dev: http://62.84.188.166:31737
+      prod: http://62.84.188.166:31737
+      pathRewrite: /pmb-notification-module
+    notification-module:
+      dev: http://62.84.188.166:31737
+      prod: http://62.84.188.166:31737
+      pathRewrite: /pmb-notification-module
+    pmb-identityAccessModule:
+      dev: http://62.84.188.166:31704
+      prod: http://62.84.188.166:31704
+      pathRewrite: /pmb-identity-access-module
+    pmb-warehouseModule:
+      dev: http://62.84.188.166:31710
+      prod: http://62.84.188.166:31710
+      pathRewrite: /pmb-warehouse-module
+    pmb-access-control-module:
+      dev: http://62.84.188.166:31716
+      prod: http://62.84.188.166:31716
+      pathRewrite: /pmb-access-control-module
+    pmb-dad-mock-module:
+      dev: http://62.84.188.166:30068
+      prod: http://62.84.188.166:30068
+      pathRewrite: /pmb-dad-mock-module
+    pmb-milling-module:
+      dev: http://62.84.188.166:31722
+      prod: http://62.84.188.166:31722
+      pathRewrite: /pmb-milling-module
+    pmb-paddy-collection-module:
+      dev: http://62.84.188.166:31713
+      prod: http://62.84.188.166:31713
+      pathRewrite: /pmb-paddy-collection-module
+    pmb-paddy-selling-and-movement-module:
+      dev: http://62.84.188.166:31070
+      prod: http://62.84.188.166:31070
+      pathRewrite: /pmb-paddy-selling-and-movement-module
+    pmb-policy-module:
+      dev: http://62.84.188.166:31731
+      prod: http://62.84.188.166:31731
+      pathRewrite: /pmb-policy-module
+proxy:
+  write: both
+mock:
+  enabled: false
+auth:
+  provider: keycloak
+  serverUrl: http://62.84.188.166:31698
+  realm: PMB-DEV
+  clientId: admin-portal
+  useMockAuth: false
+  session:
+    idleTimeoutMs: 900000
+  provision:
+    enabled: false
+    adapter: admin-service
+    adminServiceUrl: http://62.84.188.166:31698
+iam:
+  enabled: true

package/QA/pmb-dev/gdl/i.gdl

@@ -0,0 +1,17 @@
+// Generator smoke-test entities. Replace with your actual PMB domain schema.
+// These example endpoints are not assumed to exist on the PMB backend.
+entity Book {
+  string title required
+  string description
+  date publicationDate
+  bigDecimal price
+}
+
+entity Author {
+  string firstName required
+  string lastName required
+}
+
+relationship ManyToOne {
+  Book{author} to Author
+}