AX Portal

여러분이 만든 웹페이지를 한곳에 모아 모두가 보고 사용할 수 있게 하는 공간입니다. 내 페이지는 좌측 목록에서 내 이메일 → 페이지 이름으로 보입니다.

GitHub 초대 메일에서 Accept invitation을 누릅니다.
Git과 VS Code 또는 Cursor를 설치합니다.
터미널에서 저장소를 받습니다.git clone https://github.com/BoostersSCMOrg/boosters_ax_portal.git
강사에게 내 GitHub 아이디를 알려줍니다. 명단 등록과 초대가 끝나야 PR을 올릴 수 있습니다.

최신 내용을 받습니다.git switch main git pull origin main
내 작업 브랜치를 만듭니다.git switch -c student/내-github-아이디/페이지이름
새 페이지를 만듭니다.npm run create:page -- --email 내이메일@boosters.kr --name "내 이름" --page first-page --title "나의 첫 페이지"
students/내-slug/first-page/index.html만 열어 기능을 만듭니다.
검사합니다.npm run validate
올린 뒤 GitHub에서 Pull Request(PR)를 만듭니다.git add students/내-slug/first-page git commit -m "feat: add my first page" git push -u origin 내-브랜치이름

코드에 API 키·비밀번호를 적으면 포탈에 접속하는 모든 사람이 볼 수 있습니다. 검사에서 자동으로 차단되니, 대신 아래 3단계를 따르세요.

좌측 하단 내 API 키 관리에서 키를 등록합니다. 이름(예: NOTION_TOKEN)과 값을 넣습니다.
허용 호스트는 "이 키를 보내도 되는 곳"입니다. Notion 키라면 api.notion.com처럼, 그 키로 호출할 API 주소의 도메인을 적습니다. 키가 엉뚱한 서버로 새는 것을 막아주는 안전장치예요.
코드에서는 키 값 대신 이름만 씁니다. 서버가 호출하는 순간 진짜 값으로 바꿔주므로, 값은 코드·Git·화면 어디에도 나타나지 않습니다.<script src="/js/page-sdk.js"></script> await AxPortal.callApi({ owner: '내-slug', secret: 'NOTION_TOKEN', url: 'https://api.notion.com/v1/search', method: 'POST', headers: { 'Notion-Version': '2022-06-28' } })

MySQL 데이터 조회는 SELECT 권한만 있는 조회 전용 계정을 mysql://계정:비밀번호@호스트:3306/디비명 형식으로 등록한 뒤 AxPortal.queryDb를 씁니다. 자세한 예시는 키 관리 화면에 있습니다.

링크·파일·문서로 된 작업물은 좌측 하단 ⬆ 수기 업로드에서 올립니다. AX의 '작업물 올리기'와 같은 양식이에요.

제목과 짧은 설명을 적습니다.
대표 링크를 넣거나, 파일(HTML·PDF·이미지 등)을 끌어다 놓고 Google Drive에 업로드를 누릅니다. HTML 파일은 포탈에서 웹페이지처럼 렌더링됩니다.
사용한 도구·타입·해결 포인트 태그를 고르고 올리기를 누르면 좌측 메뉴의 내 이름 아래에 바로 나타납니다.
Claude·ChatGPT 아티팩트는 링크로 등록하면 포탈 안에서 열리지 않습니다(claude.ai가 iframe 삽입을 차단). 아티팩트 화면의 Copy로 코드를 복사한 뒤, 파일 업로드 탭의 HTML 코드 붙여넣기에 붙이고 "HTML 파일로 추가"를 누르면 포탈 안에서 그대로 렌더링됩니다.

보이기/숨기기는 AX 내 페이지 → 작업물 탭에서, 관리자는 관리자 → 제출물 탭에서 할 수 있습니다.

콘텐츠 화면 우상단의 ♥를 누르면 누가 좋아요를 눌렀는지 보이고 여기서 좋아요를 남길 수 있습니다. 💬를 누르면 댓글을 읽고 바로 쓸 수 있어요. AX '작업물'과 같은 데이터라 어느 쪽에서 남겨도 함께 보입니다.