git clone https://github.com/MaximumTrainer/Waymark
cd Waymark

docker compose up -d

ConnectionStrings__OnboardingDb="Host=localhost;Port=5432;Database=onboarding;Username=postgres;Password=postgres" \
  dotnet run --project src/backend/OpenOnboarding.Api

cd src/frontend
cp .env.example .env.local
# Set VITE_API_BASE_URL=http://localhost:5072
# Set VITE_API_KEY=dev-api-key-change-in-production
npm install
npm run dev

POST /api/flows
Content-Type: application/json
X-Api-Key: dev-api-key-change-in-production

{
  "name": "My First Journey",
  "nodes": [
    {
      "id": "11111111-1111-1111-1111-111111111111",
      "key": "welcome",
      "type": "Information",
      "title": "Welcome! This is step one.",
      "isStartNode": true
    }
  ],
  "connections": []
}

{
  "name": "Journey name",
  "description": "Optional description",
  "nodes": [],
  "connections": []
}

{
  "fields": [
    { "name": "CompanyName", "type": "text",   "required": true },
    { "name": "Country",     "type": "select", "required": true, "options": ["USA", "GBR", "DEU"] },
    { "name": "Revenue",     "type": "number", "required": false }
  ]
}

{
  "acceptedFileTypes": ["application/pdf", "image/jpeg", "image/png"],
  "maxFiles": 3
}

{
  "url": "https://kyc-provider.example.com/verify?session={{sessionId}}&customer={{externalCustomerId}}"
}

{
  "action": "SetProfileField",
  "field": "kyc_status",
  "value": "pending",
  "failOnError": true
}

{
  "requiredFields": ["FieldA", "FieldB"],
  "rules": [
    { "field": "CompanyName", "minLength": 2, "maxLength": 100, "pattern": "^[A-Za-z0-9 ]+$" },
    { "field": "Revenue",     "minimum": 0,   "maximum": 999999999 },
    { "field": "RiskTier",    "allowedValues": ["Low", "Medium", "High"] }
  ],
  "crossFieldRules": [
    { "field1": "EndDate", "operator": "GreaterThan", "field2": "StartDate" }
  ]
}

GET /api/workflow/sessions/{sessionId}

PUT /api/customers/{customerId}

GET /api/workflow/sessions/{sessionId}/next

import { useState } from 'react'

const API = import.meta.env.VITE_API_BASE_URL
const KEY = import.meta.env.VITE_API_KEY

export function useWaymark(flowId: string) {
  const [sessionId, setSessionId] = useState<string | null>(null)
  const [currentNode, setCurrentNode] = useState<NodeDto | null>(null)
  const [status, setStatus] = useState<'idle' | 'active' | 'completed'>('idle')

  async function start() {
    const res = await fetch(`${API}/api/workflow/sessions/start`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json', 'X-Api-Key': KEY },
      body: JSON.stringify({ flowId }),
    })
    const data = await res.json()
    setSessionId(data.sessionId)
    setCurrentNode(data.currentNode)
    setStatus('active')
  }

  async function submit(nodeId: string, payload: Record<string, unknown>) {
    const res = await fetch(
      `${API}/api/workflow/sessions/${sessionId}/steps/${nodeId}/submit`,
      {
        method: 'POST',
        headers: { 'Content-Type': 'application/json', 'X-Api-Key': KEY },
        body: JSON.stringify({ payload }),
      }
    )
    const data = await res.json()
    if (data.nextNode) {
      setCurrentNode(data.nextNode)
    } else {
      setStatus('completed')
    }
  }

  return { start, submit, currentNode, status }
}

import { useEffect } from 'react'

function NodeRenderer({ node, onSubmit }) {
  const content = node.jsonContent ? JSON.parse(node.jsonContent) : {}

  useEffect(() => {
    if (node.type === 'Redirect' && content.url) {
      window.location.assign(content.url)
    }
  }, [node.type, content.url])

  switch (node.type) {
    case 'Form':
      return <DynamicForm fields={content.fields} onSubmit={onSubmit} />
    case 'DocumentUpload':
      return <FileUpload accept={content.acceptedFileTypes} onSubmit={onSubmit} />
    case 'Redirect':
      return null
    case 'Information':
      return <p>{node.title}</p>
    default:
      return null
  }
}

// composables/useWaymark.ts
import { ref } from 'vue'

