Citizen Intelligence Agency Documentation latest

Comprehensive documentation for the Citizen Intelligence Agency - an independent, volunteer-driven OSINT platform for political transparency in Sweden.

GitHub Release CII Best Practices OpenSSF Scorecard SLSA 3 Verify & Release Quality Gate Status Security Rating License

Project Overview

The Citizen Intelligence Agency is a volunteer-driven, open-source intelligence (OSINT) project that provides comprehensive analysis of political activities in Sweden. Through advanced monitoring of key political figures and institutions, we deliver:

Our initiative remains strictly independent and non-partisan, focused on fostering informed decision-making and enhancing democratic engagement.

Key Features

The Citizen Intelligence Agency provides a comprehensive set of features for political transparency and analysis:

πŸ“Š Interactive Dashboards

Real-time dashboards visualizing political activities, governance metrics, and institutional performance across Swedish political entities.

πŸ† Political Scoreboard Systems

Quantitative assessments and rankings of political figures, parties, and institutions based on objective performance metrics.

πŸ“ˆ Critical Analytics Tools

Advanced data analysis capabilities providing insights into political trends, voting patterns, and governance effectiveness.

πŸ” Transparency Metrics

Standardized measurements of transparency across government entities, highlighting areas of strength and opportunities for improvement.

βš–οΈ Accountability Measures

Tools for tracking commitments, voting consistency, and alignment between political promises and policy implementation.

πŸ“± Data-Driven Insights

Evidence-based assessments powered by open data sources to provide objective analyses of political performance.

Explore our comprehensive feature set for a detailed overview of available capabilities, including dashboard screenshots and functionality details.

Data Sources

Our analysis is powered by authoritative Swedish government and international data sources:

Source Description
πŸ›οΈ Swedish Parliament Open Data Parliamentary members, committees, and official documents
πŸ—³οΈ Swedish Election Authority Election data, political parties, and voting results
🌍 World Bank Open Data Global economic indicators and demographic data
πŸ’Ή Swedish Financial Management Authority Government finances and economic trends

Runtime Environment

JDK Version Status Release Info
JDK-21 Supported LTS Release
JDK-22 Compatible Feature Release
JDK-23 Compatible Feature Release
JDK-24 Compatible Feature Release
JDK-25 Supported LTS Release

For details on technology lifecycle management, see the End-of-Life Strategy.

Architecture & Documentation

Explore comprehensive architecture documentation, system diagrams, and technical resources for the Citizen Intelligence Agency project.

πŸ›οΈ Current Architecture

C4 model showing current system structure, containers, components, and relationships.

View Architecture

πŸ›οΈ Future Architecture

C4 model showing future system structure and planned enhancements for the platform.

View Future Architecture

πŸ” Security Architecture

Comprehensive security architecture design and implementation patterns for the platform.

View Security Architecture

πŸ” Future Security Architecture

Advanced security architecture vision incorporating AI-enhanced security capabilities.

View Future Security Architecture

🧠 System Mindmaps

Current system component relationships and conceptual architecture visualized through mind mapping.

View Mindmaps

🧠 Future Concept Maps

Evolution roadmap with AI-enhanced capabilities and future system expansion plans.

View Future Concepts

πŸ’Ό SWOT Analysis

Strategic assessment of the platform's strengths, weaknesses, opportunities, and threats.

View SWOT Analysis

πŸ’Ό Future SWOT

Strategic analysis of future platform positioning and opportunities for development.

View Future SWOT

πŸ“Š Data Model

Current data structures, relationships, and entity frameworks used in the system.

View Data Model View Entity Documentation

πŸ“Š Future Data Model

Enhanced political data architecture planned for future system iterations.

View Future Data Architecture

πŸ”„ Process Flowcharts

Current data processing workflows and business process models used in the system.

View Flowcharts

πŸ”„ Future Flowcharts

Enhanced AI-driven workflows planned for future development of the platform.

View Future Flows

πŸ”„ State Diagrams

Current system state transitions and behavioral models of platform components.

View State Diagrams

πŸ”„ Future State Diagrams

