📘

Dokumentide ringlus ja kontrollimine

circulations crm_office 🛡️ RLS Protected

Dokumendi ringlus ja kontrollimine <unk> koodist saadud protsessi- ja API-dokumendid.

Fachliche Bestimmung: Dokumendi ringlus ja kontroll <unk> koodist saadud protsesside ja API-dokumendid.

⚡ Töövoogud ja elutsüklid (2) 🗄️ Andme mudelid & väljad (3) 🔌 Algsed punktid (UI ja API) (23) 🛡️ Määruse ja vastavus

⚡ Töövoogud ja elutsüklid

Kasutaja käsk: ravikirjeldus `plan:command_circulation_agent`

Kontrollitud püsivkava (durable_plan), algus: manuell_command.

1. circulation_agent

circulation_agent

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Aktionen: circulation_agent

Ülemkõlblikkus `status:circulation`

Üldne kontrollisüsteem (ainult jälgitav) - ülekanded ei ole nõutavad <unk>vt teenindusvalideerimine.

1. draft

Raamatu töövõime

2. active

aktiivsed

Status <unk>active<unk> state-massiini pöörlemine.

3. completed

täidetud

Status <unk>completed<unk> state machine ringlus.

4. rejected

Vastutatud

Status <unk>rejected<unk> state machine ringlus.

5. returned

tagastatud

Status <unk>Tõmbunud <unk> state machine ringlus.

6. cancelled

tühistatud

Status <unk> kustutatud<unk> state machine ringlus.

🗄️ Andme mudelid & väljad

CirculationComments circulation_comments RLS Aktiv

13 Kärgid / varud

Tabelle circulation_comments

Feldname	Andme tüüp	Kohustus	Schlüssel	Tööandjapidamis
`circulation_id`	`UUID`	Ja *	FK ➔ document_circulations.id	Feld circulation_id
`step_id`	`UUID`	Nein	FK ➔ circulation_steps.id	Feld step_id
`document_id`	`UUID`	Ja *	FK ➔ documents.id	Feld document_id
`author_id`	`UUID`	Nein	FK ➔ organization_users.id	Feld author_id
`page`	`INTEGER`	Ja *	-	Feld page
`x`	`FLOAT`	Ja *	-	Feld x
`y`	`FLOAT`	Ja *	-	Feld y
`text`	`TEXT`	Ja *	-	Feld text
`id`	`UUID`	Nein	PK	Feld id
`tenant_id`	`UUID`	Ja *	FK ➔ organizations.id	Feld tenant_id
`created_at`	`DATETIME`	Ja *	-	Feld created_at
`updated_at`	`DATETIME`	Ja *	-	Feld updated_at
`metadata`	`JSONB`	Ja *	-	Feld metadata

CirculationStamps circulation_stamps RLS Aktiv

16 Kärgid / varud

Tabelle circulation_stamps

Feldname	Andme tüüp	Kohustus	Schlüssel	Tööandjapidamis
`circulation_id`	`UUID`	Ja *	FK ➔ document_circulations.id	Feld circulation_id
`step_id`	`UUID`	Nein	FK ➔ circulation_steps.id	Feld step_id
`document_id`	`UUID`	Ja *	FK ➔ documents.id	Feld document_id
`placed_by`	`UUID`	Nein	FK ➔ organization_users.id	Feld placed_by
`page`	`INTEGER`	Ja *	-	Feld page
`x`	`FLOAT`	Ja *	-	Feld x
`y`	`FLOAT`	Ja *	-	Feld y
`width`	`FLOAT`	Ja *	-	Feld width
`height`	`FLOAT`	Ja *	-	Feld height
`text`	`VARCHAR(255)`	Ja *	-	Feld text
`color`	`VARCHAR(7)`	Ja *	-	Feld color
`id`	`UUID`	Nein	PK	Feld id
`tenant_id`	`UUID`	Ja *	FK ➔ organizations.id	Feld tenant_id
`created_at`	`DATETIME`	Ja *	-	Feld created_at
`updated_at`	`DATETIME`	Ja *	-	Feld updated_at
`metadata`	`JSONB`	Ja *	-	Feld metadata

CirculationSteps circulation_steps RLS Aktiv

17 Kärgid / varud

Tabelle circulation_steps

