aimond/sapiens-web3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
1fe66ac0466635593b37a0b92e83c815d6b28f74
sapiens-web3/replit.md
kimjaehyeon0101 1fe66ac046 Add personalized AI chatbot for media outlets 
Implement AI chatbot functionality using Replit AI Integrations and OpenAI's GPT-5 model, storing chat history in a new `chatMessages` table.

Replit-Commit-Author: Agent
Replit-Commit-Session-Id: 9a264234-c5d7-4dcc-adf3-a954b149b30d
Replit-Commit-Checkpoint-Type: full_checkpoint
Replit-Commit-Screenshot-Url: https://storage.googleapis.com/screenshot-production-us-central1/3df548ff-50ae-432f-9be4-25d34eccc983/9a264234-c5d7-4dcc-adf3-a954b149b30d/d35d7YU
2025-10-15 02:13:09 +00:00

5.1 KiB
Raw Blame History

Overview

SAPIENS is a comprehensive media platform that aggregates news and content from various media outlets organized into three categories: People, Topics, and Companies. The platform features a sophisticated auction system for media outlet management rights, prediction markets tied to articles, and a multi-tier admin system. Users can browse media outlets, read articles, participate in prediction markets, and bid on management rights through an eBay-style auction system.

User Preferences

Preferred communication style: Simple, everyday language.

System Architecture

Frontend Architecture

  • Framework: React with TypeScript using Vite for build tooling
  • Styling: Tailwind CSS with shadcn/ui component library for consistent design
  • Routing: Wouter for client-side routing
  • State Management: TanStack Query for server state and data fetching
  • Authentication: Integrated with Replit Auth system

Backend Architecture

  • Framework: Express.js with TypeScript
  • Database: PostgreSQL with Drizzle ORM for type-safe database operations
  • Authentication: Replit-based OAuth with session management
  • API Design: RESTful API with structured error handling

Database Design

The system uses a PostgreSQL database with the following core entities:

  • Users: Supports role-based access (user, admin, superadmin)
  • Media Outlets: Categorized entities (people, topics, companies) with slugs and metadata
  • Articles: Content with rich text, images, and association to media outlets
  • Prediction Markets: Betting markets linked to articles with yes/no pricing
  • Auctions: eBay-style bidding system for media outlet management rights
  • Bids: Individual auction bids with quality scoring
  • Comments: User-generated content on articles
  • Community Posts: DC Inside-style forum posts for each media outlet with views, likes, and replies
  • Community Replies: Threaded replies to community posts
  • Chat Messages: AI chatbot conversation history per user per media outlet

Authentication & Authorization

  • Multi-tier Access: Three user roles with escalating permissions
  • Session Management: PostgreSQL-backed sessions with configurable TTL
  • Route Protection: Middleware-based authentication checks for protected routes

Key Features

  • Category-based Navigation: Tabbed interface for People, Topics, Companies
  • Dual View Modes: Grid and list views for article browsing
  • Auction System: Real-time bidding with quality score integration
  • Prediction Markets: Integration with external prediction market APIs
  • Admin Dashboards: Role-specific management interfaces with article CRUD operations
  • Content Management: Rich article creation, editing, and deletion with media outlet administration
  • DC Inside-style Community: Forum-style discussion boards for each media outlet with posts, replies, likes, and sorting options
  • Community Features: Post creation, threaded replies, view counts, like system, and multiple sort options (latest, views, likes, replies)
  • AI Chatbot: Personalized AI assistant for each media outlet that adapts its personality based on outlet category (people/topics/companies), providing contextual conversations in Korean

External Dependencies

Database & Infrastructure

  • Neon Database: Serverless PostgreSQL hosting
  • Drizzle ORM: Type-safe database queries and migrations
  • Replit Auth: OAuth authentication provider

UI & Styling

  • shadcn/ui: Pre-built accessible UI components
  • Radix UI: Primitive components for complex interactions
  • Tailwind CSS: Utility-first CSS framework
  • Lucide Icons: Icon library for consistent iconography

Development Tools

  • Vite: Fast build tool with HMR for development
  • TypeScript: Type safety across the full stack
  • TanStack Query: Server state management and caching
  • React Hook Form: Form handling with validation

Third-party Integrations

  • Replit AI Integrations (OpenAI): GPT-5 model for AI chatbot functionality via Replit-managed API (no separate API key required)
  • Kalshi API: External prediction market data (referenced in user requirements)
  • Image Services: Unsplash for placeholder images and media content
  • Session Storage: connect-pg-simple for PostgreSQL session management

Recent Changes

January 15, 2025 - AI Chatbot Implementation

  • Feature: Added personalized AI chatbot for each media outlet
  • Implementation:
    • Database: Created chatMessages table to store conversation history
    • Backend: Implemented chatbot service using OpenAI GPT-5 via Replit AI Integrations
    • Personality System: AI adapts based on outlet category:
      • People: Speaks as the person themselves
      • Topics: Acts as an expert on the topic
      • Companies: Represents the company
    • API: GET and POST endpoints for chat history and message sending
    • Frontend: ChatbotModal component with scrollable chat interface
    • Integration: Added Chat button to media outlet pages (authenticated users only)
  • Testing: End-to-end test passed successfully with authentication flow and message exchange