Skip to content

Commit 51b129e

Browse files
docs: update README
1 parent d11a498 commit 51b129e

File tree

2 files changed

+91
-2
lines changed

2 files changed

+91
-2
lines changed

README.md

Lines changed: 90 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,90 @@
1-
# simple-nest-project
1+
# Forum
2+
![TypeScript](https://img.shields.io/badge/typescript-%23007ACC.svg?style=for-the-badge&logo=typescript&logoColor=white&logoWidth=20)
3+
![NestJS](https://img.shields.io/badge/nestjs-%23E0234E.svg?style=for-the-badge&logo=nestjs&logoColor=white&logoWidth=20)
4+
![Prisma](https://img.shields.io/badge/Prisma-3982CE?style=for-the-badge&logo=Prisma&logoColor=white&logoWidth=20)
5+
![Docker](https://img.shields.io/badge/docker-%230db7ed.svg?style=for-the-badge&logo=docker&logoColor=white&logoWidth=20)
6+
![Redis](https://img.shields.io/badge/redis-%23DD0031.svg?style=for-the-badge&logo=redis&logoColor=white&logoWidth=20)
7+
8+
9+
This repository handles the server-side functionalities of an educational forum. Built with Domain-Driven Design (DDD) and Clean Architecture principles. The backend is responsible for managing user authentication, handling discussion threads, and storing and retrieving data. This backend serves as the core for collaboration between students and teachers, providing a API to manage questions, answers, notifications, and other features.
10+
11+
## 📋 Contents
12+
13+
- [🛠️ Features](#️-features)
14+
- [🚀 Technologies Used](#-technologies-used)
15+
- [💾 Setup and Installation](#-setup-and-installation)
16+
- [⚙️ How to Run](#️-how-to-run)
17+
- [🧪 Running Tests](#-running-tests)
18+
19+
## 🛠️ Features
20+
21+
- User registration and authentication.
22+
- Create, edit, and delete questions and answers.
23+
- Comment on questions and answers.
24+
- Mark the best answer for a question.
25+
- Notifications for key forum interactions.
26+
- File uploads and attachment management by Cloudflare R2.
27+
28+
- ## 🚀 Technologies Used
29+
30+
- [Nest.js](https://nestjs.com) - A progressive Node.js framework.
31+
- [Prisma](https://www.prisma.io) - ORM for database access.
32+
- [Vitest](https://vitest.dev) - Unit and e2e testing.
33+
- [Docker](https://www.docker.com) - Containerization for execution.
34+
- [Redis](https://redis.io) - Caching for performance optimization.
35+
- [CloudFlare R2](https://www.cloudflare.com/pt-br/) - Upload and storage of attachments
36+
37+
## 💾 Setup and Installation
38+
39+
1. **Clone the repository:**
40+
```bash
41+
git clone https://github.com/DanielF-Cardoso/forum-nest.git
42+
```
43+
2. **Run Docker:** To use Redis and Postgress services with Docker
44+
```bash
45+
docker-compose up -d
46+
```
47+
3. **Set up environment variables:** Create a .env file based on the provided example
48+
```bash
49+
cp .env-example .env
50+
```
51+
4. **Install dependencies:**
52+
```bash
53+
npm install
54+
```
55+
5. **Set up the database:** Ensure Prisma is properly configured and apply migrations
56+
```bash
57+
npx prisma migrate dev
58+
```
59+
60+
## ⚙️ How to Run
61+
62+
1. **Run the application locally:**
63+
```bash
64+
npm run start:dev
65+
```
66+
67+
## 🧪 Running Tests
68+
69+
- **Run the Unit test:**
70+
```bash
71+
npm run test
72+
```
73+
- **Run the Unit tests in watch mode:**
74+
```bash
75+
npm run test:watch
76+
```
77+
- **Run the Unit tests with coverage:**
78+
```bash
79+
npm run test:cov
80+
```
81+
- **Run end-to-end tests:**
82+
```bash
83+
npm run test:e2e
84+
```
85+
- **Run end-to-end tests in watch mode:**
86+
```bash
87+
npm run test:watch
88+
```
89+
90+

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
2-
"name": "05-nest-clean",
2+
"name": "forum-nest",
33
"version": "0.0.1",
44
"description": "",
55
"author": "",

0 commit comments

Comments
 (0)