# nest-graphql-fullstack-template

**Repository Path**: jh_shot/nest-graphql-fullstack-template

## Basic Information

- **Project Name**: nest-graphql-fullstack-template
- **Description**: NestJS GraphQL 全栈模板
- **Primary Language**: TypeScript
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-11-03
- **Last Updated**: 2024-07-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Nodejs, Nestjs, Vue, Graphql

## README

# Nest GraphQL Fullstack Template

## 简介

Nest GraphQL Fullstack Template 是一个参考若依实现的开源后台管理系统全栈模版。

## 特性

- **技术栈**：使用 Nest/Vue3 等前端前沿技术开发
- **TypeScript**：应用程序级 JavaScript 的语言

## 准备

- [Node](http://nodejs.org/) 和 [Git](https://git-scm.com/)
- [Nest](https://docs.nestjs.com/)
- [TypeORM](https://typeorm.io/)
- [Vue3](https://cn.vuejs.org/guide/introduction.html)

## 安装使用

- 获取项目代码

```bash
git clone https://gitee.com/jh_shot/nest-graphql-fullstack-template.git
```

- 安装依赖

```bash
pnpm i
```

- 部署 Docker 服务
  
```bash
docker-compose -p fullstack up
```

- 运行全部

```bash
# 选择 All -> dev
pnpm scripts
```

- 只运行后端，可通过 playground 验证代码逻辑

```bash
# 选择 Server -> dev
pnpm scripts
```

- 打包全部

```bash
# 选择 All -> build
pnpm scripts
```

## 注意事项

- NestJS 执行顺序：中间件 -> 守卫 -> 拦截器/管道 -> 异常过滤器
- TypeOrm 查询 `select: false` 的列需要用 `createQueryBuilder`
- TypeOrm 需要用 `save` 触发关联表操作，`insert` 只影响当前表
- TypeOrm 不要修改数据库表结构，Entity 只做了简单定义，`synchronize` 会报错
- DTO 结尾表示请求传输对象，VO 结尾表示响应传输对象
- 不要使用枚举类型标记字段，GraphQL 会返回枚举 key，使用自定义标量代替
- Grafana 使用线上模板ID `11159`； 使用服务名连接：`http://prometheus:9090`

## 待处理