預設埠 API 3001/Web 5173/Admin 5174:YSK Kit 合約先行全端平台,本地三埠即開產品

Key takeaway

預設埠 API 3001、Web 5173、Admin 5174,讓團隊一開本地開發就對齊後端、前台與管理後台;YSK Kit 以合約先行全端平台,把共用合約、hexagonal API 與可選介面一次備齊。

預設埠 API 3001/Web 5173/Admin 5174:YSK Kit 合約先行全端平台,本地三埠即開產品

預設埠 API 3001、Web 5173、Admin 5174,讓團隊一開本地開發就對齊後端、前台與管理後台;YSK Kit 以合約先行全端平台,把共用合約、hexagonal API 與可選介面一次備齊。

引言

香港團隊做新產品,最怕開頭就卡在「後端埠、前台埠、後台埠各寫各的」。YSK Limited 的 YSK Kit(MIT 開源 v1.1.3)把預設埠寫進產品起手式:API 走 3001、Web 走 5173、Admin 走 5174,配合 CLI ysk-kit(別名 yskk),從 scaffold 到 pnpm dev 一條線開齊本地三埠,縮短對齊成本。

一、這個特點解決什麼痛點

新產品常見痛點是環境碎片化:有人改 API 埠、有人改 Vite 埠、管理後台又另開一組,文件與腳本很快不同步。預設三埠把本地開發約定固定下來——打開瀏覽器就知道後端、產品前台與管理介面各在哪裡,新人 onboarding 與跨端聯調都更乾脆。對香港中小企與外包交付團隊來說,少一輪「你用邊個 port」的來回,就能更快進入業務功能。

二、特點背後的完整方案(展開整項 YSK Kit)

YSK Kit 是合約先行全端平台:共用合約、hexagonal API,以及可選的 Web、Admin、流動應用與桌面客戶端。官方公開版本為 v1.1.3,授權 MIT,需要 Node.js 24 與 pnpm 12。預設埠正是本地開發的起點:API 3001/Web 5173/Admin 5174。

起手可直接產生產品(例如 thin · MySQL · saas):

pnpm create @ysk-kit/app my-product --preset thin --db mysql --flavor saas

之後 pnpm install、複製 .env、起動資料庫,再 pnpm db:generate && pnpm db:migrate && pnpm db:seed,以 CLI 加模組後 pnpm gen:openapi 與 pnpm dev,即可在本機三埠同時打開。

平台另備六種 Flavor(saas、desktop、gateway、php-bridge、trading、static-web3),以及十六項能力(auth、rbac、audit-log、storage、i18n、jobs、mail、notifications、llm、websocket、push、mobile、team、apikey、crypto、billing)。預設 thin 會剝走 llm、billing、organizations(team)與 push,需要時以 pnpm ysk-kit add 還原。十個完成範例(如 clinic-booking、crm-contacts、inventory-stock 等)以 overlay 套到新產品目錄,行業 domain 留在產品倉,保持 kit 精簡可升級。

三埠預設不是孤立數字,而是與合約先行架構、CLI、Flavor 與能力模組一起,把「開新產品」變成可重複的工程節奏。

三、誰最適合用/香港應用場景

適合要快速開 SaaS、內部工具、預約/CRM/庫存等垂直產品的香港開發團隊、產品工作室,以及需要可交付 scaffold 的外判項目。常見場景包括:診所預約、會員會籍、報價發票、活動報名、外勤工單——以範例 overlay 起步,再在自有主機部署。產品仍裝在您擁有或合約指定的主機,方便符合本地營運與資料安排。

四、如何開始(WhatsApp / email / deep-link)

立即用預設三埠打開 YSK Kit 全端開發節奏:

MIT 可自行安裝使用;若需要代為 scaffold 或訂造,可經上述渠道聯絡 YSK Limited。

結語

預設埠 API 3001、Web 5173、Admin 5174,讓本地全端一眼對齊;YSK Kit 再以合約先行、六種 Flavor、十六項能力與十個範例,把開新產品變成可複製流程。歡迎到產品頁開始,或 WhatsApp/電郵與我們談談你的下一個產品。


參考來源

Related services & products