Dev

applications/Unity.GrantManager/docker-compose.yml

@@ -146,6 +146,27 @@ services:
     networks:
       - common-network
 
+  prometheus:
+    image: prom/prometheus:latest
+    ports:
+      - "9090:9090"
+    volumes:
+      - ./scripts/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro
+      - ./scripts/prometheus/alert-rules.yml:/etc/prometheus/alert-rules.yml:ro
+    depends_on:
+      - unity-grantmanager-web
+    networks:
+      - common-network
+
+  alertmanager:
+    image: prom/alertmanager:latest
+    ports:
+      - "9093:9093"
+    volumes:
+      - ./scripts/prometheus/alertmanager.yml:/etc/alertmanager/alertmanager.yml:ro
+    networks:
+      - common-network
+
 volumes:
   postgres_data:
   redis_volume_data:

applications/Unity.GrantManager/modules/Unity.AI/docs/README.md

@@ -0,0 +1,14 @@
+# Unity.AI Docs
+
+## Architecture
+- [`index.md`](./index.md)
+- [`flow-map.md`](./flow-map.md)
+- [`prompt-map.md`](./prompt-map.md)
+- [`implementation-playbook.md`](./implementation-playbook.md)
+
+## Operations
+- [`operations/application-analysis.md`](./operations/application-analysis.md)
+- [`operations/attachment-summary.md`](./operations/attachment-summary.md)
+- [`operations/application-scoring.md`](./operations/application-scoring.md)
+- [`operations/form-mapping.md`](./operations/form-mapping.md)
+- [`operations/form-worksheet.md`](./operations/form-worksheet.md)

applications/Unity.GrantManager/modules/Unity.AI/docs/flow-map.md

@@ -0,0 +1,14 @@
+# Flow Map
+
+## Standard path
+UI -> API app service -> queue -> background job -> AI runtime -> persisted result
+
+## Operation families
+- Application Analysis: submission -> analysis
+- Attachment Summary: attachment ids -> summaries
+- Application Scoring: application + scoresheet -> scoring
+- Form Mapping: form version -> mapping
+- Form Worksheet: form version -> worksheet
+
+## Build Rule
+See [`implementation-playbook.md`](./implementation-playbook.md) for the canonical add-a-new-operation sequence.

applications/Unity.GrantManager/modules/Unity.AI/docs/implementation-playbook.md

@@ -0,0 +1,73 @@
+# AI Operation Implementation Playbook
+
+## Purpose
+Use this when adding a new AI operation. Start with the bare minimum and only add optional pieces when the operation needs them.
+
+Use these existing operations as the canonical references:
+
+1. `ApplicationAnalysis`
+2. `ApplicationScoring`
+3. `AttachmentSummary`
+4. `FormMapping`
+5. `FormWorksheet`
+
+## Base Pattern
+1. Define the prompt type.
+2. Add the v2 prompt seed.
+3. Add the operation seed.
+4. Add the runtime contract method.
+5. Add the runtime implementation.
+6. Add the app service or queue entry.
+7. Add the background job only if the result must be applied or persisted.
+8. Add the UI button and status polling only if users trigger the operation from the web app.
+9. Add tests for the prompt, runtime parsing, and job or service path.
+
+## Bare Minimum
+For the first pass, only add what is required for a working operation:
+
+- prompt type
+- prompt seed
+- operation seed
+- runtime method
+- queue/app service entry
+- job or direct apply path, if needed
+
+## Optional Pieces
+Add these only when the operation needs them:
+
+- feature flag
+- permissions
+- permission definition provider entries
+- menu entry
+- UI button
+- status polling
+- refresh-after-complete behavior
+- persistence/import/publish/assign behavior
+
+## Rules
+- Keep the prompt as the source of truth.
+- Reuse the existing async generation pattern.
+- Do not hardcode field buckets or response shapes in UI code.
+- Do not invent new plumbing if an existing operation already does the same job.
+- Do not add tenant feature seeding.
+- Do not add write-back UI behavior unless the operation already persists output.
+
+## Expected Flow
+1. User clicks Generate.
+2. UI disables the button and shows generating state, if the operation has UI.
+3. API checks permission and feature flag, if the operation uses them.
+4. API queues the generation request.
+5. Background job loads the operation context.
+6. Job builds the prompt payload from existing data.
+7. AI runtime renders v2 prompts and logs input/output.
+8. Job parses the AI response.
+9. Job applies the result if needed.
+10. Job stamps status and rate limit state.
+11. UI polls status and refreshes after completion, if applicable.
+
+## Validation
+- Confirm the prompt version is v2.
+- Confirm the operation exists in the AI operation seed.
+- Confirm any required feature flag exists in the host feature definitions.
+- Confirm any required permission is wired in the permission definition provider.
+- Confirm the UI button uses the same generating/status flow as the other operations, if it is user-triggered.

applications/Unity.GrantManager/modules/Unity.AI/docs/index.md