export function useWaymark(flowId: string) {
  const sessionId  = ref<string | null>(null)
  const currentNode = ref<any | null>(null)
  const isComplete = ref(false)

  const API = import.meta.env.VITE_API_BASE_URL
  const KEY = import.meta.env.VITE_API_KEY

  async function start() {
    const response = await fetch(`${API}/api/workflow/sessions/start`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json', 'X-Api-Key': KEY },
      body: JSON.stringify({ flowId }),
    })
    const data = await response.json()
    sessionId.value   = data.sessionId
    currentNode.value = data.currentNode
  }

  async function submit(nodeId: string, payload: Record<string, unknown>) {
    const response = await fetch(
      `${API}/api/workflow/sessions/${sessionId.value}/steps/${nodeId}/submit`,
      {
        method: 'POST',
        headers: { 'Content-Type': 'application/json', 'X-Api-Key': KEY },
        body: JSON.stringify({ payload }),
      }
    )
    const data = await response.json()
    currentNode.value = data.nextNode ?? null
    if (!data.nextNode) isComplete.value = true
  }

  return { start, submit, currentNode, isComplete }
}

const BASE = process.env.WAYMARK_API_URL
const KEY  = process.env.WAYMARK_API_KEY

async function startSession(flowId) {
  const res  = await fetch(`${BASE}/api/workflow/sessions/start`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'X-Api-Key': KEY },
    body: JSON.stringify({ flowId }),
  })
  return res.json() // { sessionId, currentNode }
}

async function submitStep(sessionId, nodeId, payload) {
  const res = await fetch(
    `${BASE}/api/workflow/sessions/${sessionId}/steps/${nodeId}/submit`,
    {
      method: 'POST',
      headers: { 'Content-Type': 'application/json', 'X-Api-Key': KEY },
      body: JSON.stringify({ payload }),
    }
  )
  return res.json() // { nextNode } or null when complete
}

// Usage
const { sessionId, currentNode } = await startSession('my-flow-id')
const result = await submitStep(sessionId, currentNode.id, { Country: 'USA' })

{
  "name": "Contact Form",
  "nodes": [
    {
      "id": "11111111-1111-1111-1111-111111111111", "key": "personal-info", "type": "Form",
      "title": "Your details", "isStartNode": true,
      "jsonContent": "{\"fields\":[{\"name\":\"Name\",\"type\":\"text\",\"required\":true},{\"name\":\"Email\",\"type\":\"email\",\"required\":true}]}",
      "complianceRuleJson": "{\"requiredFields\":[\"Name\",\"Email\"],\"rules\":[{\"field\":\"Email\",\"pattern\":\"^[^@]+@[^@]+\\\\.[^@]+$\"}]}"
    },
    {
      "id": "22222222-2222-2222-2222-222222222222", "key": "message", "type": "Form", "title": "Your message",
      "jsonContent": "{\"fields\":[{\"name\":\"Subject\",\"type\":\"text\",\"required\":true},{\"name\":\"Body\",\"type\":\"textarea\",\"required\":true}]}"
    },
    {
      "id": "33333333-3333-3333-3333-333333333333", "key": "confirmation", "type": "Information",
      "title": "Thank you! We'll be in touch within 24 hours."
    }
  ],
  "connections": [
    { "sourceNodeId": "11111111-1111-1111-1111-111111111111", "targetNodeId": "22222222-2222-2222-2222-222222222222" },
    { "sourceNodeId": "22222222-2222-2222-2222-222222222222", "targetNodeId": "33333333-3333-3333-3333-333333333333" }
  ]
}