Feldname	Andme tüüp	Kohustus	Schlüssel	Tööandjapidamis
`circulation_id`	`UUID`	Ja *	FK ➔ document_circulations.id	Feld circulation_id
`position`	`INTEGER`	Ja *	-	Feld position
`assignee_id`	`UUID`	Ja *	FK ➔ organization_users.id	Feld assignee_id
`status`	`VARCHAR(48)`	Ja *	-	Feld status
`instructions`	`TEXT`	Nein	-	Feld instructions
`assigned_at`	`DATETIME`	Nein	-	Feld assigned_at
`started_at`	`DATETIME`	Nein	-	Feld started_at
`completed_at`	`DATETIME`	Nein	-	Feld completed_at
`decision`	`VARCHAR(32)`	Nein	-	Feld decision
`notes`	`TEXT`	Nein	-	Feld notes
`due_at`	`DATETIME`	Nein	-	Feld due_at
`decision_comment`	`TEXT`	Nein	-	Feld decision_comment
`id`	`UUID`	Nein	PK	Feld id
`tenant_id`	`UUID`	Ja *	FK ➔ organizations.id	Feld tenant_id
`created_at`	`DATETIME`	Ja *	-	Feld created_at
`updated_at`	`DATETIME`	Ja *	-	Feld updated_at
`metadata`	`JSONB`	Ja *	-	Feld metadata

🔌 Algsed punktid (UI ja API)

Art	Teadus	Lõpppunkt / tee	Titel & Zweck	Õigustamine
⚡ REST API	DELETE	`/api/v1/circulations/{circulation_id}/assignees/{step_id}`	remove_assignee Semantic binding: operator_surface; mutation=True	`circulations`
⚡ REST API	DELETE	`/api/v1/circulations/{circulation_id}/documents/{document_id}`	remove_document Semantic binding: operator_surface; mutation=True	`circulations`
⚡ REST API	GET	`/api/v1/circulations`	list_circulations Semantic binding: inventory_only; mutation=False	`circulations`
⚡ REST API	GET	`/api/v1/circulations/{circulation_id}`	get_circulation Semantic binding: inventory_only; mutation=False	`circulations`
⚡ REST API	GET	`/api/v1/circulations/{circulation_id}/documents/{document_id}/preview`	document_preview Semantic binding: inventory_only; mutation=False	`circulations`
⚡ REST API	GET	`/api/v1/circulations/{circulation_id}/final-pdf`	download_final_pdf Semantic binding: inventory_only; mutation=False	`circulations`
⚡ REST API	GET	`/circulations`	circulations_page Semantic binding: inventory_only; mutation=False	`circulations`
⚡ REST API	GET	`/circulations/new`	circulation_create_page Semantic binding: inventory_only; mutation=False	`circulations`
⚡ REST API	GET	`/circulations/{circulation_id}`	circulation_detail_page Semantic binding: inventory_only; mutation=False	`circulations`
⚡ REST API	PATCH	`/api/v1/circulations/{circulation_id}`	update_circulation Semantic binding: operator_surface; mutation=True	`circulations`
⚡ REST API	PATCH	`/api/v1/circulations/{circulation_id}/assignees/{step_id}`	update_assignee Semantic binding: operator_surface; mutation=True	`circulations`
⚡ REST API	POST	`/api/v1/circulations`	create_circulation Semantic binding: operator_surface; mutation=True	`circulations`
⚡ REST API	POST	`/api/v1/circulations/{circulation_id}/assignees`	add_assignee Semantic binding: operator_surface; mutation=True	`circulations`
⚡ REST API	POST	`/api/v1/circulations/{circulation_id}/begin-review`	begin_review Semantic binding: operator_surface; mutation=True	`circulations`
⚡ REST API	POST	`/api/v1/circulations/{circulation_id}/cancel`	cancel_circulation Semantic binding: operator_surface; mutation=True	`circulations`
⚡ REST API	POST	`/api/v1/circulations/{circulation_id}/comments`	add_comment Semantic binding: operator_surface; mutation=True	`circulations`
⚡ REST API	POST	`/api/v1/circulations/{circulation_id}/complete-step`	complete_step Semantic binding: operator_surface; mutation=True	`circulations`
⚡ REST API	POST	`/api/v1/circulations/{circulation_id}/documents`	add_document Semantic binding: operator_surface; mutation=True	`circulations`
⚡ REST API	POST	`/api/v1/circulations/{circulation_id}/return`	return_for_revision Semantic binding: operator_surface; mutation=True	`circulations`
⚡ REST API	POST	`/api/v1/circulations/{circulation_id}/stamps`	add_stamp Semantic binding: operator_surface; mutation=True	`circulations`
⚡ REST API	POST	`/api/v1/circulations/{circulation_id}/start`	start_circulation Semantic binding: operator_surface; mutation=True	`circulations`
⚡ REST API	POST	`/api/v1/circulations/{circulation_id}/steps/reorder`	reorder_steps Semantic binding: operator_surface; mutation=True	`circulations`
⚡ REST API	POST	`/api/v1/circulations/{circulation_id}/upload`	upload_document Semantic binding: operator_surface; mutation=True	`circulations`

🛡️ Määruse ja vastavus

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

Töötlusvõime
Kliendi isolatsioon (postgreSQL RLS)