Merge pull request #13828 from ohcnetwork/release

Author: sainak

.copilot/copilot-instructions.md

@@ -0,0 +1,292 @@
+# Project Structure
+
+This React TypeScript application follows a modular architecture with clear separation of concerns.
+
+## Main Entry Points
+- [src/index.tsx](mdc:src/index.tsx) - Application bootstrap
+- [src/App.tsx](mdc:src/App.tsx) - Root component
+- [src/vite.config.mts](mdc:vite.config.mts) - Vite configuration
+
+## Key Directories
+- `src/components/` - Reusable UI components
+- `src/components/ui/` - ShadCN UI components
+- `src/pages/` - Page components and routes
+- `src/Utils/` - Utility functions and helpers
+- `src/hooks/` - Custom React hooks
+- `src/context/` - React context providers
+- `src/types/` - TypeScript type definitions and typed API definitions
+- `src/Locale/` - Internationalization files
+- `src/CAREUI/` - Custom UI component library
+
+## Configuration Files
+- [tailwind.config.js](mdc:tailwind.config.js) - Tailwind CSS configuration
+- [tsconfig.json](mdc:tsconfig.json) - TypeScript configuration
+- [components.json](mdc:components.json) - Shadcn UI configuration
+
+# Coding Standards
+
+## TypeScript Guidelines
+- Use TypeScript for all new code
+- Prefer interfaces over types for object definitions
+- Use functional components with proper type definitions
+- Avoid using `any` type; use proper type definitions
+- Use type inference where possible
+
+## Component Structure
+- One component per file is preferred. 
+- Prefer default exports for components
+- Follow the component naming pattern: `ComponentName.tsx`
+- Place components in appropriate feature directories
+- Keep components small and focused
+
+## Styling Guidelines
+- Use Tailwind CSS for styling
+- Follow mobile-first responsive design
+- Use Shadcn UI components when available
+
+## State Management
+- Use TanStack Query for API data management
+- Prefer React Context for global state
+- Use local state for component-specific data
+
+## File Naming
+- Use kebab-case for directories: `auth-wizard/`
+- Use PascalCase for component files: `AuthWizard.tsx`
+- Use camelCase for utility files: `useAuth.ts`
+
+## Testing
+- Write tests in Cypress for E2E testing
+- Follow testing guidelines in `cypress/docs/`
+- Test components in isolation
+- Write meaningful test descriptions
+
+# Data Fetching and API Guidelines
+
+## TanStack Query Usage
+
+- Use TanStack Query with the `query` and `mutate` utilities from `@/Utils/request/`
+- Use appropriate query keys following the resource pattern
+- Leverage built-in features for pagination and debouncing
+- Implement proper error handling using the global error handler
+
+## API Route Definitions
+
+### Modern Route Pattern
+
+Routes are defined in dedicated API files (`*Api.ts`) within the corresponding type directory:
+
+```typescript
+// src/types/user/userApi.ts
+export default {
+  list: {
+    path: "/api/v1/users/",
+    method: HttpMethod.GET,
+    TRes: Type<PaginatedResponse<UserReadMinimal>>(),
+  },
+  create: {
+    path: "/api/v1/users/",
+    method: HttpMethod.POST,
+    TRes: Type<UserReadMinimal>(),
+    TBody: Type<UserCreate>(),
+  },
+} as const;
+
+// src/types/facility/facilityApi.ts
+export default {
+  getFacility: {
+    path: "/api/v1/facility/{id}/",
+    method: HttpMethod.GET,
+    TRes: Type<FacilityRead>(),
+  },
+  updateMonetaryComponents: {
+    path: "/api/v1/facility/{facilityId}/set_monetary_codes/",
+    method: HttpMethod.POST,
+    TRes: Type<FacilityRead>(),
+    TBody: Type<{
+      discount_codes: Code[];
+      discount_monetary_components: MonetaryComponentRead[];
+    }>(),
+  },
+} as const;
+```
+
+### Legacy Route Pattern
+
+Legacy routes are defined in `src/Utils/api.tsx`:
+
+```typescript
+export const routes = {
+  auth: {
+    login: {
+      path: "/api/v1/auth/login/",
+      method: "POST",
+    } as ApiRoute<LoginResponse, never, LoginData>,
+    logout: {
+      path: "/api/v1/auth/logout/",
+      method: "POST",
+    } as ApiRoute<void>,
+  },
+} as const;
+```
+
+## Query Patterns
+
+### Basic Queries
+
+```typescript
+const { data } = useQuery({
+  queryKey: ['users'],
+  queryFn: query(userApi.list)
+});
+```
+
+### With Parameters
+
+```typescript
+// Path parameters
+const { data } = useQuery({
+  queryKey: ['user', username],
+  queryFn: query(userApi.get, {
+    pathParams: { username }
+  })
+});
+
+// Query parameters
+const { data } = useQuery({
+  queryKey: ['facilities', searchTerm],
+  queryFn: query(facilityApi.getAllFacilities, {
+    queryParams: { search: searchTerm }
+  })
+});
+```
+
+## Mutation Patterns
+
+```typescript
+const { mutate: createUser } = useMutation({
+  mutationFn: mutate(userApi.create),
+  onSuccess: () => {
+    queryClient.invalidateQueries(["users"]);
+  },
+});
+```
+
+## Error Handling
+
+- Errors are handled globally by default
+- Common scenarios are automatically handled:
+  - Session expiry → Redirects to /session-expired
+  - Bad requests (400/406) → Shows error notification
+- Use `silent: true` option to suppress error notifications
+- Custom error handling can be implemented using `onError` callbacks
+
+
+# UI Component Guidelines
+
+## Component Library Usage
+- Use Shadcn UI components as the primary component library
+- NEVER modify the shadcn component files directly in `components/ui/*`
+- Follow the component documentation for proper usage
+- Customize components using Tailwind CSS
+- Maintain consistent styling across components
+
+## Routing with Raviger
+
+### Route Definition
+```typescript
+// src/Routers/routes/FacilityRoutes.tsx
+const FacilityRoutes: AppRoutes = {
+  "/facility/:facilityId/overview": ({ facilityId }) => (
+    <FacilityOverview facilityId={facilityId} />
+  ),
+  "/facility/:facilityId/services/:serviceId": ({ facilityId, serviceId }) => (
+    <HealthcareServiceShow facilityId={facilityId} serviceId={serviceId} />
+  )
+};
+
+// Type-safe route parameters
+type RouteParams<T extends string> =
+  T extends `${string}:${infer Param}/${infer Rest}`
+    ? { [_ in Param | keyof RouteParams<Rest>]: string }
+    : T extends `${string}:${infer Param}`
+      ? { [_ in Param]: string }
+      : Record<string, never>;
+```
+
+### Navigation and Hooks
+```typescript
+// Navigation
+import { navigate, useRedirect } from "raviger";
+
+// Redirect from old to new route
+useRedirect("/user", "/users");
+
+// Programmatic navigation
+navigate(`/facility/${facilityId}/services`);
+
+// Route matching
+const routes = useRoutes(Routes);
+```
+
+### Route Organization
+- Define routes in dedicated files under `src/Routers/routes/`
+- Group related routes in feature-specific files (e.g., `FacilityRoutes.tsx`)
+- Combine routes in `AppRouter.tsx`
+- Use proper typing with `AppRoutes` type
+- Support plugin routes through `usePluginRoutes` hook
+
+### Layout and Navigation
+```typescript
+// Conditional sidebar rendering
+const PATHS_WITHOUT_SIDEBAR = [
+  "/",
+  "/session-expired",
+  /^\/facility\/[^/]+\/services_requests\/[^/]+$/,
+];
+
+// Route wrapper with error boundary
+<ErrorBoundary fallback={<ErrorPage />}>
+  {routes}
+</ErrorBoundary>
+```
+
+## Responsive Design
+- Use Tailwind's responsive classes
+- Follow mobile-first approach
+- Test components across different screen sizes
+- Use proper breakpoints as defined in `tailwind.config.js`
+
+## Accessibility
+- Implement proper ARIA attributes
+- Ensure keyboard navigation works
+- Maintain proper color contrast
+- Support screen readers
+- Test with accessibility tools
+
+## Component Structure
+```typescript
+// Example component structure
+interface ComponentProps {
+  title: string;
+  onAction: () => void;
+}
+
+export function Component({ title, onAction }: ComponentProps) {
+  const [state, setState] = useState(false);
+  
+  return (
+    <div className="p-4 space-y-4">
+      <h2 className="text-xl font-bold">{title}</h2>
+      <Button onClick={onAction}>
+        Action
+      </Button>
+    </div>
+  );
+}
+```
+
+## Internationalization
+- Use translation keys from `src/Locale/`
+- Support RTL languages
+- Use proper date/time formatting
+- Support multiple languages

