Art CRM

A planned gallery and artist relationship-management system for contacts, inventory, consignments, sales, and exhibitions.

This repository is currently a documented product scaffold. It does not yet contain application code, a data schema, production data, or a deployment. The documentation establishes the product boundary and the first testable implementation slice without presenting planned capabilities as working features.

Work locally

Requirements: Node.js 22 or later. The repository currently has no runtime dependencies.

npm ci
npm test

Repository map

• PROJECT.md records lifecycle, boundaries, evidence, and the exact next action.
• AGENTS.md defines safe operating and verification rules.
• CONTEXT.md defines the initial gallery-operations language.
• docs/adr/ records decisions that should survive implementation choices.
• tests/ protects the scaffold's documentation and truthfulness contract.
• .github/workflows/validate.yml validates pull requests and main without deploying the scaffold.

Current boundary

The first implementation target is an Inventory Intake tracer bullet: record a Party, an authored Work, and one physical Inventory Object with explicit identity and status. Persistence, user interface, authentication, and hosting choices remain open until that slice is designed test-first.

No deployment exists. Do not enter real collector, artist, sales, provenance, or financial data until access, backup, export, and privacy requirements are decided and tested.