WealthWise-Finance-Tracker: Skill for Codex

Scaffold a complete new API endpoint for the WealthWise API following all project conventions.

The entity/resource name is provided in the task prompt.

Scope

Create all four layers in this exact order:

1. Zod schema — packages/shared-types/src/schemas/<entity>.schema.ts

import { z } from 'zod';

export const Create<Entity>Schema = z.object({
  // entity-specific fields with validation
});

export const Update<Entity>Schema = Create<Entity>Schema.partial();

export const <Entity>ResponseSchema = Create<Entity>Schema.extend({
  _id: z.string(),
  userId: z.string(),
  createdAt: z.string().datetime(),
  updatedAt: z.string().datetime(),
});

export const <Entity>ListResponseSchema = z.array(<Entity>ResponseSchema);

Add inferred types to packages/shared-types/src/types/index.ts:

export type Create<Entity>Input = z.infer<typeof Create<Entity>Schema>;
export type Update<Entity>Input = z.infer<typeof Update<Entity>Schema>;
export type <Entity>Response = z.infer<typeof <Entity>ResponseSchema>;

Export from packages/shared-types/src/index.ts.

2. Mongoose model — apps/api/src/models/<entity>.model.ts

• userId: { type: Schema.Types.ObjectId, ref: 'User', required: true, index: true }
• timestamps: true in schema options (handles createdAt/updatedAt automatically)
• Define compound indexes in the schema file
• Export: export const <Entity>Model = model<I<Entity>>('<Entity>', <entity>Schema)

3. Service — apps/api/src/services/<entity>.service.ts

Implement with full type signatures:

• get<Entity>s(userId: string): Promise<I<Entity>[]>
• get<Entity>ById(id: string, userId: string): Promise<I<Entity>> — throws ApiError.notFound if missing
• create<Entity>(userId: string, data: Create<Entity>Input): Promise<I<Entity>>
• update<Entity>(id: string, userId: string, data: Update<Entity>Input): Promise<I<Entity>> — throws ApiError.notFound if missing
• delete<Entity>(id: string, userId: string): Promise<void> — throws ApiError.notFound if missing