How nyllon-software/signudoc works
SignuDoc is a self-hosted electronic-signature application. The main workflow is: an authenticated sender uploads a PDF, prepares an envelope with ordered signers and fields, sends signing links, and signers complete it without accounts; the finished PDF and audit certificate are sealed, stored, and made downloadable and publicly verifiable. Templates, dashboard tracking, organizational administration, branding, and security are parallel product capabilities. Several connections below reflect README-documented behavior; unsampled route and service internals are represented at their existing directory paths.
Main entry points: signing.ts Signing workflow · connection.ts Postgres database · envelopes Envelope preparation · envelopes.ts Envelope workflow
Components 24
Envelope authoring
- Dashboard
src/components/dashboard/dashboard-documents-surface.tsx - Envelope preparation
src/components/envelopes - Envelope endpoints
src/app/api/envelopes - Envelope workflow
src/lib/envelopes.ts - Template screens
src/components/templates - Template endpoints
src/app/api/templates
Identity and administration
- Account screens
src/components/auth - Authentication
src/lib/auth/server.ts - Organization settings
src/components/settings - Admin endpoints
src/app/api/admin - Application settings
src/lib/settings.ts
Signing and evidence
- Signing screens
src/components/signing - Signing endpoints
src/app/api/signing - Signing workflow
src/lib/signing.ts - Audit trail
src/lib/services/audit.ts - PDF sealing
src/lib/services/pdf-seal.ts
Document access
- Verify page
src/app/verify/page.tsx - Verify endpoint
src/app/api/verify/route.ts - Download endpoints
src/app/api/download
Persistence and services
- Email delivery
src/lib/services/email.ts - PDF storage
src/lib/services/storage.ts - Postgres database
src/lib/db/connection.ts
Other components
- Sender
- Signer
Connections 27
- Sender → Account screens: signs in
README.md - Account screens → Authentication: authenticates
README.md - Sender → Envelope preparation: prepares PDF
README.md - Envelope preparation → Envelope endpoints: uploads draft
README.md - Envelope endpoints → Envelope workflow: creates draft
src/app/api/envelopes/route.ts - Envelope workflow → PDF storage: stores documents
src/lib/envelopes.ts - Envelope workflow → Postgres database: persists envelope
src/lib/envelopes.ts - Envelope preparation → Template endpoints: saves template
README.md - Template endpoints → Postgres database: persists templates
- Sender → Dashboard: tracks envelopes
README.md - Dashboard → Envelope endpoints: loads envelope data
- Sender → Signing endpoints: sends envelope
README.md - Signing endpoints → Signing workflow: handles signing
- Signing workflow → Audit trail: records events
- Signing workflow → PDF sealing: finalizes signed PDF
README.md - Signing workflow → Email delivery: delivers signing links
README.md - Signer → Signing screens: opens signing link
README.md - Signing screens → Signing endpoints: submits signature
- Signing workflow → PDF storage: stores completed PDF
README.md - Signing workflow → Email delivery: sends completed copy
README.md - Signer → Download endpoints: downloads document
README.md - Verify page → Verify endpoint: checks fingerprint
src/app/api/verify/route.ts - Verify endpoint → PDF storage: checks document
- Organization settings → Admin endpoints: updates settings
- Admin endpoints → Application settings: reads and updates
src/app/api/admin/settings/route.ts - Application settings → Postgres database: reads settings
src/lib/settings.ts - Authentication → Postgres database: uses database
src/lib/auth/server.ts