# Veritas Product Features

> **Canonical source:** the canonical features document for this domain is
> [`deep-dive/features.md`](./deep-dive/features.md), rendered in the docs
> center. This file is its operational companion (service topology, APIs,
> schemas, runtime detail) — reconciled by linking, not duplicated (§2, §13).

> AI-Powered News Agency for Ghana and West Africa

Veritas is an autonomous AI-powered news agency that ingests, analyzes,
fact-checks, produces, and distributes verified news across every major digital
channel. Built for Ghana and West Africa, Veritas delivers multilingual,
multimedia news -- from automated article generation to 24/7 live streaming --
while maintaining editorial integrity through AI-powered fact-checking, bias
detection, and compliance monitoring.

---

## Table of Contents

1. [Executive Summary](#executive-summary)
2. [News Ingestion and Aggregation](#news-ingestion-and-aggregation)
3. [AI Editorial Pipeline](#ai-editorial-pipeline)
4. [Fact-Checking and Verification](#fact-checking-and-verification)
5. [Bias Detection and Balance](#bias-detection-and-balance)
6. [Content Generation](#content-generation)
7. [Multimedia Production](#multimedia-production)
8. [Live Streaming](#live-streaming)
9. [Social Media Distribution](#social-media-distribution)
10. [Reader Experience](#reader-experience)
11. [Multilingual Support](#multilingual-support)
12. [Subscription and Monetization](#subscription-and-monetization)
13. [B2B API Platform](#b2b-api-platform)
14. [USSD and Feature Phone Access](#ussd-and-feature-phone-access)
15. [Investigative Journalism Tools](#investigative-journalism-tools)
16. [Election Coverage and Compliance](#election-coverage-and-compliance)
17. [Knowledge Graph and Entity Intelligence](#knowledge-graph-and-entity-intelligence)
18. [Analytics and Intelligence](#analytics-and-intelligence)
19. [Notifications and Alerts](#notifications-and-alerts)
20. [Community Engagement](#community-engagement)
21. [Platform Availability](#platform-availability)
22. [Access Tiers](#access-tiers)
23. [Integration Features](#integration-features)

---

## Executive Summary

Veritas operates as a complete newsroom-in-a-box. Its core value proposition is
delivering verified, balanced news at scale without the overhead of a
traditional newsroom. The platform handles every stage of the news lifecycle:

| Stage          | What Veritas Does                                                  |
| -------------- | ------------------------------------------------------------------ |
| **Discover**   | Ingests from 300+ RSS feeds, sitemaps, and social media sources    |
| **Analyze**    | NLP pipeline: sentiment, topics, entities, language, embeddings    |
| **Verify**     | Automated claim extraction, evidence retrieval, fact-checking      |
| **Score**      | Political bias analysis with Ghana Political Lean (GPL) scoring    |
| **Produce**    | AI-generated articles, video, audio, podcasts, and social content  |
| **Edit**       | Seven AI agents simulate a professional newsroom editorial process |
| **Distribute** | Pushes to web, mobile, YouTube, TikTok, Instagram, WhatsApp, USSD  |
| **Monetize**   | Subscriptions, ads, mobile money, B2B API licensing                |

### Key Numbers

| Metric              | Value                      |
| ------------------- | -------------------------- |
| Content Sources     | 300+ Ghanaian news outlets |
| Supported Languages | 6 (English + 5 Ghanaian)   |
| AI Newsroom Agents  | 7 specialized roles        |
| Social Platforms    | 8+ distribution channels   |
| API Endpoints       | 80+ REST endpoints         |
| Payment Providers   | 5 (including mobile money) |

---

## News Ingestion and Aggregation

### Automated Source Collection

Veritas continuously monitors and ingests content from across the Ghanaian media
landscape:

- **RSS Feed Monitoring** -- Scheduled polling of 300+ Ghanaian news outlet RSS
  feeds with configurable refresh intervals per source
- **Sitemap Crawling** -- Deep sitemap discovery and parsing for outlets that
  publish sitemaps alongside RSS feeds
- **Social Media Monitoring** -- Tracks breaking news and trending topics from
  X/Twitter and Facebook pages of major outlets
- **Source Reliability Scoring** -- Each source is scored for reliability based
  on historical accuracy, editorial standards, and correction frequency

### Content Processing

Once ingested, every piece of content passes through an automated processing
pipeline:

- **Semantic Deduplication** -- Uses pgvector embeddings to detect and merge
  duplicate or near-duplicate stories from different sources
- **Language Detection** -- Automatically identifies whether content is in
  English, Twi, Ewe, Ga, Hausa, or Dagbani
- **Content Normalization** -- Standardizes headlines, timestamps, author
  attribution, and media assets across different source formats
- **Media Extraction** -- Pulls featured images, embedded videos, and other
  media assets with proper attribution
- **Source Attribution Tracking** -- Maintains full provenance records linking
  every article back to its original source

### Story Clustering

Related articles are automatically grouped into coherent story threads:

- **Semantic Story Grouping** -- Clusters articles covering the same event or
  topic using embedding similarity
- **Timeline Construction** -- Builds chronological timelines showing how a
  story has developed across sources
- **Multi-Source Perspective View** -- Presents the same story from multiple
  outlets side by side, highlighting differences in framing

---

## AI Editorial Pipeline

### Seven Specialized AI Agents

Veritas simulates a professional newsroom with seven AI agents, each with
distinct roles and priorities:

| Agent                      | Priority | Responsibilities                                         |
| -------------------------- | -------- | -------------------------------------------------------- |
| Editor-in-Chief            | 10       | Final editorial decisions, content approval, standards   |
| Managing Editor            | 9        | Content editing, quality control, editorial standards    |
| Fact-Checker               | 8        | Claim verification, evidence retrieval, accuracy scoring |
| Journalist (Investigative) | 7        | Deep investigative reporting, source analysis            |
| Journalist (Political)     | 7        | Political coverage, election reporting, government news  |
| Content Strategist         | 6        | Trending topics, content planning, audience insights     |
| Social Media Mgr           | 5        | Social posting, platform optimization, engagement        |

### Editorial Workflow

Content flows through a structured editorial pipeline:

1. **Draft Generation** -- AI generates initial article drafts from ingested
   source material, maintaining attribution and adding context
2. **Fact-Check Review** -- The Fact-Checker agent verifies claims, flags
   unverified statements, and adds evidence links
3. **Managing Editor QC** -- The Managing Editor reviews for editorial
   standards, clarity, balance, and accuracy
4. **Editor-in-Chief Approval** -- Final review and approval before publication
5. **Scheduling** -- Content is scheduled for optimal publication timing based
   on traffic patterns and audience behavior

### Content Management System

The built-in CMS provides full editorial control:

- **Draft, Review, Schedule, Publish, Archive** -- Complete lifecycle management
  for all content types
- **Revision History** -- Full version history with content diffing between
  revisions
- **Priority-Based Scheduling** -- Peak traffic window optimization with Ghana
  timezone-aware quiet hours (Africa/Accra)
- **AI-Powered Quality Control** -- Automated quality reviews at each stage of
  the editorial pipeline

---

## Fact-Checking and Verification

### Automated Claim Extraction

Veritas automatically identifies verifiable claims within articles:

- **Claim Detection** -- NLP-powered identification of factual claims,
  statistics, quotes, and attributions within article text
- **Claim Linking** -- Connects extracted claims to their original sources and
  any related prior fact-checks
- **Claim Classification** -- Categorizes claims by type (statistical, quote,
  prediction, policy, historical)

### Evidence Retrieval and Scoring

For each extracted claim, Veritas searches for supporting or contradicting
evidence:

- **Cross-Reference Search** -- Searches the knowledge base, prior articles, and
  external databases for relevant evidence
- **Evidence Quality Scoring** -- Rates evidence quality based on source
  reliability, recency, and relevance
- **Verdict Assignment** -- Assigns verdicts (true, mostly true, mixed, mostly
  false, false, unverifiable) with confidence scores
- **ClaimReview Structured Data** -- Outputs fact-checks in Schema.org
  ClaimReview format for search engine integration

### Source Credibility Tracking

Every source in the system has a dynamic credibility score:

- **Historical Accuracy Tracking** -- Tracks the accuracy record of each source
  over time
- **Correction Monitoring** -- Notes when sources issue corrections and how
  promptly
- **Reliability Scoring** -- Aggregate reliability scores inform how much weight
  claims from each source receive

---

## Bias Detection and Balance

### Ghana Political Lean (GPL) Scoring

Veritas provides a unique Ghana-specific political bias analysis system:

- **Political Spectrum Analysis** -- Scores content on a political lean spectrum
  tailored to the Ghanaian political landscape
- **Coverage Balance Analysis** -- Measures whether coverage of political topics
  gives proportional representation to different political perspectives
- **Coverage Blindspot Detection** -- Inspired by Ground News, identifies topics
  and perspectives that are underrepresented in coverage

### Bias Transparency

Users see bias information integrated directly into their reading experience:

- **Bias Score Badges** -- Every article displays its political lean score
- **Multi-Source Comparison** -- Side-by-side views showing how different
  outlets with different political leanings cover the same story
- **Source Diversity Indicators** -- Highlights when a story is being covered by
  sources from across the political spectrum versus only one side

---

## Content Generation

### AI Article Generation

Veritas generates original articles and reports using AI:

- **News Article Drafting** -- AI-generated articles from clustered source
  material with full attribution
- **Weather Reports** -- Automated weather summaries for Ghanaian regions
- **Market Summaries** -- Daily financial market overviews covering the Ghana
  Stock Exchange, Cedi exchange rates, and commodity prices
- **Fuel Price Updates** -- Automated tracking and reporting of fuel price
  changes across Ghana
- **Trend Analysis** -- AI-generated analysis of trending topics and emerging
  stories

### AI Writing Assistant

A built-in writing assistant helps journalists and editors:

- **Draft Improvement** -- Suggests improvements to clarity, conciseness, and
  readability
- **Headline Generation** -- Generates multiple headline options optimized for
  engagement and accuracy
- **A/B Testing for Headlines** -- Tests different headline variants to optimize
  click-through rates while maintaining editorial integrity
- **Summary Generation** -- Creates article summaries at different length levels

---

## Multimedia Production

### AI Video Production

Veritas produces broadcast-quality video content using AI:

- **AI Anchor Avatars** -- Lifelike AI news anchors powered by HeyGen, Tavus,
  and D-ID that read news scripts on camera
- **Script-to-Video Pipeline** -- Automated pipeline that converts written
  scripts into complete video segments with anchor shots, B-roll, lower thirds,
  and transitions
- **B-Roll Insertion** -- Intelligent insertion of relevant B-roll footage at
  appropriate points in the script, with Ghana-specific keyword detection
- **Graphics Overlays** -- Automated lower thirds, headline banners, bullet
  points, source citations, and breaking news banners
- **Multi-Format Output** -- Renders in 720p, 1080p, and 4K at 24/30/60fps with
  16:9, 9:16 (vertical), and 1:1 (square) aspect ratios

### YouTube Shorts and Short-Form Video

Dedicated pipelines for short-form video across platforms:

- **YouTube Shorts Production** -- Automated creation of vertical news clips
  optimized for YouTube Shorts format
- **TikTok Video** -- Platform-specific formatting with trending sounds,
  hashtags, and caption optimization
- **Instagram Reels** -- Reels production with Instagram-optimized formatting,
  hashtags, and engagement hooks
- **Caption and Subtitle Generation** -- Automated captioning in all supported
  languages

### Audio and Podcast Production

Full audio content production capabilities:

- **Text-to-Speech** -- AI voice synthesis in English (via ElevenLabs) and
  Ghanaian languages (via Ghana NLP Khaya) for audio versions of articles
- **Voice Profiles** -- Multiple anchor voice personas with distinct
  characteristics, tones, and language specializations
- **Podcast Series** -- Automated podcast episode production with scheduled
  recording, editing, and distribution
- **Radio Syndication** -- Audio formatting for radio broadcast partners
- **Voice Assistant Integration** -- Content formatted for voice assistant
  platforms

---

## Live Streaming

### 24/7 YouTube Live Infrastructure

Veritas operates a continuous live news stream:

- **RTMP Server** -- Custom RTMP ingest server for live broadcast
- **Multi-Platform Push** -- Simultaneous streaming to YouTube Live and other
  platforms
- **Lower-Thirds Graphics** -- Real-time on-screen graphics including anchor
  names, headlines, and breaking news banners
- **Breaking News Overlays** -- Automatic breaking news alerts that interrupt
  regular programming

### Interactive Viewer Q&A

Live stream viewers can interact directly with AI anchors:

- **Multi-Channel Question Submission** -- Accept questions from YouTube Live
  Chat, X/Twitter, Instagram, Facebook, Telegram, web forms, mobile app, and SMS
- **AI-Powered Moderation** -- Automatic question screening with profanity
  filters, spam detection, duplicate detection, and sentiment analysis
- **AI Response Generation** -- AI generates anchor responses with source
  citations and fact-check verification
- **Conversational Video Intelligence** -- Tavus CVI integration for
  interactive, conversational AI responses during live broadcasts
- **Priority Queue** -- Questions are prioritized by relevance, upvotes, and
  viewer engagement
- **Engagement Analytics** -- Real-time metrics on questions received, sources,
  sentiment distribution, and response times

---

## Social Media Distribution

### Platform Coverage

Veritas distributes content across eight major social platforms:

| Platform  | Content Types                                   | Automation Level |
| --------- | ----------------------------------------------- | ---------------- |
| YouTube   | Long-form video, Shorts, Live streaming         | Fully automated  |
| TikTok    | Short-form video with trending sounds/hashtags  | Fully automated  |
| Instagram | Reels, Stories (multi-segment), feed posts      | Fully automated  |
| Facebook  | Page posts, video, links                        | Fully automated  |
| WhatsApp  | Business Channel broadcasts, news summaries     | Fully automated  |
| Telegram  | Channel posts with polls, media, formatted text | Fully automated  |
| LinkedIn  | Professional news updates, analysis             | Fully automated  |
| X/Twitter | Breaking news, thread creation, monitoring      | Fully automated  |

### Intelligent Scheduling

Content distribution is optimized for maximum engagement:

- **Unified Cross-Platform Scheduler** -- Single scheduling engine manages
  posting across all platforms with conflict detection and resolution
- **Optimal Time Window Calculation** -- AI determines the best posting times
  for each platform based on Ghana timezone audience patterns
- **Breaking News Staggering** -- Breaking news is posted in a specific platform
  priority order (fastest platforms first) with configurable delays
- **Content Pillar Rotation** -- Ensures variety in content types posted to each
  platform
- **Virality Scoring** -- AI scores content candidates for viral potential on
  each platform using platform-specific signals

### Platform-Specific Optimization

Each platform receives content tailored to its format:

- **TikTok** -- Trending sound matching, hashtag optimization, caption strategy
  optimization, and content pillar balancing
- **Instagram Reels** -- Hashtag sets, caption optimization, and engagement hook
  templates
- **Instagram Stories** -- Multi-segment stories with polls, stickers, breaking
  news hooks, and category-specific visual styles
- **WhatsApp** -- Formatted message templates with media attachments, subscriber
  management, and broadcast orchestration
- **Telegram** -- HTML-formatted posts, polls, hashtags, and media grouping

### Growth and Partnership Automation

Automated audience growth and partnership management:

- **Platform Growth Targets** -- Set subscriber/follower targets per platform
  with AI-generated growth plans
- **Engagement Automation** -- AI-powered community engagement with sentiment
  monitoring and crisis detection
- **Influencer Discovery** -- Automated identification of relevant influencers
  for partnership opportunities
- **Partnership Proposal Generation** -- AI-generated collaboration proposals
  for potential partners
- **Affiliate Tracking** -- Automated affiliate event tracking and performance
  reporting

### Channel Ecosystem Management

Manage the complete multi-channel presence from a single dashboard:

- **Channel Branding** -- Platform-specific branding plans for each channel
- **Content Routing** -- Rules-based routing of content to appropriate channels
  based on topic, format, and audience
- **Cross-Promotion** -- Automated cross-promotion between channels
- **Membership Tiers** -- Platform-specific membership programs with exclusive
  content and perks
- **Unified Analytics Dashboard** -- Consolidated analytics across all channels

---

## Reader Experience

### Web Application (PWA)

The web application is a Progressive Web App with full offline capabilities:

- **Responsive Design** -- Adapts seamlessly to desktop, tablet, and mobile
  screens
- **Internationalization** -- Full i18n support with locale-based routing for
  all six supported languages
- **Offline Mode** -- Service worker caching enables reading cached articles
  without an internet connection
- **Reading Mode** -- Distraction-free reading experience with customizable
  typography (font family, font size), themes (light, dark, sepia), and reading
  progress tracking
- **Reading Statistics** -- Tracks reading time, articles read, and reading
  history
- **Search with Autocomplete** -- Full-text article search with autocomplete
  suggestions, faceted filtering by category, topic, language, source, and bias

### Mobile Application

Native mobile experience via Expo/React Native:

- **Offline Reading** -- Download articles for offline access
- **Push Notifications** -- Breaking news and personalized alerts via FCM
- **Audio Playback** -- Listen to AI-narrated versions of articles
- **Customizable Themes** -- Light and dark mode support
- **Accessibility** -- Full accessibility features with screen reader support

### Content Discovery

Users can discover content through multiple pathways:

- **Trending Stories** -- Real-time trending articles based on view counts and
  engagement within configurable time windows
- **Personalized Recommendations** -- Collaborative and content-based filtering
  suggests articles based on reading history and preferences
- **User Preferences** -- Users set preferred topics, categories, languages, and
  sources for personalized feeds
- **Related Articles** -- Semantic similarity-based article recommendations
- **Story Timelines** -- Follow developing stories across multiple articles and
  sources

---

## Multilingual Support

### Six Ghanaian Languages

Veritas supports the major languages of Ghana:

| Language | Region                | TTS Provider      | Features                          |
| -------- | --------------------- | ----------------- | --------------------------------- |
| English  | National              | ElevenLabs        | Full NLP, TTS, generation, search |
| Twi      | Ashanti, most regions | Ghana NLP (Khaya) | TTS, translation, NER             |
| Ewe      | Volta Region          | Ghana NLP (Khaya) | TTS, translation, NER             |
| Ga       | Greater Accra         | Ghana NLP (Khaya) | TTS, translation, NER             |
| Hausa    | Northern Ghana        | Ghana NLP (Khaya) | TTS, translation, NER             |
| Dagbani  | Northern Ghana        | Ghana NLP (Khaya) | TTS, translation, NER             |

### Language Features

- **Code-Switching Detection** -- Identifies when text switches between
  languages (common in Ghanaian English), enabling appropriate NLP processing
- **Ghanaian English Normalization** -- Handles Ghanaian English idioms and
  expressions in NLP analysis
- **Translation** -- Article translation between all supported languages via
  Ghana NLP Khaya API
- **Language-Specific Search** -- Search results can be filtered by language
- **Language-Specific Feeds** -- Content feeds filtered by language preference

---

## Subscription and Monetization

### Subscription Plans

Veritas offers tiered subscription plans:

- **Free Tier** -- Basic access with limited article views, ads displayed
- **Premium Tier** -- Unlimited articles, reading mode, audio articles, ad-free
  experience, priority content
- **Family Plan** -- Premium access for up to 6 family members with invite/
  accept/decline/leave workflows
- **Student Plan** -- Discounted access with student verification via email
  domain, ID upload, or enrollment letter

### Subscription Management

Full subscription lifecycle management:

- **Subscribe, Upgrade, Downgrade, Cancel, Resume, Pause, Unpause** -- Complete
  lifecycle operations
- **Usage Tracking** -- Monthly and per-feature usage monitoring with
  configurable limits
- **Feature Access Control** -- Granular feature gating (reading mode, audio
  articles, ad-free, API access, etc.)
- **Subscription History** -- Complete history of plan changes and billing
  events
- **Subscription Analytics** -- Revenue analytics, churn tracking, and plan
  distribution metrics

### Payment Methods

Designed for the Ghanaian market with local payment support:

| Provider      | Type           | Region |
| ------------- | -------------- | ------ |
| Stripe        | Credit/Debit   | Global |
| Paystack      | Local payments | Ghana  |
| MTN MoMo      | Mobile money   | Ghana  |
| Vodafone Cash | Mobile money   | Ghana  |
| AirtelTigo    | Mobile money   | Ghana  |

### Advertising

- **Ad Serving** -- Integrated ad display for free-tier users
- **Ad Network Management** -- Manage multiple ad network integrations
- **Paywall System** -- Configurable paywall for premium content

### Tipping

- **Reader Tips** -- Readers can send tips (payments) to support journalism

---

## B2B API Platform

### News Feed API

Third-party partners can access Veritas content programmatically:

- **Article Feed** -- Paginated, filterable article feed with engagement
  metrics, entity mentions, bias scores, and full metadata
- **Trending Articles** -- Trending content within configurable time windows
- **Article Detail** -- Full article content with body text, entities, and
  engagement data

### Search API

- **Full-Text Faceted Search** -- Search articles with faceted aggregations by
  category, topic, source, language, and bias
- **Autocomplete Suggestions** -- Type-ahead suggestions for search queries

### Fact-Check API

- **Claim Listing** -- Browse fact-checked claims with ClaimReview structured
  data
- **Claim Detail** -- Full claim detail with evidence and verdict
- **Claim Search/Verification** -- Submit a claim text and receive matching
  fact-checks

### Entity API

- **Entity Search** -- Search named entities (people, organizations, locations,
  events, products, legislation, concepts)
- **Entity Detail** -- Full entity profiles with metadata and aliases
- **Entity-Article Relationships** -- Find all articles mentioning a specific
  entity with sentiment scores
- **Entity Relationship Graph** -- Explore relationships between entities
  (leads, member of, located in, founded, works for, related to, opposes, allies
  with, subsidiary of, parent of)

### Media API

- **Media Asset Listing** -- Browse media assets (images, video, audio,
  documents, embeds) with filters by article, kind, and role
- **Media Search** -- Search media by alt text, caption, and credit
- **Article Media** -- Get all media associated with a specific article

### Monitoring and Alerts API

- **Alert Subscriptions** -- Create keyword, topic, entity mention, breaking
  news, fact-check, source, or sentiment change alerts
- **Webhook Delivery** -- Receive alert notifications via webhook or email
- **Alert Frequency Control** -- Configure instant, hourly, daily, or weekly
  alert delivery
- **Monitoring Dashboard** -- API usage statistics and monitoring metrics

### Developer SDKs

- **TypeScript SDK** -- Full-featured TypeScript/JavaScript SDK with typed
  methods for all API endpoints
- **Python SDK** -- Async and sync Python SDK with comprehensive API coverage

### API Key Management

- **Scoped API Keys** -- Fine-grained permission scopes (articles:read,
  search:read, claims:read, claims:search, entities:read, entities:write,
  analytics:read)
- **Rate Limiting** -- Per-key rate limits with configurable hourly and daily
  quotas
- **Usage Metering** -- Automatic tracking of API usage per key, endpoint, and
  time period
- **Sandbox Environment** -- Test API keys with sandbox endpoints for
  development

---

## USSD and Feature Phone Access

### Telco Gateway Integration

Veritas reaches users without smartphones through USSD menus:

- **MTN Gateway** -- Integration with Ghana's largest mobile network
- **Vodafone Gateway** -- Integration with Vodafone Ghana
- **AirtelTigo Gateway** -- Integration with AirtelTigo Ghana
- **Glo Gateway** -- Integration with Globacom

### USSD Menu System

- **Multilingual Menus** -- USSD menus available in English and Twi
- **Category Navigation** -- Browse news by category through numbered menu
  options
- **Article Delivery** -- Articles formatted for USSD character limits with
  pagination for longer content
- **Session Management** -- Stateful USSD sessions with timeout handling

### Voice Callback

- **Text-to-Voice** -- Articles converted to voice for delivery via phone call
- **Voice Callback Requests** -- Users can request a callback to hear news read
  aloud
- **Multi-Provider Support** -- Voice delivery through multiple telephony
  providers

---

## Investigative Journalism Tools

### Anonymous Tip Submission

- **Encrypted Tips** -- Tips are encrypted at rest using AES-256-GCM for source
  protection
- **Anonymous Submission** -- Tips can be submitted without identification
- **Evidence Attachment** -- Support for attaching documents and media as
  evidence
- **Contact Options** -- Optional encrypted contact information for follow-up

### Research Assistant

- **AI Research Tools** -- AI-powered research assistance for journalists
  investigating stories
- **Knowledge Base Search** -- RAG-powered search across the full article
  archive and knowledge base

---

## Election Coverage and Compliance

### Ghana Election Compliance Framework

Veritas includes comprehensive election coverage compliance tools:

- **Constitutional Provisions Reference** -- Database of Ghanaian constitutional
  provisions relevant to election coverage
- **Coverage Guidelines** -- Election coverage guidelines reference for
  editorial staff
- **Election Offences Reference** -- Database of election offences under
  Ghanaian law

### Election Phase Awareness

- **Phase Detection** -- Automatic detection of current election phase
  (pre-election, campaign, silence period, election day, post-election)
- **Silence Period Enforcement** -- Automatic content compliance checking during
  the constitutionally mandated silence period before elections

### Compliance Checking

- **Content Compliance Check** -- Automated analysis of article text for
  election coverage compliance
- **Coverage Balance Analysis** -- Measures whether election coverage gives
  proportional representation to registered political parties
- **Violation Tracking** -- Records and tracks coverage violations for audit and
  compliance reporting
- **Political Party Database** -- Maintains current list of registered political
  parties for balance analysis

---

## Knowledge Graph and Entity Intelligence

### Named Entity Recognition and Tracking

- **Entity Extraction** -- AI-powered extraction of people, organizations,
  locations, events, products, legislation, and concepts from articles
- **Entity Profiles** -- Rich profiles with aliases, descriptions, images, and
  metadata
- **Entity Mention Tracking** -- Tracks every mention of an entity across all
  articles with mention count, sentiment, and context

### Entity Relationship Graph

- **Relationship Types** -- Ten relationship types: leads, member of, located
  in, founded, works for, related to, opposes, allies with, subsidiary of,
  parent of
- **Confidence Scoring** -- Each relationship has a confidence score
- **Graph Navigation** -- Navigate the entity relationship graph to discover
  connections between people, organizations, and events

---

## Analytics and Intelligence

### Content Analytics

- **Article Performance** -- View counts, engagement metrics, and read time
  tracking per article
- **Content Trends** -- Identify trending topics, emerging stories, and content
  gaps
- **Source Performance** -- Analytics on which sources drive the most engagement

### Social Media Analytics

- **Per-Platform Metrics** -- Detailed performance metrics for each social
  platform (views, engagement, shares, comments)
- **Cross-Platform Comparison** -- Compare performance across all distribution
  channels
- **Posting Time Analysis** -- Identify optimal posting windows based on
  historical engagement
- **Hashtag Effectiveness** -- Track which hashtags drive the most engagement
- **Content Pillar Performance** -- Measure effectiveness of different content
  categories per platform
- **Virality Tracking** -- Monitor which content achieves viral distribution

### Revenue Analytics

- **Subscription Analytics** -- Revenue, churn, plan distribution, and growth
  metrics
- **Ad Revenue Tracking** -- Advertising revenue analytics
- **B2B API Usage Analytics** -- Track API partner usage and revenue

### Real-Time Dashboard

- **Real-Time Data Feeds** -- Live metrics streaming for operational monitoring
- **Breaking News Monitoring** -- Real-time monitoring of breaking news events

---

## Notifications and Alerts

### Push Notifications

- **FCM Push** -- Firebase Cloud Messaging push notifications to mobile devices
- **Breaking News Alerts** -- Immediate push for breaking news events
- **Personalized Alerts** -- Topic and entity-based notification preferences

### Email Notifications

- **SMTP/SendGrid/SES** -- Multi-provider email delivery
- **Newsletter Campaigns** -- Email newsletter creation and distribution
- **Digest Emails** -- Configurable daily or weekly news digests

### Emergency Broadcasts

- **Emergency Alert Distribution** -- Rapid distribution of emergency and safety
  information across all channels simultaneously
- **Multi-Channel Emergency Push** -- Simultaneous alerts across web, mobile,
  social, and USSD

---

## Community Engagement

### Commenting System

- **Article Comments** -- Threaded commenting on articles with moderation

### Community Features

- **Community Engagement** -- Community-driven features for reader interaction
  and participation

---

## Platform Availability

| Platform         | Technology            | Status    | Key Features                                |
| ---------------- | --------------------- | --------- | ------------------------------------------- |
| Web (PWA)        | Next.js 16, React 19  | Available | Offline support, i18n, reading mode         |
| Mobile (iOS)     | Expo/React Native     | Available | Push notifications, offline, audio playback |
| Mobile (Android) | Expo/React Native     | Available | Push notifications, offline, audio playback |
| REST API         | Hono                  | Available | 80+ endpoints, OpenAPI docs, JWT auth       |
| B2B API          | Hono + SDKs           | Available | TypeScript and Python SDKs                  |
| USSD             | Telco gateway         | Available | MTN, Vodafone, AirtelTigo, Glo              |
| YouTube          | YouTube Data/Live API | Available | Videos, Shorts, Live streaming              |
| TikTok           | TikTok API            | Available | Short-form video automation                 |
| Instagram        | Instagram Graph API   | Available | Reels, Stories, feed posts                  |
| WhatsApp         | WhatsApp Business API | Available | Channel broadcasts                          |
| Telegram         | Telegram Bot API      | Available | Channel posts with media                    |
| CLI              | Commander.js          | Available | Administrative and development tools        |

---

## Access Tiers

### Consumer Tiers

| Feature                  | Free    | Premium   | Family    | Student   |
| ------------------------ | ------- | --------- | --------- | --------- |
| Article reading          | Limited | Unlimited | Unlimited | Unlimited |
| Article search           | Yes     | Yes       | Yes       | Yes       |
| Trending articles        | Yes     | Yes       | Yes       | Yes       |
| Bias scores              | Yes     | Yes       | Yes       | Yes       |
| Fact-check access        | Yes     | Yes       | Yes       | Yes       |
| Reading mode             | No      | Yes       | Yes       | Yes       |
| Audio articles           | No      | Yes       | Yes       | Yes       |
| Ad-free experience       | No      | Yes       | Yes       | Yes       |
| Offline reading (mobile) | Limited | Full      | Full      | Full      |
| Push notifications       | Basic   | Full      | Full      | Full      |
| Family sharing (up to 6) | No      | No        | Yes       | No        |
| Student discount         | No      | No        | No        | Yes       |

### B2B API Tiers

| Capability             | Basic | Professional | Enterprise |
| ---------------------- | ----- | ------------ | ---------- |
| News Feed API          | Yes   | Yes          | Yes        |
| Search API             | Yes   | Yes          | Yes        |
| Fact-Check API         | No    | Yes          | Yes        |
| Entity API             | No    | Yes          | Yes        |
| Media API              | No    | Yes          | Yes        |
| Monitoring/Alerts API  | No    | No           | Yes        |
| Rate limits (per hour) | Low   | Medium       | High       |
| Webhook notifications  | No    | Yes          | Yes        |
| Dedicated support      | No    | No           | Yes        |

---

## Integration Features

### Cross-Domain (Oshun Monorepo)

- **Shared Infrastructure** -- Uses @oshun/database patterns and shared Docker
  Compose infrastructure (PostgreSQL, Redis, MinIO)
- **Event Bus** -- Publishes domain events for cross-domain coordination

### External AI Services

| Service           | Integration Purpose                            |
| ----------------- | ---------------------------------------------- |
| Anthropic Claude  | LLM for editorial pipeline, content generation |
| OpenAI            | Alternative LLM provider                       |
| HeyGen            | AI video avatar rendering                      |
| D-ID              | AI video avatar rendering                      |
| Tavus CVI         | Conversational video intelligence for live Q&A |
| ElevenLabs        | English text-to-speech                         |
| Ghana NLP (Khaya) | Ghanaian language TTS, NER, and translation    |
| Cohere            | Embeddings and reranking                       |

### External Distribution Services

| Service           | Integration Purpose                          |
| ----------------- | -------------------------------------------- |
| YouTube Data API  | Video uploads, channel management, analytics |
| YouTube Live API  | 24/7 live streaming                          |
| TikTok API        | Video uploads, analytics                     |
| Instagram Graph   | Reels, Stories, feed posts                   |
| Facebook Graph    | Page management, posts                       |
| WhatsApp Business | Channel broadcasts, subscriber management    |
| Telegram Bot      | Channel posts, polls, media                  |
| LinkedIn API      | Professional content distribution            |

### Payment Integrations

| Provider      | Integration Purpose                           |
| ------------- | --------------------------------------------- |
| Stripe        | Global card payments and subscription billing |
| Paystack      | Ghana local payment processing                |
| MTN MoMo API  | MTN Mobile Money integration                  |
| Vodafone Cash | Vodafone Mobile Money integration             |
| AirtelTigo    | AirtelTigo Mobile Money integration           |

### Notification Integrations

| Service  | Integration Purpose                                    |
| -------- | ------------------------------------------------------ |
| FCM      | Firebase Cloud Messaging for mobile push notifications |
| SendGrid | Transactional and marketing email delivery             |
| AWS SES  | Email delivery at scale                                |
| SMTP     | Direct SMTP email delivery                             |