{
  "name": "Conditional Payment",
  "nodes": [
    {
      "id": "11111111-1111-1111-1111-111111111111", "key": "select-method", "type": "Form",
      "title": "How would you like to pay?", "isStartNode": true,
      "jsonContent": "{\"fields\":[{\"name\":\"Method\",\"type\":\"select\",\"options\":[\"CreditCard\",\"PayPal\"],\"required\":true}]}"
    },
    {
      "id": "22222222-2222-2222-2222-222222222222", "key": "card-details", "type": "Form",
      "title": "Enter card details",
      "jsonContent": "{\"fields\":[{\"name\":\"CardNumber\",\"type\":\"text\",\"required\":true},{\"name\":\"CVV\",\"type\":\"text\",\"required\":true},{\"name\":\"Expiry\",\"type\":\"text\",\"required\":true}]}",
      "complianceRuleJson": "{\"requiredFields\":[\"CardNumber\",\"CVV\"],\"rules\":[{\"field\":\"CardNumber\",\"pattern\":\"^[0-9]{16}$\"},{\"field\":\"CVV\",\"pattern\":\"^[0-9]{3,4}$\"}]}"
    },
    {
      "id": "33333333-3333-3333-3333-333333333333", "key": "paypal", "type": "Redirect",
      "title": "Redirecting to PayPal…",
      "jsonContent": "{\"url\":\"https://paypal.com/checkout?session={{sessionId}}\"}"
    },
    { "id": "44444444-4444-4444-4444-444444444444", "key": "success", "type": "Information", "title": "Payment accepted!" }
  ],
  "connections": [
    { "sourceNodeId": "11111111-1111-1111-1111-111111111111", "targetNodeId": "22222222-2222-2222-2222-222222222222", "conditionField": "Method", "conditionOperator": "Equals", "conditionValue": "CreditCard", "priority": 0 },
    { "sourceNodeId": "11111111-1111-1111-1111-111111111111", "targetNodeId": "33333333-3333-3333-3333-333333333333", "priority": 1 },
    { "sourceNodeId": "22222222-2222-2222-2222-222222222222", "targetNodeId": "44444444-4444-4444-4444-444444444444" },
    { "sourceNodeId": "33333333-3333-3333-3333-333333333333", "targetNodeId": "44444444-4444-4444-4444-444444444444" }
  ]
}

{
  "name": "Enterprise Onboarding",
  "nodes": [
    {
      "id": "11111111-1111-1111-1111-111111111111", "key": "user-type", "type": "Form",
      "title": "Tell us about yourself", "isStartNode": true,
      "jsonContent": "{\"fields\":[{\"name\":\"Role\",\"type\":\"select\",\"options\":[\"Admin\",\"Guest\"],\"required\":true},{\"name\":\"Company\",\"type\":\"text\",\"required\":true}]}"
    },
    {
      "id": "22222222-2222-2222-2222-222222222222", "key": "admin-kyc", "type": "Form", "title": "Identity verification",
      "jsonContent": "{\"fields\":[{\"name\":\"TaxId\",\"type\":\"text\",\"required\":true},{\"name\":\"Jurisdiction\",\"type\":\"select\",\"options\":[\"USA\",\"GBR\",\"DEU\"],\"required\":true}]}",
      "complianceRuleJson": "{\"requiredFields\":[\"TaxId\",\"Jurisdiction\"]}"
    },
    {
      "id": "33333333-3333-3333-3333-333333333333", "key": "admin-docs", "type": "DocumentUpload",
      "title": "Upload your company registration document",
      "jsonContent": "{\"acceptedFileTypes\":[\"application/pdf\"],\"maxFiles\":1}"
    },
    {
      "id": "44444444-4444-4444-4444-444444444444", "key": "flag-for-review", "type": "Logic",
      "jsonContent": "{\"action\":\"SetProfileField\",\"field\":\"kyc_status\",\"value\":\"pending_review\",\"failOnError\":false}"
    },
    { "id": "55555555-5555-5555-5555-555555555555", "key": "guest-welcome", "type": "Information", "title": "Welcome! Your account has been created." },
    { "id": "66666666-6666-6666-6666-666666666666", "key": "admin-complete", "type": "Information", "title": "KYC submitted — we'll review and notify you within 2 business days." }
  ],
  "connections": [
    { "sourceNodeId": "11111111-1111-1111-1111-111111111111", "targetNodeId": "22222222-2222-2222-2222-222222222222", "conditionField": "Role", "conditionOperator": "Equals", "conditionValue": "Admin", "priority": 0 },
    { "sourceNodeId": "11111111-1111-1111-1111-111111111111", "targetNodeId": "55555555-5555-5555-5555-555555555555", "priority": 1 },
    { "sourceNodeId": "22222222-2222-2222-2222-222222222222", "targetNodeId": "33333333-3333-3333-3333-333333333333" },
    { "sourceNodeId": "33333333-3333-3333-3333-333333333333", "targetNodeId": "44444444-4444-4444-4444-444444444444" },
    { "sourceNodeId": "44444444-4444-4444-4444-444444444444", "targetNodeId": "66666666-6666-6666-6666-666666666666" }
  ]
}