refactor: cleanup

Author: guiseek

apps/server/src/main.ts

@@ -1,21 +1,28 @@
-/**
- * This is not a production server yet!
- * This is only a minimal backend to get started.
- */
-
-import { Logger } from '@nestjs/common';
+import { DocumentBuilder, SwaggerModule } from '@nestjs/swagger';
 import { NestFactory } from '@nestjs/core';
-
+import { Logger } from '@nestjs/common';
 import { AppModule } from './app/app.module';
 
 async function bootstrap() {
   const app = await NestFactory.create(AppModule);
-  const globalPrefix = 'api';
-  app.setGlobalPrefix(globalPrefix);
+  const prefix = 'api';
+  app.setGlobalPrefix(prefix);
+
+  const config = new DocumentBuilder()
+    .setTitle('DevParaná')
+    .setDescription('The DevParaná Platform API')
+    .setVersion('1.0')
+    .addBearerAuth()
+    .build();
+
+  const document = SwaggerModule.createDocument(app, config);
+  SwaggerModule.setup('docs', app, document);
+
   const port = process.env.PORT || 3000;
   await app.listen(port);
+
   Logger.log(
-    `🚀 Application is running on: http://localhost:${port}/${globalPrefix}`
+    `🚀 Application is running on: http://localhost:${port}/${prefix}`
   );
 }
 

docs/data-source.html

@@ -0,0 +1,45 @@
+<h1>Data Source</h1>
+<p>Esta camada tem como responsabilidade o acesso a dados no lado do servidor, contendo códigos que modela e se comunica com um ou mais tipos de fonte de dados e tudo que está relacionado diretamente, como gerenciamento de estado por exemplo.</p>
+<blockquote>
+<p>Aqui encontraremos muitas implementações concretas cujos contratos foram definidos na camada de domínio.</p>
+</blockquote>
+<h2>Estrutura</h2>
+<pre><code class="language-sh">📂 src
+└── 📂 lib
+    ├── dtos
+    ├── entities
+    ├── facades
+    ├── providers
+    ├── repositories
+    ├── services
+    └── providers.ts
+</code></pre>
+<h2>DTOs</h2>
+<h2>Entities</h2>
+<h2>Facades</h2>
+<h2>Providers</h2>
+<h2>Repositories</h2>
+<h2>Services</h2>
+<style>
+  body {
+    font-family: 'Segoe UI', sans-serif;
+  }
+  blockquote {
+    margin-left: 1em;
+    margin-top: 1em;
+    padding: 0.06em 0.6em;
+    background-color: #12e20b4a;
+    border-style: solid;
+    border-color: #12e20b;
+    border-width: 0 0.2em 0.2em 0;
+    border-radius: 0.3em;
+
+    transition: margin 500ms ease-in-out, border 500ms ease-in-out;
+  }
+  blockquote:hover {
+    margin-left: 0;
+    margin-top: 0;
+    border-width: 0 0.8em 0.8em 0;
+  }
+</style>
+

package.json

@@ -41,6 +41,7 @@
     "@nestjs/core": "^10.0.2",
     "@nestjs/jwt": "^10.2.0",
     "@nestjs/platform-express": "^10.0.2",
+    "@nestjs/swagger": "^7.4.0",
     "@nestjs/typeorm": "^10.0.2",
     "bcrypt": "^5.1.1",
     "class-transformer": "^0.5.1",

packages/data-source-account/package.json

@@ -6,7 +6,10 @@
     "@platform/domain-account": "0.0.1",
     "@platform/util-shared": "0.0.1",
     "class-validator": "^0.14.1",
-    "typeorm": "^0.3.20"
+    "typeorm": "^0.3.20",
+    "@nestjs/typeorm": "^10.0.2",
+    "@nestjs/swagger": "^7.4.0",
+    "bcrypt": "^5.1.1"
   },
   "type": "commonjs",
   "main": "./src/index.js",

packages/data-source-account/readme.md

@@ -0,0 +1,31 @@
+# Data Source
+
+Esta camada tem como responsabilidade o acesso a dados no lado do servidor, contendo códigos que modela e se comunica com um ou mais tipos de fonte de dados e tudo que está relacionado diretamente, como gerenciamento de estado por exemplo.
+
+> Aqui encontraremos muitas implementações concretas cujos contratos foram definidos na camada de domínio.
+
+## Estrutura
+
+```sh
+📂 src
+└── 📂 lib
+    ├── dtos
+    ├── entities
+    ├── facades
+    ├── providers
+    ├── repositories
+    ├── services
+    └── providers.ts
+```
+
+## DTOs
+
+## Entities
+
+## Facades
+
+## Providers
+
+## Repositories
+
+## Services

packages/data-source-account/src/lib/data-source-account.providers.ts

@@ -1,2 +1,3 @@
 export * from './create-user';
 export * from './sign-in';
+export * from './sign-up';

packages/data-source-account/src/lib/data-source-account.spec.ts

@@ -1,11 +1,14 @@
 import { IsString, MinLength } from 'class-validator';
 import { SignIn } from '@platform/domain-account';
+import { ApiProperty } from '@nestjs/swagger';
 
 export class SignInDto implements SignIn {
   @IsString()
+  @ApiProperty()
   username: string;
 
   @IsString()
   @MinLength(6)
+  @ApiProperty()
   password: string;
 }

