Skip to content

Turn the curriculum into a roadmap of stages, quests, Builders and textbook - #69

Merged
jsshin2022 merged 2 commits into
mainfrom
hub-curriculum-courses
Oct 25, 2026
Merged

jsshin2022 merged 2 commits into
mainfrom
hub-curriculum-courses

Conversation

@jsshin2022

@jsshin2022 jsshin2022 commented Oct 25, 2026 •

Copy link
Copy Markdown
Member

The curriculum becomes a roadmap: five stages on one road, numbered quests to clear, and the Builders and textbook beside each stage. Four commits.

Roadmap (second commit)

  • Stages on one road.
    • The five levels are stages on a single road, grouped as WORLD 1 · 배우기 (L0–L2) and WORLD 2 · 만들기 (L3–L4).
    • Each stage node has a progress ring.
    • A cleared stage turns gold with a star, and the road behind it fills in.
    • A "지금 여기" pin marks the first stage that is not cleared.
    • On phones the road swipes sideways.
  • Quests.
    • In a stage, each material is a numbered quest (퀘스트 01, 02, …).
    • Its card has a "클리어 표시" button next to the first-look link, so marking a quest done no longer needs the dialog.
    • The book and lecture are not quests.
  • Stage reward.
    • Under the quests, a "클리어 보상" row shows n / total next to the 다음 스테이지 button.
    • When the last quest is cleared, the row turns into STAGE CLEAR with the existing finish card button.
  • Tracker.
    • "내 로드맵: 퀘스트 n / 18 · 배지 n / 5" sits beside the tab note.
    • It replaces the 학습 완료 counter in 이어서 보기 and the shelf footer.
    • Records stay in this browser, as before; the footer says so.
  • Labels.
    • The tab reads "로드맵으로 보기".
    • The dialog button reads "클리어 표시".
    • The finish card shows the stage name.
  • New events.
    • stage_clear (level).
    • mark_done gains source: card.
  • Checked.
    • Layout and contrast are checked in dark mode.
    • The regression scripts pass unchanged.

Levels (first commit)

  • Each level leads with a Korean stage name; the English name moves to a small line on the step card.
    • L0 입문, L1 개념 완성, L2 실전 적용, L3 도구 개발, L4 연구
  • The level panel adds an "이런 분께" line.
  • 이 단계를 만든 Builder: every Builder behind the level's courses, with avatar and medal, linking to their Builder page. On wide screens it sits beside the level heading, so the panel does not get taller.
  • The "다음 단계" button and the step cards use the stage name.

Course cards

  • Up to three tags.
  • 구성: what the course is made of, e.g. 웹북 25장 + 부록 5편, 스터디 16회 · 발표 자료, 14주 · 정규 모임 12회 + 매지컬 위크 2회.
  • 교재: shown on the four courses that follow 『실무로 통하는 인과추론 with 파이썬』.
  • A first-look link outside the card button: 1장 읽기, 영상 보기, OT 자료, 특강 보기, and so on. It uses preview if set, otherwise the repo's site.
  • The maker label reads "Builder".
  • Every value comes from the repo's own README; nothing is estimated.

Textbook box

  • The book and the lecture are no longer cards among the L2 courses.
  • They sit in a "함께 보는 교재" box under the L2 courses, with the Hanbit link and a 자세히 button for the existing dialog.
  • The book row says how many L2 courses follow it.
  • The hero's "커리큘럼 L2" buttons still scroll to and highlight the item.
  • The L2 step card says "교재 2" instead of "책·강의".

Data

  • levels.json: tier, for.
  • repos.json: optional format, tags, preview, previewLabel, textbook.
  • check_data.py validates them:
    • tags: at most three short labels.
    • preview: a web link.
    • previewLabel: needs a link.
    • textbook: must be a paid item id.

Events

  • New: try_course (repo).
  • open_builder from the lineup (source: curriculum).
  • click_partner from the textbook box (placement: curriculum).

Checked

  • Desktop 1440, phone 390, dark mode: no page overflow, no console errors.
  • axe (wcag2a/aa): no violations.
  • No text under 12px.
  • Existing regression scripts pass. Two expectations were updated: the maker label, and the stamp total now that the web book stamp exists.

Track map (third commit)

The subway-map style stays. These changes make it easier to read.

  • Numbered lines.
    • Each line starts with its number (1–6) in the line colour.
    • The picker chips use the same numbers.
  • Picker and guide.
    • The picker ("노선 골라 보기") moves above the map.
    • The reading guide is a single row.
    • The phone view drops the two self-evident guide items.
  • Map content.
    • Zones use the stage names (입문 … 연구).
    • The paid dashed line is labelled "교재 (유료)".
  • Quest progress on the map.
    • Cleared quests turn yellow with a check.
    • A "지금 여기" pin marks the next quest to clear, the same one the roadmap points to.
  • Phone strips.
    • Each strip shows the line number and tagline.
    • Stations carry a level chip and, for transfer stations, the numbers of the other lines.
    • Cleared stations and the pin show here too.
  • Checks.
    • axe: no violations on the map tab in light and dark, desktop and phone.
    • The regression scripts pass.

One record, action quests, one start button (fourth commit)

  • Progress lives in the passport.
    • The passport gains a 로드맵 group: five stage stamps (입문 클리어 … 연구 클리어), 15 stamps in all.
    • Clearing every quest in a stage stamps it and shows the stamp toast.
    • The tracker beside the tab note is now a "내 여권 · 스탬프 n/15 · 스테이지 n/5" button that opens the passport.
  • WORLD 2 quests are things to do.
    • levels.json gives L3 and L4 a quests list of passport stamp ids:
      • L3: comment, first_pr
      • L4: runner, open_project
    • Those stages show the action quests first, each with a link to where it happens and a "했어요" button, then "이 스테이지의 레포" without clear buttons.
    • A claim from the passport dialog also updates the roadmap (hub:stamp event).
  • Start finder.
    • The eight goal chips are removed.
    • The note row has one "어디서 시작할지 모르겠어요 · 3문항" button.
    • While a suggested route is shown, a "‹ 로드맵 전체로" chip goes back.
  • Docs. README and CONTRIBUTING describe the roadmap and the stage stamps.
  • Tests.
    • Route and passport expectations were updated.
    • axe and the layout audit found no issues on 63 page and width combinations.

Generated by Claude Code

Each level now leads with a Korean stage name and a line on who it is
for, lists the Builders who made it, and keeps the book and lecture in a
textbook box beside the courses that follow them. Course cards carry
three tags, what the course is made of, and a first-look link.
The five levels sit on one road as stages, each with a progress ring, and
a pin marks the first stage not yet cleared. Materials are numbered
quests with a clear button on the card; clearing every quest in a stage
shows the finish card. A small tracker beside the tab note counts quests
and stage badges, kept in this browser only.
@jsshin2022 jsshin2022 changed the title Present the curriculum as courses with their Builders and textbook Turn the curriculum into a roadmap of stages, quests, Builders and textbook Oct 25, 2026
@jsshin2022
jsshin2022 merged commit ce25948 into main Oct 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant