feat: initial project structure, config, gitignore, requirements and README

.env.example

@@ -0,0 +1,10 @@
+# Copy this file to .env and fill in your values
+# NEVER commit .env to GitHub
+
+NEO4J_URI=bolt://localhost:7687
+NEO4J_USER=neo4j
+NEO4J_PASSWORD=your_password_here
+
+NEWSAPI_KEY=your_newsapi_key_here
+DATAGOV_API_KEY=579b464db66ec23d9960025070515804
+OPENAI_API_KEY=your_openai_key_here

.gitignore

@@ -0,0 +1,39 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+
+# Virtual Environment
+venv/
+env/
+.env
+.venv/
+
+# Secrets
+*.env
+config/secrets.py
+config/.env
+
+# Data files (large)
+data/raw/*.csv
+data/raw/*.json
+data/raw/*.pdf
+data/processed/*.csv
+
+# Logs
+logs/*.log
+
+# IDE
+.vscode/settings.json
+.idea/
+*.DS_Store
+
+# Neo4j
+neo4j/data/
+
+# Node
+node_modules/

README.md

@@ -1,2 +1,58 @@
-# bharatgraph
-AI-powered public transparency platform for India
+# 🇮🇳 BharatGraph
+
+**AI-powered Public Transparency & Relationship Mapping Platform for India**
+
+> A civic-tech platform that aggregates public government data, maps relationships 
+> between politicians, companies and contracts using graph AI, and generates 
+> evidence-backed risk scores — helping journalists and citizens hold power accountable.
+
+## ⚠️ Legal Disclaimer
+This platform uses ONLY publicly available government data (MyNeta, data.gov.in, MCA, 
+GeM, court records, official press releases). It provides statistical relationship 
+analysis and risk scores — NOT accusations. All claims link to original source documents.
+
+## 🏗️ Project Structure
+```
+bharatgraph/
+├── scrapers/        # Data collection scripts
+├── processing/      # Data cleaning & entity resolution
+├── graph/           # Neo4j graph database logic
+├── ai/              # Risk scoring & anomaly detection
+├── api/             # FastAPI backend
+├── frontend/        # React dashboard
+├── blockchain/      # Audit logging
+├── data/            # Raw and processed data
+├── docs/            # Documentation
+├── tests/           # Test files
+└── config/          # Configuration
+```
+
+## 📊 Data Sources
+- Election Commission / MyNeta — candidate affidavits
+- data.gov.in — government open datasets
+- MCA21 — company directors
+- GeM — procurement contracts
+- PIB / e-Gazette — official announcements
+- CAG reports, court judgments, ADR, PRS
+
+## 🚀 Quick Start
+```bash
+git clone https://github.com/YOUR_USERNAME/bharatgraph.git
+cd bharatgraph
+pip install -r requirements.txt
+cp .env.example .env
+# edit .env with your keys
+python scrapers/datagov_scraper.py
+```
+
+## 📅 Development Phases
+- Phase 1 (Days 1–30): Data collection & graph setup
+- Phase 2 (Days 31–60): AI risk scoring
+- Phase 3 (Days 61–90): Dashboard & API
+- Phase 4 (Days 91–120): Live monitoring & deployment
+
+## 🤝 Contributing
+Open source. PRs welcome. See docs/CONTRIBUTING.md
+
+## 📜 License
+MIT License

config/settings.py

@@ -0,0 +1,43 @@
+import os
+from dotenv import load_dotenv
+
+load_dotenv()
+
+# Project Info
+PROJECT_NAME = "BharatGraph"
+VERSION = "0.1.0"
+DESCRIPTION = "AI-powered public transparency platform for India"
+
+# Database
+NEO4J_URI = os.getenv("NEO4J_URI", "bolt://localhost:7687")
+NEO4J_USER = os.getenv("NEO4J_USER", "neo4j")
+NEO4J_PASSWORD = os.getenv("NEO4J_PASSWORD", "password")
+
+# API Keys (free ones)
+NEWSAPI_KEY = os.getenv("NEWSAPI_KEY", "")
+OPENAI_API_KEY = os.getenv("OPENAI_API_KEY", "")
+
+# Scraper settings
+DEFAULT_DELAY = 2.0       # seconds between requests (be polite)
+MAX_RETRIES = 3
+REQUEST_TIMEOUT = 30
+
+# Data paths
+DATA_RAW_PATH = "data/raw/"
+DATA_PROCESSED_PATH = "data/processed/"
+DATA_SAMPLES_PATH = "data/samples/"
+LOGS_PATH = "logs/"
+
+# Data Sources URLs
+DATAGOV_BASE_URL = "https://api.data.gov.in/resource/"
+DATAGOV_API_KEY = os.getenv("DATAGOV_API_KEY", "579b464db66ec23d9960025070515804")
+PIB_RSS_URL = "https://pib.gov.in/RssMain.aspx?ModId=6&Lang=1&Regid=3"
+MYNETA_BASE_URL = "https://myneta.info"
+MCA_BASE_URL = "https://www.mca.gov.in"
+GEM_BASE_URL = "https://mkp.gem.gov.in"
+LOKSABHA_URL = "https://loksabha.nic.in"
+RAJYASABHA_URL = "https://rajyasabha.nic.in"
+ECOURTS_URL = "https://judgments.ecourts.gov.in"
+PRS_URL = "https://prsindia.org"
+CAG_URL = "https://cag.gov.in"
+ADR_URL = "https://adrindia.org"