fiam_version: '0.2'
instance:
  id: specimen.resource.shared-postgresql-table
  kind: specimen
  title: Shared PostgreSQL table integration
  status: provisional
  intent: Separate database protocol binding from the shared table that creates architectural coupling between applications.
nodes:
- id: node.app-a
  kind: system-node
  name: Application A
  node_type: fiam.node-type.service
- id: node.app-b
  kind: system-node
  name: Application B
  node_type: fiam.node-type.service
- id: node.postgres
  kind: system-node
  name: PostgreSQL
  node_type: fiam.node-type.database
ports:
- id: port.pg.provider
  owner: node.postgres
  participations:
  - contract: contract.sql
    mode: offers
- id: port.app-a.pg
  owner: node.app-a
  participations:
  - contract: contract.sql
    mode: requires
- id: port.app-b.pg
  owner: node.app-b
  participations:
  - contract: contract.sql
    mode: requires
contracts:
- id: contract.sql
  kind: interface-contract
  purpose:
  - fiam.purpose.transactional-data-access
  operations:
  - id: operation.sql.write
    name: INSERT/UPDATE
    effect: fiam.effect.write
  - id: operation.sql.read
    name: SELECT
    effect: fiam.effect.read
endpoints:
- id: endpoint.pg
  kind: endpoint
  address: db.internal:5432
bindings:
- id: binding.pg
  contract: contract.sql
  provider_port: port.pg.provider
  consumer_ports:
  - port.app-a.pg
  - port.app-b.pg
  endpoints:
  - endpoint.pg
  communication_stack:
  - role: fiam.stack-role.database-protocol
    term: fiam.protocol.postgresql-frontend-backend
  - role: fiam.stack-role.transport
    term: fiam.transport.tcp
information_resources:
- id: resource.pg.exchange
  kind: information-resource
  name: public.integration_exchange
  resource_kind: fiam.information-resource.relational-table
  resource_scope: fiam.resource-scope.shared-state
  owner: node.postgres
  selectors:
  - kind: fiam.resource-selector.sql-qualified-name
    value: public.integration_exchange
  facets:
    durability: fiam.durability.persistent
    mutability: fiam.mutability.mutable
interactions:
- id: interaction.app-a.write
  kind: interaction
  operation: operation.sql.write
  binding: binding.pg
- id: interaction.app-b.read
  kind: interaction
  operation: operation.sql.read
  binding: binding.pg
assertions:
- id: assertion.app-a.write-table
  assertion_kind: relation
  subject: interaction.app-a.write
  predicate: fiam.relation.writes-to
  polarity: asserted
  object_ref: resource.pg.exchange
  evidence:
    mode: fiam.evidence.declared
    source: modeling specimen
    confidence: 0.98
- id: assertion.app-b.read-table
  assertion_kind: relation
  subject: interaction.app-b.read
  predicate: fiam.relation.reads-from
  polarity: asserted
  object_ref: resource.pg.exchange
  evidence:
    mode: fiam.evidence.declared
    source: modeling specimen
    confidence: 0.98
- id: assertion.pg.table-conforms
  assertion_kind: relation
  subject: resource.pg.exchange
  predicate: fiam.relation.conforms-to-shape
  polarity: asserted
  object_ref: shape.pg.exchange-table
  evidence:
    mode: fiam.evidence.declared
    source: FIAM v0.2 semantic specimen
    confidence: 0.98
- id: assertion.pg.table-element
  assertion_kind: relation
  subject: resource.pg.exchange
  predicate: fiam.relation.element-shape
  polarity: asserted
  object_ref: shape.pg.exchange-row
  evidence:
    mode: fiam.evidence.declared
    source: FIAM v0.2 semantic specimen
    confidence: 0.98
  facets:
    role: fiam.shape-role.element
    slot: row
- id: assertion.pg.collection-element
  assertion_kind: relation
  subject: shape.pg.exchange-table
  predicate: fiam.relation.element-shape
  polarity: asserted
  object_ref: shape.pg.exchange-row
  evidence:
    mode: fiam.evidence.declared
    source: FIAM v0.2 semantic specimen
    confidence: 0.98
  facets:
    role: fiam.shape-role.element
    slot: row
- id: assertion.pg.write-accepts
  assertion_kind: relation
  subject: interaction.app-a.write
  predicate: fiam.relation.accepts-shape
  polarity: asserted
  object_ref: shape.pg.exchange-row
  evidence:
    mode: fiam.evidence.declared
    source: FIAM v0.2 semantic specimen
    confidence: 0.98
  facets:
    role: fiam.shape-role.request
    representation: fiam.representation.sql-row
- id: assertion.pg.read-produces
  assertion_kind: relation
  subject: interaction.app-b.read
  predicate: fiam.relation.produces-shape
  polarity: asserted
  object_ref: shape.pg.exchange-row
  evidence:
    mode: fiam.evidence.declared
    source: FIAM v0.2 semantic specimen
    confidence: 0.98
  facets:
    role: fiam.shape-role.response
    representation: fiam.representation.sql-row
tests:
  stresses:
  - shared-state-coupling
  - binding-vs-data-resource
  - schema-qualified-selection
  notes:
  - Both applications use the same PostgreSQL Binding family, but their integration coupling is through the shared table resource.
  expected_properties:
  - id: check.evidence
    kind: all-assertions-have-evidence
  - id: check.no-deprecated
    kind: no-deprecated-terms
  - id: check.no-legacy-representations
    kind: no-legacy-representations
  - id: check.pg.table-shape
    kind: relation-exists
    subject: resource.pg.exchange
    predicate: fiam.relation.conforms-to-shape
    object_ref: shape.pg.exchange-table
  - id: check.pg.row-shape
    kind: relation-exists
    subject: resource.pg.exchange
    predicate: fiam.relation.element-shape
    object_ref: shape.pg.exchange-row
  - id: check.pg.ddl
    kind: field-contains
    ref: artifact.pg.exchange-ddl
    field: describes
    value: shape.pg.exchange-row
x-references:
- https://www.postgresql.org/docs/current/ddl-basics.html
- https://www.postgresql.org/docs/current/infoschema-tables.html
information_shapes:
- id: shape.pg.exchange-table
  kind: information-shape
  name: integration_exchange collection
  shape_kind: fiam.information-shape.collection
- id: shape.pg.exchange-row
  kind: information-shape
  name: integration_exchange row
  shape_kind: fiam.information-shape.object
artifacts:
- id: artifact.pg.exchange-ddl
  kind: artifact
  name: integration_exchange DDL
  artifact_type: fiam.artifact.sql-ddl
  describes:
  - resource.pg.exchange
  - shape.pg.exchange-table
  - shape.pg.exchange-row
  locator: db://public.integration_exchange/ddl