541 lines
13 KiB
Go

package forum
import (
"dk/internal/store"
"fmt"
"sort"
"strings"
"sync"
"time"
)
// Forum represents a forum post or thread in the game
type Forum struct {
ID int `json:"id"`
Posted int64 `json:"posted"`
LastPost int64 `json:"last_post"`
Author int `json:"author"`
Parent int `json:"parent"`
Replies int `json:"replies"`
Title string `json:"title"`
Content string `json:"content"`
}
func (f *Forum) Save() error {
forumStore := GetStore()
forumStore.UpdateForum(f)
return nil
}
func (f *Forum) Delete() error {
forumStore := GetStore()
forumStore.RemoveForum(f.ID)
return nil
}
// Creates a new Forum with sensible defaults
func New() *Forum {
now := time.Now().Unix()
return &Forum{
Posted: now,
LastPost: now,
Author: 0,
Parent: 0, // Default to thread (not reply)
Replies: 0,
Title: "",
Content: "",
}
}
// Validate checks if forum has valid values
func (f *Forum) Validate() error {
if strings.TrimSpace(f.Title) == "" {
return fmt.Errorf("forum title cannot be empty")
}
if strings.TrimSpace(f.Content) == "" {
return fmt.Errorf("forum content cannot be empty")
}
if f.Posted <= 0 {
return fmt.Errorf("forum Posted timestamp must be positive")
}
if f.LastPost <= 0 {
return fmt.Errorf("forum LastPost timestamp must be positive")
}
if f.Parent < 0 {
return fmt.Errorf("forum Parent cannot be negative")
}
if f.Replies < 0 {
return fmt.Errorf("forum Replies cannot be negative")
}
return nil
}
// ForumStore provides in-memory storage with O(1) lookups and forum-specific indices
type ForumStore struct {
*store.BaseStore[Forum] // Embedded generic store
byParent map[int][]int // Parent -> []ID
byAuthor map[int][]int // Author -> []ID
threadsOnly []int // Parent=0 IDs sorted by last_post DESC, id DESC
allByLastPost []int // All IDs sorted by last_post DESC, id DESC
mu sync.RWMutex // Protects indices
}
// Global in-memory store
var forumStore *ForumStore
var storeOnce sync.Once
// Initialize the in-memory store
func initStore() {
forumStore = &ForumStore{
BaseStore: store.NewBaseStore[Forum](),
byParent: make(map[int][]int),
byAuthor: make(map[int][]int),
threadsOnly: make([]int, 0),
allByLastPost: make([]int, 0),
}
}
// GetStore returns the global forum store
func GetStore() *ForumStore {
storeOnce.Do(initStore)
return forumStore
}
// AddForum adds a forum post to the in-memory store and updates all indices
func (fs *ForumStore) AddForum(forum *Forum) {
fs.mu.Lock()
defer fs.mu.Unlock()
// Validate forum
if err := forum.Validate(); err != nil {
return
}
// Add to base store
fs.Add(forum.ID, forum)
// Rebuild indices
fs.rebuildIndicesUnsafe()
}
// RemoveForum removes a forum post from the store and updates indices
func (fs *ForumStore) RemoveForum(id int) {
fs.mu.Lock()
defer fs.mu.Unlock()
// Remove from base store
fs.Remove(id)
// Rebuild indices
fs.rebuildIndicesUnsafe()
}
// UpdateForum updates a forum post efficiently
func (fs *ForumStore) UpdateForum(forum *Forum) {
fs.mu.Lock()
defer fs.mu.Unlock()
// Validate forum
if err := forum.Validate(); err != nil {
return
}
// Update base store
fs.Add(forum.ID, forum)
// Rebuild indices
fs.rebuildIndicesUnsafe()
}
// LoadData loads forum data from JSON file, or starts with empty store
func LoadData(dataPath string) error {
fs := GetStore()
// Load from base store, which handles JSON loading
if err := fs.BaseStore.LoadData(dataPath); err != nil {
return err
}
// Rebuild indices from loaded data
fs.rebuildIndices()
return nil
}
// SaveData saves forum data to JSON file
func SaveData(dataPath string) error {
fs := GetStore()
return fs.BaseStore.SaveData(dataPath)
}
// rebuildIndicesUnsafe rebuilds all indices from base store data (caller must hold lock)
func (fs *ForumStore) rebuildIndicesUnsafe() {
// Clear indices
fs.byParent = make(map[int][]int)
fs.byAuthor = make(map[int][]int)
fs.threadsOnly = make([]int, 0)
fs.allByLastPost = make([]int, 0)
// Collect all forum posts and build indices
allForums := fs.GetAll()
for id, forum := range allForums {
// Parent index
fs.byParent[forum.Parent] = append(fs.byParent[forum.Parent], id)
// Author index
fs.byAuthor[forum.Author] = append(fs.byAuthor[forum.Author], id)
// Threads only (parent = 0)
if forum.Parent == 0 {
fs.threadsOnly = append(fs.threadsOnly, id)
}
// All posts
fs.allByLastPost = append(fs.allByLastPost, id)
}
// Sort allByLastPost by last_post DESC, then ID DESC
sort.Slice(fs.allByLastPost, func(i, j int) bool {
forumI, _ := fs.GetByID(fs.allByLastPost[i])
forumJ, _ := fs.GetByID(fs.allByLastPost[j])
if forumI.LastPost != forumJ.LastPost {
return forumI.LastPost > forumJ.LastPost // DESC
}
return fs.allByLastPost[i] > fs.allByLastPost[j] // DESC
})
// Sort threadsOnly by last_post DESC, then ID DESC
sort.Slice(fs.threadsOnly, func(i, j int) bool {
forumI, _ := fs.GetByID(fs.threadsOnly[i])
forumJ, _ := fs.GetByID(fs.threadsOnly[j])
if forumI.LastPost != forumJ.LastPost {
return forumI.LastPost > forumJ.LastPost // DESC
}
return fs.threadsOnly[i] > fs.threadsOnly[j] // DESC
})
// Sort byParent replies by posted ASC, then ID ASC
for parent := range fs.byParent {
if parent > 0 { // Only sort replies, not threads
sort.Slice(fs.byParent[parent], func(i, j int) bool {
forumI, _ := fs.GetByID(fs.byParent[parent][i])
forumJ, _ := fs.GetByID(fs.byParent[parent][j])
if forumI.Posted != forumJ.Posted {
return forumI.Posted < forumJ.Posted // ASC
}
return fs.byParent[parent][i] < fs.byParent[parent][j] // ASC
})
}
}
// Sort byAuthor by posted DESC, then ID DESC
for author := range fs.byAuthor {
sort.Slice(fs.byAuthor[author], func(i, j int) bool {
forumI, _ := fs.GetByID(fs.byAuthor[author][i])
forumJ, _ := fs.GetByID(fs.byAuthor[author][j])
if forumI.Posted != forumJ.Posted {
return forumI.Posted > forumJ.Posted // DESC
}
return fs.byAuthor[author][i] > fs.byAuthor[author][j] // DESC
})
}
}
// rebuildIndices rebuilds all forum-specific indices from base store data
func (fs *ForumStore) rebuildIndices() {
fs.mu.Lock()
defer fs.mu.Unlock()
fs.rebuildIndicesUnsafe()
}
// Retrieves a forum post by ID
func Find(id int) (*Forum, error) {
fs := GetStore()
forum, exists := fs.GetByID(id)
if !exists {
return nil, fmt.Errorf("forum post with ID %d not found", id)
}
return forum, nil
}
// Retrieves all forum posts ordered by last post time (most recent first)
func All() ([]*Forum, error) {
fs := GetStore()
fs.mu.RLock()
defer fs.mu.RUnlock()
result := make([]*Forum, 0, len(fs.allByLastPost))
for _, id := range fs.allByLastPost {
if forum, exists := fs.GetByID(id); exists {
result = append(result, forum)
}
}
return result, nil
}
// Retrieves all top-level forum threads (parent = 0)
func Threads() ([]*Forum, error) {
fs := GetStore()
fs.mu.RLock()
defer fs.mu.RUnlock()
result := make([]*Forum, 0, len(fs.threadsOnly))
for _, id := range fs.threadsOnly {
if forum, exists := fs.GetByID(id); exists {
result = append(result, forum)
}
}
return result, nil
}
// Retrieves all replies to a specific thread/post
func ByParent(parentID int) ([]*Forum, error) {
fs := GetStore()
fs.mu.RLock()
defer fs.mu.RUnlock()
ids, exists := fs.byParent[parentID]
if !exists {
return []*Forum{}, nil
}
result := make([]*Forum, 0, len(ids))
for _, id := range ids {
if forum, exists := fs.GetByID(id); exists {
result = append(result, forum)
}
}
return result, nil
}
// Retrieves forum posts by a specific author
func ByAuthor(authorID int) ([]*Forum, error) {
fs := GetStore()
fs.mu.RLock()
defer fs.mu.RUnlock()
ids, exists := fs.byAuthor[authorID]
if !exists {
return []*Forum{}, nil
}
result := make([]*Forum, 0, len(ids))
for _, id := range ids {
if forum, exists := fs.GetByID(id); exists {
result = append(result, forum)
}
}
return result, nil
}
// Retrieves the most recent forum activity (limited by count)
func Recent(limit int) ([]*Forum, error) {
fs := GetStore()
fs.mu.RLock()
defer fs.mu.RUnlock()
if limit > len(fs.allByLastPost) {
limit = len(fs.allByLastPost)
}
result := make([]*Forum, 0, limit)
for i := 0; i < limit; i++ {
if forum, exists := fs.GetByID(fs.allByLastPost[i]); exists {
result = append(result, forum)
}
}
return result, nil
}
// Retrieves forum posts containing the search term in title or content
func Search(term string) ([]*Forum, error) {
fs := GetStore()
fs.mu.RLock()
defer fs.mu.RUnlock()
var result []*Forum
lowerTerm := strings.ToLower(term)
for _, id := range fs.allByLastPost {
if forum, exists := fs.GetByID(id); exists {
if strings.Contains(strings.ToLower(forum.Title), lowerTerm) ||
strings.Contains(strings.ToLower(forum.Content), lowerTerm) {
result = append(result, forum)
}
}
}
return result, nil
}
// Retrieves forum posts with activity since a specific timestamp
func Since(since int64) ([]*Forum, error) {
fs := GetStore()
fs.mu.RLock()
defer fs.mu.RUnlock()
var result []*Forum
for _, id := range fs.allByLastPost {
if forum, exists := fs.GetByID(id); exists && forum.LastPost >= since {
result = append(result, forum)
}
}
return result, nil
}
// Saves a new forum post to the in-memory store and sets the ID
func (f *Forum) Insert() error {
fs := GetStore()
// Validate before insertion
if err := f.Validate(); err != nil {
return fmt.Errorf("validation failed: %w", err)
}
// Assign new ID if not set
if f.ID == 0 {
f.ID = fs.GetNextID()
}
// Add to store
fs.AddForum(f)
return nil
}
// Returns the posted timestamp as a time.Time
func (f *Forum) PostedTime() time.Time {
return time.Unix(f.Posted, 0)
}
// Returns the last post timestamp as a time.Time
func (f *Forum) LastPostTime() time.Time {
return time.Unix(f.LastPost, 0)
}
// Sets the posted timestamp from a time.Time
func (f *Forum) SetPostedTime(t time.Time) {
f.Posted = t.Unix()
}
// Sets the last post timestamp from a time.Time
func (f *Forum) SetLastPostTime(t time.Time) {
f.LastPost = t.Unix()
}
// Returns true if this is a top-level thread (parent = 0)
func (f *Forum) IsThread() bool {
return f.Parent == 0
}
// Returns true if this is a reply to another post (parent > 0)
func (f *Forum) IsReply() bool {
return f.Parent > 0
}
// Returns true if this post has replies
func (f *Forum) HasReplies() bool {
return f.Replies > 0
}
// Returns true if there has been activity within the last 24 hours
func (f *Forum) IsRecentActivity() bool {
return time.Since(f.LastPostTime()) < 24*time.Hour
}
// Returns how long ago the last activity occurred
func (f *Forum) ActivityAge() time.Duration {
return time.Since(f.LastPostTime())
}
// Returns how long ago the post was originally made
func (f *Forum) PostAge() time.Duration {
return time.Since(f.PostedTime())
}
// Returns true if the given user ID is the author of this post
func (f *Forum) IsAuthor(userID int) bool {
return f.Author == userID
}
// Returns a truncated version of the content for previews
func (f *Forum) Preview(maxLength int) string {
if len(f.Content) <= maxLength {
return f.Content
}
if maxLength < 3 {
return f.Content[:maxLength]
}
return f.Content[:maxLength-3] + "..."
}
// Returns the number of words in the content
func (f *Forum) WordCount() int {
if f.Content == "" {
return 0
}
// Simple word count by splitting on whitespace
words := 0
inWord := false
for _, char := range f.Content {
if char == ' ' || char == '\t' || char == '\n' || char == '\r' {
if inWord {
words++
inWord = false
}
} else {
inWord = true
}
}
if inWord {
words++
}
return words
}
// Returns the character length of the content
func (f *Forum) Length() int {
return len(f.Content)
}
// Returns true if the title or content contains the given term (case-insensitive)
func (f *Forum) Contains(term string) bool {
lowerTerm := strings.ToLower(term)
return strings.Contains(strings.ToLower(f.Title), lowerTerm) ||
strings.Contains(strings.ToLower(f.Content), lowerTerm)
}
// Updates the last_post timestamp to current time
func (f *Forum) UpdateLastPost() {
f.LastPost = time.Now().Unix()
}
// Increments the reply count
func (f *Forum) IncrementReplies() {
f.Replies++
}
// Decrements the reply count (minimum 0)
func (f *Forum) DecrementReplies() {
if f.Replies > 0 {
f.Replies--
}
}
// Retrieves all direct replies to this post
func (f *Forum) GetReplies() ([]*Forum, error) {
return ByParent(f.ID)
}
// Retrieves the parent thread (if this is a reply) or returns self (if this is a thread)
func (f *Forum) GetThread() (*Forum, error) {
if f.IsThread() {
return f, nil
}
return Find(f.Parent)
}