@polymorphism-tech/morph-spec 3.2.0 → 4.2.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/CLAUDE.md +352 -7
- package/README.md +1 -14
- package/bin/detect-agents.js +1 -1
- package/bin/morph-spec.js +122 -34
- package/bin/validate.js +1 -1
- package/docs/getting-started.md +0 -5
- package/docs/v3.0/AGENTS.md +521 -0
- package/docs/v3.0/ANALYSIS.md +555 -0
- package/docs/v3.0/ARCHITECTURE.md +436 -0
- package/docs/v3.0/EXECUTION-FLOW.md +1304 -0
- package/docs/v3.0/FEATURES.md +688 -0
- package/docs/v3.0/README.md +231 -0
- package/docs/v3.0/ROADMAP.md +801 -0
- package/docs/validation-checklist.md +0 -1
- package/package.json +1 -1
- package/src/commands/agents/index.js +4 -0
- package/src/commands/{spawn-team.js → agents/spawn-team.js} +172 -172
- package/src/commands/{create-story.js → feature/create-story.js} +357 -354
- package/src/commands/feature/index.js +6 -0
- package/src/commands/{shard-spec.js → feature/shard-spec.js} +2 -2
- package/src/commands/{sprint-status.js → feature/sprint-status.js} +1 -1
- package/src/commands/{generate-context.js → generation/generate-context.js} +40 -40
- package/src/commands/{generate.js → generation/generate.js} +4 -4
- package/src/commands/generation/index.js +5 -0
- package/src/commands/index.js +16 -0
- package/src/commands/{capture-pattern.js → learning/capture-pattern.js} +121 -121
- package/src/commands/learning/index.js +5 -0
- package/src/commands/{detect-agents.js → project/detect-agents.js} +178 -178
- package/src/commands/project/detect-workflow.js +174 -0
- package/src/commands/{detect.js → project/detect.js} +104 -104
- package/src/commands/{doctor.js → project/doctor.js} +356 -356
- package/src/commands/project/index.js +10 -0
- package/src/commands/{init.js → project/init.js} +305 -295
- package/src/commands/{sync.js → project/sync.js} +167 -167
- package/src/commands/{update.js → project/update.js} +240 -240
- package/src/commands/{advance-phase.js → state/advance-phase.js} +416 -357
- package/src/commands/{approve.js → state/approve.js} +221 -221
- package/src/commands/state/index.js +8 -0
- package/src/commands/{rollback-phase.js → state/rollback-phase.js} +185 -185
- package/src/commands/{state.js → state/state.js} +334 -334
- package/src/commands/{validate-phase.js → state/validate-phase.js} +221 -221
- package/src/commands/tasks/index.js +4 -0
- package/src/commands/{task.js → tasks/task.js} +78 -78
- package/src/commands/templates/index.js +8 -0
- package/src/commands/templates/template-customize.js +101 -0
- package/src/commands/templates/template-list.js +128 -0
- package/src/commands/templates/template-render.js +95 -0
- package/src/commands/templates/template-show.js +131 -0
- package/src/commands/templates/template-validate.js +91 -0
- package/src/commands/utils/index.js +7 -0
- package/src/commands/{session-summary.js → utils/session-summary.js} +291 -291
- package/src/commands/{troubleshoot.js → utils/troubleshoot.js} +222 -222
- package/src/commands/{analyze-blazor-concurrency.js → validation/analyze-blazor-concurrency.js} +193 -193
- package/src/commands/validation/index.js +8 -0
- package/src/commands/{lint-fluent.js → validation/lint-fluent.js} +352 -352
- package/src/commands/{validate-blazor-state.js → validation/validate-blazor-state.js} +210 -210
- package/src/commands/{validate-blazor.js → validation/validate-blazor.js} +156 -156
- package/src/commands/{validate-css.js → validation/validate-css.js} +84 -84
- package/src/core/index.js +10 -0
- package/src/core/registry/command-registry.js +302 -0
- package/src/core/registry/index.js +8 -0
- package/src/core/registry/validator-registry.js +204 -0
- package/src/core/state/index.js +8 -0
- package/src/{lib → core/state}/phase-state-machine.js +214 -214
- package/src/{lib → core/state}/state-manager.js +572 -534
- package/src/core/templates/index.js +9 -0
- package/src/core/templates/template-registry.js +335 -0
- package/src/core/templates/template-renderer.js +477 -0
- package/src/core/templates/template-validator.js +296 -0
- package/src/core/workflows/index.js +7 -0
- package/src/core/workflows/workflow-detector.js +354 -0
- package/src/lib/{complexity-analyzer.js → analysis/complexity-analyzer.js} +441 -441
- package/src/lib/analysis/index.js +7 -0
- package/src/lib/{checkpoint-hooks.js → checkpoints/checkpoint-hooks.js} +258 -258
- package/src/lib/checkpoints/index.js +7 -0
- package/src/lib/detectors/config-detector.js +223 -223
- package/src/lib/detectors/conversation-analyzer.js +163 -163
- package/src/lib/{design-system-detector.js → detectors/design-system-detector.js} +187 -187
- package/src/lib/detectors/index.js +87 -84
- package/src/lib/detectors/standards-generator.js +275 -275
- package/src/lib/detectors/structure-detector.js +245 -245
- package/src/lib/{context-generator.js → generators/context-generator.js} +526 -516
- package/src/lib/generators/index.js +10 -0
- package/src/lib/{metadata-extractor.js → generators/metadata-extractor.js} +387 -380
- package/src/lib/{recap-generator.js → generators/recap-generator.js} +205 -205
- package/src/lib/learning/index.js +7 -0
- package/src/lib/orchestration/index.js +7 -0
- package/src/lib/{team-orchestrator.js → orchestration/team-orchestrator.js} +323 -323
- package/src/lib/stacks/index.js +7 -0
- package/src/lib/{stack-resolver.js → stacks/stack-resolver.js} +180 -148
- package/src/lib/standards/index.js +7 -0
- package/src/lib/{standards-context-injector.js → standards/standards-context-injector.js} +298 -288
- package/src/lib/troubleshooting/index.js +8 -0
- package/src/lib/{troubleshoot-grep.js → troubleshooting/troubleshoot-grep.js} +204 -204
- package/src/lib/{troubleshoot-index.js → troubleshooting/troubleshoot-index.js} +144 -144
- package/src/lib/validators/architecture/architecture-validator.js +387 -0
- package/src/lib/validators/architecture/index.js +7 -0
- package/src/lib/validators/architecture-validator.js +40 -367
- package/src/lib/{blazor-concurrency-analyzer.js → validators/blazor/blazor-concurrency-analyzer.js} +277 -288
- package/src/lib/{blazor-state-validator.js → validators/blazor/blazor-state-validator.js} +279 -291
- package/src/lib/{blazor-validator.js → validators/blazor/blazor-validator.js} +369 -374
- package/src/lib/validators/blazor/index.js +9 -0
- package/src/lib/validators/content/content-validator.js +351 -0
- package/src/lib/validators/content/index.js +7 -0
- package/src/lib/validators/content-validator.js +164 -351
- package/src/lib/validators/{contract-compliance-validator.js → contracts/contract-compliance-validator.js} +273 -273
- package/src/lib/validators/contracts/index.js +7 -0
- package/src/lib/{css-validator.js → validators/css/css-validator.js} +352 -352
- package/src/lib/validators/css/index.js +7 -0
- package/src/lib/validators/{design-system-validator.js → design-system/design-system-validator.js} +231 -231
- package/src/lib/validators/design-system/index.js +7 -0
- package/src/lib/validators/package-validator.js +41 -340
- package/src/lib/validators/packages/index.js +7 -0
- package/src/lib/validators/packages/package-validator.js +360 -0
- package/src/lib/validators/shared/index.js +12 -0
- package/src/lib/validators/shared/issue-counter.js +18 -0
- package/src/lib/validators/shared/result-formatter.js +124 -0
- package/src/lib/{spec-validator.js → validators/spec-validator.js} +258 -258
- package/src/lib/validators/ui/index.js +7 -0
- package/src/lib/validators/ui/ui-contrast-validator.js +422 -0
- package/src/lib/validators/ui-contrast-validator.js +31 -409
- package/src/lib/{validation-runner.js → validators/validation-runner.js} +286 -284
- package/src/ui/wizard-questions.js +0 -2
- package/src/utils/color-utils.js +70 -0
- package/src/utils/file-copier.js +188 -189
- package/src/utils/process-handler.js +97 -0
- package/stacks/blazor-azure/.claude/skills/level-2-domains/ai-agents/ai-system-architect.md +3 -3
- package/stacks/blazor-azure/.claude/skills/level-2-domains/backend/api-designer.md +59 -0
- package/stacks/blazor-azure/.claude/skills/level-2-domains/backend/dotnet-senior.md +45 -255
- package/stacks/blazor-azure/.claude/skills/level-2-domains/backend/ef-modeler.md +33 -88
- package/stacks/blazor-azure/.claude/skills/level-2-domains/backend/ms-agent-expert.md +25 -89
- package/stacks/blazor-azure/.claude/skills/level-2-domains/integrations/hangfire-orchestrator.md +64 -0
- package/stacks/blazor-azure/.morph/config/agents.json +879 -764
- package/stacks/blazor-azure/.morph/hooks/{pre-commit-tests.sh → pre-commit/tests-csharp.sh} +3 -2
- package/stacks/blazor-azure/.morph/templates/infrastructure/github/workflows/cd-prod.yml.hbs +41 -0
- package/stacks/blazor-azure/.morph/templates/infrastructure/github/workflows/cd-staging.yml.hbs +24 -0
- package/stacks/blazor-azure/.morph/templates/infrastructure/github/workflows/ci-build.yml.hbs +23 -0
- package/stacks/nextjs-supabase/.claude/commands/morph-apply.md +221 -0
- package/stacks/nextjs-supabase/.claude/commands/morph-archive.md +79 -0
- package/stacks/nextjs-supabase/.claude/commands/morph-deploy.md +529 -0
- package/stacks/nextjs-supabase/.claude/commands/morph-infra.md +209 -0
- package/stacks/nextjs-supabase/.claude/commands/morph-preflight.md +227 -0
- package/stacks/nextjs-supabase/.claude/commands/morph-proposal.md +122 -0
- package/stacks/nextjs-supabase/.claude/commands/morph-status.md +86 -0
- package/stacks/nextjs-supabase/.claude/commands/morph-troubleshoot.md +122 -0
- package/stacks/nextjs-supabase/.claude/settings.local.json +6 -0
- package/stacks/nextjs-supabase/.claude/skills/level-2-domains/integrations/supabase-expert.md +30 -150
- package/stacks/nextjs-supabase/.morph/config/agents.json +345 -345
- package/stacks/nextjs-supabase/.morph/hooks/pre-commit/tests-typescript.sh +61 -0
- package/stacks/nextjs-supabase/.morph/templates/infrastructure/github/workflows/cd-prod.yml.hbs +22 -0
- package/stacks/nextjs-supabase/.morph/templates/infrastructure/github/workflows/cd-staging.yml.hbs +22 -0
- package/stacks/nextjs-supabase/.morph/templates/infrastructure/github/workflows/ci-build.yml.hbs +35 -0
- package/stacks/nextjs-supabase/README.md +6 -15
- package/bin/render-template.js +0 -349
- package/bin/semantic-detect-agents.js +0 -247
- package/bin/validate-agents-skills.js +0 -257
- package/bin/validate-agents.js +0 -70
- package/bin/validate-phase.js +0 -263
- package/docs/examples.md +0 -328
- package/scripts/reorganize-skills.cjs +0 -175
- package/scripts/validate-agents-structure.cjs +0 -52
- package/scripts/validate-skills.cjs +0 -180
- package/src/commands/deploy.js +0 -780
- package/src/lib/continuous-validator.js +0 -421
- package/src/lib/decision-constraint-loader.js +0 -109
- package/src/lib/design-system-scaffolder.js +0 -299
- package/src/lib/hook-executor.js +0 -257
- package/src/lib/mockup-generator.js +0 -366
- package/src/lib/ui-detector.js +0 -350
- package/src/llm/schema-validator.js +0 -121
- package/src/sanitizer/.gitkeep +0 -0
- package/src/scanner/.gitkeep +0 -0
- package/src/types/index.js +0 -477
- package/src/ui/.gitkeep +0 -0
- package/src/writer/.gitkeep +0 -0
- package/stacks/blazor-azure/.azure/README.md +0 -293
- package/stacks/blazor-azure/.azure/docs/azure-devops-setup.md +0 -454
- package/stacks/blazor-azure/.azure/docs/branch-strategy.md +0 -398
- package/stacks/blazor-azure/.azure/docs/local-development.md +0 -515
- package/stacks/blazor-azure/.azure/pipelines/pipeline-variables.yml +0 -34
- package/stacks/blazor-azure/.azure/pipelines/prod-pipeline.yml +0 -319
- package/stacks/blazor-azure/.azure/pipelines/staging-pipeline.yml +0 -234
- package/stacks/blazor-azure/.azure/pipelines/templates/build-dotnet.yml +0 -75
- package/stacks/blazor-azure/.azure/pipelines/templates/deploy-app-service.yml +0 -94
- package/stacks/blazor-azure/.azure/pipelines/templates/deploy-container-app.yml +0 -120
- package/stacks/blazor-azure/.azure/pipelines/templates/infra-deploy.yml +0 -90
- package/stacks/blazor-azure/.claude/settings.local.json +0 -15
- package/stacks/blazor-azure/.morph/docs/STORY-DRIVEN-DEVELOPMENT.md +0 -392
- package/stacks/blazor-azure/.morph/docs/workflows/design-impl.md +0 -37
- package/stacks/blazor-azure/.morph/docs/workflows/enforcement-pipeline.md +0 -668
- package/stacks/blazor-azure/.morph/docs/workflows/fast-track.md +0 -29
- package/stacks/blazor-azure/.morph/docs/workflows/full-morph.md +0 -76
- package/stacks/blazor-azure/.morph/docs/workflows/standard.md +0 -44
- package/stacks/blazor-azure/.morph/docs/workflows/ui-refresh.md +0 -39
- package/stacks/blazor-azure/.morph/examples/api-nextjs/README.md +0 -241
- package/stacks/blazor-azure/.morph/examples/api-nextjs/contracts.ts +0 -307
- package/stacks/blazor-azure/.morph/examples/api-nextjs/spec.md +0 -399
- package/stacks/blazor-azure/.morph/examples/api-nextjs/tasks.md +0 -168
- package/stacks/blazor-azure/.morph/examples/micro-saas/README.md +0 -125
- package/stacks/blazor-azure/.morph/examples/micro-saas/contracts.cs +0 -358
- package/stacks/blazor-azure/.morph/examples/micro-saas/decisions.md +0 -246
- package/stacks/blazor-azure/.morph/examples/micro-saas/spec.md +0 -236
- package/stacks/blazor-azure/.morph/examples/micro-saas/tasks.md +0 -150
- package/stacks/blazor-azure/.morph/examples/multi-agent/README.md +0 -309
- package/stacks/blazor-azure/.morph/examples/multi-agent/contracts.cs +0 -433
- package/stacks/blazor-azure/.morph/examples/multi-agent/spec.md +0 -479
- package/stacks/blazor-azure/.morph/examples/multi-agent/tasks.md +0 -185
- package/stacks/blazor-azure/.morph/examples/scheduled-reports/decisions.md +0 -158
- package/stacks/blazor-azure/.morph/examples/scheduled-reports/proposal.md +0 -95
- package/stacks/blazor-azure/.morph/examples/scheduled-reports/spec.md +0 -267
- package/stacks/blazor-azure/.morph/examples/state-v3.json +0 -188
- package/stacks/blazor-azure/.morph/hooks/README.md +0 -348
- package/stacks/blazor-azure/.morph/hooks/pre-commit-agents.sh +0 -24
- package/stacks/blazor-azure/.morph/hooks/pre-commit-all.sh +0 -48
- package/stacks/blazor-azure/.morph/hooks/pre-commit-specs.sh +0 -49
- package/stacks/blazor-azure/.morph/hooks/task-completed.js +0 -73
- package/stacks/blazor-azure/.morph/hooks/teammate-idle.js +0 -68
- package/stacks/blazor-azure/.morph/standards/agent-framework-blazor-ui.md +0 -359
- package/stacks/blazor-azure/.morph/standards/agent-framework-production.md +0 -410
- package/stacks/blazor-azure/.morph/standards/agent-framework-setup.md +0 -413
- package/stacks/blazor-azure/.morph/standards/agent-framework-workflows.md +0 -349
- package/stacks/blazor-azure/.morph/standards/agent-teams-workflow.md +0 -474
- package/stacks/blazor-azure/.morph/standards/architecture.md +0 -325
- package/stacks/blazor-azure/.morph/standards/azure.md +0 -605
- package/stacks/blazor-azure/.morph/standards/coding.md +0 -377
- package/stacks/blazor-azure/.morph/standards/dotnet10-migration.md +0 -520
- package/stacks/blazor-azure/.morph/standards/fluent-ui-setup.md +0 -590
- package/stacks/blazor-azure/.morph/standards/migration-guide.md +0 -514
- package/stacks/blazor-azure/.morph/standards/passkeys-auth.md +0 -423
- package/stacks/blazor-azure/.morph/standards/vector-search-rag.md +0 -536
- package/stacks/blazor-azure/.morph/templates/CONTEXT-FEATURE.md +0 -276
- package/stacks/blazor-azure/.morph/templates/CONTEXT.md +0 -170
- package/stacks/blazor-azure/.morph/templates/FluentDesignTheme.cs +0 -149
- package/stacks/blazor-azure/.morph/templates/MudTheme.cs +0 -281
- package/stacks/blazor-azure/.morph/templates/agent.cs +0 -163
- package/stacks/blazor-azure/.morph/templates/clarify-questions.md +0 -159
- package/stacks/blazor-azure/.morph/templates/component.razor +0 -239
- package/stacks/blazor-azure/.morph/templates/contracts/Commands.cs +0 -74
- package/stacks/blazor-azure/.morph/templates/contracts/Entities.cs +0 -25
- package/stacks/blazor-azure/.morph/templates/contracts/Queries.cs +0 -74
- package/stacks/blazor-azure/.morph/templates/contracts/README.md +0 -74
- package/stacks/blazor-azure/.morph/templates/contracts.cs +0 -217
- package/stacks/blazor-azure/.morph/templates/decisions.md +0 -123
- package/stacks/blazor-azure/.morph/templates/design-system.css +0 -226
- package/stacks/blazor-azure/.morph/templates/infra/.dockerignore.example +0 -89
- package/stacks/blazor-azure/.morph/templates/infra/Dockerfile.example +0 -82
- package/stacks/blazor-azure/.morph/templates/infra/README.md +0 -286
- package/stacks/blazor-azure/.morph/templates/infra/app-insights.bicep +0 -63
- package/stacks/blazor-azure/.morph/templates/infra/app-service.bicep +0 -164
- package/stacks/blazor-azure/.morph/templates/infra/azure-pipelines-deploy.yml +0 -480
- package/stacks/blazor-azure/.morph/templates/infra/container-app-env.bicep +0 -49
- package/stacks/blazor-azure/.morph/templates/infra/container-app.bicep +0 -156
- package/stacks/blazor-azure/.morph/templates/infra/deploy-checklist.md +0 -426
- package/stacks/blazor-azure/.morph/templates/infra/deploy.ps1 +0 -229
- package/stacks/blazor-azure/.morph/templates/infra/deploy.sh +0 -208
- package/stacks/blazor-azure/.morph/templates/infra/key-vault.bicep +0 -91
- package/stacks/blazor-azure/.morph/templates/infra/main.bicep +0 -189
- package/stacks/blazor-azure/.morph/templates/infra/parameters.dev.json +0 -29
- package/stacks/blazor-azure/.morph/templates/infra/parameters.prod.json +0 -29
- package/stacks/blazor-azure/.morph/templates/infra/parameters.staging.json +0 -29
- package/stacks/blazor-azure/.morph/templates/infra/sql-database.bicep +0 -103
- package/stacks/blazor-azure/.morph/templates/infra/storage.bicep +0 -106
- package/stacks/blazor-azure/.morph/templates/integrations/asaas-client.cs +0 -387
- package/stacks/blazor-azure/.morph/templates/integrations/asaas-webhook.cs +0 -351
- package/stacks/blazor-azure/.morph/templates/integrations/azure-identity-config.cs +0 -288
- package/stacks/blazor-azure/.morph/templates/integrations/clerk-config.cs +0 -258
- package/stacks/blazor-azure/.morph/templates/job.cs +0 -171
- package/stacks/blazor-azure/.morph/templates/migration.cs +0 -83
- package/stacks/blazor-azure/.morph/templates/proposal.md +0 -141
- package/stacks/blazor-azure/.morph/templates/recap.md +0 -94
- package/stacks/blazor-azure/.morph/templates/repository.cs +0 -141
- package/stacks/blazor-azure/.morph/templates/saas/subscription.cs +0 -347
- package/stacks/blazor-azure/.morph/templates/saas/tenant.cs +0 -338
- package/stacks/blazor-azure/.morph/templates/service.cs +0 -139
- package/stacks/blazor-azure/.morph/templates/simulation.md +0 -353
- package/stacks/blazor-azure/.morph/templates/spec.md +0 -149
- package/stacks/blazor-azure/.morph/templates/sprint-status.yaml +0 -68
- package/stacks/blazor-azure/.morph/templates/state.template.json +0 -222
- package/stacks/blazor-azure/.morph/templates/story.md +0 -143
- package/stacks/blazor-azure/.morph/templates/tasks.md +0 -257
- package/stacks/blazor-azure/.morph/templates/test.cs +0 -239
- package/stacks/blazor-azure/.morph/templates/ui-components.md +0 -362
- package/stacks/blazor-azure/.morph/templates/ui-design-system.md +0 -286
- package/stacks/blazor-azure/.morph/templates/ui-flows.md +0 -336
- package/stacks/blazor-azure/.morph/templates/ui-mockups.md +0 -133
- package/stacks/nextjs-supabase/.morph/docs/easypanel-setup.md +0 -169
- package/stacks/nextjs-supabase/.morph/docs/supabase-mcp-setup.md +0 -247
- package/stacks/nextjs-supabase/.morph/examples/crud-nextjs-supabase/README.md +0 -697
- package/stacks/nextjs-supabase/.morph/examples/crud-nextjs-supabase/spec.md +0 -85
- package/stacks/nextjs-supabase/.morph/examples/crud-nextjs-supabase/tasks.md +0 -86
- package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/README.md +0 -498
- package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/decisions.md +0 -121
- package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/spec.md +0 -138
- package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/tasks.md +0 -162
- package/stacks/nextjs-supabase/.morph/standards/easypanel-deploy.md +0 -191
- package/stacks/nextjs-supabase/.morph/standards/nextjs-patterns.md +0 -193
- package/stacks/nextjs-supabase/.morph/standards/supabase-auth.md +0 -171
- package/stacks/nextjs-supabase/.morph/standards/supabase-pgvector.md +0 -164
- package/stacks/nextjs-supabase/.morph/standards/supabase-rls.md +0 -179
- package/stacks/nextjs-supabase/.morph/standards/supabase-storage.md +0 -148
- package/stacks/nextjs-supabase/.morph/templates/contracts.cs +0 -173
- package/stacks/nextjs-supabase/.morph/templates/contracts.ts +0 -168
- package/stacks/nextjs-supabase/.morph/templates/decisions.md +0 -115
- package/stacks/nextjs-supabase/.morph/templates/dockerfile-api.dockerfile +0 -38
- package/stacks/nextjs-supabase/.morph/templates/dockerfile-web.dockerfile +0 -48
- package/stacks/nextjs-supabase/.morph/templates/proposal.md +0 -145
- package/stacks/nextjs-supabase/.morph/templates/recap.md +0 -134
- package/stacks/nextjs-supabase/.morph/templates/rls-policy.sql +0 -57
- package/stacks/nextjs-supabase/.morph/templates/spec.md +0 -231
- package/stacks/nextjs-supabase/.morph/templates/supabase-migration.sql +0 -100
- package/stacks/nextjs-supabase/.morph/templates/tasks.md +0 -257
- /package/src/commands/{search-patterns.js → learning/search-patterns.js} +0 -0
- /package/src/commands/{migrate-state.js → utils/migrate-state.js} +0 -0
- /package/src/commands/{upgrade.js → utils/upgrade.js} +0 -0
- /package/src/{lib → core/templates}/template-data-sources.js +0 -0
- /package/src/lib/{design-system-generator.js → generators/design-system-generator.js} +0 -0
- /package/src/lib/{learning-system.js → learning/learning-system.js} +0 -0
- /package/{src/generator → stacks/blazor-azure/.morph/templates}/.gitkeep +0 -0
- /package/{src/llm → stacks/nextjs-supabase/.morph/templates}/.gitkeep +0 -0
|
@@ -1,85 +0,0 @@
|
|
|
1
|
-
# CRUD App - Specification
|
|
2
|
-
|
|
3
|
-
## 1. Overview
|
|
4
|
-
|
|
5
|
-
Full-stack CRUD application demonstrating the Next.js + .NET API + Supabase stack. Users can manage products with authentication, file uploads, and paginated listings.
|
|
6
|
-
|
|
7
|
-
### 1.1 Objectives
|
|
8
|
-
|
|
9
|
-
- .NET 10 Minimal API with Dapper for data access
|
|
10
|
-
- Supabase Auth for authentication (email + OAuth)
|
|
11
|
-
- Row Level Security for data isolation per user
|
|
12
|
-
- File uploads via Supabase Storage
|
|
13
|
-
- Next.js 15 Server Components for data fetching
|
|
14
|
-
|
|
15
|
-
### 1.2 Use Cases
|
|
16
|
-
|
|
17
|
-
- Internal product catalogs
|
|
18
|
-
- Personal inventory management
|
|
19
|
-
- MVP product showcases
|
|
20
|
-
- Learning reference for the Next.js + Supabase stack
|
|
21
|
-
|
|
22
|
-
## 2. Functional Requirements
|
|
23
|
-
|
|
24
|
-
### 2.1 Product CRUD
|
|
25
|
-
|
|
26
|
-
| ID | Requirement |
|
|
27
|
-
|----|-------------|
|
|
28
|
-
| PROD-001 | Create product with name, description, price, and image |
|
|
29
|
-
| PROD-002 | List products with pagination (20 items/page) |
|
|
30
|
-
| PROD-003 | Search products by name (case-insensitive) |
|
|
31
|
-
| PROD-004 | Update product fields |
|
|
32
|
-
| PROD-005 | Delete product (soft or hard delete) |
|
|
33
|
-
| PROD-006 | View product detail page |
|
|
34
|
-
|
|
35
|
-
### 2.2 Authentication
|
|
36
|
-
|
|
37
|
-
| ID | Requirement |
|
|
38
|
-
|----|-------------|
|
|
39
|
-
| AUTH-001 | Email/password sign-up and sign-in via Supabase Auth |
|
|
40
|
-
| AUTH-002 | OAuth login (Google, GitHub) |
|
|
41
|
-
| AUTH-003 | Session management with cookie-based refresh |
|
|
42
|
-
| AUTH-004 | Protected routes via Next.js middleware |
|
|
43
|
-
| AUTH-005 | JWT forwarded to .NET API for endpoint authorization |
|
|
44
|
-
|
|
45
|
-
### 2.3 File Uploads
|
|
46
|
-
|
|
47
|
-
| ID | Requirement |
|
|
48
|
-
|----|-------------|
|
|
49
|
-
| FILE-001 | Upload product image to Supabase Storage |
|
|
50
|
-
| FILE-002 | Generate signed URL for private images |
|
|
51
|
-
| FILE-003 | Validate file type (JPEG, PNG, WebP) and size (max 5MB) |
|
|
52
|
-
| FILE-004 | Delete image from storage when product is deleted |
|
|
53
|
-
|
|
54
|
-
### 2.4 Data Isolation
|
|
55
|
-
|
|
56
|
-
| ID | Requirement |
|
|
57
|
-
|----|-------------|
|
|
58
|
-
| RLS-001 | Users can only read their own products |
|
|
59
|
-
| RLS-002 | Users can only insert products with their own user_id |
|
|
60
|
-
| RLS-003 | Users can only update/delete their own products |
|
|
61
|
-
| RLS-004 | RLS enforced at PostgreSQL level (not just application) |
|
|
62
|
-
|
|
63
|
-
## 3. Non-Functional Requirements
|
|
64
|
-
|
|
65
|
-
### 3.1 Performance
|
|
66
|
-
|
|
67
|
-
| ID | Requirement |
|
|
68
|
-
|----|-------------|
|
|
69
|
-
| PERF-001 | API response < 100ms (P95) for CRUD endpoints |
|
|
70
|
-
| PERF-002 | LCP < 2.5s (Core Web Vitals) |
|
|
71
|
-
| PERF-003 | Pagination via LIMIT/OFFSET with indexed queries |
|
|
72
|
-
|
|
73
|
-
### 3.2 Security
|
|
74
|
-
|
|
75
|
-
| ID | Requirement |
|
|
76
|
-
|----|-------------|
|
|
77
|
-
| SEC-001 | HTTPS in production |
|
|
78
|
-
| SEC-002 | CORS restricted to known frontend origins |
|
|
79
|
-
| SEC-003 | SQL injection prevention via parameterized queries (Dapper) |
|
|
80
|
-
| SEC-004 | JWT validation with Supabase secret |
|
|
81
|
-
| SEC-005 | Supabase service_role key never exposed to frontend |
|
|
82
|
-
|
|
83
|
-
---
|
|
84
|
-
|
|
85
|
-
*MORPH-SPEC by Polymorphism Tech*
|
|
@@ -1,86 +0,0 @@
|
|
|
1
|
-
# CRUD App - Tasks
|
|
2
|
-
|
|
3
|
-
## Phase 1: Supabase Setup
|
|
4
|
-
|
|
5
|
-
| ID | Task | Dependencies | Estimate |
|
|
6
|
-
|----|------|--------------|----------|
|
|
7
|
-
| T001 | Create Supabase project and configure auth providers (email, Google, GitHub) | - | S |
|
|
8
|
-
| T002 | Create products table migration with RLS policies | T001 | M |
|
|
9
|
-
| T003 | Create Supabase Storage bucket for product images with access policies | T001 | S |
|
|
10
|
-
|
|
11
|
-
## Phase 2: .NET API Setup
|
|
12
|
-
|
|
13
|
-
| ID | Task | Dependencies | Estimate |
|
|
14
|
-
|----|------|--------------|----------|
|
|
15
|
-
| T004 | Create .NET 10 Minimal API project with Dapper and Npgsql | - | S |
|
|
16
|
-
| T005 | Configure JWT authentication with Supabase JWT secret validation | T001, T004 | M |
|
|
17
|
-
| T006 | Implement ProductsEndpoints (GET list with pagination, GET by id, POST, PUT, DELETE) | T004, T005 | M |
|
|
18
|
-
|
|
19
|
-
## Phase 3: Auth Middleware and CORS
|
|
20
|
-
|
|
21
|
-
| ID | Task | Dependencies | Estimate |
|
|
22
|
-
|----|------|--------------|----------|
|
|
23
|
-
| T007 | Configure CORS policy for Next.js frontend origin | T004 | S |
|
|
24
|
-
| T008 | Add health check endpoint and OpenAPI documentation | T004 | S |
|
|
25
|
-
|
|
26
|
-
## Phase 4: Next.js Frontend
|
|
27
|
-
|
|
28
|
-
| ID | Task | Dependencies | Estimate |
|
|
29
|
-
|----|------|--------------|----------|
|
|
30
|
-
| T009 | Create Next.js 15 project with Tailwind CSS and @supabase/ssr | - | S |
|
|
31
|
-
| T010 | Implement Supabase client (browser) and server client with cookie handling | T009, T001 | M |
|
|
32
|
-
| T011 | Create login page with email/password and OAuth buttons | T010 | M |
|
|
33
|
-
| T012 | Create auth callback route handler and Next.js middleware for protected routes | T010 | M |
|
|
34
|
-
|
|
35
|
-
## Phase 5: Product Pages
|
|
36
|
-
|
|
37
|
-
| ID | Task | Dependencies | Estimate |
|
|
38
|
-
|----|------|--------------|----------|
|
|
39
|
-
| T013 | Create products list page (Server Component) with pagination and search | T006, T012 | M |
|
|
40
|
-
| T014 | Create product detail/edit page with form validation | T013 | M |
|
|
41
|
-
| T015 | Create new product page with image upload to Supabase Storage | T003, T013 | M |
|
|
42
|
-
|
|
43
|
-
## Phase 6: Docker and Deploy
|
|
44
|
-
|
|
45
|
-
| ID | Task | Dependencies | Estimate |
|
|
46
|
-
|----|------|--------------|----------|
|
|
47
|
-
| T016 | Create Dockerfile.api (multi-stage .NET build) | T006 | S |
|
|
48
|
-
| T017 | Create Dockerfile.web (Next.js standalone output) | T015 | S |
|
|
49
|
-
| T018 | Create docker-compose.yml for local development | T016, T017 | S |
|
|
50
|
-
|
|
51
|
-
## Checkpoints
|
|
52
|
-
|
|
53
|
-
| Checkpoint | After Tasks | Validation |
|
|
54
|
-
|------------|-------------|------------|
|
|
55
|
-
| CP1 | T003 | Supabase project ready with table, RLS, and storage bucket |
|
|
56
|
-
| CP2 | T008 | API compiles, health check responds, JWT validation works |
|
|
57
|
-
| CP3 | T012 | Auth flow works: login, session, protected routes |
|
|
58
|
-
| CP4 | T015 | Full CRUD works: list, create, edit, delete products |
|
|
59
|
-
| CP5 | T018 | Docker Compose runs both services locally |
|
|
60
|
-
|
|
61
|
-
## Legend
|
|
62
|
-
|
|
63
|
-
- **S** = Small (< 1h)
|
|
64
|
-
- **M** = Medium (1-3h)
|
|
65
|
-
|
|
66
|
-
## Execution Order
|
|
67
|
-
|
|
68
|
-
```
|
|
69
|
-
Supabase: T001 -> T002 -> T003 (CP1)
|
|
70
|
-
|
|
71
|
-
API (after T001):
|
|
72
|
-
T004 -> T005 -> T006 -> T007 -> T008 (CP2)
|
|
73
|
-
|
|
74
|
-
Frontend (after T001):
|
|
75
|
-
T009 -> T010 -> T011 -> T012 (CP3)
|
|
76
|
-
|
|
77
|
-
Pages (after API + Auth):
|
|
78
|
-
T013 -> T014 -> T015 (CP4)
|
|
79
|
-
|
|
80
|
-
Docker:
|
|
81
|
-
T016 -> T017 -> T018 (CP5)
|
|
82
|
-
```
|
|
83
|
-
|
|
84
|
-
---
|
|
85
|
-
|
|
86
|
-
*MORPH-SPEC by Polymorphism Tech*
|
|
@@ -1,498 +0,0 @@
|
|
|
1
|
-
# Multi-Tenant SaaS - Next.js + .NET API + Supabase
|
|
2
|
-
|
|
3
|
-
Multi-tenant SaaS application with tenant isolation via RLS, Stripe billing, team management, and AI-powered search using pgvector.
|
|
4
|
-
|
|
5
|
-
## Architecture
|
|
6
|
-
|
|
7
|
-
```
|
|
8
|
-
┌─────────────────────────────────────────────────────────────┐
|
|
9
|
-
│ Next.js 15 Frontend │
|
|
10
|
-
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────────┐ │
|
|
11
|
-
│ │ App Router │ │ Tenant │ │ Supabase Auth │ │
|
|
12
|
-
│ │ /dashboard │ │ Context │ │ + custom claims │ │
|
|
13
|
-
│ │ /settings │ │ Provider │ │ (tenant_id) │ │
|
|
14
|
-
│ │ /billing │ │ │ │ │ │
|
|
15
|
-
│ │ /search │ │ │ │ │ │
|
|
16
|
-
│ └──────────────┘ └──────────────┘ └──────────────────┘ │
|
|
17
|
-
└────────────────────────────┬────────────────────────────────┘
|
|
18
|
-
│ REST API (Bearer JWT with tenant_id claim)
|
|
19
|
-
▼
|
|
20
|
-
┌─────────────────────────────────────────────────────────────┐
|
|
21
|
-
│ .NET 10 Minimal API │
|
|
22
|
-
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────────┐ │
|
|
23
|
-
│ │ Tenant │ │ Stripe │ │ pgvector │ │
|
|
24
|
-
│ │ Middleware │ │ Webhooks │ │ Search │ │
|
|
25
|
-
│ │ (from JWT) │ │ Handler │ │ Endpoints │ │
|
|
26
|
-
│ └──────────────┘ └──────────────┘ └──────────────────┘ │
|
|
27
|
-
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────────┐ │
|
|
28
|
-
│ │ Dapper │ │ JWT Auth │ │ Team Mgmt │ │
|
|
29
|
-
│ │ + pgvector │ │ Middleware │ │ Endpoints │ │
|
|
30
|
-
│ └──────────────┘ └──────────────┘ └──────────────────┘ │
|
|
31
|
-
└────────────────────────────┬────────────────────────────────┘
|
|
32
|
-
│
|
|
33
|
-
▼
|
|
34
|
-
┌─────────────────────────────────────────────────────────────┐
|
|
35
|
-
│ Supabase Cloud (Pro) │
|
|
36
|
-
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────────┐ │
|
|
37
|
-
│ │ PostgreSQL │ │ Auth │ │ Storage │ │
|
|
38
|
-
│ │ + RLS │ │ + custom │ │ (per-tenant │ │
|
|
39
|
-
│ │ + pgvector │ │ claims │ │ buckets) │ │
|
|
40
|
-
│ └──────────────┘ └──────────────┘ └──────────────────┘ │
|
|
41
|
-
└─────────────────────────────────────────────────────────────┘
|
|
42
|
-
│
|
|
43
|
-
▼
|
|
44
|
-
┌─────────────────────────────────────────────────────────────┐
|
|
45
|
-
│ External Services │
|
|
46
|
-
│ ┌──────────────┐ ┌──────────────┐ │
|
|
47
|
-
│ │ Stripe │ │ OpenAI │ │
|
|
48
|
-
│ │ Billing │ │ Embeddings │ │
|
|
49
|
-
│ └──────────────┘ └──────────────┘ │
|
|
50
|
-
└─────────────────────────────────────────────────────────────┘
|
|
51
|
-
```
|
|
52
|
-
|
|
53
|
-
## What It Demonstrates
|
|
54
|
-
|
|
55
|
-
- Multi-tenancy via PostgreSQL RLS (tenant_id from JWT app_metadata)
|
|
56
|
-
- Supabase Auth with custom claims for tenant context
|
|
57
|
-
- Stripe subscription billing with webhook handling
|
|
58
|
-
- Team management (invite, roles, remove members)
|
|
59
|
-
- AI-powered semantic search using pgvector
|
|
60
|
-
- Per-tenant data isolation at the database level
|
|
61
|
-
- Dashboard with tenant-scoped metrics
|
|
62
|
-
|
|
63
|
-
## Tech Stack
|
|
64
|
-
|
|
65
|
-
| Layer | Technology |
|
|
66
|
-
|-------|-----------|
|
|
67
|
-
| **Frontend** | Next.js 15 (App Router, Server Components) |
|
|
68
|
-
| **Backend** | .NET 10 Minimal APIs + Dapper |
|
|
69
|
-
| **Database** | Supabase PostgreSQL (Pro) + pgvector |
|
|
70
|
-
| **Auth** | Supabase Auth with custom claims |
|
|
71
|
-
| **Billing** | Stripe (subscriptions, webhooks) |
|
|
72
|
-
| **AI Search** | OpenAI text-embedding-3-small + pgvector |
|
|
73
|
-
| **Deploy** | EasyPanel (VPS) + Supabase Cloud |
|
|
74
|
-
|
|
75
|
-
## Cost Estimate
|
|
76
|
-
|
|
77
|
-
| Resource | Tier | Cost/month |
|
|
78
|
-
|----------|------|------------|
|
|
79
|
-
| Supabase | Pro (8GB DB, 100GB Storage) | $25 |
|
|
80
|
-
| VPS (API + Web) | Hetzner/DigitalOcean 2GB | ~$5-6 |
|
|
81
|
-
| Stripe | Pay-as-you-go (2.9% + $0.30/txn) | Variable |
|
|
82
|
-
| OpenAI Embeddings | text-embedding-3-small | ~$0.02/1M tokens |
|
|
83
|
-
| Domain | Optional | ~$1 |
|
|
84
|
-
|
|
85
|
-
**Total**: ~$31/month base + Stripe transaction fees
|
|
86
|
-
|
|
87
|
-
---
|
|
88
|
-
|
|
89
|
-
## Code Reference
|
|
90
|
-
|
|
91
|
-
### Tenant Isolation RLS Policy
|
|
92
|
-
|
|
93
|
-
The core of multi-tenancy: every table has a `tenant_id` column, and RLS policies read the tenant from the JWT's `app_metadata`.
|
|
94
|
-
|
|
95
|
-
```sql
|
|
96
|
-
-- supabase/migrations/001_tenant_setup.sql
|
|
97
|
-
|
|
98
|
-
-- Function to extract tenant_id from JWT app_metadata
|
|
99
|
-
CREATE OR REPLACE FUNCTION auth.tenant_id()
|
|
100
|
-
RETURNS UUID AS $$
|
|
101
|
-
SELECT COALESCE(
|
|
102
|
-
(current_setting('request.jwt.claims', true)::json
|
|
103
|
-
-> 'app_metadata' ->> 'tenant_id')::uuid,
|
|
104
|
-
'00000000-0000-0000-0000-000000000000'::uuid
|
|
105
|
-
);
|
|
106
|
-
$$ LANGUAGE sql STABLE;
|
|
107
|
-
|
|
108
|
-
-- Tenants table (no RLS - managed by service_role)
|
|
109
|
-
CREATE TABLE tenants (
|
|
110
|
-
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
111
|
-
name TEXT NOT NULL,
|
|
112
|
-
slug TEXT NOT NULL UNIQUE,
|
|
113
|
-
stripe_customer_id TEXT,
|
|
114
|
-
plan TEXT NOT NULL DEFAULT 'free',
|
|
115
|
-
status TEXT NOT NULL DEFAULT 'active',
|
|
116
|
-
created_at TIMESTAMPTZ NOT NULL DEFAULT now()
|
|
117
|
-
);
|
|
118
|
-
|
|
119
|
-
-- Tenant members
|
|
120
|
-
CREATE TABLE tenant_members (
|
|
121
|
-
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
122
|
-
tenant_id UUID NOT NULL REFERENCES tenants(id) ON DELETE CASCADE,
|
|
123
|
-
user_id UUID NOT NULL REFERENCES auth.users(id) ON DELETE CASCADE,
|
|
124
|
-
role TEXT NOT NULL DEFAULT 'member',
|
|
125
|
-
invited_by UUID REFERENCES auth.users(id),
|
|
126
|
-
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
|
|
127
|
-
UNIQUE(tenant_id, user_id)
|
|
128
|
-
);
|
|
129
|
-
|
|
130
|
-
ALTER TABLE tenant_members ENABLE ROW LEVEL SECURITY;
|
|
131
|
-
|
|
132
|
-
CREATE POLICY "Members can view own tenant members"
|
|
133
|
-
ON tenant_members FOR SELECT
|
|
134
|
-
USING (tenant_id = auth.tenant_id());
|
|
135
|
-
|
|
136
|
-
CREATE POLICY "Admins can manage tenant members"
|
|
137
|
-
ON tenant_members FOR ALL
|
|
138
|
-
USING (
|
|
139
|
-
tenant_id = auth.tenant_id()
|
|
140
|
-
AND EXISTS (
|
|
141
|
-
SELECT 1 FROM tenant_members tm
|
|
142
|
-
WHERE tm.tenant_id = auth.tenant_id()
|
|
143
|
-
AND tm.user_id = auth.uid()
|
|
144
|
-
AND tm.role IN ('owner', 'admin')
|
|
145
|
-
)
|
|
146
|
-
);
|
|
147
|
-
|
|
148
|
-
-- Example tenant-scoped data table
|
|
149
|
-
CREATE TABLE documents (
|
|
150
|
-
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
151
|
-
tenant_id UUID NOT NULL REFERENCES tenants(id) ON DELETE CASCADE,
|
|
152
|
-
title TEXT NOT NULL,
|
|
153
|
-
content TEXT,
|
|
154
|
-
embedding vector(1536),
|
|
155
|
-
created_by UUID NOT NULL REFERENCES auth.users(id),
|
|
156
|
-
created_at TIMESTAMPTZ NOT NULL DEFAULT now()
|
|
157
|
-
);
|
|
158
|
-
|
|
159
|
-
ALTER TABLE documents ENABLE ROW LEVEL SECURITY;
|
|
160
|
-
|
|
161
|
-
CREATE POLICY "Tenant members can view documents"
|
|
162
|
-
ON documents FOR SELECT
|
|
163
|
-
USING (tenant_id = auth.tenant_id());
|
|
164
|
-
|
|
165
|
-
CREATE POLICY "Tenant members can insert documents"
|
|
166
|
-
ON documents FOR INSERT
|
|
167
|
-
WITH CHECK (tenant_id = auth.tenant_id());
|
|
168
|
-
|
|
169
|
-
CREATE INDEX idx_documents_tenant ON documents(tenant_id);
|
|
170
|
-
CREATE INDEX idx_documents_embedding ON documents
|
|
171
|
-
USING ivfflat (embedding vector_cosine_ops) WITH (lists = 100);
|
|
172
|
-
```
|
|
173
|
-
|
|
174
|
-
### Supabase Auth Custom Claims for tenant_id
|
|
175
|
-
|
|
176
|
-
After a user is added to a tenant, set their `app_metadata` so the JWT includes `tenant_id`:
|
|
177
|
-
|
|
178
|
-
```sql
|
|
179
|
-
-- supabase/migrations/002_auth_hooks.sql
|
|
180
|
-
|
|
181
|
-
-- Function called after user joins a tenant
|
|
182
|
-
CREATE OR REPLACE FUNCTION set_tenant_claim()
|
|
183
|
-
RETURNS TRIGGER AS $$
|
|
184
|
-
BEGIN
|
|
185
|
-
-- Update user's app_metadata with tenant_id
|
|
186
|
-
UPDATE auth.users
|
|
187
|
-
SET raw_app_meta_data =
|
|
188
|
-
COALESCE(raw_app_meta_data, '{}'::jsonb)
|
|
189
|
-
|| jsonb_build_object('tenant_id', NEW.tenant_id::text)
|
|
190
|
-
WHERE id = NEW.user_id;
|
|
191
|
-
|
|
192
|
-
RETURN NEW;
|
|
193
|
-
END;
|
|
194
|
-
$$ LANGUAGE plpgsql SECURITY DEFINER;
|
|
195
|
-
|
|
196
|
-
CREATE TRIGGER on_tenant_member_created
|
|
197
|
-
AFTER INSERT ON tenant_members
|
|
198
|
-
FOR EACH ROW
|
|
199
|
-
EXECUTE FUNCTION set_tenant_claim();
|
|
200
|
-
```
|
|
201
|
-
|
|
202
|
-
### Stripe Webhook Handler (.NET)
|
|
203
|
-
|
|
204
|
-
```csharp
|
|
205
|
-
using Stripe;
|
|
206
|
-
using Stripe.Events;
|
|
207
|
-
using Dapper;
|
|
208
|
-
using Npgsql;
|
|
209
|
-
|
|
210
|
-
public static class StripeWebhookEndpoints
|
|
211
|
-
{
|
|
212
|
-
public static void MapStripeWebhooks(this IEndpointRouteBuilder app)
|
|
213
|
-
{
|
|
214
|
-
app.MapPost("/webhooks/stripe", HandleWebhookAsync)
|
|
215
|
-
.AllowAnonymous();
|
|
216
|
-
}
|
|
217
|
-
|
|
218
|
-
private static async Task<IResult> HandleWebhookAsync(
|
|
219
|
-
HttpRequest request,
|
|
220
|
-
IConfiguration config,
|
|
221
|
-
NpgsqlConnection db,
|
|
222
|
-
CancellationToken ct = default)
|
|
223
|
-
{
|
|
224
|
-
var json = await new StreamReader(request.Body).ReadToEndAsync(ct);
|
|
225
|
-
var endpointSecret = config["Stripe:WebhookSecret"]!;
|
|
226
|
-
|
|
227
|
-
Event stripeEvent;
|
|
228
|
-
try
|
|
229
|
-
{
|
|
230
|
-
stripeEvent = EventUtility.ConstructEvent(
|
|
231
|
-
json,
|
|
232
|
-
request.Headers["Stripe-Signature"],
|
|
233
|
-
endpointSecret);
|
|
234
|
-
}
|
|
235
|
-
catch (StripeException)
|
|
236
|
-
{
|
|
237
|
-
return Results.BadRequest("Invalid signature");
|
|
238
|
-
}
|
|
239
|
-
|
|
240
|
-
await db.OpenAsync(ct);
|
|
241
|
-
|
|
242
|
-
switch (stripeEvent.Type)
|
|
243
|
-
{
|
|
244
|
-
case EventTypes.CustomerSubscriptionCreated:
|
|
245
|
-
case EventTypes.CustomerSubscriptionUpdated:
|
|
246
|
-
{
|
|
247
|
-
var subscription = stripeEvent.Data.Object as Subscription;
|
|
248
|
-
await db.ExecuteAsync("""
|
|
249
|
-
UPDATE tenants
|
|
250
|
-
SET plan = @Plan, status = @Status
|
|
251
|
-
WHERE stripe_customer_id = @CustomerId
|
|
252
|
-
""",
|
|
253
|
-
new
|
|
254
|
-
{
|
|
255
|
-
Plan = subscription!.Items.Data[0].Price.Lookup_key ?? "pro",
|
|
256
|
-
Status = subscription.Status == "active" ? "active" : "past_due",
|
|
257
|
-
CustomerId = subscription.CustomerId
|
|
258
|
-
});
|
|
259
|
-
break;
|
|
260
|
-
}
|
|
261
|
-
|
|
262
|
-
case EventTypes.CustomerSubscriptionDeleted:
|
|
263
|
-
{
|
|
264
|
-
var subscription = stripeEvent.Data.Object as Subscription;
|
|
265
|
-
await db.ExecuteAsync("""
|
|
266
|
-
UPDATE tenants
|
|
267
|
-
SET plan = 'free', status = 'active'
|
|
268
|
-
WHERE stripe_customer_id = @CustomerId
|
|
269
|
-
""",
|
|
270
|
-
new { CustomerId = subscription!.CustomerId });
|
|
271
|
-
break;
|
|
272
|
-
}
|
|
273
|
-
|
|
274
|
-
case EventTypes.InvoicePaymentFailed:
|
|
275
|
-
{
|
|
276
|
-
var invoice = stripeEvent.Data.Object as Invoice;
|
|
277
|
-
await db.ExecuteAsync("""
|
|
278
|
-
UPDATE tenants SET status = 'past_due'
|
|
279
|
-
WHERE stripe_customer_id = @CustomerId
|
|
280
|
-
""",
|
|
281
|
-
new { CustomerId = invoice!.CustomerId });
|
|
282
|
-
break;
|
|
283
|
-
}
|
|
284
|
-
}
|
|
285
|
-
|
|
286
|
-
return Results.Ok();
|
|
287
|
-
}
|
|
288
|
-
}
|
|
289
|
-
```
|
|
290
|
-
|
|
291
|
-
### Dashboard with Tenant Context
|
|
292
|
-
|
|
293
|
-
```tsx
|
|
294
|
-
// app/(dashboard)/dashboard/page.tsx
|
|
295
|
-
import { createClient } from "@/lib/supabase/server";
|
|
296
|
-
import { redirect } from "next/navigation";
|
|
297
|
-
|
|
298
|
-
const API_URL = process.env.API_URL || "http://localhost:5000";
|
|
299
|
-
|
|
300
|
-
interface DashboardMetrics {
|
|
301
|
-
totalDocuments: number;
|
|
302
|
-
totalMembers: number;
|
|
303
|
-
storageUsedMb: number;
|
|
304
|
-
plan: string;
|
|
305
|
-
searchesThisMonth: number;
|
|
306
|
-
}
|
|
307
|
-
|
|
308
|
-
export default async function DashboardPage() {
|
|
309
|
-
const supabase = await createClient();
|
|
310
|
-
const { data: { session } } = await supabase.auth.getSession();
|
|
311
|
-
|
|
312
|
-
if (!session) redirect("/login");
|
|
313
|
-
|
|
314
|
-
const tenantId = session.user.app_metadata?.tenant_id;
|
|
315
|
-
if (!tenantId) redirect("/onboarding");
|
|
316
|
-
|
|
317
|
-
const response = await fetch(`${API_URL}/api/dashboard`, {
|
|
318
|
-
headers: { Authorization: `Bearer ${session.access_token}` },
|
|
319
|
-
cache: "no-store",
|
|
320
|
-
});
|
|
321
|
-
|
|
322
|
-
const metrics: DashboardMetrics = await response.json();
|
|
323
|
-
|
|
324
|
-
return (
|
|
325
|
-
<div className="p-6">
|
|
326
|
-
<h1 className="mb-6 text-2xl font-bold">Dashboard</h1>
|
|
327
|
-
|
|
328
|
-
<div className="grid grid-cols-1 gap-4 md:grid-cols-2 lg:grid-cols-4">
|
|
329
|
-
<MetricCard title="Documents" value={metrics.totalDocuments} />
|
|
330
|
-
<MetricCard title="Team Members" value={metrics.totalMembers} />
|
|
331
|
-
<MetricCard title="Storage Used" value={`${metrics.storageUsedMb} MB`} />
|
|
332
|
-
<MetricCard
|
|
333
|
-
title="Plan"
|
|
334
|
-
value={metrics.plan.charAt(0).toUpperCase() + metrics.plan.slice(1)}
|
|
335
|
-
/>
|
|
336
|
-
</div>
|
|
337
|
-
|
|
338
|
-
<div className="mt-8">
|
|
339
|
-
<h2 className="mb-4 text-lg font-semibold">Searches This Month</h2>
|
|
340
|
-
<p className="text-3xl font-bold">{metrics.searchesThisMonth}</p>
|
|
341
|
-
</div>
|
|
342
|
-
</div>
|
|
343
|
-
);
|
|
344
|
-
}
|
|
345
|
-
|
|
346
|
-
function MetricCard({ title, value }: { title: string; value: string | number }) {
|
|
347
|
-
return (
|
|
348
|
-
<div className="rounded-lg border p-4">
|
|
349
|
-
<p className="text-sm text-gray-500">{title}</p>
|
|
350
|
-
<p className="mt-1 text-2xl font-bold">{value}</p>
|
|
351
|
-
</div>
|
|
352
|
-
);
|
|
353
|
-
}
|
|
354
|
-
```
|
|
355
|
-
|
|
356
|
-
### pgvector Similarity Search Endpoint
|
|
357
|
-
|
|
358
|
-
```csharp
|
|
359
|
-
using Dapper;
|
|
360
|
-
using Npgsql;
|
|
361
|
-
using System.Security.Claims;
|
|
362
|
-
using System.Text;
|
|
363
|
-
using System.Text.Json;
|
|
364
|
-
|
|
365
|
-
public static class SearchEndpoints
|
|
366
|
-
{
|
|
367
|
-
public static void MapSearchEndpoints(this IEndpointRouteBuilder app)
|
|
368
|
-
{
|
|
369
|
-
app.MapPost("/api/search", SearchAsync)
|
|
370
|
-
.WithTags("Search")
|
|
371
|
-
.RequireAuthorization();
|
|
372
|
-
}
|
|
373
|
-
|
|
374
|
-
private static async Task<IResult> SearchAsync(
|
|
375
|
-
SearchRequest request,
|
|
376
|
-
NpgsqlConnection db,
|
|
377
|
-
IConfiguration config,
|
|
378
|
-
ClaimsPrincipal user,
|
|
379
|
-
CancellationToken ct = default)
|
|
380
|
-
{
|
|
381
|
-
// 1. Generate embedding from query text via OpenAI
|
|
382
|
-
var embedding = await GenerateEmbeddingAsync(
|
|
383
|
-
request.Query, config["OpenAI:ApiKey"]!, ct);
|
|
384
|
-
|
|
385
|
-
// 2. Query pgvector for similar documents (scoped by tenant via RLS)
|
|
386
|
-
var tenantId = user.FindFirstValue("tenant_id");
|
|
387
|
-
await db.OpenAsync(ct);
|
|
388
|
-
|
|
389
|
-
var results = await db.QueryAsync<SearchResult>("""
|
|
390
|
-
SELECT id, title, content,
|
|
391
|
-
1 - (embedding <=> @Embedding::vector) AS similarity
|
|
392
|
-
FROM documents
|
|
393
|
-
WHERE tenant_id = @TenantId
|
|
394
|
-
AND 1 - (embedding <=> @Embedding::vector) > @Threshold
|
|
395
|
-
ORDER BY embedding <=> @Embedding::vector
|
|
396
|
-
LIMIT @Limit
|
|
397
|
-
""",
|
|
398
|
-
new
|
|
399
|
-
{
|
|
400
|
-
Embedding = $"[{string.Join(",", embedding)}]",
|
|
401
|
-
TenantId = Guid.Parse(tenantId!),
|
|
402
|
-
Threshold = request.Threshold ?? 0.7,
|
|
403
|
-
Limit = request.Limit ?? 10
|
|
404
|
-
});
|
|
405
|
-
|
|
406
|
-
return Results.Ok(results);
|
|
407
|
-
}
|
|
408
|
-
|
|
409
|
-
private static async Task<float[]> GenerateEmbeddingAsync(
|
|
410
|
-
string text, string apiKey, CancellationToken ct)
|
|
411
|
-
{
|
|
412
|
-
using var http = new HttpClient();
|
|
413
|
-
http.DefaultRequestHeaders.Add("Authorization", $"Bearer {apiKey}");
|
|
414
|
-
|
|
415
|
-
var payload = new
|
|
416
|
-
{
|
|
417
|
-
model = "text-embedding-3-small",
|
|
418
|
-
input = text
|
|
419
|
-
};
|
|
420
|
-
|
|
421
|
-
var response = await http.PostAsJsonAsync(
|
|
422
|
-
"https://api.openai.com/v1/embeddings", payload, ct);
|
|
423
|
-
response.EnsureSuccessStatusCode();
|
|
424
|
-
|
|
425
|
-
var json = await response.Content.ReadFromJsonAsync<JsonElement>(ct);
|
|
426
|
-
var embeddingArray = json
|
|
427
|
-
.GetProperty("data")[0]
|
|
428
|
-
.GetProperty("embedding");
|
|
429
|
-
|
|
430
|
-
return embeddingArray.EnumerateArray()
|
|
431
|
-
.Select(e => e.GetSingle())
|
|
432
|
-
.ToArray();
|
|
433
|
-
}
|
|
434
|
-
}
|
|
435
|
-
|
|
436
|
-
public sealed record SearchRequest(
|
|
437
|
-
string Query, double? Threshold = 0.7, int? Limit = 10);
|
|
438
|
-
|
|
439
|
-
public sealed record SearchResult(
|
|
440
|
-
Guid Id, string Title, string? Content, double Similarity);
|
|
441
|
-
```
|
|
442
|
-
|
|
443
|
-
## Folder Structure
|
|
444
|
-
|
|
445
|
-
```
|
|
446
|
-
project/
|
|
447
|
-
├── src/
|
|
448
|
-
│ ├── api/ # .NET Backend
|
|
449
|
-
│ │ ├── Endpoints/
|
|
450
|
-
│ │ │ ├── DashboardEndpoints.cs
|
|
451
|
-
│ │ │ ├── TeamEndpoints.cs
|
|
452
|
-
│ │ │ ├── SearchEndpoints.cs
|
|
453
|
-
│ │ │ ├── StripeWebhookEndpoints.cs
|
|
454
|
-
│ │ │ └── DocumentEndpoints.cs
|
|
455
|
-
│ │ ├── Middleware/
|
|
456
|
-
│ │ │ └── TenantMiddleware.cs
|
|
457
|
-
│ │ ├── DTOs/
|
|
458
|
-
│ │ ├── Program.cs
|
|
459
|
-
│ │ └── Api.csproj
|
|
460
|
-
│ │
|
|
461
|
-
│ └── web/ # Next.js Frontend
|
|
462
|
-
│ ├── app/
|
|
463
|
-
│ │ ├── (auth)/
|
|
464
|
-
│ │ │ ├── login/page.tsx
|
|
465
|
-
│ │ │ └── signup/page.tsx
|
|
466
|
-
│ │ ├── (dashboard)/
|
|
467
|
-
│ │ │ ├── layout.tsx
|
|
468
|
-
│ │ │ ├── dashboard/page.tsx
|
|
469
|
-
│ │ │ ├── documents/page.tsx
|
|
470
|
-
│ │ │ ├── search/page.tsx
|
|
471
|
-
│ │ │ ├── team/page.tsx
|
|
472
|
-
│ │ │ ├── billing/page.tsx
|
|
473
|
-
│ │ │ └── settings/page.tsx
|
|
474
|
-
│ │ ├── onboarding/page.tsx
|
|
475
|
-
│ │ ├── auth/callback/route.ts
|
|
476
|
-
│ │ ├── layout.tsx
|
|
477
|
-
│ │ └── page.tsx
|
|
478
|
-
│ ├── components/
|
|
479
|
-
│ │ ├── tenant-provider.tsx
|
|
480
|
-
│ │ └── ...
|
|
481
|
-
│ ├── lib/
|
|
482
|
-
│ │ └── supabase/
|
|
483
|
-
│ └── types/
|
|
484
|
-
│
|
|
485
|
-
├── supabase/
|
|
486
|
-
│ └── migrations/
|
|
487
|
-
│ ├── 001_tenant_setup.sql
|
|
488
|
-
│ ├── 002_auth_hooks.sql
|
|
489
|
-
│ └── 003_pgvector_setup.sql
|
|
490
|
-
│
|
|
491
|
-
├── docker-compose.yml
|
|
492
|
-
├── Dockerfile.api
|
|
493
|
-
└── Dockerfile.web
|
|
494
|
-
```
|
|
495
|
-
|
|
496
|
-
---
|
|
497
|
-
|
|
498
|
-
*MORPH-SPEC by Polymorphism Tech*
|