Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/samchon/shopping-backend
Shopping Mall Backend Server made by NestJS + Prisma for Education
https://github.com/samchon/shopping-backend
commerce educational-project functional-programming nestia nestjs prisma shopping tdd typia
Last synced: 27 days ago
JSON representation
Shopping Mall Backend Server made by NestJS + Prisma for Education
- Host: GitHub
- URL: https://github.com/samchon/shopping-backend
- Owner: samchon
- License: mit
- Created: 2023-09-30T15:56:01.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2024-10-18T07:23:38.000Z (28 days ago)
- Last Synced: 2024-10-19T03:10:04.724Z (27 days ago)
- Topics: commerce, educational-project, functional-programming, nestia, nestjs, prisma, shopping, tdd, typia
- Language: TypeScript
- Homepage:
- Size: 2.43 MB
- Stars: 12
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Shopping Backend
## 1. Outline
[](https://github.com/samchon/shopping-backend/blob/master/LICENSE)
[](https://www.npmjs.com/package/@samchon/shopping-api)
[](https://github.com/samchon/shopping-backend/actions?query=workflow%3Abuild)
[](https://nestia.io/docs/)
Example backend server of Shopping mall for education.
`@samchon/shopping-backend` is an example backend project of [NestJS](https://nestjs.com) and [Prisma](https://prisma.io) stack. It has been developed to educate how to adapt **functional programming** in the NestJS development. Therefore, it is not the actual e-commerce service, and implementation of most functions is different from the actual shopping mall and may be meaningless.
Also, `@samchon/shopping-backend` guides how to utilize those 3rd party libraries (what I've developed) in the production, and demonostrates how they are powerful for the productivity. Especially, I have ideally implemented **TDD (Test Driven Development)** through below libraries. I hope this repo would be helpful for your learning.
- [typia](https://github.com/samchon/typia): Superfast runtime validator
- [nestia](https://github.com/samchon/nestia): NestJS helper libraries like SDK generation
- [prisma-markdown](https://github.com/samchon/prisma-markdown): Markdown generator of Prisma, including ERD and descriptions
## 2. Installation
### 2.1. NodeJS
This backend server has implemented through TypeScript and it runs on the NodeJS. Therefore, to mount this backend server on your local machine, you've to install the NodeJS.
- https://nodejs.org/en/
### 2.2. PostgreSQL
> ```bash
> bash postgres.sh
>```
>
> If you've installed Docker, then run the script above.
Otherwise, visit below PostgreSQL official site and install it manually.
https://www.enterprisedb.com/downloads/postgres-postgresql-downloads
After that, run the `npm run schema ` command.
Database schema for BBS backend system would be automatically constructed.
```bash
npm run schema postgres root
```
### 2.3. Repository
From now on, you can start the backend server development, right now.
Just download this project through the git clone command and install dependencies by the npm install command. After those preparations, you can start the development by typing the `npm run dev` command.
```bash
# CLONE REPOSITORY
git clone https://github.com/samchon/shopping-backend
cd shopping-backend
# INSTALL DEPENDENCIES
npm install
# START DEVELOPMENT
npm run dev
```
## 3. Development
> - A. Definition only
> - Design prisma schema file
> - Build and Share ERD document with your companions
> - Write DTO structures
> - Declare controller method only
> - B. Software Development Kit
> - Build SDK from the declaration only controller files
> - SDK supports mockup simulator, boosting up frontend development
> - SDK is type safe, so development will be much safer
> - C. Test Automation Program
> - Build test program earlier than main program development
> - Utilize SDK library in the test program development
> - This is the TDD (Test Driven Development)
> - D. Main Program Development
### 3.1. Definition
Before developing the main program, define it before.
At first, design the DB architecture on the Prisma Schema files of ([prisma/schema](prisma/schema)).
Writing the schema definitions, don't forget to write the detailed descriptions on each tables and properties. After that, build ERD (Enterprise Relationship Diagram) document through `npm run build:prisma` command. The ERD document will be generated on the [docs/ERD.md](docs/ERD.md) path. If you share the ERD document with your companions, your team can enjoy increased productivity by standardizing words and entities.
At second, write DTO structures under the [src/api/structures](src/api/structures) directory and declare API endpoint specs under the [src/controllers](src/controllers) directory. Note that, do not implement the function body of the controller. Just write declaration only. Below code is never pseudo code, but actual code for current step.
```typescript
@Controller("bbs/articles")
export class BbsArticleController {
@TypedRoute.Patch()
public async index(
@TypedBody() input: IBbsArticle.IRequest
): Promise> {
return null!;
}
}
```
### 3.2. Software Development Kit
[`@samchon/shopping-backend`](https://github.com/samchon/shopping-backend) provides SDK (Software Development Kit) for convenience.
SDK library means a collection of `fetch` functions with proper types, automatically generated by [nestia](https://github.com/samchon/nestia). As you can see from the above gif image, SDK library boosts up client developments by providing type hints and auto completions.
Furthermore, the SDK library supports [Mockup Simulator](https://nestia.io/docs/sdk/simulator/).
If client developer configures `simulate` option to be `true`, the SDK library will not send HTTP request to your backend server, but simulate the API endpoints by itself. With that feature, frontend developers can directly start the interaction development, even when the [main program development](#34-main-program) has not started.
```bash
# BUILD SDK IN LOCAL
npm run build:sdk
# BUILD SDK AND PUBLISH IT TO THE NPM
npm run package:api
```
### 3.3. Test Automation Program
> TDD (Test Driven Development)
After the [Definition](#31-definition) and client [SDK](#32-software-development-kit) generation, you've to design the use-case scenarios and implement a test automation program who represents those use-case scenarios and guarantees the [Main Program](#34-main-program).
To add a new test function in the Test Automation Program, create a new TS file under the [test/features](test/features) directory following the below category and implement the test scenario function with representative function name and `export` symbol.
Note that, the Test Automation Program resets the local DB schema whenever being run. Therefore, you've to be careful if import data has been stored in the local DB server. To avoid the resetting the local DB, configure the `reset` option like below.
Also, the Test Automation Program runs all of the test functions placed into the [test/features](test/features) directory. However, those full testing may consume too much time. Therefore, if you want to reduce the testing time by specializing some test functions, use the `include` option like below.
- supported options
- `include`: test only restricted functions who is containing the special keyword.
- `exclude`: exclude some functions who is containing the special keyword.
- `reset`: do not reset the DB
```bash
# test without db reset
npm run test -- --reset false
# include or exclude some features
npm run test -- --include something
npm run test -- --include cart order issue
npm run test -- --include cart order issue --exclude index deposit
# run performance benchmark program
npm run benchmark
```
For reference, if you run `npm run benchmark` command, your test functions defined in the [test/features/api](test/features/api) directory would be utilized for performance benchmarking. If you want to see the performance bench result earlier, visit below link please:
- [docs/benchmarks/AMD Ryzen 9 7940HS w Radeon 780M Graphics.md](https://github.com/samchon/shopping-backend/blob/master/docs/benchmarks/AMD%20Ryzen%209%207940HS%20w%20Radeon%20780M%20Graphics.md)
### 3.4. Main Program
After [Definition](#31-definition), client [SDK](#32-software-development-kit) building and [Test Automation Program](#33-test-automation-program) are all prepared, finally you can develop the Main Program. Also, when you complete the Main Program implementation, it would better to validate the implementation through the pre-built [SDK](#32-software-development-kit) and [Test Automation Program](#33-test-automation-program).
However, do not commit a mistake that writing source codes only in the [controller](src/controllers) classes. The API Controller must have a role that only intermediation. The main source code should be write down separately following the directory categorizing. For example, source code about DB I/O should be written into the [src/providers](src/providers) directory.
## 4. Appendix
### 4.1. NPM Run Commands
List of the run commands defined in the [package.json](package.json) are like below:
- Test
- **`test`**: **Run [Test Automation Program](#33-test-automation-program)**
- `benchmark`: Run performance benchmark program
- Build
- `build`: Build every below programs
- `build:sdk`: Build SDK library, but only for local
- `build:test`: Build [Test Automation Program](#33-test-automation-program)
- `build:main`: Build main program
- **`dev`**: **Incremental builder of the [Test Automation Program](#33-test-automation-program)**
- `eslint`: EsLint validator runner
- `pretter`: Adjust prettier to every source codes
- `webpack`: Run webpack bundler
- Deploy
- `package:api`: Build and deploy the SDK library to the NPM
- `schema`: Create DB, users and schemas on local database
- `start`: Start the backend server
- Webpack
- `webpack`: Run webpack bundler
- `webpack:start`: Start the backend server built by webpack
- `webpack:test`: Run test program to the webpack built
### 4.2. Directories
- [.vscode/launch.json](.vscode/launch.json): Configuration for debugging
- [packages/api/](packages/api): Client [SDK](#32-software-development-kit) library for the client developers
- [**docs/**](docs/): Documents like ERD (Entity Relationship Diagram)
- [**prisma/schema**](prisma/schema): Prisma Schema Files
- [src/](src/): TypeScript Source directory
- [src/api/](src/api/): Client SDK that would be published to the `@ORGANIZATION/PROJECT-api`
- [**src/api/functional/**](src/api/functional/): API functions generated by the [`nestia`](https://github.com/samchon/nestia)
- [**src/api/structures/**](src/api/structures/): DTO structures
- [src/controllers/](src/controllers/): Controller classes of the Main Program
- [src/providers/](src/providers/): Service providers (bridge between DB and controllers)
- [src/executable/](src/executable/): Executable programs
- [**test/**](test/): Test Automation Program