mars
f20988b90c
- 更新 DashboardLayout 组件，统一使用演示模式布局 - 实现仪表盘页面的完整演示数据和功能 - 完成用户管理页面的演示模式，包含搜索、过滤、分页等功能 - 实现通话记录页面的演示数据和录音播放功能 - 完成翻译员管理页面的演示模式 - 实现订单管理页面的完整功能 - 完成发票管理页面的演示数据 - 更新文档管理页面 - 添加 utils.ts 工具函数库 - 完善 API 路由和数据库结构 - 修复各种 TypeScript 类型错误 - 统一界面风格和用户体验
数据库设置说明
概述
本项目使用 Supabase 作为后端数据库服务，提供 PostgreSQL 数据库、身份验证、实时订阅等功能。
数据库配置步骤
1. 创建 Supabase 项目
- 访问 Supabase Dashboard
- 创建新项目
- 记录项目的 URL 和 API 密钥
2. 执行数据库脚本
- 在 Supabase Dashboard 中，进入 SQL Editor
- 将
schema.sql文件的内容复制粘贴到编辑器中 - 点击 "Run" 执行脚本
3. 配置环境变量
在项目根目录的 .env.local 文件中配置以下变量：
# Supabase 配置
NEXT_PUBLIC_SUPABASE_URL=https://your-project-id.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
数据库表结构
核心表
-
users - 用户表
- 存储用户基本信息
- 支持个人用户、企业用户、管理员三种类型
-
enterprises - 企业表
- 存储企业客户信息
- 与用户表关联
-
orders - 订单表
- 存储口译服务订单
- 关联用户和译员
-
invoices - 发票表
- 存储发票信息
- 支持个人和企业发票
-
interpreters - 译员表
- 存储译员信息和能力
- 支持多语言和专业领域
-
calls - 通话记录表
- 存储实际通话记录
- 用于统计和质量评估
-
documents - 文档翻译表
- 存储文档翻译任务
- 跟踪翻译进度
辅助表
- enterprise_contracts - 企业合同表
- enterprise_bills - 企业账单表
- system_settings - 系统设置表
安全策略
行级安全 (RLS)
所有表都启用了行级安全策略：
- 管理员权限：管理员可以访问所有数据
- 用户权限：普通用户只能访问自己的数据
- 企业权限：企业用户可以访问所属企业的数据
身份验证
使用 Supabase Auth 进行用户身份验证：
- 支持邮箱密码注册/登录
- 支持社交登录（可选）
- JWT 令牌验证
- 会话管理
数据库索引
为提高查询性能，已创建以下索引：
- 用户邮箱索引
- 用户类型索引
- 订单状态索引
- 订单创建时间索引
- 其他常用查询字段索引
触发器
自动更新 updated_at 字段的触发器已为所有表配置。
初始数据
系统会自动插入以下初始设置：
- 应用基本配置
- 支持的语言列表
- 默认货币设置
- 税率配置
备份和恢复
Supabase 提供自动备份功能，建议：
- 定期检查备份状态
- 测试恢复流程
- 导出重要数据作为额外备份
监控和维护
建议定期执行以下维护任务：
- 检查数据库性能
- 清理过期数据
- 更新统计信息
- 监控存储使用情况
故障排除
常见问题
-
连接失败
- 检查环境变量配置
- 确认 Supabase 项目状态
-
权限错误
- 检查 RLS 策略
- 确认用户角色设置
-
查询性能问题
- 检查索引使用情况
- 优化查询语句
调试工具
- Supabase Dashboard 中的 SQL Editor
- 实时日志监控
- 性能分析工具
扩展功能
实时订阅
项目支持实时数据订阅，可以监听：
- 新订单创建
- 订单状态变更
- 通话状态更新
全文搜索
可以启用 PostgreSQL 的全文搜索功能来搜索：
- 用户信息
- 订单内容
- 文档内容
地理位置
如需要地理位置功能，可以启用 PostGIS 扩展。
开发建议
- 使用类型安全的查询构建器
- 实施适当的错误处理
- 使用事务处理复杂操作
- 定期更新依赖包
- 遵循数据库最佳实践