wealth/docs/pages/market/search.md

35 lines
3.7 KiB
Markdown

# جستجو (analyst search)
`/search?q=` · `apps/{bull,bear}/src/app/(main)/search/page.tsx` · Type: search results · Layout: [layout-main.md](layout-main.md), [layout.md](layout.md)
| Field | Value |
| ----------- | ------------------------------------------------------------------------------------------------------ |
| Robots | `noindex` (page `metadata`); not blocked, since no app has `robots.ts` |
| Status | `200` for every query; a guest is sent to login and a creator gets the no-access state, in the browser |
| loading.tsx | `(main)/search/loading.tsx`: the frame, the field and featured-analyst cards |
| First flush | none: the page entry reads nothing; the search runs in the browser |
| Canonical | none |
| H1 | bull: none, the tab bar's «جستجو» is a `<span>`; bear: `PageHeader` «جستجو» |
| JSON-LD | none |
| Scripts | none beyond the layout's |
## Sections
In bull's document order.
| Section | Data | HTML | JS | Index | Notes |
| ------------------------------------------- | ------------- | ----------- | ------- | ----- | -------------------------------------------------------------------------------------------------------------- |
| MobileTopBar (bull) | config | first flush | hydrate | no | the tab bar with «جستجو» centred, no back |
| ↳ Bell, account avatar or login link (bull) | viewer | skeleton | hydrate | no | |
| DeskBack, PageHeader (bear) | config | first flush | hydrate | no | «بازگشت» then the H1; the header's search field opened the page, so it is pushed |
| SearchPanel | viewer, query | skeleton | hydrate | no | `AuthGuard role="investor"`, then `<Suspense>` and `PartBoundary name="search"`; bear: `framed` |
| ↳ SearchField | — | skeleton | hydrate | no | the query lives in `?q=` (`useSearchPage`), so back from a channel restores the results |
| ↳ RecentSearches | viewer | skeleton | hydrate | no | under 2 characters; the persisted `recent-searches` store |
| ↳ SearchFeatured | query | skeleton | hydrate | no | under 2 characters; the featured analysts |
| ↳ SearchResults, SearchNoResults | query | skeleton | hydrate | no | `useCreatorSearchPart`; each card links its channel; a failed search is a part-size `ErrorFallback` with retry |
## Notes
- Search is for signed-in investors, not crawlers: every analyst's channel is reachable from `/analysts` and from post pages.
- Debt: bull has no H1 while bear has one. Render the `PageHeader` title as an `sr-only` H1 in bull too.