Merge pull request #122 from floriaaan/feature/add-swagger-routes

[FEATURE] Add swagger page

apps/web/app/admin/docs/page.tsx

@@ -0,0 +1,31 @@
+"use client";
+import { RedocStandalone } from "redoc";
+import { useQuery } from "@tanstack/react-query";
+import { fetchAPI } from "@/lib/fetchAPI";
+import { useAuth } from "@/hooks";
+
+export default function Docs() {
+  const { user, session } = useAuth();
+
+  const { data: doc, isLoading } = useQuery({
+    queryKey: ["docs"],
+    queryFn: async () => {
+      const res = await fetchAPI(`/docs`, session?.token);
+      return await res.json();
+    },
+  });
+
+  if (isLoading) return "";
+
+  return (
+    <div>
+      <RedocStandalone
+        spec={doc}
+        options={{
+          nativeScrollbars: true,
+          theme: { colors: { primary: { main: "#F99436" } } },
+        }}
+      />
+    </div>
+  );
+}

apps/web/components/admin/sidebar.tsx

@@ -31,6 +31,7 @@ import {
   MdManageAccounts,
   MdTableView,
   MdUnfoldMore,
+  MdDocumentScanner,
 } from "react-icons/md";
 
 export const Sidebar = () => {
@@ -111,6 +112,18 @@ export const Sidebar = () => {
                   <MdDoneAll className="h-5 w-5 shrink-0" />
                   État de l’application
                 </Link>
+                {isAdmin && (
+                  <Link
+                    href="/admin/docs"
+                    className={cn(
+                      "inline-flex items-center gap-x-2 px-4 py-2 text-sm font-semibold hover:bg-black hover:bg-opacity-5",
+                      path === "/admin/docs" && "bg-black bg-opacity-10",
+                    )}
+                  >
+                    <MdDocumentScanner className="h-5 w-5 shrink-0" />
+                    Documentation technique
+                  </Link>
+                )}
               </div>
             </>
           ) : (

apps/web/components/ui/sheet.tsx

@@ -23,9 +23,7 @@ const SheetClose = () => (
   </SheetPrimitive.Close>
 );
 
-const SheetPortal = ({ ...props }: SheetPrimitive.DialogPortalProps) => (
-  <SheetPrimitive.Portal {...props} />
-);
+const SheetPortal = ({ ...props }: SheetPrimitive.DialogPortalProps) => <SheetPrimitive.Portal {...props} />;
 SheetPortal.displayName = SheetPrimitive.Portal.displayName;
 
 const SheetOverlay = React.forwardRef<

apps/web/package.json

@@ -52,6 +52,7 @@
     "react-hook-form": "^7.47.0",
     "react-icons": "^5.0.1",
     "react-map-gl": "^7.1.6",
+    "redoc": "^2.1.5",
     "tailwind-merge": "^1.14.0",
     "tailwindcss": "3.3.3",
     "tailwindcss-animate": "^1.0.7",