Code Documentation Regulators Trust.

// Saves trade to database
function executeTradeOrder(
  clientId, ticker,
  quantity, price
) {
  const total = quantity * price;
  const record = {
    clientId, ticker,
    quantity, price, total,
    timestamp: new Date()
  };
  db.insert('trades', record);
  return record;
}

/**
 * @function executeTradeOrder
 * @description Executes and persists an institutional
 *   trade order to the immutable trade ledger.
 *
 * @compliance FINRA-3110 Supervisory Control —
 *   Subject to supervisory review per Rule 3110.
 *
 * @compliance SEC-17a-4 Records Retention —
 *   Written to immutable store; retained 6 years.
 *
 * @compliance SOX-302 Executive Certification —
 *   Affects financial reporting. Requires sign-off.
 *
 * @data-classification Financial / PII
 * @risk-level          Critical
 * @audit-trail         ✓ Logged via tradeAuditLog
 * @param {string} clientId  - Client identifier (PII)
 * @param {string} ticker    - Exchange ticker symbol
 * @param {number} quantity  - Number of shares
 * @param {number} price     - Execution price per share
 * @returns {TradeRecord} Persisted record with audit ID
 * @throws {ComplianceError} If supervisory hold active
 */
function executeTradeOrder(
  clientId, ticker,
  quantity, price
) {
  checkSupervisoryHold(clientId);
  const total = quantity * price;
  const record = {
    clientId, ticker,
    quantity, price, total,
    timestamp: new Date(),
    immutable: true,
    retentionYears: 6
  };
  tradeAuditLog.write(record);
  return db.insert('trades', record);
}