Skip to content

feat(auth): 重設管理員密碼指令;安裝說明補上 .env 密碼注意事項;發布 v1.3.2 - #48

Merged
begin0808 merged 1 commit into
mainfrom
feat/reset-admin-password
Oct 20, 2026
Merged

begin0808 merged 1 commit into
mainfrom
feat/reset-admin-password

Conversation

@begin0808

Copy link
Copy Markdown
Owner

起因

使用者來信:照手冊手動安裝,先啟動過一次才改 .env 的密碼。管理員帳號只在第一次啟動時依 .env 建立,之後改 .env 不會生效,結果怎麼登都是「帳號或密碼錯誤」,接著被鎖 15 分鐘。以前只能刪資料重裝或還原備份。

變更

  • 新指令 docker compose exec api python -m app.scripts.reset_admin(--username 可指定其他管理員)
    • 產生 12 碼英數臨時密碼(去掉 0/O/1/l/I),解除鎖定、重新啟用;登入後須立即改密碼,舊登入全部失效
    • 只能重設系統管理員帳號;帳號打錯時列出現有管理員
    • 記入操作軌跡(操作者「主機指令」,不記密碼)
  • 文件:安裝指南第 2 步(.env 密碼只在第一次啟動有效、$/# 會被截掉)與第 5 步「登不進去怎麼辦」;FAQ 新增「第一次登入就被鎖 15 分鐘」、「忘記管理員密碼」改用新指令;手冊 FAQ、.env.example、安裝程式結尾提示
  • v1.3.1 日期更正為 2026-10-20;版本號更新為 v1.3.2

驗證

  • 後端全部 670 項通過(新增 7 項)、ruff、mypy
  • 實機重現來信情境(本機建置的 api 映像 + PostgreSQL):changeme 首次啟動 → 改 .env 重啟 → 新密碼登入 401×4、423 鎖定,鎖定中正確密碼也 423 → 執行指令 → 臨時密碼登入 200 且須改密碼 → 改密碼後新密碼 200、舊密碼 401;帳號打錯回傳代碼 1 並列出管理員;操作軌跡有紀錄

無資料表結構變更。

🤖 Generated with Claude Code

使用者來信:照手冊手動安裝,先啟動過一次才改 .env 的密碼,管理員帳號早已依
舊密碼建立,怎麼登都是「帳號或密碼錯誤」並被鎖 15 分鐘。以前只能刪資料重裝
或還原備份。

- docker compose exec api python -m app.scripts.reset_admin:產生英數臨時密碼、
  解除鎖定、重新啟用,登入後須立即改密碼;只限系統管理員帳號;記入操作軌跡
- 安裝指南、FAQ、手冊、.env.example、安裝程式結尾提示補上說明
- v1.3.1 發布日期更正為 2026-10-20

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@begin0808
begin0808 merged commit 9045031 into main Oct 20, 2026
6 checks passed
@begin0808
begin0808 deleted the feat/reset-admin-password branch October 20, 2026 06:41
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