Enhanced adaptive state transitions planned for future system implementation.

View Future States

πŸ”§ CI/CD Workflows

Current automation processes and continuous integration/deployment pipelines.

View CI/CD Workflows

πŸ”§ Future Workflows

Enhanced CI/CD with machine learning capabilities planned for future development.

View Future DevOps

πŸ“… Lifecycle Management

Maintenance and end-of-life planning for the platform's technology components.

View EOL Strategy

πŸ’° Security Implementation

Cost and security implementation guidelines for safely deploying the platform.

View Security Plan

πŸ“Š API Documentation

Detailed API reference and technical documentation for developers and integrators.

View API Docs

πŸ–ΌοΈ Feature Showcase

Visual showcase of platform features, dashboards, and political analytics capabilities.

View Feature Showcase

πŸ›‘οΈ Evidence-Based Threat Model

Comprehensive STRIDE threat analysis with attack trees, risk quantification, and security control mapping demonstrating transparent security practices.

Threat Model: Public Documentation STRIDE: Complete Analysis Attack Trees: Documented

πŸ›οΈ CRA Assessment Implementation

Complete Cyber Resilience Act (CRA) compliance assessment for political transparency platform, demonstrating regulatory alignment for democratic transparency systems.

CRA Assessment: Complete Classification: Standard OSS Vulnerability Management: Implemented

Documentation Map

This documentation map provides a comprehensive overview of all available documentation resources for the Citizen Intelligence Agency project:

Document Focus Description Documentation Link
Architecture πŸ›οΈ Architecture C4 model showing current system structure View Source
Future Architecture πŸ›οΈ Architecture C4 model showing future system structure View Source
Security Architecture πŸ” Security Security architecture design and patterns View Source
Future Security Architecture πŸ” Security Future security architecture with AI enhancements View Source
Mindmaps 🧠 Concept Current system component relationships View Source
Future Mindmaps 🧠 Concept Future capability evolution View Source
SWOT Analysis πŸ’Ό Business Current strategic assessment View Source
Future SWOT Analysis πŸ’Ό Business Future strategic opportunities View Source
Data Model πŸ“Š Data Current data structures and relationships View Source
Future Data Model πŸ“Š Data Enhanced political data architecture View Source
Flowcharts πŸ”„ Process Current data processing workflows View Source
Future Flowcharts πŸ”„ Process Enhanced AI-driven workflows View Source
State Diagrams πŸ”„ Behavior Current system state transitions View Source
Future State Diagrams πŸ”„ Behavior Enhanced adaptive state transitions View Source
CI/CD Workflows πŸ”§ DevOps Current automation processes View Source
Future Workflows πŸ”§ DevOps Enhanced CI/CD with ML View Source
End-of-Life Strategy πŸ“… Lifecycle Maintenance and EOL planning View Source
Financial Security Plan πŸ’° Security Cost and security implementation View Source
CIA Features πŸš€ Features Platform features overview View on hack23.com

Deployment Options

AWS CloudFormation Deployment

The Citizen Intelligence Agency can be deployed on AWS using our provided CloudFormation template:

  1. Download the CloudFormation stack file
  2. Create a new stack in the AWS CloudFormation console
  3. Upload the template file and configure parameters
  4. Acknowledge IAM resource creation and launch the stack
  5. Access the application via the URL in the stack outputs

Debian/Ubuntu Installation

For local or self-hosted deployment on Debian/Ubuntu 24.04+:

  1. Install prerequisites:
    sudo apt-get install openjdk-21-jdk postgresql-16 postgresql-contrib postgresql-16-pgaudit
  2. Configure PostgreSQL as detailed in the PostgreSQL configuration guide.
  3. Create database and user:
    sudo su - postgres
    psql
    postgres=# CREATE USER eris WITH password 'discord';
    postgres=# CREATE DATABASE cia_dev;
    postgres=# GRANT ALL PRIVILEGES ON DATABASE cia_dev to eris;
  4. Download and install the Debian package:
    wget https://github.com/Hack23/cia/releases/download/2025.1.2/cia-dist-deb-2025.1.2.all.deb
    sudo dpkg -i cia-dist-deb-2025.1.2.all.deb
  5. Access the server at https://localhost:28443/cia/

