From 6f7f38c9da23dee1ba7abddbc96b1aba93beda95 Mon Sep 17 00:00:00 2001
From: Masahiko AMANO <hiko-19@ya.ru>
Date: Tue, 1 Jul 2025 23:58:13 +0300
Subject: [PATCH] docs(erd): add entity relationship diagram (ERD)

---
 docs/erd.puml | 208 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 208 insertions(+)
 create mode 100644 docs/erd.puml

diff --git a/docs/erd.puml b/docs/erd.puml
new file mode 100644
index 0000000..4b01a36
--- /dev/null
+++ b/docs/erd.puml
@@ -0,0 +1,208 @@
+@startuml Tanabata File Manager entity relationship diagram
+
+' skinparam linetype ortho
+
+
+' ========== SYSTEM ==========
+
+entity "system.users" as usr {
+    * id : uuid <<generated>>
+    --
+    * name : varchar(32)
+    * password : text
+    * is_admin : boolean
+}
+
+entity "system.mime" as mime {
+    * name : varchar(127)
+    --
+    * extension : varchar(16)
+}
+
+
+' ========== DATA ==========
+
+entity "data.categories" as cty {
+    * id : uuid <<generated>>
+    --
+    * name : varchar(256)
+      notes : text
+      color : char(6)
+    * created_at : timestamptz <<generated>>
+    * creator_id : uuid
+    ' * is_private : boolean
+}
+
+cty::creator_id }o--|| usr::id
+
+entity "data.files" as fle {
+    * id : uuid <<generated>>
+    --
+      name : varchar(256)
+    * mime : varchar(127)
+    * datetime : timestamptz
+      notes : text
+    * metadata : jsonb
+    * created_at : timestamptz <<generated>>
+    * creator_id : uuid
+    ' * is_private : boolean
+}
+
+fle::mime }o--|| mime::name
+fle::creator_id }o--|| usr::id
+
+entity "data.tags" as tag {
+    * id : uuid <<generated>>
+    --
+    * name : varchar(256)
+      notes : text
+      color : char(6)
+      category_id : uuid
+    * created_at : timestamptz <<generated>>
+    * creator_id : uuid
+    ' * is_private : boolean
+}
+
+tag::category_id }o--o| cty::id
+tag::creator_id }o--|| usr::id
+
+entity "data.file_tag" as ft {
+    * file_id : uuid
+    * tag_id : uuid
+}
+
+ft::file_id }o--|| fle::id
+ft::tag_id }o--|| tag::id
+
+entity "data.autotags" as atg {
+    * trigger_tag_id : uuid
+    * add_tag_id : uuid
+    --
+    * is_active : boolean
+}
+
+atg::trigger_tag_id }o--|| tag::id
+atg::add_tag_id }o--|| tag::id
+
+entity "data.pools" as pool {
+    * id : uuid <<generated>>
+    --
+    * name : varchar(256)
+      notes : text
+    '   parent_id : uuid
+    * created_at : timestamptz
+    * creator_id : uuid
+    ' * is_private : boolean
+}
+
+pool::creator_id }o--|| usr::id
+' pool::parent_id }o--o| pool::id
+
+entity "data.file_pool" as fp {
+    * file_id : uuid
+    * pool_id : uuid
+    * number : integer
+}
+
+fp::file_id }o--|| fle::id
+fp::pool_id }o--|| pool::id
+
+
+' ========== ACCESS ==========
+
+entity "access.files" as acl_f {
+    * user_id : uuid
+    * file_id : uuid
+    --
+    * read : boolean
+    * write : boolean
+}
+
+acl_f::user_id }o--|| usr::id
+acl_f::file_id }o--|| fle::id
+
+entity "access.tags" as acl_t {
+    * user_id : uuid
+    * tag_id : uuid
+    --
+    * read : boolean
+    * write : boolean
+    ' * files_read : boolean
+    ' * files_write : boolean
+}
+
+acl_t::user_id }o--|| usr::id
+acl_t::tag_id }o--|| tag::id
+
+entity "access.categories" as acl_c {
+    * user_id : uuid
+    * category_id : uuid
+    --
+    * read : boolean
+    * write : boolean
+    ' * tags_read : boolean
+    ' * tags_write : boolean
+}
+
+acl_c::user_id }o--|| usr::id
+acl_c::category_id }o--|| cty::id
+
+entity "access.pools" as acl_p {
+    * user_id : uuid
+    * pool_id : uuid
+    --
+    * read : boolean
+    * write : boolean
+    ' * files_read : boolean
+    ' * files_write : boolean
+}
+
+acl_p::user_id }o--|| usr::id
+acl_p::pool_id }o--|| pool::id
+
+
+' ========== ACTIVITY ==========
+
+entity "activity.sessions" as ssn {
+    * id : uuid <<generated>>
+    --
+    * user_id : uuid
+    * user_agent : varchar(512)
+    * started_at : timestamptz
+      expires_at : timestamptz
+    * last_activity : timestamptz
+}
+
+ssn::user_id }o--|| usr::id
+
+entity "activity.file_views" as fv {
+    * file_id : uuid
+    * timestamp : timestamptz
+    * user_id : uuid
+}
+
+fv::file_id }o--|| fle::id
+fv::user_id }o--|| usr::id
+
+entity "activity.tag_uses" as tu {
+    * tag_id : uuid
+    * timestamp : timestamptz
+    * user_id : uuid
+    --
+    * included : boolean
+}
+
+tu::tag_id }o--|| tag::id
+tu::user_id }o--|| usr::id
+
+entity "activity.pool_views" as pv {
+    * pool_id : uuid
+    * timestamp : timestamptz
+    * user_id : uuid
+}
+
+pv::pool_id }o--|| pool::id
+pv::user_id }o--|| usr::id
+
+
+@enduml