{"id":25198558,"url":"https://github.com/jpcurada/xparky-tracker","last_synced_at":"2026-04-29T17:31:56.242Z","repository":{"id":263464894,"uuid":"890487698","full_name":"JpCurada/xparky-tracker","owner":"JpCurada","description":"XParkyTracker is a Streamlit web app that simplifies XP tracking and certificate distribution for Data and Machine Learning Cadets in Google Developer Group On Campus PUP's learning programs. ","archived":false,"fork":false,"pushed_at":"2024-12-28T14:06:20.000Z","size":2774,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-10T03:17:26.720Z","etag":null,"topics":["gdg","google-cloud-platform","python","streamlit"],"latest_commit_sha":null,"homepage":"https://dataml-xparky-tracker.streamlit.app/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JpCurada.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-18T16:47:36.000Z","updated_at":"2024-12-29T17:08:29.000Z","dependencies_parsed_at":"2024-12-28T15:17:59.479Z","dependency_job_id":"31423bf8-551b-475b-b184-024957f23e3c","html_url":"https://github.com/JpCurada/xparky-tracker","commit_stats":null,"previous_names":["jpcurada/xparkytracker"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JpCurada%2Fxparky-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JpCurada%2Fxparky-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JpCurada%2Fxparky-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JpCurada%2Fxparky-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JpCurada","download_url":"https://codeload.github.com/JpCurada/xparky-tracker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247226205,"owners_count":20904465,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gdg","google-cloud-platform","python","streamlit"],"created_at":"2025-02-10T03:17:37.045Z","updated_at":"2026-04-29T17:31:56.199Z","avatar_url":"https://github.com/JpCurada.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# XParky Tracker\n## Experience Points (XP) Tracking System for Data and ML Cadets\n\nXParkyTracker is a Streamlit-based web application designed to track and manage experience points (XP) for Data and Machine Learning Cadets participating in Google Developer Group On Campus PUP's learning programs.\n\n## 📋 Table of Contents\n- [Overview](#overview)\n- [Features](#features)\n- [Technology Stack](#technology-stack)\n- [Project Structure](#project-structure)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Development](#development)\n\n## Overview\nXParkyTracker simplifies the process of tracking learner progress and achievements in the Data and ML learning path. The application helps mentors and organizers monitor cadet progress through various activities, certifications, and projects.\n\n### Key Objectives\n- Track cadet progress through learning milestones\n- Monitor completion of certifications and badges\n- Calculate and manage experience points\n- Provide insights into learning progress\n- Facilitate assessment of learning achievements\n\n## Features\n\n### XP Tracking\n- **Certificate Tracking**: Record and validate completed certificates\n- **Badge Management**: Track earned badges from learning platforms\n- **Project Submissions**: Monitor and grade project submissions\n- **Point Calculation**: Automated XP calculation based on achievements\n- **Progress Dashboard**: Visual representation of cadet progress\n\n### Administrative Features\n- **Achievement Verification**: Validate submitted certificates and badges\n- **Points Configuration**: Customize point values for different achievements\n- **Progress Reports**: Generate individual and group progress reports\n\n## Technology Stack\n- **Frontend \u0026 Backend**: Streamlit\n- **Programming Language**: Python 3.9\n- **Data Processing**: Pandas \n- **Development Environment**: Dev Container support\n- **Version Control**: Git\n\n## Project Structure\n```\nXParkyTracker/\n├── .devcontainer/       # Development container configuration\n├── .streamlit/          # Streamlit configuration\n├── assets/             # Static assets and resources\n├── src/                # Source code directory\n│   ├── __init__.py\n│   ├── points.py       # XP calculation logic\n│   ├── validators.py   # Certificate/badge validation\n│   └── utils.py        # Utility functions\n├── app.py              # Main Streamlit application\n└── requirements.txt    # Python dependencies\n```\n\n## Installation\n\n### Prerequisites\n- Python 3.9\n- Git\n- Google Cloud credentials (for Google Sheets integration)\n\n### Local Setup\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/username/XParkyTracker.git\n   cd XParkyTracker\n   ```\n\n2. Create a virtual environment:\n   ```bash\n   python -m venv venv\n   source venv/bin/activate  # On Windows: venv\\Scripts\\activate\n   ```\n\n3. Install dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. Configure Google Sheets credentials:\n   - Reach out to me for credentials\n\n## Usage\n\n### Starting the Application\n```bash\nstreamlit run app.py\n```\n\n### For Cadets\n1. Submit certificates and badges through the interface\n2. View current XP status\n3. Track progress towards learning goals\n4. Access performance insights\n\n### For Administrators\n1. Verify submitted achievements\n2. Monitor cadet progress\n3. Generate progress reports\n4. Manage point configurations\n\n## Development\n\n### Point System Configuration\nPoints are awarded for different achievements:\n- Certificates: 100\n- Badges: 100\n- Projects: 150\n- Attendance/Answers Eval Forms: 200\n\n### Adding New Features\n1. Create feature branch\n2. Implement functionality\n3. Add appropriate tests\n4. Submit pull request\n\n### Code Style Guidelines\n- Follow PEP 8\n- Include docstrings\n- Comment complex logic\n- Use type hints\n\n## Configuration\n\n### Streamlit Settings\nConfigure in `.streamlit/config.toml`:\n```toml\n[theme]\nprimaryColor = \"#...\"\nbackgroundColor = \"#...\"\nsecondaryBackgroundColor = \"#...\"\ntextColor = \"#...\"\n```\n\n### Google Sheets Integration\nRequired environment variables:\n```\nGOOGLE_SHEETS_CREDENTIALS=...\nSPREADSHEET_ID=...\n```\n\n## Contributing\n1. Fork repository\n2. Create feature branch\n3. Implement changes\n4. Submit pull request\n\n## Support\nFor support:\n- Create GitHub issue\n- Contact GDG On Campus PUP organizers\n- Reach out to project maintainers\n\n---\n\n**Note**: This documentation is maintained by the GDG On Campus PUP Data and ML track team. For questions about the learning program itself, please contact the GDG organizers directly.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjpcurada%2Fxparky-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjpcurada%2Fxparky-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjpcurada%2Fxparky-tracker/lists"}