hamed
20c8eaaad9
- Implemented TourProgressController to handle API endpoints for tracking guided tours seen by users. - Created UserTourProgress entity to store the highest version of tours seen by each user. - Developed UserTourProgressRepository for database interactions related to user tour progress. - Introduced TourProgressService to manage business logic for marking tours as seen and retrieving seen maps. - Added comprehensive tests for API endpoints and entity behavior to ensure functionality and data integrity.
42 lines
1.5 KiB
TypeScript
42 lines
1.5 KiB
TypeScript
import { QuestionMarkCircleIcon } from '@heroicons/react/24/outline';
|
|
import { useTour } from '../../hooks/useTour';
|
|
import { getTour } from '../../lib/tour/registry';
|
|
|
|
/**
|
|
* دکمهٔ «راهنمای این صفحه».
|
|
*
|
|
* وجود تور قبل از هر هوکی بررسی میشود تا صفحهای که راهنما ندارد — یعنی بیشتر
|
|
* صفحات پنل — هیچ درخواستی برای وضعیت تورها نفرستد.
|
|
*/
|
|
export default function TourButton({ tourId }: { tourId?: string }) {
|
|
const tour = getTour(tourId);
|
|
|
|
if (!tour) return null;
|
|
|
|
return <TourLauncher tourId={tour.id} />;
|
|
}
|
|
|
|
/** اجرای خودکار وظیفهٔ خود صفحه است؛ این دکمه فقط دستی اجرا میکند. */
|
|
function TourLauncher({ tourId }: { tourId: string }) {
|
|
const { start } = useTour(tourId);
|
|
|
|
return (
|
|
<button
|
|
type="button"
|
|
aria-label="راهنمای این صفحه"
|
|
title="راهنمای این صفحه"
|
|
onClick={start}
|
|
style={{
|
|
display: 'inline-flex', alignItems: 'center', justifyContent: 'center',
|
|
width: 30, height: 30, borderRadius: 'var(--r-pill)',
|
|
background: 'transparent', border: 'none', cursor: 'pointer',
|
|
color: 'var(--text-3)', flexShrink: 0,
|
|
}}
|
|
onMouseEnter={(e) => (e.currentTarget.style.color = 'var(--primary)')}
|
|
onMouseLeave={(e) => (e.currentTarget.style.color = 'var(--text-3)')}
|
|
>
|
|
<QuestionMarkCircleIcon style={{ width: 20, height: 20 }} />
|
|
</button>
|
|
);
|
|
}
|