How ciroligeiro/assineaqui works
Assine Aqui is a web platform for business-document signing, with mandatory MFA, role-based administration, an internal certificate authority, and HSM-isolated signing keys. The main workflow is users authenticating, managing or uploading documents, assigning signers, signing, and verifying signatures; administrators can also review audit and signature records. The graph includes documented encrypted MinIO storage and shared rate limiting. Edges rely on the excerpts, SOURCE INDEX references, or README statements; unsampled implementation details and unshown frontend-to-route mappings are omitted.
Main entry points: database.py Relational records · app.py Flask app · signatures.py Signature workflow · documents.py Document workflow
Components 22
Web interface
- Web dashboards
frontend
Application API
- Flask app
backend/app.py - Authentication
backend/routes/auth.py - MFA
backend/routes/mfa.py - User management
backend/routes/users.py - Document workflow
backend/routes/documents.py - Signature workflow
backend/routes/signatures.py - Audit queries
backend/routes/audit.py
Signing and cryptography
- Document encryption
backend/tools/crypto/aesgcm_encryption.py - PDF stamping
backend/tools/pdf_stamp.py - RSA-PSS signatures
backend/tools/crypto/rsa_signature.py - Certificate authority
backend/tools/crypto/pki.py
Persistence and audit
- Relational records
backend/models/database.py - Audit writer
backend/tools/audit.py - Encrypted object storage
backend/tools/storage.py
Security infrastructure
- Role checks
backend/tools/permissions.py - PKCS#11 key store
backend/tools/crypto/hsm.py - Shared rate limiter
backend/extensions.py
Other components
- Platform user
- MinIO
- PostgreSQL
- Redis
Connections 38
- Platform user → Web dashboards: uses
README.md - Web dashboards → Flask app: fetches API
README.md - Flask app → Authentication: mounts routes
backend/app.py - Flask app → User management: mounts routes
backend/app.py - Flask app → Document workflow: mounts routes
backend/app.py - Flask app → Signature workflow: mounts routes
backend/app.py - Flask app → MFA: mounts routes
backend/app.py - Flask app → Audit queries: mounts routes
backend/app.py - Flask app → Shared rate limiter: attaches
backend/app.py - Authentication → Relational records: reads users
backend/routes/auth.py - Authentication → Document encryption: decrypts MFA secret
backend/routes/auth.py - Authentication → Audit writer: records events
backend/routes/auth.py - MFA → Relational records: reads MFA state
backend/routes/mfa.py - MFA → Document encryption: handles MFA secret
backend/routes/mfa.py - User management → Relational records: manages accounts
backend/routes/users.py - User management → PKCS#11 key store: creates user keys
backend/routes/users.py - User management → Certificate authority: issues certificates
backend/routes/users.py - Document workflow → Relational records: manages records
backend/routes/documents.py - Document workflow → Document encryption: encrypts documents
backend/routes/documents.py - Document workflow → Encrypted object storage: stores documents
backend/routes/documents.py - Document workflow → PDF stamping: stamps PDFs
backend/routes/documents.py - Document workflow → Audit writer: records events
backend/routes/documents.py - Document workflow → Role checks: checks access
backend/routes/documents.py - Signature workflow → Relational records: manages signatures
backend/routes/signatures.py - Signature workflow → Document encryption: decrypts documents
backend/routes/signatures.py - Signature workflow → RSA-PSS signatures: signs and verifies
backend/routes/signatures.py - Signature workflow → Certificate authority: verifies certificates
backend/routes/signatures.py - Signature workflow → Encrypted object storage: retrieves documents
backend/routes/signatures.py - Signature workflow → Audit writer: records events
backend/routes/signatures.py - Signature workflow → Role checks: checks access
backend/routes/signatures.py - Audit queries → Relational records: reads audit records
backend/routes/audit.py - Audit queries → Role checks: checks access
backend/routes/audit.py - Audit writer → Relational records: writes events
backend/tools/audit.py - Relational records → PKCS#11 key store: generates owner keys
backend/models/database.py - Relational records → Certificate authority: issues owner certificate
backend/models/database.py - Encrypted object storage → MinIO: stores objects
backend/tools/storage.py - Shared rate limiter → Redis: shares counters
backend/extensions.py - Relational records → PostgreSQL: persists records
README.md