🏷️ Project Classification According to Hack23 Framework

Following the Hack23 Classification & Business Continuity Framework guidelines for comprehensive project assessment:

🎯 Project Classification

πŸ”’ Security Classification

⏱️ Business Continuity

πŸ›‘οΈ Security Investment Returns

🎯 Competitive Differentiation

πŸ“ˆ Porter's Five Forces Strategic Impact

πŸ’° Business Impact Analysis Matrix

Comprehensive assessment of potential business impacts across the CIA triad (Confidentiality, Integrity, Availability):

Impact Category Financial Operational Reputational Regulatory
πŸ”’ Confidentiality Financial: Negligible Operational: Negligible Reputational: Low Regulatory: Low
βœ… Integrity Financial: Negligible Operational: High Reputational: High Regulatory: Moderate
⏱️ Availability Financial: Negligible Operational: High Reputational: Low Regulatory: Low

This classification demonstrates the platform's strategic value as a market-leading political transparency solution with high integrity requirements and strong competitive positioning. The assessment guides security investment priorities and business continuity planning for optimal resource allocation.

πŸ’Ό Business Case for News Organizations

Overview: CIA for Media Intelligence

The Citizen Intelligence Agency provides news organizations with systematic political monitoring at scale, enabling data-driven journalism that was previously resource-prohibitive. With 45 behavioral risk rules across 5 analytical frameworks, CIA delivers comprehensive coverage of 349 Swedish politicians, 10,000+ annual votes, and 20,000+ documents. The platform combines real-time monitoring with 50 years of historical data from the Swedish Riksdag, providing unprecedented depth for political analysis. Our proven methodology and open-source transparency ensure reliability and trustβ€”critical factors for news organizations staking their reputation on accurate reporting.

Intelligence Product Portfolio

Political Intelligence API

RESTful API with OAuth 2.0 authentication and 99.5% uptime SLA. Access 349 politician profiles, 10,000+ annual votes, 20,000+ documents through standardized endpoints. Real-time updates deliver voting results within minutes of parliamentary decisions, while daily risk assessments highlight emerging concerns. Rate limits scale with tier selection, and comprehensive documentation ensures rapid integration into existing newsroom workflows.

Advanced Analytics Platform

Interactive dashboards designed for non-technical users enable journalists to explore political data without programming knowledge. Custom report generation supports PDF, Excel, and PowerPoint formats for editorial meetings and publication. Automated alerting via email, SMS, and Slack ensures breaking news opportunities are never missed. Enterprise tier includes white-label branding options, allowing news organizations to present CIA intelligence under their own brand identity.

Risk Assessment Feed

45 behavioral rules analyze politician, party, committee, and ministry activities across four operational domains. Severity classification system (MINOR: 10-49, MAJOR: 50-99, CRITICAL: 100+) prioritizes investigative leads. Historical trend analysis reveals patterns over time, while predictive modeling forecasts coalition dynamics and policy shifts. Transparent methodology with all 45 rules publicly documented ensures editorial teams understand exactly what triggers alerts, supporting defensible journalism.

Pricing & Tier Structure

Tier Monthly Price Rate Limits Features Best For
Developer €0 100 req/day Basic endpoints, historical data Students, independent journalists
Professional €2,500 10,000 req/day Full API, real-time updates Journalists, small news organizations
Enterprise €10,000 Unlimited Custom endpoints, SLA 99.9%, white-label Major news organizations, wire services
Academic €1,500 5,000 req/day Research access, bulk downloads Universities, research institutions

Additional Revenue Streams

ROI Calculations for Media Organizations

Example 1: Reuters (Wire Service)

Annual Cost: €120,000 (Enterprise tier)

Value Delivered:

  • 2,000+ automated wire stories (€60/story = €120,000)
  • Breaking news speed advantage (24-hour lead time = €200,000 competitive value)
  • Fact-checking efficiency: 2,000 hours saved/year (€50/hour = €100,000)

