feat: postal inquiry

dockerfile

@@ -1,5 +1,6 @@
 FROM registry.hamdocker.ir/seniorkian/node:18-alpine
 
+
 WORKDIR /app
 
 COPY package*.json ./

src/Pages/PostcodeInquiry.tsx

@@ -0,0 +1,290 @@
+import React, { useState } from "react";
+import { Grid } from "../components/Grid/Grid";
+import Textfield from "../components/Textfeild/Textfeild";
+import { useApiMutation } from "../utils/useApiRequest";
+import { motion, AnimatePresence } from "framer-motion";
+import Typography from "../components/Typography/Typography";
+import { useToast } from "../hooks/useToast";
+import {
+  MapPinIcon,
+  BuildingOfficeIcon,
+  IdentificationIcon,
+} from "@heroicons/react/24/outline";
+import Button from "../components/Button/Button";
+
+interface PostcodeInquiryData {
+  avenue: string;
+  buildingName: string;
+  description: string;
+  floorNo: number | null;
+  houseNo: string;
+  houseNoSpecified: boolean;
+  location: string;
+  locationCode: string;
+  locationType: string;
+  parish: string | null;
+  postCode: string;
+  preAvenue: string;
+  sideFloor: number | null;
+  state: string;
+  townShip: string;
+  village: string;
+  zone: string;
+  address: string;
+  hasError: boolean;
+  errorMessage: string | null;
+  errorCode: number;
+}
+
+interface PostcodeInquiryResponse {
+  status: boolean;
+  statusCode: number;
+  data: PostcodeInquiryData;
+  apiLogId: string;
+}
+
+const PostcodeInquiry: React.FC = () => {
+  const [postcode, setPostcode] = useState("");
+  const [inquiryData, setInquiryData] = useState<PostcodeInquiryData | null>(
+    null,
+  );
+  const showToast = useToast();
+
+  const inquiryMutation = useApiMutation<PostcodeInquiryResponse>({
+    api: "postcode-inquiry",
+    method: "get",
+  });
+
+  const handleSearch = async () => {
+    const trimmed = postcode.trim();
+
+    if (!trimmed) {
+      showToast("لطفا کد پستی را وارد کنید", "error");
+      return;
+    }
+
+    if (trimmed.length !== 10) {
+      showToast("کد پستی باید 10 رقم باشد", "error");
+      return;
+    }
+
+    try {
+      const result = await inquiryMutation.mutateAsync({ postcode: trimmed });
+
+      if (result?.status && result?.data) {
+        if (result.data.hasError) {
+          setInquiryData(null);
+          showToast(result.data.errorMessage || "نتیجه‌ای یافت نشد", "info");
+        } else {
+          setInquiryData(result.data);
+        }
+      } else {
+        setInquiryData(null);
+        showToast("نتیجه‌ای یافت نشد", "info");
+      }
+    } catch (error: any) {
+      console.error("Postcode inquiry error:", error);
+      showToast(
+        error?.response?.data?.message || "خطا در استعلام کد پستی",
+        "error",
+      );
+      setInquiryData(null);
+    }
+  };
+
+  const handlePostcodeChange = (e: React.ChangeEvent<HTMLInputElement>) => {
+    const value = e.target.value;
+    const numericValue = value.replace(/\D/g, "").slice(0, 10);
+    setPostcode(numericValue);
+  };
+
+  const handleKeyPress = (e: React.KeyboardEvent<HTMLInputElement>) => {
+    if (e.key === "Enter") {
+      handleSearch();
+    }
+  };
+
+  return (
+    <Grid container column className="gap-4 p-4 max-w-6xl mx-auto">
+      <motion.div
+        initial={{ opacity: 0, y: 20 }}
+        animate={{ opacity: 1, y: 0 }}
+        transition={{ duration: 0.4, delay: 0.1 }}
+        className="w-full"
+      >
+        <Grid
+          container
+          column
+          className="gap-4 p-6 bg-white dark:bg-dark-800 rounded-xl shadow-lg border border-gray-200 dark:border-dark-600"
+        >
+          <Typography
+            variant="h5"
+            className="text-gray-900 dark:text-gray-100 font-bold mb-2"
+          >
+            استعلام کد پستی
+          </Typography>
+
+          <Grid container className="gap-4 items-end">
+            <Grid container className="flex-1" column>
+              <Textfield
+                placeholder="کد پستی (10 رقم)"
+                value={postcode}
+                onChange={handlePostcodeChange}
+                onKeyPress={handleKeyPress}
+                fullWidth
+              />
+            </Grid>
+            <Button
+              onClick={handleSearch}
+              disabled={inquiryMutation.isPending}
+              className="px-6 py-2.5"
+            >
+              {inquiryMutation.isPending ? "در حال جستجو..." : "جستجو"}
+            </Button>
+          </Grid>
+        </Grid>
+      </motion.div>
+
+      <AnimatePresence mode="popLayout">
+        {inquiryData && (
+          <motion.div
+            initial={{ opacity: 0, y: 20 }}
+            animate={{ opacity: 1, y: 0 }}
+            exit={{ opacity: 0 }}
+            className="w-full"
+          >
+            <div className="bg-white dark:bg-dark-800 rounded-xl shadow-lg border border-gray-200 dark:border-dark-600 p-6">
+              <Grid container column className="gap-4">
+                <div className="flex items-start justify-between pb-4 border-b border-gray-200 dark:border-dark-600">
+                  <div className="flex items-center gap-3">
+                    <div className="p-3 bg-primary-100 dark:bg-primary-900/30 rounded-lg">
+                      <MapPinIcon className="w-6 h-6 text-primary-600 dark:text-primary-400" />
+                    </div>
+                    <div>
+                      <Typography
+                        variant="h6"
+                        className="text-gray-900 dark:text-gray-100 font-bold"
+                      >
+                        نتیجه استعلام کد پستی
+                      </Typography>
+                      <Typography
+                        variant="body2"
+                        className="text-gray-600 dark:text-gray-400 mt-1"
+                      >
+                        کد پستی: {inquiryData.postCode}
+                      </Typography>
+                    </div>
+                  </div>
+                </div>
+
+                <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
+                  {inquiryData.address && (
+                    <div className="flex items-start gap-3 p-3 bg-gray-50 dark:bg-dark-700 rounded-lg md:col-span-2">
+                      <MapPinIcon className="w-5 h-5 text-gray-600 dark:text-gray-400 shrink-0 mt-0.5" />
+                      <div className="flex-1">
+                        <Typography
+                          variant="body2"
+                          className="text-gray-500 dark:text-gray-400 text-xs mb-1"
+                        >
+                          آدرس
+                        </Typography>
+                        <Typography
+                          variant="body1"
+                          className="text-gray-900 dark:text-gray-100 font-medium"
+                        >
+                          {inquiryData.address}
+                        </Typography>
+                      </div>
+                    </div>
+                  )}
+
+                  {inquiryData.buildingName && (
+                    <div className="flex items-center gap-3 p-3 bg-gray-50 dark:bg-dark-700 rounded-lg">
+                      <BuildingOfficeIcon className="w-5 h-5 text-gray-600 dark:text-gray-400 shrink-0" />
+                      <div>
+                        <Typography
+                          variant="body2"
+                          className="text-gray-500 dark:text-gray-400 text-xs"
+                        >
+                          نام ساختمان
+                        </Typography>
+                        <Typography
+                          variant="body1"
+                          className="text-gray-900 dark:text-gray-100 font-medium"
+                        >
+                          {inquiryData.buildingName}
+                        </Typography>
+                      </div>
+                    </div>
+                  )}
+
+                  {inquiryData.state && (
+                    <div className="flex items-center gap-3 p-3 bg-gray-50 dark:bg-dark-700 rounded-lg">
+                      <MapPinIcon className="w-5 h-5 text-gray-600 dark:text-gray-400 shrink-0" />
+                      <div>
+                        <Typography
+                          variant="body2"
+                          className="text-gray-500 dark:text-gray-400 text-xs"
+                        >
+                          استان
+                        </Typography>
+                        <Typography
+                          variant="body1"
+                          className="text-gray-900 dark:text-gray-100 font-medium"
+                        >
+                          {inquiryData.state}
+                        </Typography>
+                      </div>
+                    </div>
+                  )}
+
+                  {inquiryData.townShip && (
+                    <div className="flex items-center gap-3 p-3 bg-gray-50 dark:bg-dark-700 rounded-lg">
+                      <MapPinIcon className="w-5 h-5 text-gray-600 dark:text-gray-400 shrink-0" />
+                      <div>
+                        <Typography
+                          variant="body2"
+                          className="text-gray-500 dark:text-gray-400 text-xs"
+                        >
+                          شهرستان
+                        </Typography>
+                        <Typography
+                          variant="body1"
+                          className="text-gray-900 dark:text-gray-100 font-medium"
+                        >
+                          {inquiryData.townShip}
+                        </Typography>
+                      </div>
+                    </div>
+                  )}
+
+                  {inquiryData.locationCode && (
+                    <div className="flex items-center gap-3 p-3 bg-gray-50 dark:bg-dark-700 rounded-lg">
+                      <IdentificationIcon className="w-5 h-5 text-gray-600 dark:text-gray-400 shrink-0" />
+                      <div>
+                        <Typography
+                          variant="body2"
+                          className="text-gray-500 dark:text-gray-400 text-xs"
+                        >
+                          کد شهر
+                        </Typography>
+                        <Typography
+                          variant="body1"
+                          className="text-gray-900 dark:text-gray-100 font-medium"
+                        >
+                          {inquiryData.locationCode}
+                        </Typography>
+                      </div>
+                    </div>
+                  )}
+                </div>
+              </Grid>
+            </div>
+          </motion.div>
+        )}
+      </AnimatePresence>
+    </Grid>
+  );
+};
+
+export default PostcodeInquiry;

