Files

zg 4e0057ece5 初始化

2026-07-15 16:08:17 +08:00

name, description, metadata

name

description

metadata

session-20260623-2

2026-06-23~24 第2次会话 — 审查接入文档 + 编写方案 + 完成代码改造 + 部署到生产服务器

type	date	sessionNumber	startTime
session	2026-06-23	2	2026-06-23T16:00:00+08:00

2026-06-23 第2次会话

会话摘要

审查 MoKeeText 接入 Mokee Gateway 统一登录网关的完整文档，发现 8 个问题（3 重大 + 5 中等），编写了完整的接入实施方案。

做了什么: 编写完整 12 个 Task 的接入实施方案，保存到 docs/superpowers/plans/2026-06-23-mokeetext-gateway-integration.md
方案覆盖:
- Task 0: 网关数据库初始化（菜单/角色/管理员 SQL）
- Task 1-2: 后端 FastAPI 中间件 + CORS 改造
- Task 3: 5 个路由文件用户数据隔离改造
- Task 4-9: 前端 env/axios/路由守卫/UserChip/v-permission
- Task 10: 按钮权限控制
- Task 11-12: 部署更新
关键设计决策:
- 本地开发走 localhost 直连后端 + X-Dev-Mock-User 头模拟用户
- 生产环境走网关，axios 拦截器自动携带 Token + X-System-Code
- 图片读取 API 不鉴权（笔记中 img 标签无法带 Authorization）
- 前端保留 fetch（dev 模式）+ axios（生产模式）双通道
结果: 方案已通过 writing-plans 自检（spec coverage ✓, placeholder scan ✓, type consistency ✓）

✅ middleware/__init__.py + middleware/user_context.py — UserContext 辅助类 + FastAPI 中间件
✅ app.py — CORS 更新（3 个域名 + localhost） + 注册 UserContextMiddleware
✅ routes/notes.py — 所有接口加 created_by 过滤 + request 参数
✅ routes/websites.py — 同上（网站/账号/文件夹）
✅ routes/import_api.py — 同上
✅ routes/upload.py — 上传记录 created_by，读取保持公开
✅ routes/share.py — 保持原样（公开访问不走网关）

✅ .env / .env.production — 环境变量
✅ src/utils/request.js — Axios 实例 + 拦截器
✅ src/composables/useApi.js — 双模式：dev (fetch+mock) / production (axios+gateway)
✅ src/router.js — 路由守卫（无 Token → 登录页，localhost 豁免）
✅ src/directives/permission.js — v-permission 指令
✅ src/main.js — 注册 permission + 动态加载 UserChip Widget
✅ src/App.vue — UserChip 占位 + 本地 mock 头像
✅ index.html — UserChip CSS
✅ src/components/NoteEditor.vue — 双地址：GW_BASE（上传）+ FILE_BASE（读取）
✅ package.json — 添加 dev/build scripts，安装 axios
✅ 构建成功：static/dist/ 已生成