Total Value: €420,000 | ROI: 350%

Example 2: The Economist (News Weekly)

Annual Cost: €120,000

Value Delivered:

  • 500+ data-driven stories (€240/story = €120,000)
  • Enhanced subscriber retention (+500 subs Γ— €150 = €75,000)
  • Fact-checking savings: 2,000 hours (€50/hour = €100,000)

Total Value: €295,000 | ROI: 246%

Example 3: Svenska Dagbladet (Swedish Newspaper)

Annual Cost: €30,000 (Professional tier)

Value Delivered:

  • 200+ election stories (€150/story = €30,000)
  • Coalition analysis exclusives (reader engagement = €20,000)
  • Fact-checking efficiency: 500 hours saved (€50/hour = €25,000)

Total Value: €75,000 | ROI: 250%

Use Cases by Media Organization Type

Global News Organizations (The Economist, FT, Reuters, Bloomberg, AP)

Swedish Mainstream Media (SVT, DN, SvD, Aftonbladet, Expressen)

Alternative Media (Independent blogs, podcasts, non-profit news)

Swedish Election 2026 Pilot Program

Limited Slots: 10 Global + 5 Swedish Media Organizations

Pilot Details:

  • Duration: 3-6 months (July-September 2026 for global, April-September for Swedish)
  • Price:
    • Global media: €7,500 total (75% discount, Enterprise tier features)
    • Swedish media: €5,000/month (50% discount, 6 months)
  • Features:
    • Full Enterprise API access
    • Swedish-specific risk rules and analytics
    • Dedicated integration support engineer
    • Custom dashboard configuration
    • White-label branding options
    • Real-time alerting system
    • Election night live monitoring
    • Post-election analysis workshop

Application Requirements:

  • News organization with national/global reach
  • Dedicated data journalism or political team (2+ journalists)
  • Technical capability for API integration (or dashboard use)
  • Commitment to pilot evaluation period
  • Agreement to case study participation (anonymized option available)

Success Criteria:

  • Generate 50+ data-driven stories using CIA intelligence
  • Achieve 90%+ fact-checking accuracy on political claims
  • Demonstrate measurable time savings on political research
  • Provide feedback for platform improvement

How to Apply:

  1. Visit: https://hack23.com/swedish-election-2026.html
  2. Email: pether@hack23.com
  3. LinkedIn: James Pether SΓΆrling, CEO
  4. Include: Organization name, team size, use case description

Technical Integration Guide

API Integration Steps:

  1. Register for API key (https://github.com/Hack23/cia or contact sales)
  2. Review API documentation (OpenAPI/Swagger spec available)
  3. Test with Developer tier (€0, 100 req/day)
  4. Implement authentication (OAuth 2.0 recommended)
  5. Build endpoints integration (REST/JSON, optional GraphQL)
  6. Deploy to production environment
  7. Monitor usage, upgrade tier as needed

Dashboard Access (No Coding Required):

  1. Register for dashboard account
  2. Configure organization branding (Enterprise/white-label only)
  3. Set up alert rules and notifications
  4. Create custom reports and visualizations
  5. Train team on dashboard usage
  6. Deploy to newsroom workflow

Support Options:

Why CIA Over Competitors

Unique Differentiators:

Competitor Comparison:

Feature CIA Traditional Research Services Proprietary Political Data Vendors
Transparency βœ… All rules public ❌ Proprietary ❌ Black box
Open Source βœ… GitHub ❌ Closed ❌ Closed
Historical Depth βœ… 50+ years ⚠️ 10-20 years ⚠️ 5-15 years
API Access βœ… All tiers ❌ Enterprise only βœ… Most tiers
Price βœ… €0-10K/mo ⚠️ €15K+/mo ⚠️ €20K+/mo
Replicability βœ… Any democracy ❌ Bespoke ❌ Single country

Call-to-Action & Contact

Ready to Transform Political Journalism?

Contact Information:

Documentation Resources:

Swedish Election 2026 Pilot: Apply now for limited slots (10 global + 5 Swedish media organizations)

Contact for Media Partnership