You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+35-16Lines changed: 35 additions & 16 deletions
Original file line number
Diff line number
Diff line change
@@ -28,16 +28,22 @@
28
28
29
29
## <aname="introduction">🤖 Introduction</a>
30
30
31
-
Built using Java 17 and Spring Boot, the mail is central to all notification functions using mail within a system, ensuring scalability and enhancing user experience through various features.
31
+
Bloggios Mail Service, constructed with Java 17, Spring Boot, Java Mail, and Kafka, facilitates seamless email
32
+
notifications in HTML format using Thymeleaf. This robust combination allows for efficient handling of email
performance and scalability. With its integration of Thymeleaf, personalized and visually appealing email templates can
35
+
be effortlessly created and dispatched. Bloggios Mail Service simplifies the process of sending dynamic email
36
+
notifications, making it an indispensable tool for various applications and businesses.
32
37
33
38
## Key Features
34
39
35
-
-**Consuming Kafka Events**: Automatically sending mail as soon as receiving any event from Kafka.
36
-
-**Sending HTML Mails**: Sending mails in more user friendly Interface with Thymeleaf.
37
-
-**Persisting Mail Records**: Persisting each and every record of mails in Postgres Database
38
-
-**OTP Management**: Handles the generation and validation of one-time passwords for 2FA or account recovery, adding an extra layer of security.
40
+
-**HTML Email Support:** Enables sending of visually rich HTML-formatted emails.
41
+
-**Thymeleaf Integration:** Utilizes Thymeleaf for easy creation of dynamic and personalized email templates.
42
+
-**Asynchronous Processing with Kafka:** Enhances performance by leveraging Kafka for asynchronous message processing.
43
+
-**Java Mail API:** Integrates Java Mail API for reliable and efficient email handling.
39
44
40
-
Join our newly active Discord community for support, bug reporting, and feature requests. Here, we strive to address every issue, and developers and testers can collaborate and assist each other effectively.
45
+
Join our newly active Discord community for support, bug reporting, and feature requests. Here, we strive to address
46
+
every issue, and developers and testers can collaborate and assist each other effectively.
@@ -48,13 +54,13 @@ Join our newly active Discord community for support, bug reporting, and feature
48
54
- Java 17
49
55
- Spring Boot
50
56
- PostgreSQL
51
-
- Elasticsearch
52
-
- OAuth2.0
53
57
- Kafka
54
58
55
59
## <aname="documentation">🔋 API Documentation</a>
56
60
57
-
To help you get started with our API and understand all its features and endpoints, we have created detailed documentation available on Postman. This documentation includes comprehensive information about each endpoint, including:
61
+
To help you get started with our API and understand all its features and endpoints, we have created detailed
62
+
documentation available on Postman. This documentation includes comprehensive information about each endpoint,
63
+
including:
58
64
59
65
-**Endpoint URLs**: Specific paths to access various functionalities.
60
66
-**HTTP Methods**: The method type (GET, POST, PUT, DELETE, etc.) for each endpoint.
@@ -66,12 +72,16 @@ To help you get started with our API and understand all its features and endpoin
2.**Explore the Collection**: Navigate through the collection to find detailed descriptions and examples for each endpoint.
70
-
3.**Run Requests Directly in Postman**: Use the "Run in Postman" button to directly import the collection into your Postman workspace for testing and exploration.
75
+
2.**Explore the Collection**: Navigate through the collection to find detailed descriptions and examples for each
76
+
endpoint.
77
+
3.**Run Requests Directly in Postman**: Use the "Run in Postman" button to directly import the collection into your
78
+
Postman workspace for testing and exploration.
71
79
72
-
By leveraging the Postman documentation, you can quickly integrate our API into your application and take full advantage of its capabilities.
80
+
By leveraging the Postman documentation, you can quickly integrate our API into your application and take full advantage
81
+
of its capabilities.
73
82
74
-
For any further assistance, feel free to contact our support team or refer to the additional resources section in the documentation.
83
+
For any further assistance, feel free to contact our support team or refer to the additional resources section in the
84
+
documentation.
75
85
76
86
## <aname="quick-start">🤸 Quick Start</a>
77
87
@@ -101,6 +111,7 @@ We recommended Intellij Idea
101
111
102
112
Make sure you have Java 17 Installed in your system
103
113
Please execute the below command to check installed version of Java in your system
114
+
104
115
```bash
105
116
java --version
106
117
```
@@ -110,6 +121,7 @@ java --version
110
121
Navigate to `src/main/resources/application.yml` and add the required environment variables
111
122
112
123
If you are new at setting environment variables the please go through the below videos
124
+
113
125
- Intellij Idea [See Video](https://www.youtube.com/watch?v=jNOh4jQJG2U)
114
126
- Eclipse or STS [See Video](https://www.youtube.com/watch?v=ypvGDkbp8Ac)
115
127
@@ -119,6 +131,10 @@ POSTGRES_DATABASE -> Postgresql Database name
119
131
POSTGRES_HOST -> Postgres Database Host
120
132
POSTGRES_PASSWORD -> Postgres Database Password
121
133
POSTGRES_USERNAME -> Postgresq Database Username
134
+
MAIL_HOST -> Mail Host
135
+
MAIL_PORT
136
+
MAIL_USERNAME -> Username of Mail
137
+
MAIL_PASSWORD -> Password of Mail
122
138
```
123
139
124
140
Replace the placeholder values with your actual credentials
@@ -141,9 +157,11 @@ If you wish to contribute, you can,
141
157
- Improve documentation.
142
158
- Create content about Bloggios and share it with the world.
143
159
144
-
> Please read [`CONTRIBUTING`](CONTRIBUTING.md) for details on our [`CODE OF CONDUCT`](CODE_OF_CONDUCT.md), and the process for submitting pull requests to us.
160
+
> Please read [`CONTRIBUTING`](CONTRIBUTING.md) for details on our [`CODE OF CONDUCT`](CODE_OF_CONDUCT.md), and the
161
+
> process for submitting pull requests to us.
145
162
146
-
🆕 New to Open Source? 💡 Follow this [guide](https://opensource.guide/how-to-contribute/) to jumpstart your Open Source journey 🚀.
163
+
🆕 New to Open Source? 💡 Follow this [guide](https://opensource.guide/how-to-contribute/) to jumpstart your Open Source
164
+
journey 🚀.
147
165
148
166
## <aname="links">🔗 Links</a>
149
167
@@ -156,7 +174,8 @@ If you wish to contribute, you can,
156
174
157
175
## <aname="support">🙏Support</a>
158
176
159
-
We all need support and motivation. `Bloggios` is not an exception. Please give this project repositories a ⭐️ to encourage and show that you liked it. Don't forget to leave a star ⭐️ before you move away.
177
+
We all need support and motivation. `Bloggios` is not an exception. Please give this project repositories a ⭐️ to
178
+
encourage and show that you liked it. Don't forget to leave a star ⭐️ before you move away.
160
179
161
180
If you found the app helpful, consider supporting us with a coffee.
0 commit comments