.cursor/rules/dyolink-overview.mdc

---
description: Dyolink project context — stack, org types, git safety, verification
alwaysApply: true
---

# Dyolink overview

Monorepo: `backend/` (NestJS + Prisma), `frontend/` (Next.js + next-intl), `infrastructure/` (Docker).

## Domain

- **CLINIC** orgs: patients, appointments, treatment, staff.
- **LAB** orgs: cases, tasks, lab workflows.
- Tab access: `TAB_*_READ` / `TAB_*_EDIT` in `backend/src/common/permissions.ts`. EDIT implies READ.

## Agent behavior

- Read `AGENTS.md` and file-scoped rules before large changes.
- **Never commit or push** unless the user explicitly asks.
- Prefer minimal diffs; reuse existing components and API patterns.
- After cross-cutting changes: `backend` → `npm run build`; `frontend` → `npx tsc --noEmit`.

## i18n

All user-visible strings: `frontend/messages/en.json`, `fa.json`, `nl.json` — add keys to **all three**.

Dates/times/numbers: `frontend/src/lib/i18n/format.ts` + `useLocale()`. **Form date fields:** `AppDateInput` only (no native `<input type="date">`); wire format `YYYY-MM-DD`. **Filter selects:** `FORM_SELECT_CLASS` from `components/shared/formSelectStyles.ts` (chevron via `globals.css`). **Tables:** `components/ui/shared/Table.tsx` — use `text-start`/`text-end`/`text-center`, never physical `text-left`/`text-right`. Appointments: `ScheduleDayPicker`. Skill: `.cursor/skills/i18n-formatting/SKILL.md`.

## Treatment / appointment colors

Treatment-type colors and labels: `components/shared/treatmentTypeDisplay.ts` + `catalog-type-colors.ts`. UI badges: `components/ui/treatment/TreatmentTypeBadge.tsx`. **Prosthesis** colors/labels: `components/treatment/prosthesisTypeDisplay.ts` — use on lab Cases/Tasks/Today charts.

## Today dashboard

CLINIC + LAB KPIs/charts in `modules/today/today.service.ts`. Deep links: `components/today/today-deep-links.ts`. Task KPIs need `TAB_TASKS_READ` (no owner bypass). Skill: `.cursor/skills/today-dashboard/SKILL.md`.

## Lab case share link

QR + URL for **sent** cases; focus page `/lab-case/[token]`. Auth redirect via `postAuthRedirect.ts`. Skill: `.cursor/skills/lab-case-share-link/SKILL.md`.
improvement: some files replaced, lots of them i shall say. AGENT.MD file created. some rules and skills added for cursor agent. 2026-07-12 21:08:29 +03:30			`---`
			`description: Dyolink project context — stack, org types, git safety, verification`
			`alwaysApply: true`
			`---`

			`# Dyolink overview`

			Monorepo: `backend/` (NestJS + Prisma), `frontend/` (Next.js + next-intl), `infrastructure/` (Docker).

			`## Domain`

			`- CLINIC orgs: patients, appointments, treatment, staff.`
			`- LAB orgs: cases, tasks, lab workflows.`
			- Tab access: `TAB__READ` / `TAB__EDIT` in `backend/src/common/permissions.ts`. EDIT implies READ.

			`## Agent behavior`

			- Read `AGENTS.md` and file-scoped rules before large changes.
			`- Never commit or push unless the user explicitly asks.`
			`- Prefer minimal diffs; reuse existing components and API patterns.`
			- After cross-cutting changes: `backend` → `npm run build`; `frontend` → `npx tsc --noEmit`.

			`## i18n`

			All user-visible strings: `frontend/messages/en.json`, `fa.json`, `nl.json` — add keys to all three.

improvement: rtl direction, solar calendar and persian formatting added for persian users. 2026-07-14 01:27:11 +03:30			Dates/times/numbers: `frontend/src/lib/i18n/format.ts` + `useLocale()`. Form date fields: `AppDateInput` only (no native `<input type="date">`); wire format `YYYY-MM-DD`. Filter selects: `FORM_SELECT_CLASS` from `components/shared/formSelectStyles.ts` (chevron via `globals.css`). Tables: `components/ui/shared/Table.tsx` — use `text-start`/`text-end`/`text-center`, never physical `text-left`/`text-right`. Appointments: `ScheduleDayPicker`. Skill: `.cursor/skills/i18n-formatting/SKILL.md`.

improvement: some files replaced, lots of them i shall say. AGENT.MD file created. some rules and skills added for cursor agent. 2026-07-12 21:08:29 +03:30			`## Treatment / appointment colors`

improvement: some new gadgets added to dashboard. some new functionality added to existed gadgets. 2026-07-14 03:06:56 +03:30			Treatment-type colors and labels: `components/shared/treatmentTypeDisplay.ts` + `catalog-type-colors.ts`. UI badges: `components/ui/treatment/TreatmentTypeBadge.tsx`. Prosthesis colors/labels: `components/treatment/prosthesisTypeDisplay.ts` — use on lab Cases/Tasks/Today charts.

			`## Today dashboard`

			CLINIC + LAB KPIs/charts in `modules/today/today.service.ts`. Deep links: `components/today/today-deep-links.ts`. Task KPIs need `TAB_TASKS_READ` (no owner bypass). Skill: `.cursor/skills/today-dashboard/SKILL.md`.
improvement: QRcode and shared link added to cases inorder to make it possible for staff users to share a case info with other staffs or other clinics. 2026-07-14 21:07:05 +03:30
			`## Lab case share link`

			QR + URL for sent cases; focus page `/lab-case/[token]`. Auth redirect via `postAuthRedirect.ts`. Skill: `.cursor/skills/lab-case-share-link/SKILL.md`.