feat: DDMA claim submission with OTP, PDF, claim number extraction

- Add full DDMA claim Selenium flow (steps 1-8): search patient, open
  member page, create claim, fill form, attach files, next, submit,
  extract claim number and save confirmation PDF
- Add fee schedule price-mismatch dialog for all claim buttons (MH,
  CCA, DDMA, United, Tufts, Save) with optional price update to JSON
- Add OTP modal for DDMA claim when session expires, mirroring
  eligibility OTP flow
- Close Chrome after claim submission via quit_driver() (session
  preserved in profile)
- Move Map Price button between Direct Submission and procedure table,
  right-aligned above Billed Amount column
- Add fee-schedule update-price backend route
- Add DDMA claim processor with claimNumber/pdf_url result handling

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

apps/Backend/src/routes/feeSchedule.ts

@@ -0,0 +1,69 @@
+import { Router, Request, Response } from "express";
+import path from "path";
+import fs from "fs";
+
+const router = Router();
+
+const SCHEDULE_FILES: Record<string, string> = {
+  MH: "procedureCodesMH.json",
+  MASSHEALTH: "procedureCodesMH.json",
+  CCA: "procedureCodesCCA.json",
+  DDMA: "procedureCodesDDMA.json",
+};
+
+function getSchedulePath(siteKey: string): string | null {
+  const filename = SCHEDULE_FILES[siteKey.toUpperCase()];
+  if (!filename) return null;
+  return path.join(process.cwd(), "..", "Frontend", "src", "assets", "data", filename);
+}
+
+/**
+ * POST /api/fee-schedule/update-price
+ * Body: { siteKey, procedureCode, price }
+ * Updates the matching row's Price field in the fee schedule JSON.
+ */
+router.post("/update-price", async (req: Request, res: Response): Promise<any> => {
+  if (!req.user?.id) return res.status(401).json({ error: "Unauthorized" });
+
+  const { siteKey, procedureCode, price } = req.body;
+  if (!siteKey || !procedureCode || price == null) {
+    return res.status(400).json({ error: "siteKey, procedureCode and price are required" });
+  }
+
+  const filePath = getSchedulePath(siteKey);
+  if (!filePath) {
+    return res.status(400).json({ error: `No fee schedule for siteKey: ${siteKey}` });
+  }
+
+  try {
+    const raw = fs.readFileSync(filePath, "utf-8");
+    const rows: any[] = JSON.parse(raw);
+    const normalizedCode = String(procedureCode).trim().toUpperCase();
+    let updated = false;
+
+    for (const row of rows) {
+      const rowCode = String(row["Procedure Code"] || "").trim().toUpperCase();
+      if (rowCode === normalizedCode) {
+        // Update whichever price field(s) exist in this row
+        if ("Price" in row) row["Price"] = price;
+        if ("PriceLTEQ21" in row) row["PriceLTEQ21"] = price;
+        if ("PriceGT21" in row) row["PriceGT21"] = price;
+        updated = true;
+        break;
+      }
+    }
+
+    if (!updated) {
+      return res.status(404).json({ error: `Procedure code ${procedureCode} not found in ${siteKey} schedule` });
+    }
+
+    fs.writeFileSync(filePath, JSON.stringify(rows, null, 2), "utf-8");
+    console.log(`[feeSchedule] Updated ${siteKey} ${procedureCode} → ${price}`);
+    return res.json({ success: true });
+  } catch (err: any) {
+    console.error("[feeSchedule] Error:", err);
+    return res.status(500).json({ error: err.message });
+  }
+});
+
+export default router;

apps/Backend/src/routes/index.ts

@@ -17,6 +17,8 @@ import insuranceStatusUnitedSCORoutes from "./insuranceStatusUnitedSCO";
 import insuranceStatusTuftsSCORoutes from "./insuranceStatusTuftsSCO";
 import insuranceStatusCCARoutes from "./insuranceStatusCCA";
 import insuranceStatusCCAClaimRoutes from "./insuranceStatusCCAClaim";
+import insuranceStatusCCAPreAuthRoutes from "./insuranceStatusCCAPreAuth";
+import insuranceStatusDDMAClaimRoutes from "./insuranceStatusDDMAClaim";
 import paymentsRoutes from "./payments";
 import databaseManagementRoutes from "./database-management";
 import notificationsRoutes from "./notifications";
@@ -34,6 +36,7 @@ import procedureTimeslotRoutes from "./procedure-timeslot";
 import insuranceContactsRoutes from "./insurance-contacts";
 import commissionsRoutes from "./commissions";
 import shoppingVendorsRoutes from "./shopping-vendors";