packages/data-source-account/src/lib/data-source-account.ts

@@ -0,0 +1,30 @@
+import { IsEmail, IsString, MinLength } from 'class-validator';
+import { SignUp } from '@platform/domain-account';
+import { ApiProperty } from '@nestjs/swagger';
+
+export class SignUpDto implements SignUp {
+  @IsString()
+  @ApiProperty()
+  firstName: string;
+
+  @IsString()
+  @ApiProperty()
+  lastName: string;
+
+  @IsEmail()
+  @ApiProperty()
+  email: string;
+
+  @IsString()
+  @ApiProperty()
+  username: string;
+
+  @IsString()
+  @MinLength(6)
+  @ApiProperty()
+  password: string;
+
+  phone?: string;
+
+  photo?: string;
+}

packages/data-source-account/src/lib/dtos/index.ts

@@ -1,10 +1,17 @@
-import { SignInServerUseCase } from '@platform/domain-account';
-import { SignInDto } from '../dtos';
+import { SignInServerUseCase, SignUpServerUseCase } from '@platform/domain-account';
+import { SignInDto, SignUpDto } from '../dtos';
 
 export class AuthFacade {
-  constructor(private readonly signInUseCase: SignInServerUseCase) {}
+  constructor(
+    private readonly signInUseCase: SignInServerUseCase,
+    private readonly signUpUseCase: SignUpServerUseCase
+  ) {}
 
   signIn(data: SignInDto) {
     return this.signInUseCase.execute(data);
   }
+
+  signUp(data: SignUpDto) {
+    return this.signUpUseCase.execute(data);
+  }
 }

packages/data-source-account/src/lib/dtos/sign-in.ts

@@ -10,10 +10,7 @@ export class UserFacade {
   constructor(
     private readonly createUserUseCase: CreateUserServerUseCase,
     private readonly findUsersUseCase: FindUsersServerUseCase
-  ) {
-    console.log(createUserUseCase, findUsersUseCase);
-
-  }
+  ) {}
 
   createUser(data: CreateUserDto) {
     return this.createUserUseCase.execute(data);

packages/data-source-account/src/lib/dtos/sign-up.ts

@@ -0,0 +1,29 @@
+import {
+  provideAuthServerFacade,
+  provideCreateUserServerUseCase,
+  provideCryptoService,
+  provideFindUsersServerUseCase,
+  provideSignInServerUseCase,
+  provideSignUpServerUseCase,
+  provideUserRepository,
+  provideUserServerFacade,
+} from './providers/index';
+import { UserRepositoryImpl } from './repositories';
+import { Provider } from '@platform/util-shared';
+import { CryptoServiceImpl } from './services';
+
+export const dataSourceAccountProviders: Provider[] = [
+  provideUserRepository(UserRepositoryImpl),
+
+  provideCreateUserServerUseCase(),
+  provideFindUsersServerUseCase(),
+
+  provideUserServerFacade(),
+
+  provideCryptoService(CryptoServiceImpl),
+
+  provideSignInServerUseCase(),
+  provideSignUpServerUseCase(),
+
+  provideAuthServerFacade(),
+];

packages/data-source-account/src/lib/facades/auth.ts

@@ -0,0 +1,30 @@
+import {
+  CreateUserServerUseCase,
+  FindUsersServerUseCase,
+  SignInServerUseCase,
+  SignUpServerUseCase,
+} from '@platform/domain-account';
+import { AuthFacade, UserFacade } from '../facades';
+
+export function provideUserServerFacade() {
+  return {
+    provide: UserFacade,
+    useFactory(
+      createUser: CreateUserServerUseCase,
+      findUsers: FindUsersServerUseCase
+    ) {
+      return new UserFacade(createUser, findUsers);
+    },
+    inject: [CreateUserServerUseCase, FindUsersServerUseCase],
+  };
+}
+
+export function provideAuthServerFacade() {
+  return {
+    provide: AuthFacade,
+    useFactory(signIn: SignInServerUseCase, signUp: SignUpServerUseCase) {
+      return new AuthFacade(signIn, signUp);
+    },
+    inject: [SignInServerUseCase, SignUpServerUseCase],
+  };
+}

packages/data-source-account/src/lib/facades/user.ts

@@ -1,2 +1,5 @@
 export * from './crypto';
+export * from './facade';
 export * from './jwt';
+export * from './repository';
+export * from './use-case';

packages/data-source-account/src/lib/providers.ts

@@ -0,0 +1,22 @@
+import { UserRepository } from '@platform/domain-account';
+import { getRepositoryToken } from '@nestjs/typeorm';
+import { Type } from '@platform/util-shared';
+import { UserEntity } from '../entities';
+import { Repository } from 'typeorm';
+
+export function provideUserRepository(Repository: Type<UserRepository>) {
+  return {
+    provide: UserRepository,
+    useFactory(repository: Repository<UserEntity>) {
+      return new Repository(repository);
+    },
+    inject: [getRepositoryToken(UserEntity)],
+  };
+}
+
+export function provideUserRepositoryTest(Repository: UserRepository) {
+  return {
+    provide: UserRepository,
+    useValue: Repository,
+  };
+}