Atlas v1 Prisma schema draft

[bpalmer77fluid]

Summary

• Adds backend/prisma/schema.atlas-v1.prisma as a design draft for Atlas v1
• Live droplet schema (schema.prisma) is untouched
• Models the seven-layer architecture: Fluid boundary, Workspace, Identity, Derived data, Collaboration, Audit, Sync infrastructure

Design highlights

• Money stored as Decimal(19,4) with native amount + currency + USD snapshot + FX rate at event time
• Time stored as UTC DateTime + sourceTimezone companion field
• Every derived entity carries a version Int for stale-comment detection
• Polymorphic comments via (entityType, entityId) indexed pair
• Soft-delete on user-facing entities preserves audit trail
• SyncState per (workspace, domain) for O(1) sync health checks
• RawEvent archive for replay/debugging

Not yet applied

This is a review artifact, not a migration. No changes to running services.

Test plan

• Review schema layering against the design discussion
• Confirm Customer.email is the right natural key, or switch to fluidCustomerId
• Confirm Fluid API actually exposes an "admin list" endpoint for auto-provisioning
• Decide whether to constrain currency via Postgres enum or keep as String
• Decide cutover path: in-place migration vs parallel namespace

https://claude.ai/code/session_01KbMxHgCS9ApAueQ64oBqdX

---

Generated by Claude Code