Project Initialization

apps/edr-freight-api/src/modules/customers/customers.controller.ts

@@ -0,0 +1,30 @@
+import { Body, Controller, Get, Param, ParseUUIDPipe, Post } from '@nestjs/common';
+import { ApiOperation, ApiTags } from '@nestjs/swagger';
+
+import { CustomersService } from './customers.service';
+import { CreateCustomerDto } from './dto/create-customer.dto';
+
+@ApiTags('customers')
+// @UseGuards(JwtAuthGuard) — TODO: integrate @edr/auth
+@Controller('customers')
+export class CustomersController {
+  constructor(private readonly customersService: CustomersService) {}
+
+  @Post()
+  @ApiOperation({ summary: 'Create a new customer' })
+  create(@Body() dto: CreateCustomerDto) {
+    return this.customersService.create(dto);
+  }
+
+  @Get()
+  @ApiOperation({ summary: 'List all customers' })
+  findAll() {
+    return this.customersService.findAll();
+  }
+
+  @Get(':id')
+  @ApiOperation({ summary: 'Get a customer by ID' })
+  findOne(@Param('id', ParseUUIDPipe) id: string) {
+    return this.customersService.findById(id);
+  }
+}

apps/edr-freight-api/src/modules/customers/customers.module.ts

@@ -0,0 +1,15 @@
+import { Module } from '@nestjs/common';
+import { TypeOrmModule } from '@nestjs/typeorm';
+
+import { CustomersController } from './customers.controller';
+import { CustomersRepository } from './customers.repository';
+import { CustomersService } from './customers.service';
+import { Customer } from './entities/customer.entity';
+
+@Module({
+  imports: [TypeOrmModule.forFeature([Customer])],
+  controllers: [CustomersController],
+  providers: [CustomersService, CustomersRepository],
+  exports: [CustomersService],
+})
+export class CustomersModule {}

apps/edr-freight-api/src/modules/customers/customers.repository.ts

@@ -0,0 +1,21 @@
+import { BaseRepository } from '@edr/api-common';
+import { Injectable } from '@nestjs/common';
+import { InjectRepository } from '@nestjs/typeorm';
+import { Repository } from 'typeorm';
+
+import { Customer } from './entities/customer.entity';
+
+@Injectable()
+export class CustomersRepository extends BaseRepository<Customer> {
+  constructor(
+    @InjectRepository(Customer)
+    repository: Repository<Customer>,
+  ) {
+    super(repository);
+  }
+
+  /** Find a customer by their unique email. */
+  findByEmail(email: string): Promise<Customer | null> {
+    return this.repository.findOne({ where: { email } });
+  }
+}

apps/edr-freight-api/src/modules/customers/customers.service.ts

@@ -0,0 +1,29 @@
+import { Injectable, NotFoundException } from '@nestjs/common';
+
+import { CustomersRepository } from './customers.repository';
+import { CreateCustomerDto } from './dto/create-customer.dto';
+import { Customer } from './entities/customer.entity';
+
+@Injectable()
+export class CustomersService {
+  constructor(private readonly customersRepository: CustomersRepository) {}
+
+  /** Create a new freight customer. */
+  create(dto: CreateCustomerDto): Promise<Customer> {
+    return this.customersRepository.create(dto);
+  }
+
+  /** List every customer (alphabetical). */
+  findAll(): Promise<Customer[]> {
+    return this.customersRepository.findAll({ order: { name: 'ASC' } });
+  }
+
+  /** Get a single customer by ID. */
+  async findById(id: string): Promise<Customer> {
+    const customer = await this.customersRepository.findById(id);
+    if (!customer) {
+      throw new NotFoundException(`Customer ${id} not found`);
+    }
+    return customer;
+  }
+}

apps/edr-freight-api/src/modules/customers/dto/create-customer.dto.ts

@@ -0,0 +1,20 @@
+import { IsEmail, IsOptional, IsString } from 'class-validator';
+
+export class CreateCustomerDto {
+  @IsString()
+  name!: string;
+
+  @IsEmail()
+  email!: string;
+
+  @IsString()
+  phone!: string;
+
+  @IsOptional()
+  @IsString()
+  address?: string;
+
+  @IsOptional()
+  @IsString()
+  taxId?: string;
+}

apps/edr-freight-api/src/modules/customers/entities/customer.entity.ts

@@ -0,0 +1,20 @@
+import { BaseEntity } from '@edr/api-common';
+import { Column, Entity } from 'typeorm';
+
+@Entity({ name: 'customers' })
+export class Customer extends BaseEntity {
+  @Column({ name: 'name', type: 'varchar', length: 256 })
+  name!: string;
+
+  @Column({ name: 'email', type: 'varchar', length: 256, unique: true })
+  email!: string;
+
+  @Column({ name: 'phone', type: 'varchar', length: 32 })
+  phone!: string;
+
+  @Column({ name: 'address', type: 'text', nullable: true })
+  address?: string | null;
+
+  @Column({ name: 'tax_id', type: 'varchar', length: 64, nullable: true })
+  taxId?: string | null;
+}