architecture.md — full rewrite to reflect current v2 state:
- Accurate component map and pipeline stages
- Session lifecycle (server-side files, cookie signing, rotation)
- Multi-account DocuSign support flow
- Audit log record schema
- Batch job in-memory state caveat documented
- Security design table (log sanitizer, session signing, PDF checksums)
- Known limitations table (retry gaps, shard config, CI fixtures)
PRODUCT-SPEC.md — remove phantom migration_service.py and pdf_coords.py
that were in the original spec but never implemented; document where
pipeline orchestration actually lives
README.md — add Production deployment section covering:
- Reverse proxy / HTTPS requirement for OAuth callbacks
- Required env vars table
- SESSION_SECRET_KEY rotation procedure
- Adobe shard configuration (EU2 / NA1 / others via ADOBE_SIGN_BASE_URL)
- DocuSign sandbox-to-production switch
- Session store maintenance (stale file cleanup)
field-mapping.md — add Multi-Document Templates section explaining
documentId assignment, page number behaviour, and the known limitation
for multi-doc templates where page numbers are not rebased per document
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
README.md — rewritten to reflect actual usage: setup, auth flows, CLI
commands for all three scripts, and links to field-mapping and quirks docs.
tests/PLATFORM-QUIRKS.md — documents confirmed bugs and API quirks found
during development: numberTabs rendering as text+validation (DocuSign API
bug), multi-location field fix, zero-width tab fix, Company/Title contentType
SIGNER_ prefix variant from Adobe Sign API.
tests/ — SCENARIOS, EDGE-CASES, FIELD-TYPE-REGRESSION test planning docs.
validation/ — research notes: field eval, mapping ambiguity log, decision
log, conditional logic analysis, round-trip eval, DocuSign ingest eval.
docs/architecture.md — system architecture overview.
api-samples.md — annotated Adobe Sign API response examples.
PRODUCT-SPEC.md — product requirements and migration scope definition.
sample-templates/ — JSON fixtures (NDA, onboarding, sales contract) for
offline testing; PDFs excluded from version control.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Paul Huliganga