mirror of
https://gh.wpcy.net/https://github.com/discourse/discourse.git
synced 2026-06-19 02:05:37 +08:00
### Super high level description: Adds a nested/threaded view for Discourse topics, allowing posts to be displayed as an indented reply tree instead of the default flat chronological stream. Backend: - New /n/:slug/:topic_id routes serving roots, children (paginated), and context (ancestor chain) endpoints - TreeLoader recursively fetches reply trees with configurable max depth, Sort supports top/new/old ordering - NestedViewPostStat caches per-post reply counts (direct + total descendants, whisper-aware) with a backfill job for existing data - NestedTopic model tracks per-topic opt-in and pinned post Frontend: - Recursive <NestedPost> / <NestedPostChildren> components with lazy-load expansion, cloaking, and scroll tracking - NestedViewCache service preserves expansion state and scroll position across back/forward navigation (15 entries, 10min TTL) - Context view for deep-linking to a specific post with its ancestor chain - Floating actions bar, sort selector, real-time MessageBus updates Site settings (hidden): nested_replies_enabled, nested_replies_default, nested_replies_default_sort, nested_replies_max_depth, nested_replies_cap_nesting_depth, nested_replies_toggle_mode_groups, plus a per-category default override. Co-authored-by: Rafael Silva <xfalcox@gmail.com> Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com> Co-authored-by: Sérgio Saquetim <saquetim@discourse.org>
192 lines
6.2 KiB
Ruby
Vendored
192 lines
6.2 KiB
Ruby
Vendored
# frozen_string_literal: true
|
|
|
|
RSpec.describe Jobs::BackfillNestedReplyStats do
|
|
fab!(:topic)
|
|
fab!(:op) { Fabricate(:post, topic: topic, post_number: 1) }
|
|
fab!(:nested_topic) { Fabricate(:nested_topic, topic: topic) }
|
|
|
|
before { SiteSetting.nested_replies_enabled = true }
|
|
|
|
def execute
|
|
described_class.new.execute(nil)
|
|
end
|
|
|
|
it "does nothing when feature is disabled" do
|
|
SiteSetting.nested_replies_enabled = false
|
|
Fabricate(:post, topic: topic, reply_to_post_number: 1)
|
|
|
|
execute
|
|
|
|
expect(NestedViewPostStat.count).to eq(0)
|
|
end
|
|
|
|
it "computes direct_reply_count for a parent with replies" do
|
|
parent = Fabricate(:post, topic: topic, reply_to_post_number: 1)
|
|
3.times { Fabricate(:post, topic: topic, reply_to_post_number: parent.post_number) }
|
|
|
|
NestedViewPostStat.delete_all
|
|
execute
|
|
|
|
stat = NestedViewPostStat.find_by(post_id: parent.id)
|
|
expect(stat.direct_reply_count).to eq(3)
|
|
end
|
|
|
|
it "computes total_descendant_count across multiple depths" do
|
|
root = Fabricate(:post, topic: topic, reply_to_post_number: 1)
|
|
child = Fabricate(:post, topic: topic, reply_to_post_number: root.post_number)
|
|
Fabricate(:post, topic: topic, reply_to_post_number: child.post_number)
|
|
|
|
NestedViewPostStat.delete_all
|
|
execute
|
|
|
|
stat = NestedViewPostStat.find_by(post_id: root.id)
|
|
expect(stat.direct_reply_count).to eq(1)
|
|
expect(stat.total_descendant_count).to eq(2)
|
|
end
|
|
|
|
it "tracks whisper counts separately" do
|
|
parent = Fabricate(:post, topic: topic, reply_to_post_number: 1)
|
|
Fabricate(:post, topic: topic, reply_to_post_number: parent.post_number)
|
|
Fabricate(
|
|
:post,
|
|
topic: topic,
|
|
reply_to_post_number: parent.post_number,
|
|
post_type: Post.types[:whisper],
|
|
)
|
|
|
|
NestedViewPostStat.delete_all
|
|
execute
|
|
|
|
stat = NestedViewPostStat.find_by(post_id: parent.id)
|
|
expect(stat.direct_reply_count).to eq(2)
|
|
expect(stat.whisper_direct_reply_count).to eq(1)
|
|
expect(stat.total_descendant_count).to eq(2)
|
|
expect(stat.whisper_total_descendant_count).to eq(1)
|
|
end
|
|
|
|
it "includes soft-deleted posts in stats" do
|
|
parent = Fabricate(:post, topic: topic, reply_to_post_number: 1)
|
|
Fabricate(:post, topic: topic, reply_to_post_number: parent.post_number)
|
|
Fabricate(
|
|
:post,
|
|
topic: topic,
|
|
reply_to_post_number: parent.post_number,
|
|
deleted_at: Time.current,
|
|
)
|
|
|
|
NestedViewPostStat.delete_all
|
|
execute
|
|
|
|
stat = NestedViewPostStat.find_by(post_id: parent.id)
|
|
expect(stat.direct_reply_count).to eq(2)
|
|
end
|
|
|
|
it "preserves higher live-incremented stats over backfill-computed values" do
|
|
parent = Fabricate(:post, topic: topic, reply_to_post_number: 1)
|
|
Fabricate(:post, topic: topic, reply_to_post_number: parent.post_number)
|
|
|
|
NestedViewPostStat.delete_all
|
|
NestedViewPostStat.create!(
|
|
post_id: parent.id,
|
|
direct_reply_count: 999,
|
|
total_descendant_count: 999,
|
|
whisper_direct_reply_count: 50,
|
|
whisper_total_descendant_count: 50,
|
|
)
|
|
|
|
execute
|
|
|
|
stat = NestedViewPostStat.find_by(post_id: parent.id)
|
|
expect(stat.direct_reply_count).to eq(999)
|
|
expect(stat.total_descendant_count).to eq(999)
|
|
expect(stat.whisper_direct_reply_count).to eq(50)
|
|
expect(stat.whisper_total_descendant_count).to eq(50)
|
|
end
|
|
|
|
it "updates stats when backfill computes higher values than existing" do
|
|
parent = Fabricate(:post, topic: topic, reply_to_post_number: 1)
|
|
3.times { Fabricate(:post, topic: topic, reply_to_post_number: parent.post_number) }
|
|
|
|
NestedViewPostStat.delete_all
|
|
NestedViewPostStat.create!(post_id: parent.id, direct_reply_count: 1, total_descendant_count: 1)
|
|
|
|
execute
|
|
|
|
stat = NestedViewPostStat.find_by(post_id: parent.id)
|
|
expect(stat.direct_reply_count).to eq(3)
|
|
expect(stat.total_descendant_count).to eq(3)
|
|
end
|
|
|
|
it "processes multiple topics" do
|
|
other_topic = Fabricate(:topic)
|
|
Fabricate(:nested_topic, topic: other_topic)
|
|
other_op = Fabricate(:post, topic: other_topic, post_number: 1)
|
|
Fabricate(:post, topic: other_topic, reply_to_post_number: 1)
|
|
|
|
parent = Fabricate(:post, topic: topic, reply_to_post_number: 1)
|
|
Fabricate(:post, topic: topic, reply_to_post_number: parent.post_number)
|
|
|
|
NestedViewPostStat.delete_all
|
|
execute
|
|
|
|
expect(NestedViewPostStat.find_by(post_id: other_op.id).direct_reply_count).to eq(1)
|
|
expect(NestedViewPostStat.find_by(post_id: parent.id).direct_reply_count).to eq(1)
|
|
end
|
|
|
|
it "skips topics without a nested_topic record" do
|
|
non_nested_topic = Fabricate(:topic)
|
|
non_nested_op = Fabricate(:post, topic: non_nested_topic, post_number: 1)
|
|
Fabricate(:post, topic: non_nested_topic, reply_to_post_number: 1)
|
|
|
|
NestedViewPostStat.delete_all
|
|
execute
|
|
|
|
expect(NestedViewPostStat.find_by(post_id: non_nested_op.id)).to be_nil
|
|
end
|
|
|
|
it "inserts a zero-count sentinel row for the OP of a topic with no replies" do
|
|
NestedViewPostStat.delete_all
|
|
|
|
execute
|
|
|
|
stat = NestedViewPostStat.find_by(post_id: op.id)
|
|
expect(stat).to be_present
|
|
expect(stat.direct_reply_count).to eq(0)
|
|
expect(stat.total_descendant_count).to eq(0)
|
|
expect(stat.whisper_direct_reply_count).to eq(0)
|
|
expect(stat.whisper_total_descendant_count).to eq(0)
|
|
end
|
|
|
|
it "does not re-pick reply-less topics on subsequent runs" do
|
|
NestedViewPostStat.delete_all
|
|
|
|
execute
|
|
initial_updated_at = NestedViewPostStat.find_by(post_id: op.id).updated_at
|
|
|
|
freeze_time 1.hour.from_now
|
|
execute
|
|
expect(NestedViewPostStat.find_by(post_id: op.id).updated_at).to eq_time(initial_updated_at)
|
|
end
|
|
|
|
it "lets a later reply increment the sentinel row via ON CONFLICT" do
|
|
NestedViewPostStat.delete_all
|
|
execute
|
|
|
|
Fabricate(:post, topic: topic, reply_to_post_number: 1)
|
|
|
|
stat = NestedViewPostStat.find_by(post_id: op.id)
|
|
expect(stat.direct_reply_count).to eq(1)
|
|
expect(stat.total_descendant_count).to eq(1)
|
|
end
|
|
|
|
it "only picks up topics with missing stats" do
|
|
Fabricate(:post, topic: topic, reply_to_post_number: 1)
|
|
|
|
execute
|
|
initial_updated_at = NestedViewPostStat.find_by(post_id: op.id).updated_at
|
|
|
|
freeze_time 1.hour.from_now
|
|
execute
|
|
expect(NestedViewPostStat.find_by(post_id: op.id).updated_at).to eq_time(initial_updated_at)
|
|
end
|
|
end
|