A comprehensive digital platform for storing, managing, and discovering research papers authored by BRAC University faculty members and students.
The Research Paper Repository for BRAC University is a centralized digital platform designed to store, manage, and search research papers. It provides a structured and efficient way to submit, approve, and share research outputs while ensuring high data integrity, quick retrieval, and effective categorization.
- Paper Submission: Comprehensive form with supervisor/co-supervisor fields and dynamic categories
- Advanced Search: Search by title, author, department, research category, or publication year
- Dynamic Categories: User-created research categories (AI, Machine Learning, Cybersecurity, etc.)
- Approval Workflow: Admin approval system for quality control
- Author Management: Direct name input for corresponding authors and co-authors
- Academic Structure: Authentic BRAC University departments and schools
- File Upload: Secure PDF upload and download system (10MB limit)
- Real-time Statistics: Dynamic statistics from database
- Profile Management: User profile viewing and editing
- Authentication: JWT-based authentication with role-based access control
- Responsive Design: Mobile-friendly interface with Bootstrap 5
- Backend: Node.js with Express.js
- Database: MySQL (bracu_repo)
- Frontend: React.js with Bootstrap 5
- File Storage: Local file system (configurable for cloud storage)
- Authentication: JWT tokens with bcrypt password hashing
- Node.js (v16 or higher)
- MySQL (XAMPP/WAMP/LAMP)
- npm or yarn package manager
For Linux/Mac:
chmod +x setup.sh
./setup.shFor Windows:
setup.batgit clone <repository-url>
cd BracuLabRepo_Project# Install backend dependencies
npm install
# Install frontend dependencies
cd client
npm install
cd ..Create a .env file in the root directory:
PORT=5000
DB_HOST=localhost
DB_USER=root
DB_PASSWORD=
DB_NAME=bracu_repo
DB_PORT=3306
NODE_ENV=development
JWT_SECRET=your-super-secret-jwt-key-here
UPLOAD_PATH=./uploads
MAX_FILE_SIZE=10485760
CORS_ORIGIN=http://localhost:3000- Start your MySQL server (XAMPP/WAMP/LAMP)
- Create a database named
bracu_repo - Import the database schema:
mysql -u root -p bracu_repo < database_schema.sql
cd client
npm run build
cd ..Development Mode:
# Terminal 1: Start backend server
npm run dev
# Terminal 2: Start frontend (optional for development)
npm run clientProduction Mode:
npm start- β View all approved research papers
- β Search and filter papers
- β Download paper files
- β Browse by department/faculty
- β Submit new research papers
- β Edit their own papers
- β View submission status
- β Manage paper versions
- β Upload PDF files
- β Approve/reject paper submissions
- β View all papers (including pending)
- β Add admin notes to decisions
- β Access admin panel
- β Manage user accounts
GET /api/papers- Get approved papersGET /api/papers/:id- Get specific approved paperGET /api/search- Search approved papers with category filteringGET /api/departments- Get BRAC University departmentsGET /api/faculties- Get BRAC University schoolsGET /api/categories- Get dynamic research categoriesGET /api/stats- Get real-time dashboard statistics
POST /api/auth/login- User loginPOST /api/auth/register- User registrationGET /api/auth/profile- Get user profilePUT /api/auth/profile- Update user profilePOST /api/papers- Submit new paper with supervisor fields (Author/Admin)PUT /api/papers/:id- Update paper (Author/Admin)DELETE /api/papers/:id- Delete paper (Author/Admin)
GET /api/admin/papers- Get all papers (including pending)PUT /api/admin/papers/:id/status- Approve/reject paperGET /api/admin/pending-count- Get pending papers count
The application uses the following main tables:
users- User accounts with roles (admin/author)papers- Research paper information with supervisor fields and dynamic categoriesdepartments- BRAC University departments (8 authentic departments)faculties- BRAC University schools (6 schools)co_authors- Co-author relationships with namespaper_versions- Version history tracking
- 8 Departments: Architecture, CSE, ESS, EEE, ENH, Law, MNS, Pharmacy
- 6 Schools: Architecture & Design, Data & Sciences, Humanities & Social Sciences, Engineering, Law, Pharmacy
- JWT Authentication: Secure token-based authentication
- Password Hashing: Bcrypt password encryption
- Role-Based Access: Different permissions for different user roles
- Input Validation: Server-side validation for all inputs
- CORS Protection: Configured CORS for security
- File Upload Security: PDF-only uploads with size limits
- Helmet.js: Security headers protection
The application is fully responsive and works on:
- Desktop computers
- Tablets
- Mobile devices
- All modern browsers
npm run devnpm run build
npm startNODE_ENV=production
PORT=5000
DB_HOST=your-production-db-host
DB_USER=your-production-db-user
DB_PASSWORD=your-secure-password
DB_NAME=bracu_repo
JWT_SECRET=your-super-secure-jwt-secret
CORS_ORIGIN=https://your-domain.com- Update database schema
- Modify backend API
- Update frontend forms
- Adjust validation rules
- Modify
client/src/index.cssfor global styles - Update component-specific CSS
- Customize Bootstrap variables
- Add new API endpoints
- Create new React components
- Update routing configuration
- Modify database schema as needed
-
Database Connection Error
- Verify MySQL is running
- Check database credentials in
.env - Ensure database
bracu_repoexists - Import
database_schema.sql
-
Port Already in Use
- Change PORT in
.envfile - Kill existing processes on port 5000
- Change PORT in
-
Frontend Build Errors
- Clear
node_modulesand reinstall - Check Node.js version compatibility
- Verify all dependencies are installed
- Clear
-
File Upload Issues
- Check file size limits (10MB max)
- Verify upload directory permissions
- Ensure PDF file type validation
- Check multer configuration
-
Authentication Errors
- Check JWT_SECRET in
.env - Verify token expiration
- Check user role permissions
- Check JWT_SECRET in
- β Backend API: Complete with 19 endpoints and authentication
- β Frontend UI: Complete responsive React.js interface
- β Database Schema: Complete with BRAC University structure
- β File Upload: Secure PDF validation and storage
- β Authentication: JWT-based with role-based access control
- β Dynamic Features: Real-time statistics and user-created categories
- β Academic Integration: Supervisor fields and authentic department structure
- β Error Handling: Comprehensive error pages and user feedback
- β Performance: Optimized build with compression and security headers
- β Documentation: Complete setup, deployment, and API guides
- β Production Ready: Fully tested and optimized for deployment
For technical support or questions:
- Email: zarif.latif.biz@gmail.com
This project is licensed under the MIT License - see the LICENSE file for details.
- BRAC University for the project requirements
- Open source community for the technologies used
- Contributors and developers involved in the project
- Push to GitHub:
git init
git add .
git commit -m "Initial commit: BRACU Research Repository"
git branch -M main
git remote add origin https://github.com/YOUR_USERNAME/bracu-research-repository.git
git push -u origin main-
Deploy Frontend (Vercel):
- Go to vercel.com
- Import from GitHub
- Select your repository
- Auto-deploys on every push
-
Setup Database (PlanetScale):
- Go to planetscale.com
- Create database:
bracu-research-repo - Import
database_schema.sql - Get connection string
-
Configure Environment:
- Add environment variables in Vercel
- Update database connection
- Deploy and test
bracu-research-repository/
βββ client/ # React.js frontend
βββ uploads/ # PDF file storage
βββ server.js # Express.js backend
βββ database_schema.sql # MySQL database setup
βββ package.json # Backend dependencies
βββ .env.example # Environment template
βββ .gitignore # Git ignore rules
βββ README.md # This file