mirror of
https://github.com/patdelphi/suanming.git
synced 2026-02-28 05:33:11 +08:00
209 lines
5.9 KiB
Markdown
209 lines
5.9 KiB
Markdown
# 三算命 - AI智能命理分析平台
|
||
|
||
一个基于现代Web技术构建的智能命理分析平台，融合传统中华命理学说与AI技术，为用户提供专业的八字命理、紫微斗数、易经占卜等服务。
|
||
|
||
## 🌟 项目特色
|
||
|
||
- **传统与现代结合**：将千年传承的中华命理学说与现代AI技术完美融合
|
||
- **多元化分析**：支持八字命理、紫微斗数、易经占卜三大主流命理体系
|
||
- **智能化算法**：采用先进的算法确保分析结果的准确性和个性化
|
||
- **现代化界面**：采用现代化UI设计，提供优雅的用户体验
|
||
- **数据安全**：基于Supabase的安全数据存储和用户认证系统
|
||
|
||
## 🎯 核心功能
|
||
|
||
### 八字命理分析
|
||
- **四柱排盘**：精确计算年、月、日、时四柱干支
|
||
- **五行分析**：深度分析五行平衡与缺失
|
||
- **格局判断**：识别命格特点和层次
|
||
- **运势预测**：提供大运、流年运势分析
|
||
- **性格解读**：基于八字特征分析性格特质
|
||
- **事业指导**：提供职业发展建议
|
||
|
||
### 紫微斗数分析
|
||
- **星盘排布**：精确计算紫微星盘和十二宫位
|
||
- **主星分析**：解读命宫主星特质
|
||
- **宫位解读**：详细分析十二宫位含义
|
||
- **四化飞星**：分析化禄、化权、化科、化忌
|
||
- **大限分析**：提供人生各阶段运势预测
|
||
- **流年运势**：年度运势详细解读
|
||
|
||
### 易经占卜
|
||
- **梅花易数**：采用传统梅花易数起卦方法
|
||
- **卦象解读**：详细解释卦象含义和象征
|
||
- **变卦分析**：分析卦象变化和发展趋势
|
||
- **人生指导**：提供决策建议和人生智慧
|
||
- **时机把握**：分析最佳行动时机
|
||
|
||
## 🛠️ 技术栈
|
||
|
||
### 前端技术
|
||
- **React 18.3.1** - 现代化前端框架
|
||
- **TypeScript** - 类型安全的JavaScript超集
|
||
- **Vite 6.0.1** - 快速的构建工具
|
||
- **React Router 6** - 客户端路由管理
|
||
- **Tailwind CSS** - 实用优先的CSS框架
|
||
- **Radix UI** - 高质量的无障碍UI组件库
|
||
- **Lucide React** - 美观的图标库
|
||
- **React Hook Form** - 高性能表单库
|
||
- **Zod** - TypeScript优先的模式验证
|
||
|
||
### 后端服务
|
||
- **Supabase** - 开源的Firebase替代方案
|
||
- **PostgreSQL** - 可靠的关系型数据库
|
||
- **Edge Functions** - 服务端逻辑处理
|
||
- **实时数据库** - 实时数据同步
|
||
- **身份认证** - 安全的用户认证系统
|
||
|
||
### 开发工具
|
||
- **ESLint** - 代码质量检查
|
||
- **TypeScript ESLint** - TypeScript代码规范
|
||
- **PostCSS** - CSS后处理器
|
||
- **Autoprefixer** - CSS自动前缀
|
||
|
||
## 🚀 快速开始
|
||
|
||
### 环境要求
|
||
- Node.js >= 18.0.0
|
||
- pnpm >= 8.0.0 (推荐) 或 npm >= 9.0.0
|
||
|
||
### 安装步骤
|
||
|
||
1. **克隆项目**
|
||
```bash
|
||
git clone https://github.com/patdelphi/suanming.git
|
||
cd suanming
|
||
```
|
||
|
||
2. **安装依赖**
|
||
```bash
|
||
pnpm install
|
||
# 或者使用 npm
|
||
npm install
|
||
```
|
||
|
||
3. **环境配置**
|
||
|
||
创建 `.env.local` 文件并配置以下环境变量：
|
||
```env
|
||
VITE_SUPABASE_URL=your_supabase_project_url
|
||
VITE_SUPABASE_ANON_KEY=your_supabase_anon_key
|
||
```
|
||
|
||
4. **启动开发服务器**
|
||
```bash
|
||
pnpm dev
|
||
# 或者使用 npm
|
||
npm run dev
|
||
```
|
||
|
||
5. **访问应用**
|
||
|
||
打开浏览器访问 `http://localhost:5173`
|
||
|
||
### 构建部署
|
||
|
||
```bash
|
||
# 构建生产版本
|
||
pnpm build
|
||
|
||
# 预览构建结果
|
||
pnpm preview
|
||
```
|
||
|
||
## 📁 项目结构
|
||
|
||
```
|
||
src/
|
||
├── components/ # 可复用组件
|
||
│ ├── ui/ # 基础UI组件
|
||
│ ├── Layout.tsx # 布局组件
|
||
│ ├── AnalysisResultDisplay.tsx # 分析结果展示
|
||
│ └── ...
|
||
├── pages/ # 页面组件
|
||
│ ├── HomePage.tsx # 首页
|
||
│ ├── AnalysisPage.tsx # 分析页面
|
||
│ ├── HistoryPage.tsx # 历史记录
|
||
│ └── ...
|
||
├── contexts/ # React上下文
|
||
│ └── AuthContext.tsx # 认证上下文
|
||
├── hooks/ # 自定义Hook
|
||
├── lib/ # 工具库
|
||
│ ├── supabase.ts # Supabase客户端
|
||
│ └── utils.ts # 工具函数
|
||
├── types/ # TypeScript类型定义
|
||
└── data/ # 静态数据
|
||
```
|
||
|
||
## 🎨 设计特色
|
||
|
||
- **中国风设计**：采用传统中国元素和配色方案
|
||
- **响应式布局**：完美适配桌面端和移动端
|
||
- **无障碍设计**：遵循WCAG无障碍设计标准
|
||
- **暗色模式**：支持明暗主题切换
|
||
- **动画效果**：流畅的交互动画提升用户体验
|
||
|
||
## 🔐 安全特性
|
||
|
||
- **用户认证**：基于Supabase的安全认证系统
|
||
- **数据加密**：敏感数据传输和存储加密
|
||
- **权限控制**：细粒度的用户权限管理
|
||
- **输入验证**：严格的前后端数据验证
|
||
- **HTTPS支持**：全站HTTPS加密传输
|
||
|
||
## 📱 功能模块
|
||
|
||
### 用户系统
|
||
- 用户注册/登录
|
||
- 个人资料管理
|
||
- 分析历史记录
|
||
- 收藏夹功能
|
||
|
||
### 分析系统
|
||
- 多种分析类型选择
|
||
- 实时分析结果生成
|
||
- 详细报告导出
|
||
- 结果分享功能
|
||
|
||
### 数据管理
|
||
- 分析记录存储
|
||
- 数据备份恢复
|
||
- 隐私设置管理
|
||
|
||
## 🤝 贡献指南
|
||
|
||
我们欢迎所有形式的贡献，包括但不限于：
|
||
|
||
- 🐛 Bug报告
|
||
- 💡 功能建议
|
||
- 📝 文档改进
|
||
- 🔧 代码贡献
|
||
|
||
### 开发流程
|
||
|
||
1. Fork本项目
|
||
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
|
||
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
|
||
4. 推送到分支 (`git push origin feature/AmazingFeature`)
|
||
5. 创建Pull Request
|
||
|
||
## 📄 许可证
|
||
|
||
本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。
|
||
|
||
## 🙏 致谢
|
||
|
||
- 感谢所有贡献者的辛勤付出
|
||
- 感谢开源社区提供的优秀工具和库
|
||
- 感谢传统命理学大师们的智慧传承
|
||
|
||
## 📞 联系我们
|
||
|
||
- 项目主页：[https://github.com/patdelphi/suanming](https://github.com/patdelphi/suanming)
|
||
- 问题反馈：[Issues](https://github.com/patdelphi/suanming/issues)
|
||
- 功能建议：[Discussions](https://github.com/patdelphi/suanming/discussions)
|
||
|
||
---
|
||
|
||
**三算命** - 让传统智慧与现代技术完美融合，为您的人生提供智慧指引。
|