Products

Products are the core units of engineering work in Poelis. A product represents a system or subsystem and is the primary way to organize engineering data, items, and lifecycle states inside a workspace.

Products live inside a workspace and are independently versioned. Versions allow you to capture snapshots of the product, share increments with stakeholders, and track evolution over time.

What is a Product?

A product is where you model and evolve a complete system or subsystem:

• It contains a collection of items, each representing a discrete engineering concept (e.g., requirement, component, interface).
• It includes properties, relationships, and documents that describe the product’s structure and content.
• It maintains version history, enabling you to trace what changed, when, and by whom.

Versions

Every product has exactly one active working version called draft. This is the version you edit day-to-day.

How Versions Work

• The draft version is editable: add, update, or remove items, properties, and documents.
• When you publish a version, Poelis takes a snapshot of the draft and creates a point-in-time version.
• Published versions are immutable: once created, the contents cannot be changed.
• Only the draft can receive changes after publishing.

This model gives you a clean separation between ongoing work and released snapshots.

Baselines

A baseline is a special version you designate as the product’s reference state.

• Baselines are also immutable.