@@ -0,0 +1,80 @@
+# Unity.AI Index
+
+## Domain.Shared
+AI constants:
+- feature flags
+- permission names
+- localization keys
+- prompt type names
+
+## Application.Contracts
+Public AI surface:
+- app service interfaces
+- queue interfaces
+- DTOs
+- permission definitions
+
+## Application
+AI implementation:
+- runtime
+- prompt seeding
+- generation app services
+- validators
+- prompt logging
+
+## Web
+UI-facing AI bits:
+- menus
+- generation buttons
+- status polling
+
+## Files
+### Application
+- `AI/Operations` - validators and helpers
+- `AI/Runtime` - rendering, parsing, logging, provider calls
+- `AI/Prompts` - prompt types and template plumbing
+- `DataSeed` - seeded prompt and operation data
+- `Generation/AIGenerationAppService.cs` - generation API
+
+### Application.Contracts
+- `AI/IAIService.cs` - runtime contract
+- `Generation/IAIGenerationAppService.cs` - generation app service contract
+- `Generation/*ResultDto.cs` - queued result DTOs
+- `AI/Operations/IAIGenerationPrerequisiteValidator.cs` - queue prerequisites
+- `Automation/IApplicationAIGenerationQueue.cs` - queue contract
+- `Permissions/*` - permissions
+
+### Domain.Shared
+- `Features/AIFeatures.cs` - feature flags
+- `Localization/AILocalizationKeys.cs` - messages
+- `PromptTypes/AIPromptTypes.cs` - prompt family names
+
+### Web
+- `Menus/AIMenuContributor.cs` - menu entries
+- `Menus/AIMenus.cs` - menu item names
+
+## Access
+| Operation | View | Generate |
+| --- | --- | --- |
+| Application Analysis | `ViewApplicationAnalysis` | `GenerateApplicationAnalysis` |
+| Attachment Summary | `ViewAttachmentSummary` | `GenerateAttachmentSummaries` |
+| Application Scoring | `ViewScoringResult` | `GenerateScoring` |
+| Form Mapping | `ViewFormMapping` | `GenerateFormMapping` |
+| Form Worksheet | `ViewFormWorksheet` | `GenerateFormWorksheet` |
+
+- Features:
+  - `Unity.AI.ApplicationAnalysis`
+  - `Unity.AI.AttachmentSummaries`
+  - `Unity.AI.Scoring`
+  - `Unity.AI.FormMapping`
+  - `Unity.AI.FormWorksheet`
+
+- Rule:
+  - Both permission and feature gate must allow generation.
+
+## AI Notes
+- Prompt logging: logs rendered system/user prompts and provider output.
+- Response parsing: parses provider output into stable app-facing results.
+- Feature gating: disabled features fail early at the API boundary.
+- Background jobs: mark failures, then re-throw.
+- New operation playbook: see `implementation-playbook.md`.

applications/Unity.GrantManager/modules/Unity.AI/docs/operations/application-analysis.md

@@ -0,0 +1,19 @@
+# Application Analysis
+
+## Goal
+Generate an AI analysis of an application submission.
+
+## Inputs
+- Application submission data
+- Application context
+- Optional attachments, when present
+
+## Surface
+- `POST /api/app/ai/generation/application-analysis`
+- `GET /api/app/ai/generation/status`
+
+## Contract
+- Structured analysis output. Returns an immediate queued result via API app service, queue, background job, and AI runtime.
+
+## Notes
+- This is a reviewer-oriented summary and recommendation flow.

applications/Unity.GrantManager/modules/Unity.AI/docs/operations/application-scoring.md

@@ -0,0 +1,20 @@
+# Application Scoring
+
+## Goal
+Generate scored answers for a submitted application against an assigned scoresheet.
+
+## Inputs
+- Application submission data
+- Assigned scoresheet
+- Scoresheet questions and definitions
+
+## Surface
+- `POST /api/app/ai/generation/application-scoring`
+- `GET /api/app/ai/generation/status`
+
+## Contract
+- Structured scoring output. Returns an immediate queued result via API app service, queue, background job, and AI runtime.
+
+## Notes
+- The prompt asks for answers only for the configured section or scoresheet context.
+- The parsed output must align with the scoresheet question ids.

applications/Unity.GrantManager/modules/Unity.AI/docs/operations/attachment-summary.md

@@ -0,0 +1,18 @@
+# Attachment Summary
+
+## Goal
+Generate summaries for selected application attachments.
+
+## Inputs
+- One or more attachment IDs
+- Application context
+
+## Surface
+- `POST /api/app/ai/generation/attachment-summary`
+- `GET /api/app/ai/generation/status`
+
+## Contract
+- Structured attachment summary output. Returns an immediate queued result via API app service, queue, background job, and AI runtime.
+
+## Notes
+- Each attachment is processed as part of the generation request.

applications/Unity.GrantManager/modules/Unity.AI/docs/operations/form-mapping.md