+import feeScheduleRoutes from "./feeSchedule";
 
 const router = Router();
 
@@ -55,6 +58,8 @@ router.use("/insurance-status-unitedsco", insuranceStatusUnitedSCORoutes);
 router.use("/insurance-status-tuftssco", insuranceStatusTuftsSCORoutes);
 router.use("/insurance-status-cca", insuranceStatusCCARoutes);
 router.use("/claims", insuranceStatusCCAClaimRoutes);
+router.use("/claims", insuranceStatusCCAPreAuthRoutes);
+router.use("/claims", insuranceStatusDDMAClaimRoutes);
 router.use("/payments", paymentsRoutes);
 router.use("/database-management", databaseManagementRoutes);
 router.use("/notifications", notificationsRoutes);
@@ -72,5 +77,6 @@ router.use("/procedure-timeslot", procedureTimeslotRoutes);
 router.use("/insurance-contacts", insuranceContactsRoutes);
 router.use("/commissions", commissionsRoutes);
 router.use("/shopping-vendors", shoppingVendorsRoutes);
+router.use("/fee-schedule", feeScheduleRoutes);
 
 export default router;

apps/Backend/src/routes/insuranceStatusDDMAClaim.ts

@@ -0,0 +1,94 @@
+import { Router, Request, Response } from "express";
+import { storage } from "../storage";
+import { enqueueSeleniumJob } from "../queue/jobRunner";
+import { forwardOtpToSeleniumDDMAClaimAgent } from "../services/seleniumDDMAClaimClient";
+import { io } from "../socket";
+
+const router = Router();
+
+/**
+ * POST /ddma-claim
+ *
+ * Enqueues a Delta Dental MA claim submission job.
+ *
+ * Body fields (JSON):
+ *   data     — claim payload (memberId, dateOfBirth, serviceDate, serviceLines, patientName, etc.)
+ *   socketId — socket.io client id
+ *   claimId  — existing claim DB id (optional)
+ *
+ * Response: { status: "queued", jobId: "…" }
+ */
+router.post("/ddma-claim", async (req: Request, res: Response): Promise<any> => {
+  if (!req.user?.id) {
+    return res.status(401).json({ error: "Unauthorized: user info missing" });
+  }
+
+  try {
+    const claimData =
+      typeof req.body.data === "string"
+        ? JSON.parse(req.body.data)
+        : req.body.data ?? req.body ?? {};
+
+    // Fetch DDMA credentials
+    const credentials = await storage.getInsuranceCredentialByUserAndSiteKey(
+      req.user.id,
+      "DDMA"
+    );
+    if (!credentials) {
+      return res.status(404).json({
+        error: "No Delta Dental MA credentials found. Please add them on the Settings page.",
+      });
+    }
+
+    const enrichedPayload = {
+      claim: {
+        ...claimData,
+        massddmaUsername: credentials.username,
+        massddmaPassword: credentials.password,
+      },
+    };
+
+    const socketId: string | undefined = req.body.socketId;
+    const claimId: number | undefined = claimData.claimId
+      ? Number(claimData.claimId)
+      : undefined;
+
+    const jobId = enqueueSeleniumJob({
+      jobType: "ddma-claim-submit",
+      userId: req.user.id,
+      socketId,
+      enrichedPayload,
+      claimId,
+    });
+
+    return res.json({ status: "queued", jobId });
+  } catch (err: any) {
+    console.error("[ddma-claim route] error:", err);
+    return res.status(500).json({
+      error: err.message || "Failed to enqueue DDMA claim job",
+    });
+  }
+});
+
+/**
+ * POST /claims/ddma-claim/selenium/submit-otp
+ * Body: { session_id, otp, socketId? }
+ */
+router.post("/ddma-claim/selenium/submit-otp", async (req: Request, res: Response): Promise<any> => {
+  const { session_id: sessionId, otp, socketId } = req.body;
+  if (!sessionId || !otp) {
+    return res.status(400).json({ error: "session_id and otp are required" });
+  }
+  try {
+    const r = await forwardOtpToSeleniumDDMAClaimAgent(sessionId, otp);
+    if (socketId && io) {
+      io.to(socketId).emit("selenium:otp_submitted", { session_id: sessionId });
+    }
+    return res.json(r);
+  } catch (err: any) {
+    console.error("[ddma-claim] submit-otp failed:", err?.message);
+    return res.status(500).json({ error: err?.message || "Failed to forward OTP" });
+  }
+});
+
+export default router;