From 15ea89f477a1db4b41fdb1cc697c459237547733 Mon Sep 17 00:00:00 2001 From: Julien Froidefond Date: Thu, 27 Nov 2025 13:42:17 +0100 Subject: [PATCH] feat: add help panel to SwotQuadrant component for enhanced user guidance and update exports in swot index --- dev.db | Bin 122880 -> 131072 bytes src/components/swot/QuadrantHelp.tsx | 161 +++++++++++++++++++++++++++ src/components/swot/SwotQuadrant.tsx | 22 +++- src/components/swot/index.ts | 1 + 4 files changed, 183 insertions(+), 1 deletion(-) create mode 100644 src/components/swot/QuadrantHelp.tsx diff --git a/dev.db b/dev.db index 26e613cec59eca4d3a448fec59f9dcf121977aec..c7b9a98e8b83bc07e25f905dbeb17c88a59d819c 100644 GIT binary patch delta 7162 zcmeHMTWB0r7~XA~WG{0`(xz#mX}ggkRl7NJp9#oPG}e^H+8V@y+U{oW_si_g&PqvF zd=af$0xo?J5e4ak4-&A5FM<^DsSjGjm-ayfeGqR{9|Y?;vopJA-IHy!k7gex@c%jI z|IYcp`Oo*CIsfVC`SYGP?isGST&@Eb4}{#+56`|=*ys0N8)6OSccx1JLPh*H{LlEl z_B~B~@4e@eBWOHg_=pm^oL2GjnKWC6?h*f|0gnern~^ z;uA+#9v@ymd3(Awf78vLvBD^twt1M2v$>P@gzmu>kZn`}01Xtz)KVa;R4UQ-&k3}% z6X>9}z{^2V1DgbDJ2#$e>>mog6q>}M#A_mqqN6B=m~Lc?l^6_D=@0RMw!o=DNfb8; zfjKvRIybQ+0CVVPuDIB5*{kgP?91#tJI?&ZTxYJZ8Frbu#Jm6#cbaKs-gbKxQnuLH zp^)3oW&e&d$h&^FF}?oPYvyeCUkSUmk$$~(c8hS1?S9$h@XxU%@@3v($wmRpL>EzGqS zPRP#Oxjwe?T#)B%DmMeWdqc($i|Qz(8qONLRMo7I`AtI_5jdcR2GpW*F(L3NQb-V# zB%5u`rClDh%I5v{GUEnXrh%qNi%B(;H%%+%+9RhHj}Vthi22amY9X)3@;clM#K<{l z2v$VN1fkE2?%R;;+L2OloEe1F#6En(pz}EkQASnMGn<&}X z0^?YwCgVy(E7!l8W0vrpehJy(thwkQRSVOV_3|%5>BIJ zm(dJbAyMZlT4OLfw6FmO6wv^)UQ}x}-6VzNg0f&2z2!hkC27C zfd{mprYTOoXeVELty4{rvJhR)+PrF7SdA9t!5k5d0vwP;1CljOm#PMdBR~oAQYR+m z#I!=n$rPL+i)LtKGL2f@tPbXgSl8izG#XH@lu~9inj>%o$U(t5ubRvLb{6Jsj)-+s zwK8am)skFD$8BD2T0uxL@g$U=o%`%Ed~BH{Knx11Q&X3HHoO@JpHYJNQV3rSN((+; zXz$79_y}pZYkZD;X$HJ@#%vA?R?$x&co9R5C6!!dAWLM^%)#|U(138vNGr88ktMK_ z0B27Eo*tI)N)gTwM>7~eE!7fwav)1&vjJ5Uh@t^HpA$`85lJioK~)m$mtlFdhb3?d zRE%P1ih^D($r)3$Vs4fNVoW>>3CNMpE^nD7>VhN(Wz|+h&E=6^mcU&tL42zSUnHB2 zmN{@Ie1tUIH9pa<{V(1-jPMVi~Qq5^Ll$k%%$VRb{#YPbyAA z-kP2Ql95YJcfI9;0=**ga#=Z9&Bc>@F>elLnd6aH4VMy0l~<>_-YlXKw+4_~PS(r> ztWSHoZi3>P#Jv6DXm{63kTJV3FD@k3+Dc-g>n0rL<6SS|+#TzB2`3~bh6x80v(_C< zI3eh+mr%^9u9r}D{g}7E==p5#8dO$EJxj%gVc$XT z50J@BgQxY4O=BbKo>cEQcG#%{WQ=4n{cCS55P`xx^o zeSN!E<1tEY_i9^KfYyb^cCQ8%%yzG4-RqI$>2|NC5Jba36%GgV_lLO3-R{)}-3e~@ zYVAA0|52~@$It}QG{e*h7t1kGx<&m)oq(G4VG7Byr#4j^Mh^6~^;| z^9-lcW`xFObQ~{hxu~jjxCIDz6;(f1tbGa&Q0tnvs!3hzlgkpN;TC_GUqaNdC#yeVp4% q<}*$(;A7>x$^i6VC%-SycUOV3hxw+zyve9LU7(kdZ@R#J#t#5-A(Mar diff --git a/src/components/swot/QuadrantHelp.tsx b/src/components/swot/QuadrantHelp.tsx new file mode 100644 index 0000000..12aca74 --- /dev/null +++ b/src/components/swot/QuadrantHelp.tsx @@ -0,0 +1,161 @@ +'use client'; + +import { useState } from 'react'; +import type { SwotCategory } from '@prisma/client'; + +interface HelpContent { + description: string; + examples: string[]; + questions: string[]; +} + +const HELP_CONTENT: Record = { + STRENGTH: { + description: + 'Les atouts internes et qualités qui distinguent positivement.', + examples: [ + 'Expertise technique solide', + 'Excellentes capacités de communication', + 'Leadership naturel', + 'Rigueur et organisation', + ], + questions: [ + 'Qu\'est-ce qui le/la distingue ?', + 'Quels retours positifs reçoit-il/elle ?', + ], + }, + WEAKNESS: { + description: + 'Les axes d\'amélioration et points à travailler.', + examples: [ + 'Difficulté à déléguer', + 'Gestion du stress à améliorer', + 'Communication écrite perfectible', + 'Manque de visibilité en réunion', + ], + questions: [ + 'Quels feedbacks constructifs a-t-il/elle reçus ?', + 'Quelles situations le/la mettent en difficulté ?', + ], + }, + OPPORTUNITY: { + description: + 'Les facteurs externes favorables à saisir.', + examples: [ + 'Nouveau projet stratégique', + 'Formation disponible', + 'Poste ouvert en interne', + 'Mentor potentiel identifié', + ], + questions: [ + 'Quelles évolutions pourraient l\'aider ?', + 'Quelles ressources sont disponibles ?', + ], + }, + THREAT: { + description: + 'Les risques externes à anticiper.', + examples: [ + 'Réorganisation menaçant le poste', + 'Compétences devenant obsolètes', + 'Concurrence interne forte', + 'Budget formation réduit', + ], + questions: [ + 'Quels changements pourraient impacter négativement ?', + 'Quels risques sont à anticiper ?', + ], + }, +}; + +interface QuadrantHelpProps { + category: SwotCategory; +} + +export function QuadrantHelp({ category }: QuadrantHelpProps) { + const [isOpen, setIsOpen] = useState(false); + const content = HELP_CONTENT[category]; + + return ( + + ); +} + +interface QuadrantHelpPanelProps { + category: SwotCategory; + isOpen: boolean; +} + +export function QuadrantHelpPanel({ category, isOpen }: QuadrantHelpPanelProps) { + const content = HELP_CONTENT[category]; + + return ( +
+
+
+ {/* Description */} +

+ {content.description} +

+ +
+ {/* Examples */} +
+

+ 📝 Exemples +

+
    + {content.examples.map((example, i) => ( +
  • + + {example} +
    • + ))} +
+
+ + {/* Questions */} +
+

+ 💡 Questions +

+
    + {content.questions.map((question, i) => ( +
  • + {question} +
    • + ))} +
+
+
+
+
+
+ ); +} + diff --git a/src/components/swot/SwotQuadrant.tsx b/src/components/swot/SwotQuadrant.tsx index d1cc41c..492fa21 100644 --- a/src/components/swot/SwotQuadrant.tsx +++ b/src/components/swot/SwotQuadrant.tsx @@ -3,6 +3,7 @@ import { forwardRef, useState, useTransition, ReactNode } from 'react'; import type { SwotCategory } from '@prisma/client'; import { createSwotItem } from '@/actions/swot'; +import { QuadrantHelpPanel } from './QuadrantHelp'; interface SwotQuadrantProps { category: SwotCategory; @@ -41,6 +42,7 @@ export const SwotQuadrant = forwardRef( const [isAdding, setIsAdding] = useState(false); const [newContent, setNewContent] = useState(''); const [isPending, startTransition] = useTransition(); + const [showHelp, setShowHelp] = useState(false); const styles = categoryStyles[category]; @@ -81,10 +83,25 @@ export const SwotQuadrant = forwardRef( {...props} > {/* Header */} -
+
{icon}

{title}

+
+ {/* Help Panel */} + + {/* Items */}
{children} diff --git a/src/components/swot/index.ts b/src/components/swot/index.ts index 907dc01..340652d 100644 --- a/src/components/swot/index.ts +++ b/src/components/swot/index.ts @@ -2,4 +2,5 @@ export { SwotBoard } from './SwotBoard'; export { SwotQuadrant } from './SwotQuadrant'; export { SwotCard } from './SwotCard'; export { ActionPanel } from './ActionPanel'; +export { QuadrantHelp } from './QuadrantHelp';