Mining-Data-Viewer

Mining Projects Explorer

A FastAPI-based web application that visualizes and analyzes mining projects data from Digbee’s API. The application provides an interactive dashboard to explore mining projects, their locations, and nearby operations within a 500km radius.

Application Screenshots

Analytics Dashboard

Analytics Dashboard Visualizes commodity distribution and project status breakdown across the mining industry

Project List View

Project List View Interactive table showing detailed mining project information with sorting and filtering capabilities

Project Details

Project Details Detailed view of individual projects including location mapping and nearby operations

Features

  • πŸ“Š Interactive data table of mining projects
  • πŸ—ΊοΈ Geographic visualization of project locations
  • πŸ“ˆ Analytics dashboard with industry insights
  • πŸ” Detailed project views with nearby operations
  • 🌐 REST API endpoints for data access

Tech Stack

  • Backend: FastAPI, Python 3.8+
  • Frontend: JavaScript, HTML5, CSS3
  • Data Handling: Pydantic
  • Templates: Jinja2
  • API Integration: Requests

Installation

  1. Clone the repository:

    git clone https://github.com/TomAllsop/Mining-Data-Viewer.git
    cd Mining-Data-Viewer
  2. Create a virtual environment:

    python -m venv venv
    source venv/bin/activate  # On Windows: venv\Scripts\activate
  3. Install dependencies:

    pip install -r requirements.txt
  4. Run the application:

    uvicorn digbee_list_projects:app --reload

    OR

The application will be available at http://localhost:8000 or http://0.0.0.0:8000

API Endpoints

Endpoint Method Description
/api/mining-data GET Retrieve all mining projects
/api/nearby-projects/{project_id} GET Get projects within 500km radius

Project Structure

Mining-Data-Viewer/
β”œβ”€β”€ digbee_list_projects.py   # Main application file
β”œβ”€β”€ static/                   # Static assets
β”‚   β”œβ”€β”€ project-dashboard.js
β”‚   └── datatables-custom.css
β”œβ”€β”€ templates/               # HTML templates
β”‚   β”œβ”€β”€ index.html
β”‚   β”œβ”€β”€ analytics.html
β”‚   └── project_dashboard.html
└── requirements.txt        # Project dependencies

Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

This project is licensed under the MIT License – see the LICENSE file for details.

Acknowledgments

Visit original content creator repository https://github.com/TomAllsop/Mining-Data-Viewer

Comments

Leave a Reply

Your email address will not be published. Required fields are marked *