Rename "Request an order" to "Start an order" throughout, move the
CTA section to the top of the home page, add the customer's email to
the order-details notification, and keep the submission confirmation
message on screen for 30 seconds before redirecting.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
SendOrderDetailsEmail now CCs natascham, erickaw, danielc, and
katelyne @kentcommunications.com on the 'order received' email sent
to the customer after they submit their order details.
Root cause: OrderController.Continue (GET /order/continue) was calling
MarkTokenUsed the moment the link loaded, not when the customer
actually submitted the order. This burns a one-time link before the
customer opens it whenever anything else issues a GET first - most
likely mail security link-scanners (e.g. Outlook Safe Links) that
pre-fetch URLs found in email bodies, which matches the admin site's
mailto-link workflow.
- OrderController.Continue: only checks TokenUsedAt/TokenExpiresAt for
validity now, no longer marks the token used
- OrderApiController.SubmitOrderDetails: rejects an already-used token
(410), and marks the token used only after the order details are
successfully saved
- New AdminOrdersController + view: table of Orders with search by
email/jurisdiction #, pagination (20/page), and per-row mailto link
to resend the order-continue URL
- OrdersRepository: add GetAll() and SearchPaged() (LIKE search,
PagedQuery-based pagination)
- MailtoEncode helper added to core/helpers.asp (mailto-safe URL
encoding: %20 not +)
- Controller registered in autoload + ControllerRegistry
- public-admin/ folder: dedicated Default.asp routes, web.config with
192.168.1.0/24 ipSecurity, production template with same restriction
- applicationhost.config: second IIS Express site (Admin Web Site,
port 8081)
- run_site.cmd: launches both sites (public in separate window,
admin in foreground)
- build-release.ps1: public-admin in allow-list, swaps its
web.config from production template
- deploy-iis-remote-apply.ps1: optional admin site/app-pool config
+ restart
- deploy-iis.ps1: -AdminSiteName/-AdminAppPool/-AdminBaseUrl params,
admin smoke test
KCI wants to know if a jurisdiction needs extra office copies when ordering
blue AV envelopes, and the old flash-message confirmation after submitting a
jurisdiction number was easy to miss (auto-dismissed in a few seconds).
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Purple and blue envelope details were getting mixed up on both the
order form and the confirmation email. The purple screen no longer
asks about blue envelopes at all; the blue screen now owns the
provider question and always shows its permit questions (not just
when buying from KCI), and the order-confirmation email keeps purple
and blue answers in separate sections.
Also drop the blue page's visibleIf tied to the purple envelope
stock choice - it was hiding all blue questions for anyone using
their own purple stock, which is unrelated to blue envelope needs.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Page 3 (Blue AV Envelope Order Form) now shows only when the purple
envelope stock question is answered "KCI's stock" - choosing "My own
stock" skips it, since KCI wouldn't be sourcing envelopes either way.
Falls back to visible if that question was never reached.
Also sets clearInvisibleValues: "onHidden" on the survey so answers to
a question don't linger after the question that revealed it gets
changed back (e.g. flipping "purchase blue AV envelopes?" from Yes to
No no longer leaves the permit/nonprofit-status answers underneath it
in place) - applies to every conditional branch on the form, not just
this one.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Blue AV Envelope (Q3) no longer asks for a nonprofit authorization code
after confirming nonprofit status - it wasn't needed there. Ballot
Mailing Service (Q4) gains the same follow-up instead, with an "I don't
know my authorization code" checkbox that lets the applicant skip it.
Adds MailingNonprofitAuthCode and MailingNonprofitAuthCodeUnknown
columns to OrderDetails via migration, wired through the model,
repository, answers mapper, and confirmation email by hand rather than
via GenerateRepo.vbs, since regenerating would have dropped existing
fixups (leading-zero-preserving text fields, nullable boolean/date
guards) already baked into those files.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
- Implement Election Materials order-form revisions (docs/lucid *(2).pdf):
new "permanent ballot list" question, and a Yes/No/Unsure nonprofit-status
question now asked on both blue-envelope permit-ownership branches, with
a matching migration, model/repository regen, and validation updates.
- Box the /request-order form and heading in the site's form-panel style.
- Shrink the site footer.
- After request-order and order submission, redirect to / with a flash
message instead of re-rendering the form page inline.
- Skin the continuation and order-confirmation emails to match the site's
branding (logo, navy header/footer, purple accents) instead of plain
unstyled HTML.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Extract email sending into OrderMailer, answer-to-model mapping into
OrderDetailsAnswersMapper, label mapping into OrderDetailsLabels, and
generic dictionary-based field validation into core/lib.Validations.asp
(alongside a small lib.JsonResponse helper), replacing the private
helpers previously duplicated inline in OrderApiController and
RequestOrderController.
Extends the jurisdiction API cache to store JCode/Name pairs (not just
codes) and looks up the matching Name for an order's already-validated
JurisdictionNumber when rendering /order/continue. When a match is
found, the Municipality field is pre-filled and locked read-only;
otherwise it falls back to an empty, editable field so the user can
enter it manually.
- Blue AV Envelope: City of permit holder and Permit Number are now always
collected for an own-organization permit, regardless of nonprofit status -
a permit lookup using only the nonprofit authorization code doesn't work,
so the code is now additional info when nonprofit status is Yes, not a
replacement for city/permit number.
- Order confirmation email header simplified to "KCI Purple Envelope Order
Confirmation" text, dropping the site's PE logo mark and tagline.
- Replaced the IsValidJurisdictionNumber stub (previously always returned
true) with real validation against JurisdictionApiUrl, cached in
Application scope (JurisdictionCacheMinutes, default 60) since the
jurisdiction list is essentially static reference data. Falls back to
stale cached data on a refresh failure rather than blocking order
requests; fails open only when there's no cache at all.
Hit two Classic ASP gotchas along the way: Scripting.Dictionary can't be
stored in Application scope (ASP 0197, apartment-threaded COM object) -
cached a delimited string instead - and the codebase's generic aspJSON
parser took 43s to parse the ~1500-record API response, so switched to a
targeted regex extraction of just the JCode field (~1s).
Order form revision (docs/lucid "(1)" PDFs):
- Purple Envelope: reordered stock/permit questions, renamed postage-only to
state-permit-only, added colors question and blue-envelope-provider
cross-sell
- Blue Envelope: reworked permit flow with KCI-vs-own-organization
ownership and nonprofit-status branching
- Mailing Service: real per-piece pricing, new Presort Standard tier,
estimated-quantity question, fixed pickup-date list, removed the
ballot-sorting question
- Additional Items: added a special-requests field
- Added db/migrations/20260804153857_revise_order_details_columns.asp
(additive only - columns retired by the revision are left in place,
not dropped, since the table has real test data)
Tester feedback:
- Fixed "Spectrom" typo to "Spectrum" (value code + label + validation)
- Corrected First Class postage rate to $0.721/pc.
- Marked nearly every survey question required so SurveyJS blocks
page navigation on missing answers
Color picker for envelope colors:
- Replaced free-text color entry with a modal image picker sourced from
public/images/Purple_ballot_envelopes colors/*.bmp, converted to PNG
in public/images/purple-envelope-colors/ (23MB -> 245KB)
Cleanup pass:
- Removed the redundant "KCI's blue envelopes or another provider's"
question (redundant with the preceding yes/no)
- Removed the purple-envelope delivery-date picker in favor of a static
lead-time note
- Trimmed the Mailing Service page title
- Fixed the post-submission message to stop showing SurveyJS's default
"survey" wording
RouteKit Classic ASP MVC starter for the Purple Envelope election-materials
order site: request-order flow, token-based order continuation, SurveyJS
order-details form with server-side validation and a themed confirmation
email, plus the framework core, generators, and dev-only aspunit test harness.
Daniel Covington