docs: deepen bootstrap + config-sync guides#66
Merged
Conversation
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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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.ymlpath on the config blockPOST /admin/api/v1/auth/loginwith{tenantId, loginId, rawPassword}bootstrap/statuscurlDevslabKitProperties.Bootstrap(enableddefault false;tenant-id/admin-login-id/admin-password/must-change-password; rolePLATFORM_ADMIN)Config Sync (
guides/config-sync)application.ymlpath on the enable blockBoth guides EN + KO.
Anchors
{ #bootstrap }onconfiguration.md/.ko.mdand{ #config-sync }onadmin-console.ko.mdso the fragment links resolve#bootstrapchanged the configuration bootstrap auto-slug, so thetutorial.mdlink that pointed at the old auto-anchor is updatedVerification:
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경로POST /admin/api/v1/auth/login+{tenantId, loginId, rawPassword}사용bootstrap/statuscurl 표시DevslabKitProperties.Bootstrap기준 검증(enabled기본 false;tenant-id/admin-login-id/admin-password/must-change-password; 역할PLATFORM_ADMIN)설정 동기화 (
guides/config-sync)application.yml경로두 가이드 모두 한/영.
앵커
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)가 완료됩니다.