Skip to content

docs: deepen bootstrap + config-sync guides#66

Merged
jlc488 merged 1 commit into
mainfrom
docs/deepen-bootstrap-configsync
Jun 3, 2026
Merged

docs: deepen bootstrap + config-sync guides#66
jlc488 merged 1 commit into
mainfrom
docs/deepen-bootstrap-configsync

Conversation

@jlc488

@jlc488 jlc488 commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

EN

Finishes the feature-guide deepening pass. Brings First-admin Bootstrap and Config Sync to tutorial-level depth, with verified APIs, full file paths, and concrete copy-paste flows.

Bootstrap (guides/bootstrap)

  • application.yml path on the config block
  • NEW "Log in for the first time" walkthrough (console + curl), using the verified POST /admin/api/v1/auth/login with {tenantId, loginId, rawPassword}
  • first-run detection now shows the actual bootstrap/status curl
  • verified against DevslabKitProperties.Bootstrap (enabled default false; tenant-id / admin-login-id / admin-password / must-change-password; role PLATFORM_ADMIN)

Config Sync (guides/config-sync)

  • application.yml path on the enable block
  • NEW "A full round trip": export → commit → dry-run → apply as four copy-paste curls (local → staging)
  • links the admin-console Config Sync screen

Both guides EN + KO.

Anchors

  • pin { #bootstrap } on configuration.md/.ko.md and { #config-sync } on admin-console.ko.md so the fragment links resolve
  • pinning #bootstrap changed the configuration bootstrap auto-slug, so the tutorial.md link that pointed at the old auto-anchor is updated

Verification: mkdocs build --strict — clean, no anchor/link warnings.

This completes the 6-guide deepening (tenancy, menus, audit, cache, bootstrap, config-sync) agreed under the full guide overhaul.

KO (한국어)

기능 가이드 심화 작업 마무리. 최초 관리자 부트스트랩·설정 동기화를 튜토리얼 수준 깊이로, 검증된 API·전체 파일 경로·구체적 복붙 흐름과 함께.

부트스트랩 (guides/bootstrap)

  • 설정 블록에 application.yml 경로
  • 신규 "처음 로그인하기" 워크스루(콘솔 + curl), 검증된 POST /admin/api/v1/auth/login + {tenantId, loginId, rawPassword} 사용
  • 첫 실행 감지에 실제 bootstrap/status curl 표시
  • DevslabKitProperties.Bootstrap 기준 검증(enabled 기본 false; tenant-id/admin-login-id/admin-password/must-change-password; 역할 PLATFORM_ADMIN)

설정 동기화 (guides/config-sync)

  • 활성화 블록에 application.yml 경로
  • 신규 "전체 왕복": export → commit → dry-run → apply 네 개의 복붙 curl(로컬 → staging)
  • 관리자 콘솔 Config Sync 화면 링크

두 가이드 모두 한/영.

앵커

  • fragment 링크가 동작하도록 configuration.md/.ko.md{ #bootstrap }, admin-console.ko.md{ #config-sync } 고정
  • #bootstrap 고정으로 configuration 부트스트랩 auto-slug가 바뀌어, 옛 auto-anchor를 가리키던 tutorial.md 링크 갱신

검증: mkdocs build --strict — clean, 앵커/링크 경고 없음.

이로써 전면 개편에서 합의한 6개 가이드 심화(tenancy·menus·audit·cache·bootstrap·config-sync)가 완료됩니다.

Finish the feature-guide deepening pass: bring the first-admin bootstrap
and config-sync guides to tutorial-level depth with verified APIs, full
file paths, and concrete copy-paste flows.

bootstrap:
- application.yml path on the config block
- NEW "Log in for the first time" walkthrough (console + curl), using the
  verified POST /admin/api/v1/auth/login with {tenantId, loginId,
  rawPassword}
- first-run detection now shows the actual bootstrap/status curl
- verified against DevslabKitProperties.Bootstrap (enabled default false,
  tenant-id/admin-login-id/admin-password/must-change-password, role
  PLATFORM_ADMIN)

config-sync:
- application.yml path on the enable block
- NEW "A full round trip" section: export -> commit -> dry-run -> apply
  as four copy-paste curls (local -> staging)
- link the admin-console Config Sync screen

Both guides EN + KO.

Anchors: pin { #bootstrap } on configuration.md/.ko.md and { #config-sync }
on admin-console.ko.md so the fragment links resolve; this changed the
configuration bootstrap auto-slug, so update the tutorial.md link that
pointed at the old auto-anchor.

Verification: mkdocs build --strict clean, no anchor/link warnings.
@jlc488 jlc488 merged commit af6f307 into main Jun 3, 2026
2 checks passed
@jlc488 jlc488 deleted the docs/deepen-bootstrap-configsync branch June 3, 2026 13:24
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