src/config/menuItems.tsx

@@ -33,6 +33,11 @@ export const getInspectionMenuItems = (
           path: "/veterinarytransfer",
           component: () => import("../Pages/VeterinaryTransfer"),
         },
+        {
+          name: "postcodeinquiry",
+          path: "/postcode-inquiry",
+          component: () => import("../Pages/PostcodeInquiry"),
+        },
       ],
     });
   }

src/partials/main/MainInfractions.tsx

@@ -1,17 +1,103 @@
 import Typography from "../../components/Typography/Typography";
-import { Grid } from "../../components/Grid/Grid";
+import { motion, AnimatePresence } from "framer-motion";
+import {
+  ExclamationTriangleIcon,
+  DocumentTextIcon,
+  CheckCircleIcon,
+} from "@heroicons/react/24/outline";
+
+const containerVariants = {
+  hidden: { opacity: 0 },
+  visible: {
+    opacity: 1,
+    transition: { staggerChildren: 0.08, delayChildren: 0.05 },
+  },
+  exit: {
+    opacity: 0,
+    transition: { staggerChildren: 0.05, staggerDirection: -1 },
+  },
+};
+
+const itemVariants = {
+  hidden: { opacity: 0, y: 12 },
+  visible: { opacity: 1, y: 0 },
+  exit: { opacity: 0, y: -8 },
+};
 
 export const MainInfractions = ({
   data,
-  handleUpdate,
+  handleUpdate: _handleUpdate,
 }: {
   data: any;
   handleUpdate: () => void;
 }) => {
-  console.log(data, handleUpdate);
+  const infractions = data?.infractions || [];
+
+  if (infractions.length === 0) {
     return (
-    <Grid container column>
-      <Typography variant="body1">این بخش در دست توسعه است</Typography>
-    </Grid>
+      <motion.div
+        initial={{ opacity: 0, scale: 0.96 }}
+        animate={{ opacity: 1, scale: 1 }}
+        transition={{ duration: 0.3 }}
+        className="flex flex-col items-center justify-center py-12 px-6 rounded-xl bg-gray-50 dark:bg-gray-800/50 border border-gray-200 dark:border-gray-700"
+      >
+        <CheckCircleIcon className="w-14 h-14 text-emerald-500 dark:text-emerald-400 mb-4" />
+        <Typography
+          variant="body1"
+          className="text-gray-500 dark:text-gray-400 text-center"
+        >
+          تخلفی ثبت نشده است
+        </Typography>
+      </motion.div>
+    );
+  }
+
+  return (
+    <motion.div
+      variants={containerVariants}
+      initial="hidden"
+      animate="visible"
+      exit="exit"
+      className="flex flex-col gap-3"
+    >
+      <AnimatePresence mode="popLayout">
+        {infractions.map(
+          (
+            infraction: { _id: string; title: string; description?: string },
+            index: number,
+          ) => (
+            <motion.div
+              key={infraction._id || index}
+              variants={itemVariants}
+              layout
+              className="group flex gap-4 p-4 rounded-xl border border-gray-200 dark:border-gray-700 bg-white dark:bg-gray-800/80 hover:bg-gray-50 dark:hover:bg-gray-800 hover:border-red-200 dark:hover:border-red-900/50 shadow-sm hover:shadow-md transition-all duration-200"
+            >
+              <div className="flex-shrink-0 w-10 h-10 rounded-lg bg-red-100 dark:bg-red-900/30 flex items-center justify-center">
+                <ExclamationTriangleIcon className="w-5 h-5 text-red-600 dark:text-red-400" />
+              </div>
+              <div className="flex-1 min-w-0">
+                <Typography
+                  variant="subtitle2"
+                  className="font-semibold mb-1 text-gray-900 dark:text-gray-100"
+                >
+                  {index + 1}. {infraction.title}
+                </Typography>
+                {infraction.description && (
+                  <div className="flex items-start gap-2 mt-2">
+                    <DocumentTextIcon className="w-4 h-4 text-gray-400 dark:text-gray-500 flex-shrink-0 mt-0.5" />
+                    <Typography
+                      variant="body2"
+                      className="text-gray-600 dark:text-gray-400 leading-relaxed"
+                    >
+                      {infraction.description}
+                    </Typography>
+                  </div>
+                )}
+              </div>
+            </motion.div>
+          ),
+        )}
+      </AnimatePresence>
+    </motion.div>
   );
 };