.cursor/rules/03-data-fetching.mdc

@@ -78,17 +78,10 @@ export const routes = {
 ### Basic Queries
 
 ```typescript
-// Using modern routes
 const { data } = useQuery({
   queryKey: ['users'],
   queryFn: query(userApi.list)
 });
-
-// Using legacy routes
-const { data } = useQuery({
-  queryKey: [routes.auth.me.path],
-  queryFn: query(routes.auth.me)
-});
 ```
 
 ### With Parameters
@@ -114,18 +107,12 @@ const { data } = useQuery({
 ## Mutation Patterns
 
 ```typescript
-// Using modern routes
 const { mutate: createUser } = useMutation({
   mutationFn: mutate(userApi.create),
   onSuccess: () => {
     queryClient.invalidateQueries(["users"]);
   },
 });
-
-// Using legacy routes
-const { mutate: login } = useMutation({
-  mutationFn: mutate(routes.auth.login),
-});
 ```
 
 ## Error Handling

.env

@@ -12,6 +12,9 @@ REACT_RECAPTCHA_SITE_KEY=6LcedK8qAAAAAM2PpuqlqhZUxQpmIqHqluL74dDs
 REACT_CARE_API_URL=https://care-api.do.ohc.network
 REACT_SBOM_BASE_URL=https://sbom.ohc.network
 
+# Default payment terms for invoices
+REACT_DEFAULT_PAYMENT_TERMS=""
+
 # Dev envs
 ESLINT_NO_DEV_ERRORS=true
 CARE_CDN_URL="https://egov-s3-facility-10bedicu.s3.amazonaws.com https://egov-s3-patient-data-10bedicu.s3.amazonaws.com http://localhost:4566"

.example.env

@@ -48,6 +48,10 @@ REACT_ENABLE_MINIMAL_PATIENT_REGISTRATION=true
 # If not set, disables the requirement
 REACT_PATIENT_REG_MIN_GEO_ORG_LEVELS_REQUIRED=
 
+# Default govt. organization to be selected when registering a patient
+# If not set, does not selects anything
+REACT_PATIENT_REGISTRATION_DEFAULT_GEO_ORG="c272cd4e-6f55-4538-8d05-602f40f13c4e"
+
 # JWT token refresh interval (in milliseconds) (default: 5 minutes)
 REACT_JWT_TOKEN_REFRESH_INTERVAL=
 
@@ -73,4 +77,7 @@ REACT_MAPS_FALLBACK_URL_TEMPLATE=
 REACT_APP_RESEND_OTP_TIMEOUT=
 
 # Maximum image upload size allowed (in megabytes)
-REACT_APP_MAX_IMAGE_UPLOAD_SIZE_MB=
+REACT_APP_MAX_IMAGE_UPLOAD_SIZE_MB=
+
+# Default payment terms for invoices
+REACT_DEFAULT_PAYMENT_TERMS=

AGENTS.md

@@ -0,0 +1,22 @@
+# AGENTS.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Build/Lint/Test Commands
+- `npm run dev`: Start development server
+- `npm run build`: Build for production 
+- `npm run lint`: Run ESLint
+- `npm run lint-fix`: Run ESLint with auto-fix
+- `npm run format`: Format code with Prettier
+- `npm run cypress:open`: Open Cypress UI for interactive testing
+- Single test: `npm run cypress:run -- --spec "cypress/e2e/path/to/spec.cy.ts"`
+
+## Code Style Guidelines
+- **TypeScript**: Strict mode, ES2022 target, path aliases (`@/*` for src)
+- **Formatting**: Double quotes, 2-space indent, semicolons required
+- **Imports**: Order by 3rd-party → library → CAREUI → UI → components → hooks → utils → relative
+- **Types**: Use `interface` for objects, avoid explicit `any`, proper nullability
+- **Naming**: PascalCase for components/classes, camelCase for variables/functions
+- **Components**: Organized by feature, maintain separation of concerns
+- **Testing**: Follow Page Object Model, use data-cy attributes, AAA pattern (Arrange-Act-Assert)
+- **Error Handling**: Use dedicated error handlers, TypeScript strict null checks