wcz-layout/skills/services/SKILL.md

---

name: services
description: "Use when: integrating file, approval, PeopleSoft, email, or attendance services into your workflow."
---


## Info

You can read about each service in the links below. Services are categorized as either client or server exports, depending on their intended usage.

- **Client exports** — Contains `queryOptions` and `mutationOptions`; use for data fetching/mutations on the client with React Query.
- **Server exports** — Server functions; prefer calling mutations inside other server functions or database transactions.

## Import Paths

- Client exports: `wcz-layout/data/client`
- Server exports: `wcz-layout/data/server`
- Schemas & Models: `wcz-layout/models`

## Services

| Service    | File                 | Summary                                                                 |
| ---------- | -------------------- | ----------------------------------------------------------------------- |
| file       | `docs/file.md`       | File metadata, thumbnails, binary download/open, upload, update, delete |
| approval   | `docs/approval.md`   | Approval request lifecycle, approvers, flows, statuses, step results    |
| peoplesoft | `docs/peoplesoft.md` | Employee, manager, department, and company general manager lookups      |
| email      | `docs/email.md`      | Server-only email sending with optional file attachment references      |
| attendance | `docs/attendance.md` | (Coming soon)                                                           |