三算命 - 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. 克隆项目

git clone https://github.com/patdelphi/suanming.git
cd suanming

2. 安装依赖

pnpm install
# 或者使用 npm
npm install

3. 环境配置

创建 .env.local 文件并配置以下环境变量：

VITE_SUPABASE_URL=your_supabase_project_url
VITE_SUPABASE_ANON_KEY=your_supabase_anon_key

4. 启动开发服务器

pnpm dev
# 或者使用 npm
npm run dev

5. 访问应用

打开浏览器访问 http://localhost:5173

构建部署

# 构建生产版本
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 文件了解详情。

🙏 致谢

• 感谢所有贡献者的辛勤付出
• 感谢开源社区提供的优秀工具和库
• 感谢传统命理学大师们的智慧传承

📞 联系我们

• 项目主页：https://github.com/patdelphi/suanming
• 问题反馈：Issues
• 功能建议：Discussions

---

三算命 - 让传统智慧与现代技术完美融合，为您的人生提供智慧指引。