src/partials/main/MainPlaceInfo.tsx

@@ -119,7 +119,7 @@ const MainPlaceInfo: React.FC<MainPlaceInfoProps> = ({
   const [personRegistryData, setPersonRegistryData] =
     useState<PersonRegistryData | null>(null);
   const [unitRegistryData, setUnitRegistryData] = useState<UnitRegistryData[]>(
-    []
+    [],
   );
   const [isLoadingRegistry, setIsLoadingRegistry] = useState(false);
   const { openDrawer } = useDrawerStore();
@@ -201,7 +201,7 @@ const MainPlaceInfo: React.FC<MainPlaceInfoProps> = ({
         const unitsCandidate =
           unitResult?.data ?? (Array.isArray(unitResult) ? unitResult : []);
         setUnitRegistryData(
-          Array.isArray(unitsCandidate) ? unitsCandidate : []
+          Array.isArray(unitsCandidate) ? unitsCandidate : [],
         );
       } catch (error: any) {
         console.error("Unit registry error:", error);
@@ -320,7 +320,6 @@ const MainPlaceInfo: React.FC<MainPlaceInfoProps> = ({
               )}
             </div>
 
-            {/* Submit Inspection Button */}
             <div className="pt-2">
               <Button
                 onClick={handleOpenInspection}

src/partials/main/MainSubmitInspection.tsx

@@ -93,30 +93,28 @@ const MainSubmitInspection: React.FC<MainSubmitInspectionProps> = ({
     { key: "عمده فروش", value: "عمده فروش" },
   ];
 
+  const usersList = Array.isArray(usersData)
+    ? usersData
+    : ((usersData as any)?.data ?? []);
+
   const inspectorOptions = useMemo(() => {
-    if (!usersData?.data) return [];
-    return usersData.data
-      .filter(
-        (user: any) =>
-          user.province === profile?.province &&
-          !user?.permissions?.includes("admin")
-      )
+    if (!usersList?.length) return [];
+    return usersList
+      .filter((user: any) => user.province === profile?.province)
       .map((user: any) => ({
         key: `${user.fullname} / ${user.mobile}`,
         value: `${user.fullname} / ${user.mobile}`,
       }));
-  }, [usersData, profile]);
+  }, [usersList, profile]);
 
   const defaultInspectorKeys = useMemo(() => {
     if (!isEdit || !item?.inspectors) return [];
     return item.inspectors.map((insp: any) => {
       if (typeof insp === "string") return insp;
-      const user = usersData?.data?.find(
-        (u: any) => u.fullname === insp.fullname
-      );
+      const user = usersList?.find((u: any) => u.fullname === insp.fullname);
       return user ? `${insp.fullname} / ${user.mobile}` : insp.fullname;
     });
-  }, [item, isEdit, usersData]);
+  }, [item, isEdit, usersList]);
 
   const {
     control,
@@ -150,17 +148,15 @@ const MainSubmitInspection: React.FC<MainSubmitInspectionProps> = ({
   const watchedInfractions = watch("infractions");
 
   useEffect(() => {
-    if (isEdit && item?.inspectors && usersData?.data) {
+    if (isEdit && item?.inspectors && usersList?.length) {
       const inspectorStrings = item.inspectors.map((insp: any) => {
         if (typeof insp === "string") return insp;
-        const user = usersData.data.find(
-          (u: any) => u.fullname === insp.fullname
-        );
+        const user = usersList.find((u: any) => u.fullname === insp.fullname);
         return user ? `${insp.fullname} / ${user.mobile}` : insp.fullname;
       });
       setValue("inspectors", inspectorStrings);
     }
-  }, [item, isEdit, usersData, setValue]);
+  }, [item, isEdit, usersList, setValue]);
 
   const submitInspectionMutation = useApiMutation({
     api: "inspections",

src/routes/paths.ts

@@ -14,3 +14,4 @@ export const AUTO_LOGIN_WITH_PARAMS = "/autologin/:key/:province";
 export const NATIONAL_INFO = "/nationalinfo";
 export const LADING_INFO = "/ladinginfo";
 export const VETERINARY_TRANSFER = "/veterinarytransfer";
+export const POSTCODE_INQUIRY = "/postcode-inquiry";

src/routes/routeConfigs.ts

@@ -11,6 +11,7 @@ import AutoLogin from "../Pages/AutoLogin";
 import NationalInfo from "../Pages/NationalInfo";
 import LadingInfo from "../Pages/LadingInfo";
 import VeterinaryTransfer from "../Pages/VeterinaryTransfer";
+import PostcodeInquiry from "../Pages/PostcodeInquiry";
 
 interface Route {
   path: string;
@@ -30,6 +31,7 @@ export const getRoutes = (auth: string | null): Route[] => {
       { path: R.NATIONAL_INFO, component: NationalInfo },
       { path: R.LADING_INFO, component: LadingInfo },
       { path: R.VETERINARY_TRANSFER, component: VeterinaryTransfer },
+      { path: R.POSTCODE_INQUIRY, component: PostcodeInquiry },
     ];
 
     if (checkIsMobile()) {

src/utils/checkMenuPermission.ts

@@ -1,6 +1,6 @@
 export const checkMenuPermission = (
   menuItemName: string,
-  userPermissions: string[] = []
+  userPermissions: string[] = [],
 ): boolean => {
   if (userPermissions.includes("admin")) {
     return true;
@@ -24,7 +24,7 @@ export const checkMenuPermission = (
 
 export const checkRoutePermission = (
   routePath: string,
-  userPermissions: string[] = []
+  userPermissions: string[] = [],
 ): boolean => {
   if (userPermissions.includes("admin")) {
     return true;
@@ -35,6 +35,7 @@ export const checkRoutePermission = (
     "/inspections": ["admin", "submit"],
     "/statics": [],
     "/nationalinfo": ["admin"],
+    "/postcode-inquiry": ["admin"],
   };
 
   const requiredPermissions = routePermissionMap[routePath] || [];

src/utils/getFaPermissions.ts

@@ -22,6 +22,9 @@ export function getFaPermissions(permission: string) {
     case "veterinarytransfer":
       faPermission = "اطلاعات گواهی حمل";
       break;
+    case "postcodeinquiry":
+      faPermission = "استعلام کد پستی";
+      break;
     case "main":
       faPermission = "صفحه اصلی";
       break;