finta-reference-architecture
Installation
SKILL.md
Finta Reference Architecture
Overview
Production architecture for fundraising operations integrating with Finta's CRM platform. Designed for startup founders and fund managers who need investor pipeline visibility, automated round management, and document room analytics. Key design drivers: deal velocity tracking, investor communication audit trail, capital collection automation via Stripe, and CRM integration with external systems like HubSpot or Salesforce for LP relationship management.
Prerequisites
- A documented data-flow inventory naming each source, destination, owner, retention period, and approved fields.
- Separate development, staging, and production credentials with least-privilege access.
- An incident and rollback owner for every sync or document-sharing integration.
Instructions
- Treat Finta as the authoritative system only where the business has explicitly assigned that role; resolve conflicts through a review queue instead of automatic overwrites.
- Put exports, notifications, and CRM updates behind a durable queue with idempotency keys, bounded retries, and a dead-letter review path.
- Limit event payloads to identifiers and required fields; retrieve sensitive records only inside the authorized worker and redact diagnostics.
- Separate document-room access from operational dashboards, and enforce a permission check at the point where a document is retrieved.
- Promote changes through staging with fictitious investor data, observe a small canary, and retain a tested disable/rollback path for each integration.