zopu-code/packages/backend/convex/README.md

Convex Backend

Convex is the only application API used by web, desktop, and mobile clients. The active backend covers the durable control plane: tenancy, projects, conversation turns, Signals, Work planning (Definition/Design without approval gates), real Runs and Attempts through AgentOS, artifacts/delivery metadata, and Flue persistence.

Domain relations

• organizations and organizationMembers own tenancy.
• projects owns the single v0 Git source; projectContextDocuments stores repository context.
• conversations, conversationTurns, conversationMessages, and conversationAttachments own chat admission and reactive history.
• signals, signalConstraints, and signalSources preserve structured intent and exact evidence.
• works, signalWorkAttachments, and workEvents own proposed Work and provenance.
• workDefinitions and workQuestions own versioned outcome contracts and structured questions.
• designPackets and workSlices preserve versioned implementation intent and executable slice order.
• workRuns, workAttempts, workAttemptEvents, and resolverDecisions own bounded real execution and recovery.
• workArtifacts and workDeliveries preserve evidence and delivery metadata without performing Git or sandbox work.

The flue* tables are infrastructure tables required by Flue's persistence contract. They are deliberately separate from the product relations.