Initial commit: KOC LOOP platform

koc-portal/README.md

@@ -0,0 +1,21 @@
+# KOC LOOP 外部任务门户
+
+独立公开站点，用于把后台分发任务发给外部 KOC。
+
+## MVP 流程
+
+1. KOC 通过带 `task` 参数的任务链接进入。
+2. 只填写企微昵称/联系人和领取数量。
+3. 领取后只能看到本次领取的笔记。
+4. 在单篇笔记详情页查看标题与正文，并一一回填发布账号昵称、发布链接和发布截图。
+
+门户不直接连接数据库。浏览器只调用后台隔离开放的 KOC 领取与回填接口，后台仍是任务、笔记和发布数据的唯一数据源；后台管理页面和管理接口需要管理员登录。
+
+## 本地开发
+
+先在 `3001` 端口启动后台，再运行：
+
+```bash
+npm install
+npm run dev -- --port 3000
+```