An open-source evidence and research platform studying digital sovereignty, data governance, identity infrastructure, consent, and institutional power in Ethiopia and comparable digital systems.
# Ethiopia Digital Sovereignty Research
A reusable, auditable research infrastructure for studying digital sovereignty,
data governance, digital identity, consent and institutional power — focused on
Ethiopia and comparable digital governance systems.
## Status
This is a **research infrastructure** repository. It currently contains:
- An SQLite evidence database with Pydantic v2 validation
- A Source Registry with deterministic deduplication and status tracking
- Controlled source acquisition with SHA-256 provenance
- TXT / HTML / PDF text extraction
- A researcher-driven evidence model (excerpt, claim, summary, interpretation)
- Governance observations linked to evidence (12 dimensions)
- Executable comparative analysis (JSON / CSV)
- An evidence-backed case-study dossier framework (JSON / Markdown)
- A research-gap prioritization and evidence-expansion framework
- A deterministic evidence-findings synthesis layer (Step 11)
- A deterministic evidence-traceable case-study narrative layer (Step 12)
- A research-coverage status report
- A small **real** source catalog + a small **real** evidence corpus
- Synthetic demonstration fixtures, clearly labelled
> **Important**: This repository does **not** contain conclusions or scores about
> Ethiopia. It contains infrastructure, a source catalog, and a small evidence
> corpus. Absence of evidence is reported as `missing_evidence`, never as a score.
## Research Workflow
```
SOURCE DISCOVERY
↓
SOURCE REGISTRATION
↓
SOURCE VERIFICATION
↓
SOURCE ACQUISITION → raw source + SHA-256
↓
TEXT EXTRACTION → txt / html / pdf
↓
EVIDENCE EXTRACTION (researcher-entered)
↓
GOVERNANCE OBSERVATION
↓
COMPARATIVE ANALYSIS
↓
CASE-STUDY DOSSIER
↓
RESEARCH-GAP PRIORITIZATION
↓
EVIDENCE FINDINGS SYNTHESIS
↓
CASE-STUDY NARRATIVE
```
## Installation
Requires Python >= 3.9.
```bash
pip install -e ".[dev]"
```
## Initialize the database
```bash
python -m src.cli init
```
## Source registry
Import the curated source catalog:
```ba …