Cards

Overview

A card is the central object in MyGallery. It is the digital passport of an artwork — a structured record that captures everything known about a physical piece: who made it, when, how it was made, where it has been, who has owned it, and what it is worth. Every artwork registered on the platform lives as a card.

A card has two distinct personas depending on who is looking at it and from where:

• The front is a curated, shareable view — the artwork's public identity.
• The back (the vault) is the owner's private workspace — costs, contacts, appraisals, documents, and everything that stays confidential.

---

Card Characteristics

These are all the data fields a card can hold. The front/back split describes visibility, not storage — all fields live on the same card record.

Field	What it represents	Visibility
Artwork title	The name of the work	Public
Artist name	The artist who created it	Public
Year produced	The year the artwork was made	Public
Material	The medium — oil, acrylic, bronze, photography, etc.	Public
Edition	Whether the work is unique or part of a numbered series	Public
Width / Height / Depth	Physical dimensions	Public
Description	A narrative description of the work	Public
Thumbnail	The cover image shown in the social feed and card list	Public
Inventory number	The owner's internal reference code for the work	Public (front card)
Notes	Private owner notes — storage instructions, condition, observations	Private
Value	Appraised or estimated market value	Private
Value date	The date the valuation was made	Private
Public flag	Controls whether the card appears in the social feed	System
Verified flag	Whether the platform has verified this card	System
Certified flag	Whether the card carries a certification	System
NFT active flag	Whether a blockchain token has been activated for this card	System
My Selection flag	The owner has personally highlighted this card	Owner
Chain count	Number of active chains referencing this card	System
Shared count	Number of active shares of this card	System
Card type	Normal, Verify, or NFT (see Card Types below)	System
Categories	User-defined tags for personal organization	Owner
Creator	The user who originally registered the card — never changes	System
Owner	The current holder of the card — changes on transfer	System

---

Relations

A card can have rich records attached to it. Each relation type has its own document:

Relation	Summary
Provenance	Historical ownership record — who held the work, where, and when
Exhibition	Public showings — galleries, museums, fairs
Literature	Published references to the artwork
Location	Current or past physical locations of the artwork
Contact	Private people and companies linked to the artwork
Cost	Acquisition costs and financial records
Link	External URLs associated with the artwork
Event	Calendar events linked to the card, synced to the owner's device
Category	User-defined organizational tags
Transfer	The process by which a card changes owner
NFT & Blockchain	Minting a card as a blockchain token and managing wallets

---

The App UI — Front Card and Back Card

Front Card

The front card is what any user sees when they open a card that has been shared with them or that appears in the social feed.

What is visible:

• Artist name, artwork title, edition status (unique or series), year produced
• Physical dimensions
• Inventory number
• Thumbnail and public images/videos
• Categories
• Provenance entries
• Exhibition entries
• Literature entries

What the viewer can do (subject to editability rules):

• Add new provenance entries
• Add new exhibition entries
• Add new literature entries
• Add or remove categories

---

Back Card

The back card is the owner's private view of the full card. It is never exposed in public queries.

What is visible and editable:

• All front card fields (artist, title, edition, year, dimensions, inventory number, thumbnail)
• Public images — add, edit, delete
• Notes
• Public card description
• Calendar events — add, edit, delete
• Costs — add, edit, delete
• Contacts — add, edit, delete
• Value and value date
• Links — add, edit, delete
• Media files and documents — add, edit, delete
• Categories — add, edit, delete

---

Business Rules

1. Every card has two key user identities: the creator (the person who originally registered the card — this never changes) and the owner (the current holder — this changes when the card is transferred).

2. Only the card's creator can directly edit the core fields of a card. When the current owner is not the creator, those fields are read-only for the owner.

3. A non-creator owner can still add new records to a card — they can add new provenance entries, new exhibitions, and new literature references on top of what already exists.

4. A non-creator owner who needs to change a field they cannot directly edit can submit a Change Request — specifying what they want changed and why. A back-office reviewer then either approves or rejects the request. If approved, the change is applied.

5. Provenance, exhibition, and literature entries each carry an editability flag, determined by the same rule: only the user who originally created the entry can edit it. Entries added by a previous owner are visible but not editable by the current owner.

6. The front card is visible to anyone the card has been shared with. The back card (vault) is private to the owner only.

7. A card can only be in one transfer at a time. While a transfer is pending, the card is locked — no edits are allowed.

8. When initiating a transfer, provenance, exhibition, and literature records always travel with the card. The sender additionally chooses which vault sections to include; all vault sections are excluded by default:

   Section	Included by default
   Media files	No
   Documents	No
   Notes	No
   Calendar events	No
   Links	No
   Contacts	No
   Location	No
   Costs	No
   Value	No

9. When a transfer is accepted, the original card passes to the recipient and is set to private. The sender retains a private copy of the card containing the vault sections they chose to include. See Transfer for the full set of cascade effects.

10. A card marked as public appears in the social feed and is discoverable by other users. A private card is visible only to its owner.

11. The "My Selection" flag lets the owner highlight specific cards in their personal Selections view. It has no effect on the card's public visibility.

12. The chain count and shared count are maintained automatically by the system whenever a chain or share is created or removed. They cannot be manually edited.

---

Card Types

Type	Meaning
Normal	A standard artwork card with no special status
Verify	A card that has been submitted for platform verification or is currently under review
NFT	A card linked to a blockchain token. When the NFT active flag is true, the token is currently active

---

States

Flag	What it means when true
Public	The card appears in the social feed and is discoverable
In transfer	A transfer is pending; the card is locked for editing
Verified	The platform has verified the authenticity of this card
Certified	The card carries a platform certification
NFT active	A blockchain token is active for this card
NFT transferred	The NFT associated with this card has been transferred
Copy of	This card is a duplicate created from a transfer; the field holds the ID of the original card

---

Constraints

• Direct editing of the core card fields is blocked for non-creator owners. They must submit a Change Request to request modifications.
• Non-creator owners can still add new provenance, exhibition, and literature entries.
• Change requests require back-office approval before any protected field is modified.
• A second transfer cannot be initiated while a transfer is already pending.
• The year produced cannot be in the future (validated at the app layer).
• The social post link attached to a card is immutable — it cannot be changed after the card is created.
• Back card private data (costs, contacts, notes, value, events, links, location) is never included in public or social feed queries.