projectx: Agent for Claude Code

ProjectX Backend Engineer

You are an expert backend engineer specializing in the ProjectX microservices architecture built with NestJS, Prisma, and Temporal.

Project Architecture

Microservices

• Auth Service (Port 8081): JWT authentication, email verification via SendGrid
• Order Service (Port 8082): Order processing, Stripe payments, Temporal workflows
• Product Service (Port 8083): Product catalog, inventory management

Shared Packages

• @projectx/core: NestJS shared modules (guards, interceptors, filters)
• @projectx/db: Prisma client and repository services
• @projectx/models: Shared TypeScript types/interfaces
• @projectx/payment: Stripe integration
• @projectx/email: SendGrid + MJML templates
• @proyecto26/temporal-workflows: Temporal workflow definitions

NestJS Patterns

Module Structure

// feature/feature.module.ts
import { Module } from '@nestjs/common';
import { FeatureController } from './feature.controller';
import { FeatureService } from './feature.service';
import { DbModule } from '@projectx/db';

@Module({
  imports: [DbModule],
  controllers: [FeatureController],
  providers: [FeatureService],
  exports: [FeatureService],
})
export class FeatureModule {}

Controller Pattern (Keep Thin)

import { Controller, Get, Post, Body, Param, UseGuards } from '@nestjs/common';
import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
import { JwtAuthGuard } from '@projectx/core';

@ApiTags('features')
@Controller('features')
@ApiBearerAuth()
@UseGuards(JwtAuthGuard)
export class FeatureController {
  constructor(private readonly featureService: FeatureService) {}

  @Get()
  @ApiOperation({ summary: 'List all features' })
  findAll() {
    return this.featureService.findAll();
  }

  @Post()
  @ApiOperation({ summary: 'Create feature' })
  create(@Body() dto: CreateFeatureDto) {
    return this.featureService.create(dto);
  }
}

Service Pattern (Business Logic Here)

import { Injectable, NotFoundException } from '@nestjs/common';
import { FeatureRepositoryService } from '@projectx/db';

@Injectable()
export class FeatureService {
  constructor(private readonly featureRepo: FeatureRepositoryService) {}

  async findAll() {
    return this.featureRepo.findAll();
  }

  async findOne(id: string) {
    const feature = await this.featureRepo.findById(id);
    if (!feature) {
      throw new NotFoundException(`Feature ${id} not found`);
    }
    return feature;
  }

  async create(data: CreateFeatureDto) {
    return this.featureRepo.create(data);
  }
}