feat: add progression logic for puzzle residences

- Implemented functions to manage puzzle progress including checking if residences are started, complete, and unlocked.
- Added utility functions to retrieve piece IDs based on residence and route.
- Introduced a new TypeScript file for progression management.
- Integrated puzzle data configuration and residence data for seamless progression tracking.

src/pages/rongdesheng/home.tsx

@@ -1,5 +1,8 @@
+import { useEffect } from 'react'
 import { getBackgroundImage, getStaticImage } from '@/lib/utils'
 import { Image } from '@/components'
+import { usePuzzleStore } from '@/store/puzzleStore'
+import { getResidenceStageUnlocks, isResidenceUnlocked } from '@/config/progression'
 import { useNavigate, useParams } from 'react-router-dom'
 import { useRongdeshengStore } from '@/store/rongdeshengStore'
 
@@ -11,6 +14,17 @@ const RongdeshengHome = () => {
   const starName = 'rongdesheng'
   const lastVisitedPlace = useRongdeshengStore((s) => s.lastVisitedPlace)
 
+  const puzzles = usePuzzleStore((state) => state.puzzles)
+  const isLoaded = usePuzzleStore((state) => state.isLoaded)
+  const { dialogueUnlocked, reflectionUnlocked, internalizationUnlocked } =
+    getResidenceStageUnlocks(starName, puzzles)
+
+  useEffect(() => {
+    if (isLoaded && !isResidenceUnlocked(starName, puzzles)) {
+      navigate('/menu', { replace: true })
+    }
+  }, [isLoaded, navigate, puzzles, starName])
+
   if (!moduleName) return null
 
   return (
@@ -30,23 +44,37 @@ const RongdeshengHome = () => {
       <div className="absolute right-20 top-75 flex flex-col space-y-10">
         {/* 对话 */}
         <Image
-          button
+          button={dialogueUnlocked}
+          className={dialogueUnlocked ? undefined : 'opacity-50 grayscale cursor-not-allowed'}
           src={getStaticImage('star/一-解锁')}
-          onClick={() => navigate(`/${moduleName}/${starName}/${lastVisitedPlace || 'place1'}`)}
+          onClick={() => {
+            if (!dialogueUnlocked) return
+            navigate(`/${moduleName}/${starName}/${lastVisitedPlace || 'place1'}`)
+          }}
         />
 
         {/* 体悟（占位） */}
         <Image
-          button
+          button={reflectionUnlocked}
+          className={reflectionUnlocked ? undefined : 'opacity-50 grayscale cursor-not-allowed'}
           src={getStaticImage('star/二-解锁')}
-          onClick={() => navigate(`/${moduleName}/${starName}/reflection`)}
+          onClick={() => {
+            if (!reflectionUnlocked) return
+            navigate(`/${moduleName}/${starName}/reflection`)
+          }}
         />
 
         {/* 内化（占位） */}
         <Image
-          button
+          button={internalizationUnlocked}
+          className={
+            internalizationUnlocked ? undefined : 'opacity-50 grayscale cursor-not-allowed'
+          }
           src={getStaticImage('star/三-解锁')}
-          onClick={() => navigate(`/${moduleName}/${starName}/internalization`)}
+          onClick={() => {
+            if (!internalizationUnlocked) return
+            navigate(`/${moduleName}/${starName}/internalization`)
+          }}
         />
       </div>
     </div>