🚀 Go-Epic — Full Stack Coding Platform

A scalable full-stack coding platform for practicing, managing, and organizing coding problems, datasets, solutions, and learning resources.

---

📖 Overview

Go-Epic is a full-stack coding platform built with Golang, React, and Tailwind CSS that helps developers manage coding problems, datasets, topics, and solutions through scalable APIs and a modern frontend interface.

The platform provides authentication, protected routes, search capabilities, analytics APIs, dataset management, and role-based access control.

Core Objectives

• Create a scalable coding platform architecture
• Provide structured problem management
• Enable secure authentication flows
• Support dataset import/export operations
• Deliver responsive frontend experiences
• Offer analytics and monitoring capabilities

---

✨ Features

Backend Features:-

✅ RESTful API Architecture
✅ CRUD Operations
✅ JWT Authentication & Authorization
✅ Role-Based Access Control
✅ Protected Routes
✅ Middleware Support
✅ Validation Layer
✅ Pagination, Filtering & Sorting
✅ Search APIs
✅ Statistics APIs
✅ Error Handling
✅ API Metrics
✅ Health Monitoring
✅ Rate Limiting

Frontend Features:-

✅ Responsive Design
✅ React Component Architecture
✅ API Integration Layer
✅ Authentication UI
✅ Search Interface
✅ Dashboard Pages
✅ Dataset Explorer
✅ Admin Management Views

---

🏗 System Architecture

graph TD

A[React Frontend]
B[REST API Layer]
C[Authentication Service]
D[Business Logic]
E[Database]
F[Datasets]

A --> B
B --> C
B --> D
D --> E
D --> F

Loading

---

🛠 Tech Stack

Layer	Technology
Frontend	React.js
Styling	Tailwind CSS
Backend	Golang
API	REST
Authentication	JWT
State Management	React Hooks / Context
HTTP Client	Axios
Database	MongoDB
Deployment	Render / Railway / Vercel

---

📂 Project Structure

go-epic/

├── backend/
│   ├── cmd/
│   ├── config/
│   ├── controllers/
│   ├── middleware/
│   ├── models/
│   ├── routes/
│   ├── services/
│   ├── utils/
│   └── main.go
│
├── frontend/
│   ├── public/
│   ├── src/
│   │   ├── components/
│   │   ├── hooks/
│   │   ├── pages/
│   │   ├── services/
│   │   └── App.jsx
│
└── README.md

---

⚙ Installation

Clone Repository

git clone <repo-url>

cd go-epic

---

Backend Setup

cd backend

go mod tidy

go run main.go

Backend runs on:

http://localhost:8080

---

Frontend Setup

cd frontend

npm install

npm run dev

Frontend runs on:

http://localhost:5173

---

🔐 Environment Variables

Create .env

PORT=8080

DB_URI=your_database_uri

JWT_SECRET=secret_key

REFRESH_SECRET=refresh_key

CLIENT_URL=http://localhost:5173

RATE_LIMIT=100

---

🔑 Authentication Flow

sequenceDiagram

User->>Frontend: Login

Frontend->>Backend: Credentials

Backend->>Auth Service: Validate

Auth Service-->>Backend: Generate JWT

Backend-->>Frontend: Access Token

Frontend->>Protected APIs: Attach Token

Loading

---

🌐 API Base URL

http://localhost:8080/api/v1

---

📚 API Documentation

Problems API

Method	Route	Purpose
GET	/problems	Fetch all problems
POST	/problems	Create problem
PATCH	/problems/	Update problem
DELETE	/problems/	Delete problem

Authentication API

Method	Route
POST	/auth/register
POST	/auth/login
POST	/auth/logout
GET	/auth/profile

Search API

Endpoint	Description
/search/problems?q=keyword	Search problems
/search/topics?q=query	Search topics
/search/solutions?q=query	Search solutions

Statistics API

Route
/stats/problems
/stats/topics
/stats/datasets

---

📊 Dataset Import

1. Download dataset
2. Place file inside:

backend/datasets/

3. Import:

POST /problems/import-json

---

📥 Example API Request

POST /auth/login

{
  "email":"demo@gmail.com",
  "password":"password123"
}

Response:

{
   "success": true,
   "token":"jwt_token"
}

---

❌ Error Response

{
   "success": false,
   "message": "Validation Failed"
}

---

🚦 Rate Limiting

Applied on:

• Authentication APIs
• Search Endpoints
• Bulk Operations
• Admin Routes

Example:

100 requests / minute

---

🧪 Testing

Backend:

go test ./...

Frontend:

npm run test

---

🚀 Deployment

Service	Platform
Backend	Railway / Render
Frontend	Vercel / Netlify
Database	MongoDB Atlas

Build frontend:

npm run build

---

🔮 Future Roadmap

• Contest System
• Leaderboards
• AI Recommendations
• Discussion Forums
• Multi-language Support
• Real-time Collaboration

---

🤝 Contributing

fork repository

create feature branch

commit changes

push branch

create pull request

---

📄 License

Licensed under the MIT License.

---

Built using ❤️ with Golang, React, and Tailwind CSS