@atlashub/smartstack-cli 3.37.0 → 3.38.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.js +16 -24
- package/dist/index.js.map +1 -1
- package/dist/mcp-entry.mjs +201 -256
- package/dist/mcp-entry.mjs.map +1 -1
- package/package.json +1 -1
- package/scripts/extract-api-endpoints.ts +5 -5
- package/scripts/generate-doc-with-mock-ui.ts +10 -17
- package/templates/agents/ba-reader.md +9 -9
- package/templates/agents/ba-writer.md +12 -15
- package/templates/agents/code-reviewer.md +1 -1
- package/templates/agents/docs-context-reader.md +1 -1
- package/templates/agents/gitflow/merge.md +0 -4
- package/templates/agents/gitflow/pr.md +0 -4
- package/templates/agents/gitflow/start.md +30 -5
- package/templates/mcp-scaffolding/frontend/nav-routes.ts.hbs +20 -20
- package/templates/mcp-scaffolding/frontend/routes.tsx.hbs +16 -24
- package/templates/mcp-scaffolding/migrations/seed-roles.cs.hbs +2 -2
- package/templates/skills/_resources/mcp-validate-documentation-spec.md +3 -3
- package/templates/skills/_shared.md +15 -17
- package/templates/skills/ai-prompt/SKILL.md +1 -1
- package/templates/skills/ai-prompt/steps/step-00-init.md +47 -0
- package/templates/skills/apex/SKILL.md +3 -4
- package/templates/skills/apex/_shared.md +10 -20
- package/templates/skills/apex/references/analysis-methods.md +141 -0
- package/templates/skills/apex/references/challenge-questions.md +1 -21
- package/templates/skills/apex/references/core-seed-data.md +35 -57
- package/templates/skills/apex/references/examine-build-validation.md +87 -0
- package/templates/skills/apex/references/execution-frontend-gates.md +177 -0
- package/templates/skills/apex/references/execution-frontend-patterns.md +105 -0
- package/templates/skills/apex/references/execution-layer1-rules.md +96 -0
- package/templates/skills/apex/references/initialization-challenge-flow.md +110 -0
- package/templates/skills/apex/references/planning-layer-mapping.md +151 -0
- package/templates/skills/apex/references/post-checks.md +145 -40
- package/templates/skills/apex/references/smartstack-api.md +35 -51
- package/templates/skills/apex/references/smartstack-frontend.md +17 -17
- package/templates/skills/apex/references/smartstack-layers.md +38 -62
- package/templates/skills/apex/steps/step-00-init.md +14 -26
- package/templates/skills/apex/steps/step-01-analyze.md +10 -143
- package/templates/skills/apex/steps/step-02-plan.md +10 -92
- package/templates/skills/apex/steps/step-03-execute.md +47 -249
- package/templates/skills/apex/steps/step-04-examine.md +14 -78
- package/templates/skills/apex/steps/step-05-deep-review.md +2 -2
- package/templates/skills/apex/steps/step-08-run-tests.md +2 -0
- package/templates/skills/application/SKILL.md +6 -7
- package/templates/skills/application/references/backend-controller-hierarchy.md +16 -16
- package/templates/skills/application/references/backend-seeding-and-dto-output.md +83 -0
- package/templates/skills/application/references/backend-table-prefix-mapping.md +79 -0
- package/templates/skills/application/references/backend-verification.md +1 -1
- package/templates/skills/application/references/frontend-i18n-and-output.md +67 -0
- package/templates/skills/application/references/frontend-route-naming.md +117 -0
- package/templates/skills/application/references/frontend-route-wiring-app-tsx.md +107 -0
- package/templates/skills/application/references/frontend-verification.md +12 -12
- package/templates/skills/application/references/init-parameter-detection.md +120 -0
- package/templates/skills/application/references/migration-checklist-troubleshooting.md +100 -0
- package/templates/skills/application/references/nav-fallback-procedure.md +5 -6
- package/templates/skills/application/references/provider-template.md +2 -6
- package/templates/skills/application/references/roles-client-project-handling.md +55 -0
- package/templates/skills/application/references/roles-fallback-procedure.md +149 -0
- package/templates/skills/application/references/test-coverage-requirements.md +213 -0
- package/templates/skills/application/references/test-frontend.md +3 -3
- package/templates/skills/application/steps/step-00-init.md +11 -141
- package/templates/skills/application/steps/step-01-navigation.md +3 -3
- package/templates/skills/application/steps/step-02-permissions.md +4 -4
- package/templates/skills/application/steps/step-03-roles.md +18 -175
- package/templates/skills/application/steps/step-03b-provider.md +1 -2
- package/templates/skills/application/steps/step-04-backend.md +19 -110
- package/templates/skills/application/steps/step-05-frontend.md +17 -143
- package/templates/skills/application/steps/step-06-migration.md +12 -60
- package/templates/skills/application/steps/step-07-tests.md +9 -76
- package/templates/skills/application/templates-backend.md +29 -27
- package/templates/skills/application/templates-frontend.md +48 -48
- package/templates/skills/application/templates-seed.md +57 -131
- package/templates/skills/business-analyse/SKILL.md +27 -30
- package/templates/skills/business-analyse/_architecture.md +6 -6
- package/templates/skills/business-analyse/_shared.md +60 -88
- package/templates/skills/business-analyse/questionnaire/04-data.md +3 -3
- package/templates/skills/business-analyse/questionnaire/06-security.md +1 -1
- package/templates/skills/business-analyse/questionnaire/13-cross-module.md +1 -1
- package/templates/skills/business-analyse/react/application-viewer.md +12 -12
- package/templates/skills/business-analyse/react/components.md +8 -12
- package/templates/skills/business-analyse/react/schema.md +11 -11
- package/templates/skills/business-analyse/references/agent-module-prompt.md +2 -3
- package/templates/skills/business-analyse/references/analysis-semantic-checks.md +190 -0
- package/templates/skills/business-analyse/references/cache-warming-strategy.md +2 -2
- package/templates/skills/business-analyse/references/cadrage-challenge-patterns.md +41 -0
- package/templates/skills/business-analyse/references/cadrage-coverage-matrix.md +74 -0
- package/templates/skills/business-analyse/references/cadrage-shared-modules.md +69 -0
- package/templates/skills/business-analyse/references/cadrage-structure-cards.md +1 -1
- package/templates/skills/business-analyse/references/compilation-structure-cards.md +297 -0
- package/templates/skills/business-analyse/references/consolidation-structural-checks.md +2 -2
- package/templates/skills/business-analyse/references/deploy-modes.md +5 -5
- package/templates/skills/business-analyse/references/detection-strategies.md +7 -7
- package/templates/skills/business-analyse/references/handoff-file-templates.md +14 -22
- package/templates/skills/business-analyse/references/handoff-mappings.md +4 -4
- package/templates/skills/business-analyse/references/handoff-seeddata-generation.md +312 -0
- package/templates/skills/business-analyse/references/init-schema-deployment.md +3 -3
- package/templates/skills/business-analyse/references/naming-conventions.md +22 -24
- package/templates/skills/business-analyse/references/prd-generation.md +2 -2
- package/templates/skills/business-analyse/references/review-data-mapping.md +2 -2
- package/templates/skills/business-analyse/references/robustness-checks.md +1 -1
- package/templates/skills/business-analyse/references/spec-auto-inference.md +3 -3
- package/templates/skills/business-analyse/references/team-orchestration.md +49 -6
- package/templates/skills/business-analyse/references/ui-dashboard-spec.md +1 -1
- package/templates/skills/business-analyse/references/ui-resource-cards.md +18 -18
- package/templates/skills/business-analyse/references/validate-incremental-html.md +2 -2
- package/templates/skills/business-analyse/references/validation-checklist.md +2 -2
- package/templates/skills/business-analyse/schemas/application-schema.json +4 -5
- package/templates/skills/business-analyse/schemas/project-schema.json +1 -6
- package/templates/skills/business-analyse/schemas/sections/metadata-schema.json +2 -3
- package/templates/skills/business-analyse/schemas/sections/specification-schema.json +4 -4
- package/templates/skills/business-analyse/steps/step-00-init.md +8 -17
- package/templates/skills/business-analyse/steps/step-01-cadrage.md +35 -198
- package/templates/skills/business-analyse/steps/step-01b-applications.md +16 -20
- package/templates/skills/business-analyse/steps/step-02-decomposition.md +1 -1
- package/templates/skills/business-analyse/steps/step-03a1-setup.md +4 -4
- package/templates/skills/business-analyse/steps/step-03a2-analysis.md +1 -1
- package/templates/skills/business-analyse/steps/step-03b-ui.md +4 -4
- package/templates/skills/business-analyse/steps/step-03c-compile.md +66 -140
- package/templates/skills/business-analyse/steps/step-03d-validate.md +2 -2
- package/templates/skills/business-analyse/steps/step-04a-collect.md +2 -2
- package/templates/skills/business-analyse/steps/step-04b-analyze.md +42 -160
- package/templates/skills/business-analyse/steps/step-04c-decide.md +1 -1
- package/templates/skills/business-analyse/steps/step-05a-handoff.md +74 -104
- package/templates/skills/business-analyse/steps/step-05b-deploy.md +13 -11
- package/templates/skills/business-analyse/steps/step-06-review.md +3 -3
- package/templates/skills/business-analyse/templates/tpl-frd.md +13 -13
- package/templates/skills/business-analyse/templates/tpl-handoff.md +12 -12
- package/templates/skills/business-analyse/templates-frd.md +25 -25
- package/templates/skills/business-analyse/templates-react.md +15 -21
- package/templates/skills/controller/SKILL.md +1 -1
- package/templates/skills/controller/postman-templates.md +1 -1
- package/templates/skills/controller/references/controller-code-templates.md +2 -2
- package/templates/skills/controller/references/mcp-scaffold-workflow.md +209 -0
- package/templates/skills/controller/references/permission-sync-templates.md +13 -16
- package/templates/skills/controller/steps/step-00-init.md +11 -11
- package/templates/skills/controller/steps/step-03-generate.md +64 -103
- package/templates/skills/controller/templates.md +67 -71
- package/templates/skills/debug/SKILL.md +13 -218
- package/templates/skills/debug/steps/step-00-init.md +57 -0
- package/templates/skills/debug/steps/step-01-analyze.md +219 -0
- package/templates/skills/debug/steps/step-02-resolve.md +85 -0
- package/templates/skills/documentation/SKILL.md +49 -345
- package/templates/skills/documentation/data-schema.md +11 -8
- package/templates/skills/documentation/steps/step-00-init.md +70 -0
- package/templates/skills/documentation/steps/step-01-scan.md +113 -0
- package/templates/skills/documentation/steps/step-02-generate.md +231 -0
- package/templates/skills/documentation/steps/step-03-validate.md +238 -0
- package/templates/skills/documentation/templates.md +480 -322
- package/templates/skills/efcore/references/both-contexts.md +32 -0
- package/templates/skills/efcore/references/database-operations.md +67 -0
- package/templates/skills/efcore/references/destructive-operations.md +38 -0
- package/templates/skills/efcore/references/reset-operations.md +81 -0
- package/templates/skills/efcore/references/seed-methods.md +86 -0
- package/templates/skills/efcore/references/shared-init-functions.md +250 -0
- package/templates/skills/efcore/references/sql-objects-injection.md +61 -0
- package/templates/skills/efcore/references/troubleshooting.md +81 -0
- package/templates/skills/efcore/steps/db/step-deploy.md +1 -32
- package/templates/skills/efcore/steps/db/step-reset.md +7 -103
- package/templates/skills/efcore/steps/db/step-seed.md +10 -132
- package/templates/skills/efcore/steps/db/step-status.md +5 -44
- package/templates/skills/efcore/steps/migration/step-03-validate.md +8 -62
- package/templates/skills/efcore/steps/rebase-snapshot/step-03-create.md +1 -57
- package/templates/skills/efcore/steps/shared/step-00-init.md +11 -254
- package/templates/skills/efcore/steps/squash/step-03-create.md +1 -58
- package/templates/skills/feature-full/SKILL.md +1 -1
- package/templates/skills/feature-full/steps/step-00-init.md +57 -0
- package/templates/skills/feature-full/steps/step-01-implementation.md +1 -1
- package/templates/skills/gitflow/SKILL.md +1 -1
- package/templates/skills/gitflow/_shared.md +23 -0
- package/templates/skills/gitflow/references/commit-message-generation.md +58 -0
- package/templates/skills/gitflow/references/commit-migration-validation.md +49 -0
- package/templates/skills/gitflow/references/finish-cleanup.md +51 -0
- package/templates/skills/gitflow/references/finish-version-bumping.md +45 -0
- package/templates/skills/gitflow/references/init-environment-detection.md +41 -0
- package/templates/skills/gitflow/references/init-questions.md +185 -0
- package/templates/skills/gitflow/references/init-structure-creation.md +71 -0
- package/templates/skills/gitflow/references/init-version-detection.md +21 -0
- package/templates/skills/gitflow/references/init-workspace-detection.md +43 -0
- package/templates/skills/gitflow/references/merge-ci-status.md +36 -0
- package/templates/skills/gitflow/references/merge-execution.md +62 -0
- package/templates/skills/gitflow/references/merge-pr-context.md +76 -0
- package/templates/skills/gitflow/references/pr-build-checks.md +60 -0
- package/templates/skills/gitflow/references/pr-generation.md +58 -0
- package/templates/skills/gitflow/references/start-branch-normalization.md +28 -0
- package/templates/skills/gitflow/references/start-worktree-creation.md +50 -0
- package/templates/skills/gitflow/references/sync-push-verify.md +44 -0
- package/templates/skills/gitflow/references/sync-rebase-conflicts.md +38 -0
- package/templates/skills/gitflow/steps/step-commit.md +12 -91
- package/templates/skills/gitflow/steps/step-finish.md +15 -159
- package/templates/skills/gitflow/steps/step-init.md +24 -326
- package/templates/skills/gitflow/steps/step-merge.md +17 -176
- package/templates/skills/gitflow/steps/step-pr.md +10 -116
- package/templates/skills/gitflow/steps/step-start.md +16 -109
- package/templates/skills/gitflow/steps/step-sync.md +6 -69
- package/templates/skills/ralph-loop/SKILL.md +6 -0
- package/templates/skills/ralph-loop/references/category-completeness.md +185 -0
- package/templates/skills/ralph-loop/references/compact-loop.md +1 -1
- package/templates/skills/ralph-loop/references/init-resume-recovery.md +127 -0
- package/templates/skills/ralph-loop/references/module-transition.md +151 -0
- package/templates/skills/ralph-loop/references/multi-module-queue.md +171 -0
- package/templates/skills/ralph-loop/references/parallel-execution.md +246 -0
- package/templates/skills/ralph-loop/references/task-transform-legacy.md +6 -9
- package/templates/skills/ralph-loop/references/team-orchestration.md +45 -3
- package/templates/skills/ralph-loop/steps/step-00-init.md +36 -109
- package/templates/skills/ralph-loop/steps/step-01-task.md +15 -163
- package/templates/skills/ralph-loop/steps/step-02-execute.md +8 -154
- package/templates/skills/ralph-loop/steps/step-04-check.md +21 -73
- package/templates/skills/review-code/references/owasp-api-top10.md +5 -5
- package/templates/skills/review-code/references/smartstack-conventions.md +11 -11
- package/templates/skills/validate-feature/references/api-smoke-tests.md +140 -0
- package/templates/skills/validate-feature/references/db-validation-checks.md +180 -0
- package/templates/skills/validate-feature/steps/step-01-compile.md +5 -2
- package/templates/skills/validate-feature/steps/step-04-api-smoke.md +34 -145
- package/templates/skills/validate-feature/steps/step-05-db-validation.md +74 -260
- package/templates/skills/workflow/SKILL.md +1 -1
- package/templates/skills/workflow/steps/step-00-init.md +57 -0
package/package.json
CHANGED
|
@@ -21,7 +21,7 @@ interface DocApiEndpoint {
|
|
|
21
21
|
|
|
22
22
|
interface PermissionConstant {
|
|
23
23
|
constantPath: string; // e.g., "Permissions.Admin.Users.View"
|
|
24
|
-
value: string; // e.g., "
|
|
24
|
+
value: string; // e.g., "administration.users.read"
|
|
25
25
|
}
|
|
26
26
|
|
|
27
27
|
/**
|
|
@@ -61,7 +61,7 @@ async function findControllerFile(appPath: string, module: string): Promise<stri
|
|
|
61
61
|
|
|
62
62
|
/**
|
|
63
63
|
* Extract NavRoute attribute value
|
|
64
|
-
* Example: [NavRoute("
|
|
64
|
+
* Example: [NavRoute("administration.users")] → "administration.users"
|
|
65
65
|
*/
|
|
66
66
|
function extractNavRoute(content: string): string | null {
|
|
67
67
|
const navRouteRegex = /\[NavRoute\("([^"]+)"\)\]/;
|
|
@@ -146,7 +146,7 @@ async function loadPermissionConstants(appPath: string): Promise<Map<string, str
|
|
|
146
146
|
const map = new Map<string, string>();
|
|
147
147
|
|
|
148
148
|
// Parse permission constant definitions
|
|
149
|
-
// Example: public const string View = "
|
|
149
|
+
// Example: public const string View = "administration.users.read";
|
|
150
150
|
const lines = content.split('\n');
|
|
151
151
|
let currentNamespace = '';
|
|
152
152
|
|
|
@@ -194,7 +194,7 @@ function resolvePermission(
|
|
|
194
194
|
}
|
|
195
195
|
|
|
196
196
|
// Fallback: infer from constant name
|
|
197
|
-
// Permissions.Admin.Users.View →
|
|
197
|
+
// Permissions.Admin.Users.View → administration.users.read
|
|
198
198
|
const parts = constantPath.split('.');
|
|
199
199
|
if (parts.length >= 3) {
|
|
200
200
|
const action = parts[parts.length - 1].toLowerCase();
|
|
@@ -236,7 +236,7 @@ async function extractEndpoints(
|
|
|
236
236
|
}
|
|
237
237
|
|
|
238
238
|
// Build base API path from navRoute
|
|
239
|
-
// "
|
|
239
|
+
// "administration.users" → "/api/administration/users"
|
|
240
240
|
const basePath = `/api/${navRoute.replace(/\./g, '/')}`;
|
|
241
241
|
|
|
242
242
|
// Parse line by line to find endpoint methods
|
|
@@ -8,7 +8,6 @@
|
|
|
8
8
|
* Usage:
|
|
9
9
|
* node generate-doc-with-mock-ui.ts \
|
|
10
10
|
* --module users \
|
|
11
|
-
* --context platform \
|
|
12
11
|
* --application administration \
|
|
13
12
|
* --app-path "D:/01 - projets/SmartStack.app/02-Develop"
|
|
14
13
|
*
|
|
@@ -22,7 +21,6 @@ import { execSync } from 'child_process';
|
|
|
22
21
|
|
|
23
22
|
interface ModuleInfo {
|
|
24
23
|
module: string; // e.g., "users"
|
|
25
|
-
context: string; // e.g., "platform"
|
|
26
24
|
application: string; // e.g., "administration"
|
|
27
25
|
appPath: string;
|
|
28
26
|
}
|
|
@@ -59,16 +57,15 @@ function parseArgs(): ModuleInfo {
|
|
|
59
57
|
};
|
|
60
58
|
|
|
61
59
|
const module = getArg('--module');
|
|
62
|
-
const context = getArg('--context');
|
|
63
60
|
const application = getArg('--application');
|
|
64
61
|
const appPath = getArg('--app-path');
|
|
65
62
|
|
|
66
|
-
if (!module || !
|
|
67
|
-
console.error('Usage: node generate-doc-with-mock-ui.ts --module <name> --
|
|
63
|
+
if (!module || !application || !appPath) {
|
|
64
|
+
console.error('Usage: node generate-doc-with-mock-ui.ts --module <name> --application <app> --app-path <path>');
|
|
68
65
|
process.exit(1);
|
|
69
66
|
}
|
|
70
67
|
|
|
71
|
-
return { module,
|
|
68
|
+
return { module, application, appPath };
|
|
72
69
|
}
|
|
73
70
|
|
|
74
71
|
/**
|
|
@@ -102,8 +99,8 @@ async function findEntityFile(appPath: string, module: string): Promise<string |
|
|
|
102
99
|
/**
|
|
103
100
|
* Find React page file
|
|
104
101
|
*/
|
|
105
|
-
async function findPageFile(appPath: string, module: string,
|
|
106
|
-
const pagesPath = path.join(appPath, `web/smartstack-web/src/pages/${
|
|
102
|
+
async function findPageFile(appPath: string, module: string, application: string): Promise<string | null> {
|
|
103
|
+
const pagesPath = path.join(appPath, `web/smartstack-web/src/pages/${application}/${module}`);
|
|
107
104
|
const pattern = `${capitalize(module)}Page.tsx`;
|
|
108
105
|
|
|
109
106
|
const fullPath = path.join(pagesPath, pattern);
|
|
@@ -523,7 +520,7 @@ function generateDocumentationTSX(
|
|
|
523
520
|
businessRules: any[],
|
|
524
521
|
pageStructure: PageStructure
|
|
525
522
|
): string {
|
|
526
|
-
const { module,
|
|
523
|
+
const { module, application } = moduleInfo;
|
|
527
524
|
const ModuleName = capitalize(module);
|
|
528
525
|
|
|
529
526
|
// Generate mock data
|
|
@@ -575,8 +572,6 @@ export function ${ModuleName}DocPage() {
|
|
|
575
572
|
<span>/</span>
|
|
576
573
|
<Link to="/system/docs/user" className="hover:text-[var(--color-primary-600)]">User</Link>
|
|
577
574
|
<span>/</span>
|
|
578
|
-
<Link to="/system/docs/user/${context}" className="hover:text-[var(--color-primary-600)]">${capitalize(context)}</Link>
|
|
579
|
-
<span>/</span>
|
|
580
575
|
<span>${ModuleName}</span>
|
|
581
576
|
</div>
|
|
582
577
|
|
|
@@ -612,8 +607,6 @@ export function ${ModuleName}DocPage() {
|
|
|
612
607
|
<div className="mb-4">
|
|
613
608
|
<div className="text-sm font-medium mb-2">Navigation</div>
|
|
614
609
|
<div className="flex items-center gap-2 text-sm bg-[var(--bg-secondary)] p-3 rounded-lg">
|
|
615
|
-
<span className="px-2 py-1 bg-[var(--bg-primary)] rounded">${capitalize(context)}</span>
|
|
616
|
-
<ArrowRight className="w-4 h-4 text-[var(--text-tertiary)]" />
|
|
617
610
|
<span className="px-2 py-1 bg-[var(--bg-primary)] rounded">${capitalize(application)}</span>
|
|
618
611
|
<ArrowRight className="w-4 h-4 text-[var(--text-tertiary)]" />
|
|
619
612
|
<span className="px-2 py-1 bg-[var(--color-primary-600)] text-white rounded">${ModuleName}</span>
|
|
@@ -623,7 +616,7 @@ export function ${ModuleName}DocPage() {
|
|
|
623
616
|
<div className="mb-4">
|
|
624
617
|
<div className="text-sm font-medium mb-2">URL</div>
|
|
625
618
|
<code className="block p-3 bg-[var(--bg-secondary)] rounded-lg text-sm font-mono">
|
|
626
|
-
/${
|
|
619
|
+
/${application}/${module}
|
|
627
620
|
</code>
|
|
628
621
|
</div>
|
|
629
622
|
</section>
|
|
@@ -732,9 +725,9 @@ function singularize(str: string): string {
|
|
|
732
725
|
*/
|
|
733
726
|
async function main() {
|
|
734
727
|
const moduleInfo = parseArgs();
|
|
735
|
-
const { module,
|
|
728
|
+
const { module, application, appPath } = moduleInfo;
|
|
736
729
|
|
|
737
|
-
console.error(`\n🚀 Generating documentation for: ${
|
|
730
|
+
console.error(`\n🚀 Generating documentation for: ${application}/${module}\n`);
|
|
738
731
|
|
|
739
732
|
// 1. Find entity file
|
|
740
733
|
console.error('📁 Finding entity file...');
|
|
@@ -752,7 +745,7 @@ async function main() {
|
|
|
752
745
|
|
|
753
746
|
// 3. Find page file
|
|
754
747
|
console.error('\n📄 Finding React page...');
|
|
755
|
-
const pagePath = await findPageFile(appPath, module,
|
|
748
|
+
const pagePath = await findPageFile(appPath, module, application);
|
|
756
749
|
if (pagePath) {
|
|
757
750
|
console.error(`✅ Found: ${pagePath}`);
|
|
758
751
|
} else {
|
|
@@ -123,13 +123,13 @@ Get a compact summary of all completed (specified) modules, for use as context w
|
|
|
123
123
|
### Customers (FEAT-011)
|
|
124
124
|
Entities: Customer, Address, Contact
|
|
125
125
|
BRs: BR-VAL-001 (email unique), BR-WF-001 (activation flow)
|
|
126
|
-
Permissions:
|
|
126
|
+
Permissions: sales.customers.{read|create|update|delete}
|
|
127
127
|
FKs exposed: Customer.Id, Address.Id
|
|
128
128
|
|
|
129
129
|
### Products (FEAT-012)
|
|
130
130
|
Entities: Product, Category, PriceHistory
|
|
131
131
|
BRs: BR-VAL-002 (SKU format), BR-CALC-001 (price calculation)
|
|
132
|
-
Permissions:
|
|
132
|
+
Permissions: sales.products.{read|create|update}
|
|
133
133
|
FKs exposed: Product.Id, Category.Id
|
|
134
134
|
```
|
|
135
135
|
|
|
@@ -289,11 +289,11 @@ Generate compact context for use by other skills and agents.
|
|
|
289
289
|
- Interaction
|
|
290
290
|
|
|
291
291
|
## Permissions (5)
|
|
292
|
-
-
|
|
293
|
-
-
|
|
294
|
-
-
|
|
295
|
-
-
|
|
296
|
-
-
|
|
292
|
+
- crm.contacts.create
|
|
293
|
+
- crm.contacts.read
|
|
294
|
+
- crm.contacts.update
|
|
295
|
+
- crm.contacts.delete
|
|
296
|
+
- crm.contacts.export
|
|
297
297
|
|
|
298
298
|
## Business Rules (4)
|
|
299
299
|
- BR-VAL-001: Email must be unique
|
|
@@ -340,7 +340,7 @@ When encountering ID references, resolve them:
|
|
|
340
340
|
**Format resolved references as inline citations:**
|
|
341
341
|
- "UC-001 (Create new contact)"
|
|
342
342
|
- "[BR-SEC-015: Sensitive data encryption required]"
|
|
343
|
-
- "
|
|
343
|
+
- "crm.contacts.create (used in UC-001, UC-003)"
|
|
344
344
|
|
|
345
345
|
## Error Handling
|
|
346
346
|
|
|
@@ -366,7 +366,7 @@ This agent provides context for:
|
|
|
366
366
|
```
|
|
367
367
|
User: "What permissions does FEAT-042 need?"
|
|
368
368
|
→ Operation: answerQuestion(FEAT-042, "What permissions does this feature need?")
|
|
369
|
-
→ Output: List of
|
|
369
|
+
→ Output: List of crm.contacts.* permissions with use case mapping
|
|
370
370
|
|
|
371
371
|
User: "Find all features that use the Contact entity"
|
|
372
372
|
→ Operation: searchAcrossFeatures("Contact")
|
|
@@ -14,8 +14,8 @@ Write and update feature.json files for project-level (multi-app), application-l
|
|
|
14
14
|
|
|
15
15
|
**Directory structure (3-tier hierarchy):**
|
|
16
16
|
- Project-level (multi-app only): `docs/business-analyse/v{X.Y}/feature.json`
|
|
17
|
-
- Application-level: `docs/{
|
|
18
|
-
- Module-level: `docs/{
|
|
17
|
+
- Application-level: `docs/{app}/business-analyse/v{X.Y}/feature.json`
|
|
18
|
+
- Module-level: `docs/{app}/{module}/business-analyse/v{X.Y}/feature.json`
|
|
19
19
|
|
|
20
20
|
> **Backward compatibility:** If only 1 application, the project level is NOT created. The application-level feature.json remains the master.
|
|
21
21
|
|
|
@@ -29,7 +29,6 @@ Create an initial feature.json with metadata and draft status.
|
|
|
29
29
|
- scope: "project", "application", or "module" (default: "module")
|
|
30
30
|
- Optional: applicationRef (FEAT-NNN of master, required when scope = "module" in app mode)
|
|
31
31
|
- Optional: projectRef (PROJ-NNN of project master, required when scope = "application" in project mode)
|
|
32
|
-
- Optional: context (default: "business", allows "platform" or "personal" in project mode)
|
|
33
32
|
- Optional: initialSections for pre-populated content
|
|
34
33
|
|
|
35
34
|
**Process:**
|
|
@@ -37,8 +36,8 @@ Create an initial feature.json with metadata and draft status.
|
|
|
37
36
|
2. Increment FEAT-NNN (or PROJ-NNN) identifier
|
|
38
37
|
3. Create directory structure based on scope:
|
|
39
38
|
- If scope = "project": `docs/business-analyse/v1.0/`
|
|
40
|
-
- If scope = "application": `docs/{
|
|
41
|
-
- If scope = "module": `docs/{
|
|
39
|
+
- If scope = "application": `docs/{app}/business-analyse/v1.0/`
|
|
40
|
+
- If scope = "module": `docs/{app}/{module}/business-analyse/v1.0/`
|
|
42
41
|
4. Generate initial feature.json with:
|
|
43
42
|
- **`$schema`**: relative path to the deployed schema file (MANDATORY — see $schema rules below)
|
|
44
43
|
- id: FEAT-NNN (from config)
|
|
@@ -104,7 +103,7 @@ Update the applications array and dependency graph in a project-level feature.js
|
|
|
104
103
|
|
|
105
104
|
**Input:**
|
|
106
105
|
- projectId: PROJ-NNN of the project feature.json
|
|
107
|
-
- applications: array of application objects (code, name,
|
|
106
|
+
- applications: array of application objects (code, name, tablePrefix, icon, description, applicationRoles[], scope, dependencies[], estimatedComplexity)
|
|
108
107
|
- applicationDependencyGraph: object with edges[], topologicalOrder[], layers[]
|
|
109
108
|
|
|
110
109
|
**Process:**
|
|
@@ -432,7 +431,7 @@ Perform these structural checks before every write:
|
|
|
432
431
|
- BR IDs: must match `BR-(VAL|CALC|WF|SEC|DATA)-[A-Z]{2,4}-\d{3}` (e.g., BR-SEC-RM-042) — module prefix MANDATORY in multi-module mode
|
|
433
432
|
- UC IDs: must match `UC-[A-Z]{2,4}-\d{3}` (e.g., UC-RM-007) — module prefix MANDATORY in multi-module mode
|
|
434
433
|
- FR IDs: must match `FR-[A-Z]{2,4}-\d{3}` (e.g., FR-RM-012) — module prefix MANDATORY in multi-module mode
|
|
435
|
-
- Permission paths: must match `
|
|
434
|
+
- Permission paths: must match `{app}\.{module}\.{resource}\.{action}` (e.g., crm.contacts.read)
|
|
436
435
|
|
|
437
436
|
**Metadata:**
|
|
438
437
|
- id, version, status, scope are required
|
|
@@ -442,7 +441,7 @@ Perform these structural checks before every write:
|
|
|
442
441
|
|
|
443
442
|
**Cross-references:**
|
|
444
443
|
- All BR-XXX, UC-XXX, FR-XXX referenced must be defined in their respective sections
|
|
445
|
-
- Permission paths must use full format with
|
|
444
|
+
- Permission paths must use full format with 4 segments: `{app}.{module}.{resource}.{action}`
|
|
446
445
|
|
|
447
446
|
**Application-scope specific:**
|
|
448
447
|
- `modules[]` must exist and be non-empty after decomposition
|
|
@@ -593,19 +592,17 @@ docs/business-analyse/
|
|
|
593
592
|
v1.0/
|
|
594
593
|
feature.json ← PROJECT (multi-app master, only if 2+ apps)
|
|
595
594
|
|
|
596
|
-
docs/{
|
|
595
|
+
docs/{app}/business-analyse/
|
|
597
596
|
v1.0/
|
|
598
597
|
feature.json ← APPLICATION (master)
|
|
599
598
|
|
|
600
|
-
docs/{
|
|
599
|
+
docs/{app}/{module}/business-analyse/
|
|
601
600
|
v1.0/
|
|
602
601
|
feature.json ← MODULE (detailed)
|
|
603
602
|
v1.1/
|
|
604
603
|
feature.json
|
|
605
604
|
```
|
|
606
605
|
|
|
607
|
-
> **{context}** = "business" (default) | "platform" | "personal" — determined per application in project mode.
|
|
608
|
-
|
|
609
606
|
Versions are stored as separate files in versioned directories. Always store feature.json at the root of each version folder.
|
|
610
607
|
|
|
611
608
|
## Config Management
|
|
@@ -762,15 +759,15 @@ If a module feature.json exceeds 500KB despite incremental operations:
|
|
|
762
759
|
## $schema Reference Rules (MANDATORY)
|
|
763
760
|
|
|
764
761
|
> **Every feature.json MUST include a `$schema` field** pointing to the deployed schema file via relative path.
|
|
765
|
-
> Schemas are deployed by step-00-init to: `docs/
|
|
762
|
+
> Schemas are deployed by step-00-init to: `docs/{app}/business-analyse/schemas/`
|
|
766
763
|
|
|
767
764
|
**$schema paths by scope:**
|
|
768
765
|
|
|
769
766
|
| Scope | Feature.json location | $schema value |
|
|
770
767
|
|-------|----------------------|---------------|
|
|
771
768
|
| project | `docs/business-analyse/v1.0/feature.json` | `"../schemas/project-schema.json"` |
|
|
772
|
-
| application | `docs/{
|
|
773
|
-
| module | `docs/{
|
|
769
|
+
| application | `docs/{app}/business-analyse/v1.0/feature.json` | `"../schemas/application-schema.json"` |
|
|
770
|
+
| module | `docs/{app}/{module}/business-analyse/v1.0/feature.json` | `"../../../business-analyse/schemas/feature-schema.json"` |
|
|
774
771
|
|
|
775
772
|
**Rules:**
|
|
776
773
|
- `$schema` is ALWAYS the FIRST field in feature.json (before `id`)
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: code-reviewer
|
|
3
3
|
description: Expert code reviewer for PR analysis. Use when reviewing code changes for security, logic, clean code, or feature-specific behavior. Accepts focus area and file list. Returns structured findings table.
|
|
4
4
|
tools: Read, Grep, Glob, Skill
|
|
5
|
-
model:
|
|
5
|
+
model: sonnet
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
<role>
|
|
@@ -66,7 +66,7 @@ For each module found, extract:
|
|
|
66
66
|
- Feature status (draft/analysed/specified/approved/handed-off)
|
|
67
67
|
- Use Case IDs (UC-001, UC-002...)
|
|
68
68
|
- Business Rule IDs (BR-001, BR-002...)
|
|
69
|
-
- Permission paths (
|
|
69
|
+
- Permission paths (app.module.action)
|
|
70
70
|
- Last update dates (from metadata.updatedAt)
|
|
71
71
|
- Validation decision (APPROVED/REJECTED/pending)
|
|
72
72
|
- Version (from folder name v1.0, v1.1, etc.)
|
|
@@ -19,15 +19,11 @@ Safe PR merge with review checklist. Supports GitHub and Azure DevOps.
|
|
|
19
19
|
CONFIG_FILE=""
|
|
20
20
|
if [ -f ".claude/gitflow/config.json" ]; then
|
|
21
21
|
CONFIG_FILE=".claude/gitflow/config.json"
|
|
22
|
-
elif [ -f ".gitflow/config.json" ]; then
|
|
23
|
-
CONFIG_FILE=".gitflow/config.json"
|
|
24
22
|
else
|
|
25
23
|
# Try develop worktree
|
|
26
24
|
DEVELOP_PATH=$(git worktree list --porcelain 2>/dev/null | grep -A1 "branch refs/heads/develop" | grep "^worktree " | sed 's/^worktree //')
|
|
27
25
|
if [ -n "$DEVELOP_PATH" ] && [ -f "$DEVELOP_PATH/.claude/gitflow/config.json" ]; then
|
|
28
26
|
CONFIG_FILE="$DEVELOP_PATH/.claude/gitflow/config.json"
|
|
29
|
-
elif [ -n "$DEVELOP_PATH" ] && [ -f "$DEVELOP_PATH/.gitflow/config.json" ]; then
|
|
30
|
-
CONFIG_FILE="$DEVELOP_PATH/.gitflow/config.json"
|
|
31
27
|
fi
|
|
32
28
|
fi
|
|
33
29
|
|
|
@@ -21,15 +21,11 @@ Create PR with auto-generated description, Azure DevOps and GitHub support.
|
|
|
21
21
|
CONFIG_FILE=""
|
|
22
22
|
if [ -f ".claude/gitflow/config.json" ]; then
|
|
23
23
|
CONFIG_FILE=".claude/gitflow/config.json"
|
|
24
|
-
elif [ -f ".gitflow/config.json" ]; then
|
|
25
|
-
CONFIG_FILE=".gitflow/config.json"
|
|
26
24
|
else
|
|
27
25
|
# Try develop worktree
|
|
28
26
|
DEVELOP_PATH=$(git worktree list --porcelain 2>/dev/null | grep -A1 "branch refs/heads/develop" | grep "^worktree " | sed 's/^worktree //')
|
|
29
27
|
if [ -n "$DEVELOP_PATH" ] && [ -f "$DEVELOP_PATH/.claude/gitflow/config.json" ]; then
|
|
30
28
|
CONFIG_FILE="$DEVELOP_PATH/.claude/gitflow/config.json"
|
|
31
|
-
elif [ -n "$DEVELOP_PATH" ] && [ -f "$DEVELOP_PATH/.gitflow/config.json" ]; then
|
|
32
|
-
CONFIG_FILE="$DEVELOP_PATH/.gitflow/config.json"
|
|
33
29
|
fi
|
|
34
30
|
fi
|
|
35
31
|
|
|
@@ -45,13 +45,38 @@ FULL_BRANCH="${type}/${BRANCH_NAME}"
|
|
|
45
45
|
|
|
46
46
|
### 4. Create Branch + Worktree
|
|
47
47
|
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
48
|
+
> **FORBIDDEN — Numbered directories:**
|
|
49
|
+
> - `03-Release`, `04-Feature`, `05-Hotfix` — NEVER create these
|
|
50
|
+
> - Only `01-Main` and `02-Develop` are numbered (permanent worktrees created at init)
|
|
51
|
+
> - Features go in `{root}/features/{name}`, releases in `{root}/releases/v{version}`, hotfixes in `{root}/hotfixes/{name}`
|
|
52
|
+
> - The path MUST come from `config.json → worktrees.structure.{features|releases|hotfixes}`
|
|
53
53
|
|
|
54
|
+
```bash
|
|
55
|
+
# 1. Read config (MANDATORY — paths come from here, NEVER improvised)
|
|
56
|
+
read_gitflow_config || { echo "ERROR: No config. Run /gitflow init"; exit 1; }
|
|
57
|
+
|
|
58
|
+
# 2. Resolve path from CONFIG (NEVER improvise numbered directories)
|
|
59
|
+
case "$branch_type" in
|
|
60
|
+
feature) WORKTREE_PATH="$GF_FEATURES_PATH/$BRANCH_NAME" ;;
|
|
61
|
+
release) WORKTREE_PATH="$GF_RELEASES_PATH/v$VERSION" ;;
|
|
62
|
+
hotfix) WORKTREE_PATH="$GF_HOTFIXES_PATH/$BRANCH_NAME" ;;
|
|
63
|
+
esac
|
|
64
|
+
|
|
65
|
+
# 3. Create worktree
|
|
66
|
+
mkdir -p "$(dirname "$WORKTREE_PATH")"
|
|
54
67
|
git worktree add -b "$FULL_BRANCH" "$WORKTREE_PATH" "origin/$BASE_BRANCH"
|
|
68
|
+
|
|
69
|
+
# 4. POST-CREATION VALIDATION (BLOCKING)
|
|
70
|
+
CREATED_PATH=$(git worktree list | grep "$FULL_BRANCH" | awk '{print $1}')
|
|
71
|
+
BASENAME=$(basename "$CREATED_PATH")
|
|
72
|
+
if [[ "$BASENAME" =~ ^[0-9]{2}- ]] && [[ "$BASENAME" != "01-Main" ]] && [[ "$BASENAME" != "02-Develop" ]]; then
|
|
73
|
+
echo "BLOCKING ERROR: Worktree created with numbered prefix: $CREATED_PATH"
|
|
74
|
+
echo "Expected path: $WORKTREE_PATH"
|
|
75
|
+
git worktree remove "$CREATED_PATH" --force
|
|
76
|
+
git branch -D "$FULL_BRANCH" 2>/dev/null
|
|
77
|
+
echo "Removed invalid worktree. Recreating at correct path..."
|
|
78
|
+
git worktree add -b "$FULL_BRANCH" "$WORKTREE_PATH" "origin/$BASE_BRANCH"
|
|
79
|
+
fi
|
|
55
80
|
```
|
|
56
81
|
|
|
57
82
|
### 5. Push Branch to Remote (AUTOMATIC)
|
|
@@ -11,11 +11,11 @@
|
|
|
11
11
|
*/
|
|
12
12
|
|
|
13
13
|
export interface NavRoute {
|
|
14
|
-
/** NavRoute path (e.g., "
|
|
14
|
+
/** NavRoute path (e.g., "administration.users") */
|
|
15
15
|
navRoute: string;
|
|
16
|
-
/** API endpoint path (e.g., "/api/
|
|
16
|
+
/** API endpoint path (e.g., "/api/administration/users") */
|
|
17
17
|
api: string;
|
|
18
|
-
/** Frontend route path (e.g., "/
|
|
18
|
+
/** Frontend route path (e.g., "/administration/users") */
|
|
19
19
|
web: string;
|
|
20
20
|
/** Required permissions to access this route */
|
|
21
21
|
permissions: string[];
|
|
@@ -72,43 +72,43 @@ export function hasRoutePermission(navRoute: string, userPermissions: string[]):
|
|
|
72
72
|
}
|
|
73
73
|
|
|
74
74
|
/**
|
|
75
|
-
* Get all routes for
|
|
75
|
+
* Get all routes for an application (e.g., "administration")
|
|
76
76
|
*/
|
|
77
|
-
export function
|
|
78
|
-
return Object.values(ROUTES).filter(r => r.navRoute.startsWith(`${
|
|
77
|
+
export function getRoutesByApplication(application: string): NavRoute[] {
|
|
78
|
+
return Object.values(ROUTES).filter(r => r.navRoute.startsWith(`${application}.`));
|
|
79
79
|
}
|
|
80
80
|
|
|
81
81
|
/**
|
|
82
|
-
* Get all routes for
|
|
82
|
+
* Get all routes for an application and module (e.g., "administration.users")
|
|
83
83
|
*/
|
|
84
|
-
export function
|
|
85
|
-
const prefix = `${
|
|
84
|
+
export function getRoutesByModule(application: string, module: string): NavRoute[] {
|
|
85
|
+
const prefix = `${application}.${module}`;
|
|
86
86
|
return Object.values(ROUTES).filter(r => r.navRoute.startsWith(`${prefix}.`) || r.navRoute === prefix);
|
|
87
87
|
}
|
|
88
88
|
|
|
89
89
|
/**
|
|
90
|
-
* Get all unique
|
|
90
|
+
* Get all unique applications
|
|
91
91
|
*/
|
|
92
|
-
export function
|
|
93
|
-
const
|
|
92
|
+
export function getApplications(): string[] {
|
|
93
|
+
const applications = new Set<string>();
|
|
94
94
|
for (const route of Object.values(ROUTES)) {
|
|
95
|
-
|
|
95
|
+
applications.add(route.navRoute.split('.')[0]);
|
|
96
96
|
}
|
|
97
|
-
return Array.from(
|
|
97
|
+
return Array.from(applications);
|
|
98
98
|
}
|
|
99
99
|
|
|
100
100
|
/**
|
|
101
|
-
* Get all unique
|
|
101
|
+
* Get all unique modules within an application
|
|
102
102
|
*/
|
|
103
|
-
export function
|
|
104
|
-
const
|
|
103
|
+
export function getModules(application: string): string[] {
|
|
104
|
+
const modules = new Set<string>();
|
|
105
105
|
for (const route of Object.values(ROUTES)) {
|
|
106
106
|
const parts = route.navRoute.split('.');
|
|
107
|
-
if (parts[0] ===
|
|
108
|
-
|
|
107
|
+
if (parts[0] === application && parts.length >= 2) {
|
|
108
|
+
modules.add(parts[1]);
|
|
109
109
|
}
|
|
110
110
|
}
|
|
111
|
-
return Array.from(
|
|
111
|
+
return Array.from(modules);
|
|
112
112
|
}
|
|
113
113
|
|
|
114
114
|
/**
|
|
@@ -19,7 +19,7 @@ import { ProtectedRoute, PermissionGuard } from './guards';
|
|
|
19
19
|
// Layouts
|
|
20
20
|
// ============================================================================
|
|
21
21
|
|
|
22
|
-
{{#each
|
|
22
|
+
{{#each applications}}
|
|
23
23
|
import { {{capitalize this}}Layout } from '../layouts/{{capitalize this}}Layout';
|
|
24
24
|
{{/each}}
|
|
25
25
|
|
|
@@ -52,38 +52,30 @@ const routes: RouteObject[] = [
|
|
|
52
52
|
element: <Navigate to="{{defaultPath}}" replace />,
|
|
53
53
|
},
|
|
54
54
|
|
|
55
|
-
{{#each
|
|
56
|
-
// {{uppercase @key}}
|
|
55
|
+
{{#each applicationTree}}
|
|
56
|
+
// {{uppercase @key}} Application
|
|
57
57
|
{
|
|
58
58
|
path: '{{@key}}',
|
|
59
59
|
element: <{{capitalize @key}}Layout />,
|
|
60
60
|
children: [
|
|
61
61
|
{{#each this}}
|
|
62
|
-
// {{uppercase @key}} Application
|
|
63
62
|
{
|
|
64
|
-
path: '{{
|
|
65
|
-
children: [
|
|
66
|
-
{{#each this}}
|
|
67
|
-
{
|
|
68
|
-
path: '{{modulePath this.navRoute}}',
|
|
63
|
+
path: '{{modulePath this.navRoute}}',
|
|
69
64
|
{{#if this.permissions.length}}
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
65
|
+
element: (
|
|
66
|
+
<PermissionGuard permissions={ROUTES['{{this.navRoute}}'].permissions}>
|
|
67
|
+
<Suspense fallback={<PageLoader />}>
|
|
68
|
+
<{{pageName this.navRoute}}Page />
|
|
69
|
+
</Suspense>
|
|
70
|
+
</PermissionGuard>
|
|
71
|
+
),
|
|
77
72
|
{{else}}
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
73
|
+
element: (
|
|
74
|
+
<Suspense fallback={<PageLoader />}>
|
|
75
|
+
<{{pageName this.navRoute}}Page />
|
|
76
|
+
</Suspense>
|
|
77
|
+
),
|
|
83
78
|
{{/if}}
|
|
84
|
-
},
|
|
85
|
-
{{/each}}
|
|
86
|
-
],
|
|
87
79
|
},
|
|
88
80
|
{{/each}}
|
|
89
81
|
],
|
|
@@ -152,8 +152,8 @@ public partial class {{migrationName}} : Migration
|
|
|
152
152
|
FROM core.auth_Permissions
|
|
153
153
|
WHERE IsDeleted = 0
|
|
154
154
|
AND Code NOT LIKE '%.delete'
|
|
155
|
-
AND Code NOT LIKE '
|
|
156
|
-
AND Code NOT LIKE '
|
|
155
|
+
AND Code NOT LIKE 'administration.users.%'
|
|
156
|
+
AND Code NOT LIKE 'administration.roles.%';
|
|
157
157
|
|
|
158
158
|
PRINT 'Read, create, update permissions granted to Contributor (excluding user management)';
|
|
159
159
|
END
|
|
@@ -129,9 +129,9 @@ FOR each module:
|
|
|
129
129
|
"issues": [
|
|
130
130
|
{
|
|
131
131
|
"type": "endpoint_mismatch",
|
|
132
|
-
"documented": ["GET /api/
|
|
133
|
-
"actual": ["GET /api/
|
|
134
|
-
"message": "Endpoint PATCH /api/
|
|
132
|
+
"documented": ["GET /api/support/sla", "POST /api/support/sla"],
|
|
133
|
+
"actual": ["GET /api/support/sla", "POST /api/support/sla", "PATCH /api/support/sla/{id}/status"],
|
|
134
|
+
"message": "Endpoint PATCH /api/support/sla/{id}/status exists in code but not in documentation"
|
|
135
135
|
}
|
|
136
136
|
]
|
|
137
137
|
}
|
|
@@ -19,11 +19,11 @@ Domain → Application → Infrastructure → API → Web
|
|
|
19
19
|
### Layers
|
|
20
20
|
| Layer | Responsibility | Namespace | Folder Hierarchy |
|
|
21
21
|
|-------|-----------------|-----------|------------------|
|
|
22
|
-
| Domain | Entities, ValueObjects | `SmartStack.Domain.{
|
|
23
|
-
| Application | Interfaces (Common), DTOs | `SmartStack.Application.Common.Interfaces` / `.{
|
|
24
|
-
| Infrastructure | Service Impl, EF Core | `SmartStack.Infrastructure.Services.{
|
|
25
|
-
| API | Controllers, Middleware | `SmartStack.Api.Controllers
|
|
26
|
-
| Web | React components, pages | N/A | `pages/{
|
|
22
|
+
| Domain | Entities, ValueObjects | `SmartStack.Domain.{App}.{Module}` | `Domain/{App}/{Module}/` |
|
|
23
|
+
| Application | Interfaces (Common), DTOs | `SmartStack.Application.Common.Interfaces` / `.{App}.{Module}.DTOs` | `Application/Common/Interfaces/` + `Application/{App}/{Module}/DTOs/` |
|
|
24
|
+
| Infrastructure | Service Impl, EF Core | `SmartStack.Infrastructure.Services.{App}.{Module}` | `Infrastructure/Services/{App}/{Module}/` + `Persistence/Configurations/{App}/{Module}/` |
|
|
25
|
+
| API | Controllers, Middleware | `SmartStack.Api.Controllers` | `Api/Controllers/` |
|
|
26
|
+
| Web | React components, pages | N/A | `pages/{app}/{module}/` + `components/{module}/` |
|
|
27
27
|
|
|
28
28
|
## Permissions (2 mandatory files)
|
|
29
29
|
|
|
@@ -31,10 +31,10 @@ Domain → Application → Infrastructure → API → Web
|
|
|
31
31
|
```csharp
|
|
32
32
|
public static class {Module}
|
|
33
33
|
{
|
|
34
|
-
public const string View = "{
|
|
35
|
-
public const string Create = "{
|
|
36
|
-
public const string Update = "{
|
|
37
|
-
public const string Delete = "{
|
|
34
|
+
public const string View = "{app}.{module}.view";
|
|
35
|
+
public const string Create = "{app}.{module}.create";
|
|
36
|
+
public const string Update = "{app}.{module}.update";
|
|
37
|
+
public const string Delete = "{app}.{module}.delete";
|
|
38
38
|
}
|
|
39
39
|
```
|
|
40
40
|
|
|
@@ -59,14 +59,12 @@ builder.HasData(
|
|
|
59
59
|
### i18n Structure
|
|
60
60
|
```json
|
|
61
61
|
{
|
|
62
|
-
"{
|
|
63
|
-
"{
|
|
64
|
-
"
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
"messages": { ... }
|
|
69
|
-
}
|
|
62
|
+
"{application}": {
|
|
63
|
+
"{module}": {
|
|
64
|
+
"title": "...",
|
|
65
|
+
"fields": { ... },
|
|
66
|
+
"actions": { ... },
|
|
67
|
+
"messages": { ... }
|
|
70
68
|
}
|
|
71
69
|
}
|
|
72
70
|
}
|
|
@@ -60,7 +60,7 @@ JSON Schema for validation: Code, Name, JsonSchema, DotNetType
|
|
|
60
60
|
|
|
61
61
|
## Implementation
|
|
62
62
|
|
|
63
|
-
|
|
63
|
+
Start with [steps/step-00-init.md](steps/step-00-init.md) to gather requirements, then proceed to [steps/step-01-implementation.md](steps/step-01-implementation.md) for:
|
|
64
64
|
- Workflow steps (define use case, create prompt, define schema, execute)
|
|
65
65
|
- AI service interfaces (IAiCompletionService, IPromptService)
|
|
66
66
|
- Frontend integration (API, hooks, components)
|