后端 (book_mcp_server.py, 335 行, 15 个 MCP 工具):
- create_book / add_document / mark_html_ready / mark_json_ready / mark_failed
- update_book_status / soft_delete_book / retry_failed
- get_book / list_books / get_document / list_documents / get_document_url
- upload_to_rustfs / health
- 走 JSON-RPC + stateless_http + json_response(前端可直接调)
- launchd 守护 / 6 秒拉起(macOS)
- systemd 守护脚本(Linux/codelab)
存储:
- MongoDB (mongo:8.0 容器) - book/book_document/document_file 三表
- RustFS 对象存储(fs.code-lab.cn/scan/)- book/<id>/docs/<doc_id>/{docx,html,json}
- 幂等设计: zip_sha256 唯一 + (book_id+original_path) 唯一
前端 (Vue 3 + TS + Arco Design):
- 列表页 /book/list - 搜索 + 状态过滤 + 进度
- 详情页 /book/:id - 文档折叠 + 文件下载
- MCP 客户端 src/api/mcp.ts (JSON-RPC over fetch)
部署:
- deploy/install.sh (codelab 一键装 backend + systemd)
- deploy/install-frontend.sh (vite dev / 生产构建)
- docs/deploy.md (运维手册)
测试:
- tests/test_basic.py (sanity 7 项)
- tests/test_e2e.py (完整 e2e: docx→HTML→入库→上传→校验)
64 lines
1.3 KiB
TypeScript
64 lines
1.3 KiB
TypeScript
export interface LoginData {
|
|
username: string;
|
|
password: string;
|
|
}
|
|
|
|
export type UserType = 'system_admin' | 'user';
|
|
|
|
export interface LoginRes {
|
|
accessToken: string;
|
|
userId: string;
|
|
username: string;
|
|
loginName?: string;
|
|
role: string;
|
|
permissions: string[];
|
|
userType: UserType;
|
|
passwordChanged: boolean;
|
|
roles: string[];
|
|
realName?: string;
|
|
}
|
|
|
|
export interface UserInfo {
|
|
userId: string;
|
|
username: string;
|
|
loginName?: string;
|
|
realName?: string;
|
|
role: string;
|
|
permissions: string[];
|
|
userType: UserType;
|
|
passwordChanged: boolean;
|
|
roles: string[];
|
|
}
|
|
|
|
const demoUser: LoginRes = {
|
|
accessToken: 'template-demo-token',
|
|
userId: 'template-admin',
|
|
username: 'admin',
|
|
realName: '平台管理员',
|
|
role: 'system_admin',
|
|
permissions: ['*'],
|
|
userType: 'system_admin',
|
|
passwordChanged: true,
|
|
roles: ['system_admin'],
|
|
};
|
|
|
|
export async function login(data: LoginData) {
|
|
if (!data.username || !data.password) throw new Error('请输入账号和密码');
|
|
return { data: { ...demoUser, username: data.username } };
|
|
}
|
|
|
|
export async function logout() {
|
|
return { data: null };
|
|
}
|
|
|
|
export async function getUserInfo() {
|
|
return { data: demoUser as UserInfo };
|
|
}
|
|
|
|
export async function changePassword(_data?: {
|
|
oldPassword: string;
|
|
newPassword: string;
|
|
}) {
|
|
return { data: null };
|
|
}
|