Skip to content

Commit 775217f

Browse files
committed
Update readme
1 parent 3b1a239 commit 775217f

File tree

1 file changed

+69
-0
lines changed

1 file changed

+69
-0
lines changed

Diff for: README.md

+69
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
# BiT-Forum Backend
2+
3+
Welcome to the BiT-Forum Backend repository! This project serves as the backend for an online forum dedicated to the Bahir Dar Institute of Technology (BiT), built using Django REST framework.
4+
5+
## Purpose
6+
7+
We built is as part of our final-year project but we wanted to open-source it to foster collaboration and learning among BiT students and teachers. By contributing to this project, students can gain hands-on experience with real-world software development and help enhance the forum with new features and improvements.
8+
9+
## Vision
10+
11+
We envision this forum to be a comprehensive platform for students and teachers to engage in discussions, share resources, and collaborate on projects. Your contributions can help make this vision a reality, whether by adding new features, improving existing functionality, or fixing bugs.
12+
13+
## Features
14+
15+
- Role-based access control for students, teachers, and faculty admins of the university.
16+
- Question and answer platform with features to upvote, downvote, comment, etc.
17+
- Resource sharing. You can share files, assignments, notes, links etc.
18+
- Reward system through badges and reputation. Similar to StackOverflow.
19+
- Notification updates.
20+
- AI assistant and AI-driven profanity checks.
21+
22+
## Technologies Used
23+
24+
- Django
25+
- Django REST framework
26+
- PostgreSQL
27+
28+
## Quick Start
29+
30+
First Clone this repository to your local machine and create a `.env` file. Copy the contents of `.env.example` file found in the root directory of the project to `.env` and update the environment variables accordingly. Then you can start the project by following the commands below:
31+
32+
1. Create a Python virtual environment and activate it.
33+
2. Open up your terminal and run the following command to install the packages used in this project.
34+
35+
```shell
36+
$ pip install -r requirements.txt
37+
```
38+
39+
3. Set up a Postgres database for the project.
40+
4. Run the following commands to setup the database tables and create a superuser.
41+
42+
```shell
43+
$ python manage.py migrate
44+
$ python manage.py createsuperuser
45+
```
46+
47+
5. Start the development server:
48+
49+
```shell
50+
$ python manage.py runserver
51+
```
52+
53+
## API Documentation
54+
55+
API documentation is provided using redoc. You can access the documentation at http://localhost:8000 once the server is running.
56+
57+
## Contributing
58+
59+
We welcome the BiT community to contribute to this project whether that is providing new features or bug fixes. Please see our CONTRIBUTING.md for details on how to contribute to this project.
60+
61+
## License
62+
63+
This project is licensed under the MIT License - see the LICENSE file for details.
64+
65+
## Contact
66+
67+
If you have any questions or feedback, please open an issue or contact the project maintainers.
68+
69+
Thank you for using BiT-Forum Backend! Happy coding!

0 commit comments

Comments
 (0)