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
Home Project Features GitHub Repository

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:

SourceDescription
🏛️ Swedish Parliament Open DataParliamentary members, committees, and official documents
🗳️ Swedish Election AuthorityElection data, political parties, and voting results
🌍 World Bank Open DataGlobal economic indicators and demographic data
💹 Swedish Financial Management AuthorityGovernment finances and economic trends

Runtime Environment

JDK VersionStatusRelease Info
JDK-21SupportedLTS Release
JDK-22CompatibleFeature Release
JDK-23CompatibleFeature Release
JDK-24SupportedFuture LTS

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

🧠 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

Documentation Map

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

DocumentFocusDescriptionDocumentation Link
Architecture🏛️ ArchitectureC4 model showing current system structureView Source
Future Architecture🏛️ ArchitectureC4 model showing future system structureView Source
Mindmaps🧠 ConceptCurrent system component relationshipsView Source
Future Mindmaps🧠 ConceptFuture capability evolutionView Source
SWOT Analysis💼 BusinessCurrent strategic assessmentView Source
Future SWOT Analysis💼 BusinessFuture strategic opportunitiesView Source
Data Model📊 DataCurrent data structures and relationshipsView Source
Future Data Model📊 DataEnhanced political data architectureView Source
Flowcharts🔄 ProcessCurrent data processing workflowsView Source
Future Flowcharts🔄 ProcessEnhanced AI-driven workflowsView Source
State Diagrams🔄 BehaviorCurrent system state transitionsView Source
Future State Diagrams🔄 BehaviorEnhanced adaptive state transitionsView Source
CI/CD Workflows🔧 DevOpsCurrent automation processesView Source
Future Workflows🔧 DevOpsEnhanced CI/CD with MLView Source
End-of-Life Strategy📅 LifecycleMaintenance and EOL planningView Source
Financial Security Plan💰 SecurityCost and security implementationView Source
CIA Features🚀 FeaturesPlatform features overviewView 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.4+:

  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/