換成自己的點子：
先做一條核心流程

步驟 1先停下小店預約的工作箱

1. 打開 Docker Desktop，點左邊的「Containers」。
2. 找到 shop-booking 這一組，按那一列的停止按鈕（方塊圖示）。

做完應看到：shop-booking 這一組的狀態變成已停止（Exited）。資料還在，之後按啟動就回來。

為什麼要停：新專案和小店預約用同樣的網址，例如 API 文件頁都在 8000 號窗口。兩個同時開，會搶同一個窗口。

步驟 2建新專案資料夾，放進產品說明和專案守則

1. 在 Finder 的「文件」裡新增一個資料夾，名稱用英文小寫、單字之間用減號，例如補習班報名叫 class-signup。想不到名字就叫 my-product。
2. 打開 my-idea，點一下 product-brief.md，按 ⌘C 拷貝；打開新資料夾，按 ⌘V 貼上。
3. 打開 shop-booking，用同樣的方法把 AGENTS.md 拷貝到新資料夾。

做完應看到：新資料夾裡有 product-brief.md 和 AGENTS.md，原本的 my-idea 和 shop-booking 裡也都還在。

如果原本的資料夾裡檔案不見了：多半是用拖的，變成搬走。把檔案拖回原本的資料夾，再用 ⌘C、⌘V 拷貝一次。

步驟 3在 App 打開新資料夾，開新對話

1. 打開 ChatGPT 桌面 App，確認上方選的是「Codex」。
2. 選「打開資料夾」，選「文件」裡剛建的新資料夾。
3. 按「New chat」開新對話。

做完應看到：新對話的畫面標示著你的新資料夾，不是 shop-booking。

如果 Codex 要執行 Docker 前先問你同不同意：看清楚它要做什麼、是不是在新資料夾裡，再同意。

步驟 1請 Codex 從產品說明圈出一條核心流程

1. 在 Codex 貼上下面這段，送出。

請讀這個資料夾的 product-brief.md，這是我的產品說明，我不會寫程式。
這一課只做一條最核心的流程。請從「核心功能」挑出沒有它、第一個會用的人就用不下去的那一條，用白話寫成 3 到 6 步：誰開始、每一步做什麼、最後存下什麼。
再列出這條流程要存哪幾種資料、每種有哪些欄位，以及需要哪幾條 API（照 AGENTS.md 的 API 命名規則）。
先不要寫程式，也先不要改檔案。

以補習班課程報名為例，Codex 整理出來的樣子大概是這樣：

核心流程

家長打開網頁，選一門課程，選一個還有名額的場次，填學生姓名、家長電話和 Email，報名成功。

要存的資料

課程（名稱、學費）、場次（課程、日期、上課時間、名額上限）、報名（場次、學生姓名、家長電話、Email、狀態）。

需要的 API

GET /api/courses、GET /api/sessions?course_id=1、POST /api/enrollments，以及管理的人查報名用的 GET /api/admin/enrollments。

做完應看到：一條從頭走到尾的流程、幾種資料和幾條 API，你讀得懂也同意。

如果 Codex 列了好幾條流程：回它「請只留一條，其他的之後再做」。

步驟 2真人試用：用第 17 課的發現，選一個最重要的修改

第 17 課請人試用小店預約時，你看到了別人卡在哪裡。同樣的問題，很可能也會出現在你的產品上。趁還沒動工，挑一個最重要的先避開。

1. 複製下面這段，把第 17 課的試用紀錄貼進括號的位置，送出。
2. 看 Codex 的建議，同意就回它「同意，請照做」。

這是我在第 17 課請人試用小店預約的真人試用紀錄：
（換成你的試用紀錄，或 Codex 整理好的卡點表）
請對照剛剛的核心流程，挑出我的產品也最可能碰到的一個問題，只挑一個，說明為什麼挑它、我的流程要怎麼改。
我同意後，請在 product-brief.md 最後新增「核心流程」一段，寫進剛剛的流程、資料、API 和這一項修改，改完幫這個資料夾存一個版本，說明寫「核心流程定稿」。

做完應看到：product-brief.md 最後多了「核心流程」，裡面有一項依真人試用選出的修改，Codex 回報存好了版本。例如試用的人在小店預約不知道電話要怎麼填，補習班報名就寫明「電話欄位先寫好填寫範例」。

這一項修改什麼時候做：跟資料有關的（例如哪一欄必填），這一課做資料時就一起做；跟畫面有關的（例如按鈕放哪裡），第 21 課做網頁時再做。

步驟 3請 Codex 把專案守則換成你的產品

1. 複製下面這段，把括號換成你的產品名，送出。

這個資料夾的 AGENTS.md 是我做小店預約時的專案守則，我要沿用它做自己的產品。請照下面改寫：
1. 小森髮廊的店名、服務項目、營業時間這些示範資料，換成 product-brief.md 裡我的產品：（換成你的產品名，例如：晨光數學教室課程報名）。
2. 資料夾結構、技術組合、每完成一步存一個版本、密碼不能寫在程式裡、自動測試放在 backend/tests/ 這些做事原則，全部照舊。
3. backend/app/routers/ 的分檔改成依我產品的功能分，一個檔案只管一件事。API 網址照原本的命名規則：英文小寫、複數名詞、單字用減號；使用者用的在 /api/，管理的人用的在 /api/admin/。
4. 網址表照舊：API 文件頁 8000、網頁 3000、管理後台 3001、測試收信匣 8025。
改完用白話告訴我改了哪些地方，再幫這個資料夾存一個版本，說明寫「專案守則換成我的產品」。

