Data Architecture Decision Framework
Configure a reference architecture for your advancement data platform based on your environment, scale, and analytical priorities. The framework recommends patterns across four architectural dimensions and generates a plan grounded in enterprise data practice.
Environment Profile
These inputs shape the recommendations across all four decision areas. Adjust them to match your current environment.
Where analytical data lives and gets processed. This choice determines what analytical workloads your team can run and how much operational work is required to keep them running.
Anti-patterns
- Business logic in the bronze zone. Transforms during ingestion create an unmaintainable tangle and prevent re-processing when a transformation turns out wrong.
- Skipping the silver zone. Going directly from raw to consumption marts forces every mart to re-implement cleaning and normalization logic independently.
- Gold zone sprawl. A new mart for every dashboard request, with business logic duplicated and diverging across dozens of nearly identical tables.
- Premature lakehouse adoption. For SQL-only teams focused on reporting, the operational complexity tax exceeds the flexibility benefit.
How data moves from source systems to your analytical platform. The integration pattern determines data freshness, operational burden, and how gracefully the pipeline handles source-system changes.
Anti-patterns
- Polling CRM APIs on tight schedules. Burns API quota, adds source-system load, and still delivers stale data compared to native CDC mechanisms.
- Custom ETL without data contracts. Schema changes from source systems propagate silently and break downstream models without warning.
- iPaaS for analytical pipelines. iPaaS tools are designed for point-to-point operational sync, not warehouse-load patterns with medallion-zone modeling.
How constituent identity is resolved across systems and how data quality is measured. Every downstream metric depends on correctly answering "who is this person."
Anti-patterns
- Batch dedup only, never at point of entry. Duplicates re-accumulate between dedup runs, and the root cause (no matching on record creation) is never addressed.
- Merging without unmerge capability. A false positive merge that combines two different constituents' giving histories requires full reversal, not just flagging.
- Defining "total raised" in the BI tool. If each dashboard implements its own sum of gift amounts with its own soft-credit filtering logic, the numbers will diverge. Define canonical metrics once in a shared modeling layer.
- Ignoring soft-credit double-counting. Household soft credits and matching-gift soft credits produce inflated totals unless the aggregation explicitly filters to hard credit or uses a soft-credit-aware calculation.
What latency each data domain requires and how pipeline health is monitored. Freshness targets should match the decision cadence of the humans consuming the data. Real-time infrastructure costs are justified only when reporting delay causes measurable impact.
Anti-patterns
- Streaming infrastructure for batch-consumed data. The most common over-engineering pattern. Operational cost with no analytical improvement when no one acts on the data within the latency window batch already provides.
- No freshness SLA per data domain. Without explicit expectations per table, either everything feels stale or nothing gets monitored.
- CRM schema changes treated as anomalies. CRM administrators add custom fields and change picklist values routinely. Observability tools should classify these events, not fire false alarms.
- Skipping observability entirely. Without automated checks, pipeline failures surface only when a consumer opens a stale report. Run freshness and volume checks after every pipeline execution.
Reference Architecture
Based on your profile and selections. The diagram and summary update as you change inputs.