AppStd/EnvelopeGenerator
8
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Migrate WebUI to EnvelopeGenerator.Server

Browse Source 
Updated documentation to reflect the migration from WebUI to EnvelopeGenerator.Server, including a new "Documentation Catalog" in `AGENTS.md`. Adjusted route mappings, render modes, and directory structure for Blazor components.

Revised coordinate system documentation and CSS for status colors to align with the new architecture. Updated YARP proxy and PDF.js configuration paths.

Migrated `MIGRATION_PLAN.md` to modernize `EnvelopeGenerator.Service` with C# Worker Service equivalents. Updated `FORM_APPLICATION_CONTEXT.md` and `RECEIVER_PDF_VIEWER_CONTEXT.md` to reflect the new architecture and planned viewer integration.

Fixed German translation issues in `fix-report-label-read-and-confirmed.md`. Standardized formatting and terminology across all files.
This commit is contained in:
tekh
2026-09-22 16:17:09 +02:00
parent 80733ab1f7
commit eb219291de
5 changed files with 182 additions and 81 deletions
Download Patch File Download Diff File Expand all files Collapse all files

40
FORM_APPLICATION_CONTEXT.md
View File

@@ -1,7 +1,7 @@
# EnvelopeGenerator.Form – VB.NET Desktop Application Context
# EnvelopeGenerator.Form — VB.NET Desktop Application Context
## Purpose
**Legacy Windows Forms application** for envelope creation, management, and signature field placement. Built with **DevExpress components** and **GdPicture14** for PDF manipulation. This application is being **migrated to ReceiverUI + API** architecture.
**Legacy Windows Forms application** for envelope creation, management, and signature field placement. Built with **DevExpress components** and **GdPicture14** for PDF manipulation. This application is being **migrated to EnvelopeGenerator.Server + API** architecture.
**Primary Libraries:** DevExpress XtraGrid/XtraEditors, GdPicture14, VB.NET (.NET Framework 4.6.2)
@@ -141,7 +141,7 @@
---
#### 3. **frmEnvelopeMainData.vb** - Envelope Settings Popup
**Route Equivalent:** Part of `/sender/envelope/{id}` (inline in ReceiverUI)
**Route Equivalent:** Part of `/sender/envelope/{id}` (inline in EnvelopeGenerator.Server)
**Purpose:** Configure envelope metadata and behavior. **Shown as modal popup** before main editor.
@@ -196,7 +196,7 @@
| **Save** | Saves signature fields to database |
**Signature Field Details:**
- **Size:** 1.77" × 1.96" (4.5cm × 5cm) - **FIXED SIZE**
- **Size:** 1.77" × 1.96" (4.5cm × 5cm) - **FIXED SIZE**
- **Color:** Matches receiver color (from grid assignment)
- **Label:** "SIGNATUR" (or localized "Signature")
- **Position:** Draggable on PDF canvas
@@ -226,7 +226,7 @@ End Sub
- **Save:** Saves current receiver's fields, switches receiver, reloads all annotations
**Annotation Behavior:**
- **New annotation:** User clicks "Add Signature" ? draws interactive annotation ? auto-sized to 1.77×1.96
- **New annotation:** User clicks "Add Signature" ? draws interactive annotation ? auto-sized to 1.77×1.96
- **Existing annotation:** Loaded from database, locked size (can move but not resize)
- **Styling:** Filled rectangle with centered text "SIGNATUR"
- **Validation:** No resize, no text edit, no rotation
@@ -240,7 +240,7 @@ End Sub
---
#### 5. **frmRueckruf.vb** - Delete Reason Dialog
**Route Equivalent:** Inline confirmation in ReceiverUI
**Route Equivalent:** Inline confirmation in EnvelopeGenerator.Server
**Purpose:** Capture reason for envelope deletion/withdrawal.
@@ -278,7 +278,7 @@ Public Shared Reject_reason As String = ""
---
#### 7. **frmOrderFiles.vb** - PDF Merge Tool
**Route Equivalent:** Inline in ReceiverUI (future)
**Route Equivalent:** Inline in EnvelopeGenerator.Server (future)
**Purpose:** Select multiple PDFs and merge them into a single document.
@@ -368,11 +368,11 @@ End Sub
---
## Migration to ReceiverUI + API
## Migration to EnvelopeGenerator.Server + API
### Mapping Table
| Form Feature | ReceiverUI Equivalent | Status |
| Form Feature | EnvelopeGenerator.Server Equivalent | Status |
|---|---|---|
| **frmMain** (Envelope list) | `/sender` (EnvelopeSenderPage.razor) | ? Exists |
| Tab 0: Active Envelopes | `/sender` default view | ? Grid with filters |
@@ -409,7 +409,7 @@ End Sub
### 1. **Coordinate System Consistency**
**Database (Form App):** INCHES (GdPicture native)
**ReceiverUI (PDF.js):** Pixels on canvas
**EnvelopeGenerator.Server (PDF.js):** Pixels on canvas
**Conversion Required:**
```csharp
// Sender side (placing fields):
@@ -428,7 +428,7 @@ float canvasY = (yInches / pageHeightInches) * canvasHeight;
---
### 2. **Status Color System**
Form app uses **DevExpress CustomDrawCell** event for row coloring. ReceiverUI should use:
Form app uses **DevExpress CustomDrawCell** event for row coloring. EnvelopeGenerator.Server should use:
```css
/* Envelope status colors */
@@ -447,7 +447,7 @@ Form app uses **DevExpress CustomDrawCell** event for row coloring. ReceiverUI s
---
### 3. **Master-Detail Grid Pattern**
Form app uses **nested GridViews** (ViewReceivers, ViewHistory). ReceiverUI options:
Form app uses **nested GridViews** (ViewReceivers, ViewHistory). EnvelopeGenerator.Server options:
**Option A:** DevExpress Blazor Grid with master-detail template
```razor
@@ -481,11 +481,11 @@ Form app uses **nested GridViews** (ViewReceivers, ViewHistory). ReceiverUI opti
**Form App:**
- GdPicture14 native annotations
- Fixed size (1.77×1.96 inches)
- Fixed size (1.77×1.96 inches)
- Color-coded per receiver
- Draggable, non-resizable
**ReceiverUI Equivalent:**
**EnvelopeGenerator.Server Equivalent:**
- PDF.js canvas + HTML overlay (like receiver signature buttons)
- `<div class="signature-field-placeholder">` positioned absolutely
- Drag & drop with JS (`onmousedown`, `onmousemove`, `onmouseup`)
@@ -526,7 +526,7 @@ function makeSignatureFieldDraggable(element) {
---
### 5. **Auto-Complete Receiver Email**
Form app uses **DevExpress ComboBox** with `AllReceiverEmails` list. ReceiverUI options:
Form app uses **DevExpress ComboBox** with `AllReceiverEmails` list. EnvelopeGenerator.Server options:
**Option A:** DevExpress Blazor TagBox with remote data
```razor
@@ -550,7 +550,7 @@ Form app uses **DevExpress ComboBox** with `AllReceiverEmails` list. ReceiverUI
---
### 6. **Drag & Drop File Upload**
Form app uses **WinForms DragDrop** events. ReceiverUI equivalent:
Form app uses **WinForms DragDrop** events. EnvelopeGenerator.Server equivalent:
```razor
<div class="file-drop-zone"
@@ -577,7 +577,7 @@ Form app uses **WinForms DragDrop** events. ReceiverUI equivalent:
---
### 7. **PDF Merge (frmOrderFiles)**
Form app uses **GdPicture14 MergeDocuments**. ReceiverUI options:
Form app uses **GdPicture14 MergeDocuments**. EnvelopeGenerator.Server options:
**Option A:** Server-side merge (iText7 or PDFSharp)
```csharp
@@ -634,7 +634,7 @@ async function mergePDFs(fileDataUrls) {
4. frmFieldEditor opens
- Select receiver from dropdown (colored circles)
- Click "Add Signature" ? draw box on PDF
- Drag to position (1.77×1.96 inches, fixed size)
- Drag to position (1.77×1.96 inches, fixed size)
- Repeat for each receiver
- Click "Save"
?
@@ -680,7 +680,7 @@ async function mergePDFs(fileDataUrls) {
---
## Missing Features in ReceiverUI (To Implement)
## Missing Features in EnvelopeGenerator.Server (To Implement)
### High Priority
1. ? **Envelope list grid** (`/sender`) with status colors
@@ -735,7 +735,7 @@ async function mergePDFs(fileDataUrls) {
????????????????????????
? frmFieldEditor ? ? GdPicture PDF viewer
? (Signature Placer) ? ? Receiver selector (colored circles)
???????????????????????? ? Draggable signature boxes (1.77×1.96")
???????????????????????? ? Draggable signature boxes (1.77×1.96")
? Click "Save"
?
????????????????????????