Skip to main content

​
Overview

The Agora Forum system is a comprehensive discussion platform built for DAO governance and community engagement. It provides a multi-tenant architecture supporting categories, topics, posts, attachments, reactions, upvoting, and advanced moderation features.

Multi-tenant Architecture

Isolated data per DAO using dao_slug for complete data separation

Real-time Interactions

Emoji reactions, upvoting, and live updates for engaging discussions

Content Moderation

NSFW detection, soft/hard deletion, and archival capabilities

File Management

IPFS-based document storage and sharing with content addressing

​
Key Features

​
Discussion Features

  • Categories & Topics: Organize discussions into categories with topic threads
  • Nested Replies: Support for threaded conversations with parent-child post relationships
  • Rich Content: Markdown support with inline attachments and images
  • Reactions: Express engagement with emoji reactions on any post
  • Upvoting: Community-driven content curation through topic upvotes

​
Moderation & Security

  • Automatic NSFW Detection: Content filtering using OpenAI moderation service
  • Soft & Hard Deletion: Flexible content removal with recovery options
  • Archive System: Move content to archived state without deletion
  • Role-based Permissions: Granular access control with admin hierarchy
  • Audit Logging: Complete trail of all administrative actions

​
Integration Features

  • Search Integration: Full-text search with real-time indexing
  • DUNA Support: Specialized components for quarterly reports and documents
  • Subscription System: Follow topics and categories for notifications
  • Analytics: View tracking and engagement metrics
  • IPFS Storage: Decentralized file storage with Pinata integration

​
System Requirements

PostgreSQL with Prisma ORM for reliable data management
IPFS via Pinata for decentralized file storage
Search service integration for full-text indexing
Web3 wallet integration with signature verification

​
Quick Start

1

Connect Wallet

Users must connect their Web3 wallet to participate in discussions
2

Browse Categories

Explore forum categories to find relevant discussions
3

Create Topics

Start new discussions by creating topics (with sufficient voting power)
4

Engage

Reply to posts, add reactions, and upvote quality content

​
Architecture Overview

The forum system follows a layered architecture:

​
Next Steps

Architecture

Learn about the database schema and system design

Topics & Posts

Understand how to create and manage forum content

Reactions

Add emoji reactions and upvoting to your forum

Moderation

Set up content moderation and admin tools