Welcome to the OpenData Dicts Admin Portal guide. The portal is completely static, optimized to run straight out of a GitHub Pages (github.io) environment. Adding new datasets, dictionary tables, CSV files, and PDF data dictionaries requires no database reconfiguration. Simply update the configuration file in your git commits.

Step 1: Hosting Data Files (CSV & PDF)

To add download attachments (CSV, PDF, JSON), host the raw documents on your GitHub repository.

1. Commit the dataset files (e.g. districts.csv, districts.pdf) to your repository.
2. Push files to your remote repository branch (e.g. main).
3. Retrieve the raw GitHub URL for each file:
   https://raw.githubusercontent.com/[Username]/[Repository-Name]/[Branch]/[Path-To-File]

Step 2: Registering Datasets in datasets.js

Open datasets.js at the codebase root and insert a new object block into the DATASETS array. Here is a fully styled configuration snippet:

{
  id: "electoral-bonds-data",
  name: "Electoral Bonds Registry",
  category: "Government",
  icon: "payments",
  description: "Official records of electoral bonds purchase, listing donor names, bond values, and purchasing dates.",
  rows: "16k rows",
  updated: "7 days ago",
  tags: ["Electoral", "Finance", "Government"],
  download: {
    csv: "https://raw.githubusercontent.com/saisantoshv3/electoral_bonds/main/electoral_bonds.csv",
    pdf: "https://raw.githubusercontent.com/saisantoshv3/electoral_bonds/main/electoral_bonds.pdf",
    json: "https://raw.githubusercontent.com/saisantoshv3/electoral_bonds/main/electoral_bonds.json"
  },
  related: [
    { name: "MCA Companies Registry", id: "mca-companies-registry" }
  ],
  schema: [
    { name: "Bond Number", type: "STRING", primary: true, desc: "Alphanumeric tracking code.", sample: '"TL85110"' },
    { name: "Purchaser Name", type: "STRING", primary: false, desc: "Corporate body or citizen buyer.", sample: '"Reliance Industries"' },
    { name: "Denomination", type: "INTEGER", primary: false, desc: "Bond value in INR.", sample: "10000000" }
  ],
  previewHeaders: ["Bond Number", "Purchaser Name", "Denomination"],
  preview: [
    { "Bond Number": "TL85110", "Purchaser Name": "Reliance Industries", "Denomination": 10000000 },
    { "Bond Number": "TL85111", "Purchaser Name": "MEIL Ltd", "Denomination": 5000000 }
  ],
  pythonCode: `# Python snippet`,
  curlCode: `# curl command`
}

Step 3: Verification & Live Sync

Commit your modifications and push the files:

git add datasets.js ADMIN_GUIDE.md index.html
git commit -m "Update dictionary registry and documentation"
git push origin main

Your site hosted on GitHub Pages will automatically compile the modifications and build. Within minutes, the new dictionary registry is interactive on your homepage!