Entity와 Model

api/src/application/product/product.entity.json
api/src/application/product/product.types.ts
api/src/application/product/product.model.ts (Scaffolding 시)

ProductBaseSchema
ProductBaseListParams
ProductSubsetMapping
ProductModel (Model 클래스)
ProductService (프론트엔드)

{
  "enums": {
    "UserRole": { 
      "normal": "노멀", 
      "admin": "관리자" 
    },
    "UserOrderBy": {
      "id-desc": "ID최신순"
    }
  }
}

export const CompanyStatsType = z.object({
  totalDepartments: z.number(),
  totalEmployees: z.number(),
  avgSalary: z.number(),
  departments: z.array(z.object({
    id: z.number(),
    name: z.string(),
    employeeCount: z.number(),
  })),
});

export type CompanyStatsType = z.infer<typeof CompanyStatsType>;

// company.model.ts
const enhancers = this.createEnhancers({
  WithStats: async (row) => {
    const departments = await DepartmentModel.findMany('P', {
      company_id: row.id,
    });
    
    return {
      ...row,
      company_stats: {
        totalDepartments: departments.rows.length,
        totalEmployees: departments.rows.reduce((sum, d) => sum + d.employee_count, 0),
        avgSalary: calculateAvgSalary(departments.rows),
        departments: departments.rows.map(d => ({
          id: d.id,
          name: d.name,
          employeeCount: d.employee_count,
        })),
      },
    };
  },
});

{
  "type": "relation",
  "name": "department",
  "with": "Department",
  "nullable": true,
  "relationType": "BelongsToOne",
  "onUpdate": "CASCADE",
  "onDelete": "SET NULL"
}

// api/src/application/user/user.model.ts
class UserModelClass extends BaseModelClass {
  // 기존 CRUD 메서드들...

  @api({ httpMethod: "GET" })
  async getMyIP(): Promise<{ ip: string }> {
    const context = Sonamu.getContext();
    return { ip: context.ip };
  }

  @api({ httpMethod: "POST" })
  async sendEmail(params: { to: string; subject: string }): Promise<boolean> {
    // 외부 API 호출 (DB 조회 없음)
    return true;
  }
}

// api/src/application/util/util.frame.ts
import { BaseFrameClass, api } from "sonamu";

class UtilFrameClass extends BaseFrameClass {
  @api({ httpMethod: "GET" })
  async healthCheck(): Promise<{ status: string; timestamp: Date }> {
    return { status: "ok", timestamp: new Date() };
  }
}

export const UtilFrame = new UtilFrameClass();

class UserModelClass extends BaseModelClass {
  async findById() { ... }
  async save() { ... }
  // Entity와 무관한 로직들
  async sendEmail() { ... }
  async uploadAvatar() { ... }
  async generateReport() { ... }
}

// user-util.frame.ts
class UserUtilFrameClass extends BaseFrameClass {
  @api({ httpMethod: "POST" })
  async sendEmail(params: EmailParams): Promise<boolean> {
    // 이메일 전송 로직
    return true;
  }

  @api({ httpMethod: "POST" })
  async uploadAvatar(file: File): Promise<string> {
    // 파일 업로드 로직
    return "url";
  }
}

const errors = EntityManager.schemaValidate(entity);