{"id":26886218,"url":"https://github.com/yashisrani/college-management","last_synced_at":"2026-05-15T12:06:44.842Z","repository":{"id":273648191,"uuid":"919079323","full_name":"yashisrani/College-Management","owner":"yashisrani","description":"A simple and efficient system to manage students, courses, faculties, and departments. Supports CRUD operations, authentication, and role-based access control. Designed for scalability and easy integration.","archived":false,"fork":false,"pushed_at":"2025-05-01T07:41:48.000Z","size":34288,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-22T00:35:41.956Z","etag":null,"topics":["fresh","gin-framework","githubactions","go-api","golang","grafana-dashboard","jwt-authentication","logres","postgres","prometheus-metrics","swagger-ui"],"latest_commit_sha":null,"homepage":"","language":"Go","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/yashisrani.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-01-19T16:51:30.000Z","updated_at":"2025-05-01T07:41:51.000Z","dependencies_parsed_at":"2025-05-01T08:38:25.757Z","dependency_job_id":null,"html_url":"https://github.com/yashisrani/College-Management","commit_stats":null,"previous_names":["yashisrani/go-backend-gin-","yashisrani/gobackend","yashisrani/college-management"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/yashisrani/College-Management","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashisrani%2FCollege-Management","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashisrani%2FCollege-Management/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashisrani%2FCollege-Management/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashisrani%2FCollege-Management/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yashisrani","download_url":"https://codeload.github.com/yashisrani/College-Management/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashisrani%2FCollege-Management/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33066157,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T11:35:32.926Z","status":"ssl_error","status_checked_at":"2026-05-15T11:35:31.362Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["fresh","gin-framework","githubactions","go-api","golang","grafana-dashboard","jwt-authentication","logres","postgres","prometheus-metrics","swagger-ui"],"created_at":"2025-03-31T19:15:20.636Z","updated_at":"2026-05-15T12:06:44.813Z","avatar_url":"https://github.com/yashisrani.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# College Management System\nA simple and efficient system to manage students, courses, faculties, and departments. Supports CRUD operations, authentication, and role-based access control. Designed for scalability and easy integration.​\n\n## Features 🪄🌟\n- **Student Management**: Add, update, view, and delete student records.\n\n- **Course Management**: Manage course details and enrollments.\n\n- **Faculty Management**: Handle faculty profiles and assignments.\n\n- **Department Management**: Organize departments and associated data.\n\n- **Authentication**: Secure login system with JWT-based authentication.\n\n- **Role-Based Access Control**: Assign roles and permissions to users.\n\n- **API Documentation**: Integrated Swagger UI for API exploration.\n\n- **Monitoring**: Prometheus metrics and Grafana dashboards for system monitoring\n\n## Technologies Used 👨🏻‍💻\n- **Backend**: Go (Golang) with Gin framework\n\n- **Database**: PostgreSQL\n\n- **Authentication**: JWT (JSON Web Tokens)\n\n- **API Documentation**: Swagger UI\n\n- **Monitoring**: Prometheus and Grafana\n\n- **Containerization**: Docker and Docker Compose\n\n- **CI/CD**: GitHub Actions​\n\n## Folder Structure\n`api/` - API route definitions\n\n`controllers/` - Request handlers and business logic\n\n`model/` - Database models and schemas\n\n`store/` - Database interactions and queries\n\n`middleware/` - Custom middleware functions\n\n`utils/` - Utility functions and helpers\n\n`deployment/` - Deployment configurations\n\n`docs/`- API documentation and related files\n\n## Getting Started\n### Prerequisites\n- Go installed on your machine\n\n- Docker and Docker Compose installed\n\n- PostgreSQL database setup​ (Use Postgres Docker Image)\n\n#### Installation\n1) Clone the repository:\n\n```\ngit clone https://github.com/yashisrani/College-Management.git\n\ncd College-Management\n\ngo run cmd/main.go\n```\n\n2) Set up environment variables:\n\n- Create a .env file in the root directory and configure the necessary environment variables as per your setup.\n\n3) Run the application using Docker Compose:\n\n```\ndocker-compose up --build\n```\n\n4) Access the application:\n\n- API endpoints will be available at `http://localhost:8080/api`\n\n- Swagger UI can be accessed at` http://localhost:8080/swagger/index.html`\n\n- Grafana dashboards (if configured) will be available at `http://localhost:3000​`\n\n## ScreenShots\n\n\u003cimg width=\"1440\" alt=\"Screen Shot 2025-05-01 at 12 57 43 PM\" src=\"https://github.com/user-attachments/assets/f3ca557e-c3a3-4727-a75e-57592c5b2d37\" /\u003e\n\u003cimg width=\"1440\" alt=\"Screen Shot 2025-05-01 at 12 57 49 PM\" src=\"https://github.com/user-attachments/assets/387b2bab-cab6-4e8e-a4e8-8e68832fe9fa\" /\u003e\n\u003cimg width=\"1440\" alt=\"Screen Shot 2025-05-01 at 12 57 59 PM\" src=\"https://github.com/user-attachments/assets/afda27b9-b583-4efa-9622-17d0db687e58\" /\u003e\n\n\n\u003cimg width=\"1440\" alt=\"Screen Shot 2025-03-15 at 10 22 04 PM\" src=\"https://github.com/user-attachments/assets/28cdb19d-8d71-41ba-85ec-9a627c8fa605\" /\u003e\n\n\u003cimg width=\"1434\" alt=\"Screen Shot 2025-03-16 at 2 24 48 PM\" src=\"https://github.com/user-attachments/assets/3a0c9232-37d7-4cc5-a596-6bd49b89697d\" /\u003e\n\u003cimg width=\"1440\" alt=\"Screen Shot 2025-03-15 at 10 18 48 PM\" src=\"https://github.com/user-attachments/assets/5cec9644-f157-40c3-8b5a-5b9067c335b6\" /\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyashisrani%2Fcollege-management","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyashisrani%2Fcollege-management","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyashisrani%2Fcollege-management/lists"}