finta-upgrade-migration
Handle Finta platform updates and data migration. Trigger with phrases like "finta upgrade", "finta migration".
- License 许可
- MIT
- 最近更新
- 2026-07-13
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- finta-upgrade-migration
- tags
- [ "saas", "fundraising-crm", "investor-management", "finta" ]
- author
- Jeremy Longshore <jeremy@intentsolutions.io>
- license
- MIT
- version
- 1.0.0
- description
- Handle Finta platform updates and data migration. Trigger with phrases like "finta upgrade", "finta migration".
- allowed-tools
- Read, Grep
- compatible-with
- claude-code
03 SKILL.md 正文
Finta Upgrade & Migration
Overview
Finta is a fundraising CRM built for founders managing investor pipelines, deal rooms, and investor updates. The API exposes endpoints for funding rounds, investor contacts, and deal room documents. Tracking API changes matters because Finta evolves its data model around fundraising workflows — field renames in round stages, investor contact schema updates, and deal room permission changes can break integrations that sync pipeline data to external analytics or reporting tools.
Version Detection
const FINTA_BASE = "https://api.trustfinta.com/v1";
async function detectFintaApiVersion(apiKey: string): Promise<void> {
const res = await fetch(`${FINTA_BASE}/rounds`, {
headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
});
const data = await res.json();
const apiVersion = res.headers.get("x-finta-version") ?? "unknown";
console.log(`Finta API version: ${apiVersion}`);
// Check for deprecated fields in round objects
const knownFields = ["id", "name", "stage", "target_amount", "raised_amount", "investors", "created_at"];
if (data.rounds?.[0]) {
const actual = Object.keys(data.rounds[0]);
const deprecated = knownFields.filter((f) => !actual.includes(f));
const added = actual.filter((f) => !knownFields.includes(f));
if (deprecated.length) console.warn(`Removed fields: ${deprecated.join(", ")}`);
if (added.length) console.log(`New fields: ${added.join(", ")}`);
}
}
Migration Checklist
- [ ] Review Finta changelog for breaking changes to round or investor endpoints
- [ ] Audit codebase for hardcoded round stage values (e.g.,
"pre-seed","series-a") - [ ] Verify investor contact schema — check for
firmvs.organizationfield rename - [ ] Update deal room document upload endpoint if file size limits changed
- [ ] Test investor update email delivery via API (template format may change)
- [ ] Validate webhook payloads for round status change events
- [ ] Migrate CSV import mappings if column headers were renamed
- [ ] Check OAuth token expiry and refresh behavior for API key rotation
- [ ] Update pipeline stage enum values if Finta added custom stage support
- [ ] Run data export and re-import test to verify round-trip data integrity
Schema Migration
// Finta round schema evolved: flat stage string → structured stage object
interface OldRound {
id: string;
name: string;
stage: string; // "pre-seed", "seed", "series-a"
target_amount: number;
raised_amount: number;
investors: string[]; // investor IDs
}
interface NewRound {
id: string;
name: string;
stage: { key: string; label: string; order: number }; // structured stage
target: { amount: number; currency: string };
raised: { amount: number; currency: string };
investors: Array<{ id: string; committed_amount: number }>;
updated_at: string;
}
function migrateRound(old: OldRound): NewRound {
const stageMap: Record<string, { label: string; order: number }> = {
"pre-seed": { label: "Pre-Seed", order: 1 },
seed: { label: "Seed", order: 2 },
"series-a": { label: "Series A", order: 3 },
};
return {
id: old.id,
name: old.name,
stage: { key: old.stage, ...stageMap[old.stage] ?? { label: old.stage, order: 0 } },
target: { amount: old.target_amount, currency: "USD" },
raised: { amount: old.raised_amount, currency: "USD" },
investors: old.investors.map((id) => ({ id, committed_amount: 0 })),
updated_at: new Date().toISOString(),
};
}
Rollback Strategy
class FintaClient {
constructor(private apiKey: string, private version: "v1" | "legacy" = "v1") {}
private get baseUrl(): string {
return `https://api.trustfinta.com/${this.version}`;
}
async getRounds(): Promise<any> {
try {
const res = await fetch(`${this.baseUrl}/rounds`, {
headers: { Authorization: `Bearer ${this.apiKey}` },
});
if (!res.ok) throw new Error(`Finta ${res.status}`);
return await res.json();
} catch (err) {
if (this.version !== "legacy") {
console.warn("Falling back to legacy Finta API");
this.version = "legacy";
return this.getRounds();
}
throw err;
}
}
}
Error Handling
| Migration Issue | Symptom | Fix |
|---|---|---|
| Stage enum changed | 400 Bad Request on round creation with old stage value |
Fetch current stage options from /rounds/stages endpoint |
| Investor schema mismatch | investors returns objects instead of string IDs |
Update parser to handle both string[] and {id, committed_amount}[] |
| Deal room permissions | 403 Forbidden on document upload |
Re-check deal room access scopes after API key rotation |
| CSV import column mismatch | Import fails silently with 0 records created | Re-map columns using updated Finta field names from /schema endpoint |
| Webhook signature invalid | Webhook verification fails after API update | Update HMAC secret from Finta dashboard settings |
Resources
Next Steps
For CI pipeline integration, see finta-ci-integration.
04 同仓库更多 Skills
zustand-store-creator
Create zustand store creator operations. Auto-activating skill for Frontend Development. Triggers on: zustand store creator, zustand store creator Part of the Frontend Development skill category. Use when working with zustand store creator functionality. Trigger with phrases like "zustand store creator", "zustand creator", "zustand".
zero-trust-config-helper
Configure with zero trust config helper operations. Auto-activating skill for Security Advanced. Triggers on: zero trust config helper, zero trust config helper Part of the Security Advanced skill category. Use when configuring systems or services. Trigger with phrases like "zero trust config helper", "zero helper", "zero".
zapier-integration-helper
Assist with zapier integration helper operations. Auto-activating skill for Business Automation. Triggers on: zapier integration helper, zapier integration helper Part of the Business Automation skill category. Use when working with APIs or building integrations. Trigger with phrases like "zapier integration helper", "zapier helper", "zapier".
yaml-config-validator
Validate yaml config validator operations. Auto-activating skill for DevOps Basics. Triggers on: yaml config validator, yaml config validator Part of the DevOps Basics skill category. Use when configuring systems or services. Trigger with phrases like "yaml config validator", "yaml validator", "yaml".
xvary-stock-research
Thesis-driven equity analysis from public SEC EDGAR and market data; /analyze, /score, /compare workflows with bundled Python tools (Claude Code, Cursor, Codex).
xss-vulnerability-scanner
Scan xss vulnerability scanner operations. Auto-activating skill for Security Fundamentals. Triggers on: xss vulnerability scanner, xss vulnerability scanner Part of the Security Fundamentals skill category. Use when working with xss vulnerability scanner functionality. Trigger with phrases like "xss vulnerability scanner", "xss scanner", "xss".