Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pieceowater-dev/lotof.template.service
This project is a microservice built using the NestJS framework. It serves as a central point for handling requests and routing them to appropriate microservices.
https://github.com/pieceowater-dev/lotof.template.service
backend hub lotof service
Last synced: 5 days ago
JSON representation
This project is a microservice built using the NestJS framework. It serves as a central point for handling requests and routing them to appropriate microservices.
- Host: GitHub
- URL: https://github.com/pieceowater-dev/lotof.template.service
- Owner: pieceowater-dev
- License: mit
- Created: 2024-07-17T10:58:55.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-08-24T13:46:55.000Z (3 months ago)
- Last Synced: 2024-08-24T14:55:40.773Z (3 months ago)
- Topics: backend, hub, lotof, service
- Language: TypeScript
- Homepage:
- Size: 274 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# lotof.template.service
## Description
🚀 This project is a microservice built using the NestJS framework. It serves as a central point for handling requests and routing them to appropriate microservices. The microservice also integrates with RabbitMQ for message brokering.
🔌 With its modular architecture, the microservice enables seamless communication between different services, ensuring efficient and scalable application development.
🔒 By leveraging the power of NestJS, developers can easily implement authentication, request validation, and other common functionalities in a declarative manner.
🐇 The integration with RabbitMQ allows for reliable and asynchronous communication, enabling the microservice to handle high volumes of requests with ease.
🏗️ Whether you're building a monolithic application or a distributed system, this microservice provides a robust foundation for your project.
## Installation
### Docker Installation
To pull the Docker image from the GitHub Container Registry:
1 - Login to ghcr.io
```bash
echo "YOUR_GITHUB_TOKEN" | docker login ghcr.io -u YOUR_GITHUB_USERNAME --password-stdin
```
2 - Go to [GitHub Packages](https://github.com/orgs/pieceowater-dev/packages) menu and copy the command to pull the image
### Manual Installation
To install the dependencies, run:
```bash
npm install
```
## Running the Application
### Development Mode
To start the application in development mode with hot-reloading:
```bash
npm run start:dev
```
### Production Mode
To start the application in production mode:
```bash
npm run start:prod
```
### Debug Mode
To start the application in debug mode:
```bash
npm run start:debug
```
## Environment Variables
The application uses the following environment variables, which should be defined in a [`.env`](.env) file at the root of the project:
```properties
PORT=3001
MODE=dev
RABBITMQ_URL=amqp://guest:guest@localhost:5672
DATABASE_URL=postgres://postgres:dima3raza@localhost:5432/template
```
## Scripts
The following scripts are available in the [`package.json`](package.json):
#### Update dependencies.
```bash
npm run update
```
#### Build the project.
```bash
npm run build
```
#### Format the code using Prettier.
```bash
npm run format
```
#### Start the application.
```bash
npm run start
```
#### Start the application in development mode.
```bash
npm run start:dev
```
#### Update ```@pieceowater-dev/lotof.lib.broadcaster``` dependency to latest version and start the application in development mode.
```bash
npm run start:dev:updt
```
#### Start the application in debug mode.
```bash
npm run start:debug
```
#### Start the application in production mode.
```bash
npm run start:prod
```
#### Lint the code using ESLint.
```bash
npm run lint
```
#### Run unit tests.
```bash
npm run test
```
#### Run unit tests in watch mode.
```bash
npm run test:watch
```
#### Run unit tests with coverage.
```bash
npm run test:cov
```
#### Run unit tests in debug mode.
```bash
npm run test:debug
```
#### Run end-to-end tests.
```bash
npm run test:e2e
```
## Testing
To run the unit tests:
```bash
npm run test
```
To run the unit tests in watch mode:
```bash
npm run test:watch
```
To run the unit tests with coverage:
```bash
npm run test:cov
```
To run the end-to-end tests:
```bash
npm run test:e2e
```
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Author
### [PCWT Dev](https://github.com/pieceowater-dev)