@@ -0,0 +1,32 @@
+# Form Mapping
+
+## Goal
+Generate recommended CHEFS-to-Unity field mapping for a form version.
+
+## Inputs
+- CHEFS fields from the form version
+- Unity core intake fields
+- Worksheet-derived custom fields when available
+
+## Rule
+- Prefer existing Unity core intake fields where they already fit the source field.
+- Only suggest worksheet fields or worksheet creation when the form genuinely needs them.
+
+## Surface
+- `POST /api/app/ai/generation/form-mapping`
+- `GET /api/app/ai/generation/status`
+- `GET /api/app/application-form-version/{id}`
+
+## Contract
+- Structured mapping recommendation JSON output. Returns an immediate queued result via API app service, queue, background job, and AI runtime.
+
+## Output Shape
+- Core field matches.
+- Worksheet field matches.
+- Worksheet creation suggestions.
+- Issues or conflicts.
+- Keep the result valid JSON and compatible with the mapping page flow.
+
+## Notes
+- The AI response is expected to stay structured and JSON-shaped.
+- For new operations, follow [`implementation-playbook.md`](../implementation-playbook.md).

applications/Unity.GrantManager/modules/Unity.AI/docs/operations/form-worksheet.md

@@ -0,0 +1,29 @@
+# Form Worksheet
+
+## Goal
+Generate a recommended worksheet definition for a form version.
+
+## Inputs
+- Form version context
+- Form name
+- Existing worksheet links
+- Worksheet field context
+
+## Rule
+- Prefer existing Unity core fields when they already fit the need.
+- Only add new worksheet fields when the form genuinely needs extra Unity fields.
+
+## Surface
+- `POST /api/app/ai/generation/form-worksheet`
+- `GET /api/app/ai/generation/status`
+
+## Contract
+- Structured Flex worksheet JSON output. Returns an immediate queued result via API app service, queue, background job, and AI runtime.
+
+## Output Shape
+- Full worksheet definition JSON.
+- Include only additional worksheet fields that the form needs beyond core Unity fields.
+- Keep the result valid JSON and compatible with Flex import.
+
+## Notes
+- The AI output should stay valid JSON.

applications/Unity.GrantManager/modules/Unity.AI/docs/prompt-map.md

@@ -0,0 +1,22 @@
+# Prompt Map
+
+## Prompt families
+- `ApplicationAnalysis` - review and recommendation
+- `AttachmentSummary` - attachment summary
+- `ApplicationScoring` - question scoring
+- `FormMapping` - CHEFS to Unity mapping
+- `FormWorksheet` - worksheet generation
+
+## Versions
+- `v0`, `v1`, `v2` live under `AI/Prompts/Versions`
+- The seeder loads built-in prompt rows from those versions
+- Runtime selects by prompt family and version
+
+## Prompt rules
+- Versioned prompts are the source of truth.
+- Prompt templates define the request shape.
+- Structured outputs should stay JSON-shaped.
+- New versions should not silently change behavior.
+
+## Build Rule
+Use [`implementation-playbook.md`](./implementation-playbook.md) when adding a new prompt-backed operation.

applications/Unity.GrantManager/modules/Unity.AI/src/Unity.AI.Application.Contracts/AI/IAIService.cs

@@ -10,8 +10,9 @@ public interface IAIService
         Task<bool> IsAvailableAsync();
 
         Task<AttachmentSummaryResponse> GenerateAttachmentSummaryAsync(AttachmentSummaryRequest request, CancellationToken cancellationToken = default);
-        Task<AttachmentSummaryBatchResponse> GenerateAttachmentSummaryBatchAsync(AttachmentSummaryBatchRequest request, CancellationToken cancellationToken = default);
         Task<ApplicationAnalysisResponse> GenerateApplicationAnalysisAsync(ApplicationAnalysisRequest request, CancellationToken cancellationToken = default);
         Task<ApplicationScoringResponse> GenerateApplicationScoringAsync(ApplicationScoringRequest request, CancellationToken cancellationToken = default);
+        Task<FormMappingResponse> GenerateFormMappingAsync(FormMappingRequest request, CancellationToken cancellationToken = default);
+        Task<FormWorksheetResponse> GenerateFormWorksheetAsync(FormWorksheetRequest request, CancellationToken cancellationToken = default);
     }
 }

applications/Unity.GrantManager/modules/Unity.AI/src/Unity.AI.Application.Contracts/AI/Operations/IAIGenerationPrerequisiteValidator.cs

@@ -10,4 +10,8 @@ public interface IAIGenerationPrerequisiteValidator
     Task EnsureApplicationAnalysisAvailableAsync(Guid applicationId);
 
     Task EnsureApplicationScoringAvailableAsync(Guid applicationId);
+
+    Task EnsureFormMappingAvailableAsync(Guid applicationFormVersionId);
+
+    Task EnsureFormWorksheetAvailableAsync(Guid applicationFormVersionId);
 }