做完應看到：Codex 列出改了哪些地方。在 VS Code 打開 AGENTS.md，找不到小森髮廊，看得到你的產品名。

如果還看得到小森髮廊：回它「AGENTS.md 裡還有小森髮廊的資料，請全部換成我的產品，改完列出換了哪幾處」。

步驟 4環境健檢，把工作箱跑起來

1. 確認 Docker Desktop 開著，貼上下面這段，送出。
2. 第一次啟動要下載工作箱，等 Codex 回報完成。
3. 切到 Docker Desktop 的「Containers」，看新專案那一組。

請先讀這個資料夾的 AGENTS.md，幫我做環境健檢：Docker Desktop 有沒有在執行、Docker Compose 能不能用、Git 能不能存版本。
「文件」裡的 shop-booking 如果還有服務開著，會搶同樣的網址，請先幫我停掉，不要刪掉它的資料。
都正常的話，照 AGENTS.md 用 Docker Compose 把資料庫 PostgreSQL、Redis、測試收信匣 Mailpit 跑起來，工作箱這一組用這個資料夾的名稱，不要和 shop-booking 混在一起。資料庫密碼照守則放在 .env，不要寫進其他檔案。
跑起來後，告訴我怎麼在 Docker Desktop 看到它們。

做完應看到：新專案那一組的資料庫、Redis、Mailpit 都是綠色的執行中，shop-booking 那一組是停止的。

Redis 和 Mailpit 用不到也要開嗎：先照守則開著，不影響你的產品。第 21 課確定用不到時，那兩段可以跳過。

步驟 5建立核心流程要存的資料

1. 複製下面這段，把括號換成你在步驟 1 列出的資料、欄位和示範資料，送出。資料不只三種的話，照同樣的寫法往下加。

請照 AGENTS.md 的資料夾與命名規則，在 backend/app/models/ 建立 product-brief.md「核心流程」用到的資料，存進 Docker 裡的 PostgreSQL 資料庫：
1. （換成你的第一種資料和欄位，例如：課程：名稱、學費）
2. （換成你的第二種資料和欄位，例如：場次：課程、日期、上課時間、名額上限）
3. （換成你的第三種資料和欄位，例如：報名：場次、學生姓名、家長電話、Email、狀態、建立時間）
先放入幾筆示範資料：（換成你的示範資料，例如：國中數學、英文會話、程式入門三門課，各兩個場次，每場 12 個名額）。
資料要保存下來，重開電腦或 Docker 也不會不見。做好後用白話告訴我建了哪幾種資料、每種有哪些欄位。

做完應看到：Codex 列出的資料和欄位，和你在步驟 1 同意的一樣。

步驟 6做出核心流程需要的 API

1. 複製下面這段，把括號換成你在步驟 1 列出的 API，每一條後面用一句話寫它在做什麼，送出。

請照 AGENTS.md 的 API 命名規則，在 backend/app/routers/ 用 FastAPI 做出核心流程需要的 API，一個檔案只管一種資料：
- （換成你的 API，例如：GET /api/courses：列出課程）
- （例如：GET /api/sessions：用課程列出還能報名的場次和剩下幾個名額）
- （例如：POST /api/enrollments：新增一筆報名，名額滿了要擋下來）
- （例如：GET /api/admin/enrollments：管理的人查報名，登入第 21 課再加，先不用鎖）
讓後端跟著 Docker 一起跑。API 文件頁上新增資料的範例，請先填好一筆看得懂的示範資料。
做好後告訴我怎麼打開 API 文件頁。

做完應看到：Codex 回報做好了，告訴你打開 http://localhost:8000/docs。

步驟 7在 API 文件頁存進第一筆資料，再讀回來

1. 在瀏覽器打開 http://localhost:8000/docs。
2. 點新增資料的那一條（例如 POST /api/enrollments），按「Try it out」，範例已經填好，按「Execute」。
3. 再點列出資料的那一條（例如 GET /api/admin/enrollments），按「Try it out」、「Execute」，看剛剛那一筆有沒有出現。

做完應看到：新增時 Code 是 2 開頭，列出時看得到同一筆資料。

如果頁面上是小森髮廊的 API：你打開的是 shop-booking 的後端，看下面「卡住時怎麼辦」。

步驟 8用 VS Code 看 Codex 改了哪些檔案，存一個版本

1. 在 VS Code 按「File」→「Open Folder…」，打開你的新資料夾，看左邊多了 backend/、docker-compose.yml 這些檔案。
2. 回到 Codex，貼上下面這段。

請對照 AGENTS.md 的 API 命名規則，檢查 API 文件頁上的每一條路由：網址是不是英文小寫、複數名詞、單字用減號；使用者用的是不是都在 /api/ 底下，管理的人用的是不是都在 /api/admin/ 底下。不符合的請改好，改完列出改了哪幾條。
再列出這一課你新增和修改了哪些檔案，每個用一句白話說它在做什麼。確認 .env 沒有被存進版本後，幫這個專案存一個版本，說明寫「第 20 課：核心流程的資料與 API」。

做完應看到：Codex 說明了每個檔案的用途，並回報版本已經存好。