docs: 基本完成初版数据库设计

2026-10-15 10:09:34 +08:00
parent 63a6993276
commit e6ded00a4c
41 changed files with 2597 additions and 180 deletions
@@ -0,0 +1,22 @@
+-- 已有库完成 004/005/006 后执行；最新空库基线包含此结构，不执行本文件。
+-- 不用创建时间/升级时间冒充首次发布，不将功能历史计数分摊到资源。
+BEGIN;
+SET LOCAL TIME ZONE 'UTC';
+SET LOCAL lock_timeout = '5s';
+SET LOCAL search_path = public, pg_catalog;
+
+ALTER TABLE public.worksheets
+    ADD COLUMN first_published_at timestamptz(3);
+ALTER TABLE public.worksheet_resources
+    ADD COLUMN first_published_at timestamptz(3),
+    ADD COLUMN downloads bigint NOT NULL DEFAULT 0,
+    ADD CONSTRAINT worksheet_resources_downloads_check CHECK (downloads >= 0);
+
+COMMENT ON COLUMN public.worksheets.first_published_at IS '首次公开发布时间；新功能由发布事务写入，重发/新增资源不重置；旧时间未知保持 NULL';
+COMMENT ON COLUMN public.worksheets.is_new IS '旧版新品兼容标记；新功能新品由首次发布时间及时间窗口派生，不作为新业务权威值';
+COMMENT ON COLUMN public.worksheets.is_hot IS '功能级人工运营推荐标记，不是下载排行榜计算结果，不自动传递给资源';
+COMMENT ON COLUMN public.worksheets.downloads IS '功能累计成功保存次数；保留旧累计值，资源下载也计入，不等于资源计数总和';
+COMMENT ON COLUMN public.worksheet_resources.first_published_at IS '内容首次公开发布时间；用于资源新品判断，草稿/重发不重置，未知旧时间保持 NULL';
+COMMENT ON COLUMN public.worksheet_resources.downloads IS '内容累计成功保存次数；仅有可信资源归属的新事件递增，不分摊功能旧计数，不因个人日志删除回减';
+
+COMMIT;