Skip to content

LG-13289: Document parameters for verify proofing results event#10849

Merged
matthinz merged 8 commits intomainfrom
matthinz/13289-verify-proofing-results-docs
Jun 24, 2024
Merged

LG-13289: Document parameters for verify proofing results event#10849
matthinz merged 8 commits intomainfrom
matthinz/13289-verify-proofing-results-docs

Conversation

@matthinz
Copy link
Copy Markdown
Contributor

🎫 Ticket

Link to the relevant ticket:
LG-13289

🛠 Summary of changes

This PR documents parameters for IdV: doc auth verify proofing results, Team Ada's "workhorse" analytics event. The structure logged here is deep, with the most important stuff being in proofing_results.context.stages.*.

@matthinz matthinz marked this pull request as draft June 20, 2024 23:47
@matthinz matthinz force-pushed the matthinz/13289-verify-proofing-results-docs branch from e91ea68 to 6bf5a4d Compare June 21, 2024 15:59
@matthinz matthinz force-pushed the matthinz/13289-verify-proofing-results-docs branch from a70d0cc to 018a219 Compare June 21, 2024 23:14
@matthinz matthinz marked this pull request as ready for review June 21, 2024 23:15
@matthinz matthinz requested a review from a team June 21, 2024 23:15
# @option proofing_results [Hash] context.stages.threatmetrix.response_body JSON body of the response returned from the vendor. PII has been redacted.
# @option proofing_results [String] context.stages.threatmetrix.response_body.account_lex_id LexID associated with the response.
# @option proofing_results [String] context.stages.threatmetrix.response_body.session_id Session ID associated with the response.
# @option proofing_results [String] context.stages.threatmetrix.review_status One of "pass", "review", "reject".
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

WDYT of trying to update https://github.com/18F/identity-idp/blob/main/spec/support/fake_analytics.rb#L73 to work with nested hashes/analytics like this?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think I understand that code enough to do it in this PR. Honestly, it starts to feel to me like we need a typechecker. I kind of wonder if it would be preferable to log flat, un-nested structures?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

At that point we should switch to Crystal!

@matthinz matthinz merged commit 0e52c46 into main Jun 24, 2024
@matthinz matthinz deleted the matthinz/13289-verify-proofing-results-docs branch June 24, 2024 21:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants