# N잡 (NJOB)

## 에이전트·크롤러 안내 (ChatGPT 등)

- 이 사이트 **홈(`/`)** 은 **React SPA**입니다. **HTTP로 HTML만 가져오면** `<div id="root">` 위주로 보이고, **실제 피드·트리맵은 JS 실행 후 API로 채워집니다.**
- **JavaScript 없이** 구조를 파악하려면: (1) 이 파일 **`/llms.txt`** (2) 홈 HTML에 포함된 **`<noscript>`** 블록 (3) **`/sitemap.xml`** 을 사용하세요.
- 개별 글·토픽·브랜드 **본문 텍스트**는 해당 URL을 **JS 렌더링 가능한 도구**로 열거나, 정책상 허용 시 공개 API를 참고하세요.

---

> 부업·투자·AI·지역 정보를 주제로 한 한국어 커뮤니티·콘텐츠 플랫폼입니다. 트리맵 UI로 토픽을 탐색하고, 글·댓글·브랜드 허브·경제 뉴스(RSS)·챌린지 등을 제공합니다.

## 공개 진입점 (배포 도메인으로 읽기)

프로덕션 베이스 URL은 환경 변수 `VITE_SITE_URL`과 동일하게 두는 것이 좋습니다. 운영 **호스트명은 `www`** 를 쓰는 편이 canonical·사이트맵과 일치합니다.

- https://www.njob.ai.kr/ — 홈(토픽 트리맵·피드)
- https://www.njob.ai.kr/topics — 전체 토픽 목록
- https://www.njob.ai.kr/posts — 글 목록(검색·유형·지역 필터)
- https://www.njob.ai.kr/brands — 등록 브랜드 목록
- https://www.njob.ai.kr/brand/{slug} — 브랜드 허브 페이지
- https://www.njob.ai.kr/topic/{slug} — 토픽별 글·피드
- https://www.njob.ai.kr/post/{id} — 단일 글(구조화 데이터 Article)
- https://www.njob.ai.kr/group/{slug} — 그룹(토픽 묶음) 피드
- https://www.njob.ai.kr/regions — 지역 허브
- https://www.njob.ai.kr/region/{id} — 지역 상세
- https://www.njob.ai.kr/news — 경제 뉴스 RSS 목록(항목 클릭 시 **원문 URL**로 이동; 사이트 내 기사 상세 없음, `docs/news-rss.md`)
- https://www.njob.ai.kr/challenges — 챌린지 목록
- https://www.njob.ai.kr/challenges/{id} — 챌린지 상세
- https://www.njob.ai.kr/lobby — 전체 공개 로비 채팅

## 검색엔진 — 동적 사이트맵

- 정적 `https://www.njob.ai.kr/sitemap.xml` 외에, **개별 글·토픽 URL** 목록은 백엔드 **`GET /api/public/sitemap-extra.xml`** (공개 API 호스트 기준 전체 URL)에서 제공합니다. Search Console 등에 별도 제출. 상세는 저장소 `docs/SEO_GEO.md`.

## API (개발자·봇)

REST API는 일반적으로 `/api` 접두사 하위에 있습니다. 인증이 필요한 엔드포인트는 Bearer JWT를 사용합니다. 상세는 저장소의 백엔드 라우트·문서를 참고하세요.

## 정책·안내

- `/guide` 이용 가이드(How to) — 메인·토픽·글쓰기·쪽지 등 일반 사용자 동선 안내.
- `/terms` 이용약관, `/privacy` 개인정보처리방침, `/community-guidelines` 커뮤니티 운영 정책(신고·제재·이의 제기 등).
- 비공개·계정 영역: `/me`, `/messages`, `/notifications`, `/admin` 등은 봇 크롤링 대상에서 제외하는 것이 일반적입니다 (`robots.txt` 참고).