Mirrors/suanming

Fork 0

mirror of https://github.com/patdelphi/suanming.git synced 2026-02-27 21:23:12 +08:00

Files

patdelphi 5e87725cde docs: 添加完整的项目文档和说明文件

2025-08-18 09:20:15 +08:00

5.9 KiB

Raw Blame History

三算命 - 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

安装步骤

克隆项目

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

安装依赖

pnpm install
# 或者使用 npm
npm install

环境配置

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

VITE_SUPABASE_URL=your_supabase_project_url
VITE_SUPABASE_ANON_KEY=your_supabase_anon_key

启动开发服务器

pnpm dev
# 或者使用 npm
npm run dev

访问应用

打开浏览器访问 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报告
💡 功能建议
📝 文档改进
🔧 代码贡献

开发流程

Fork本项目
创建特性分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
创建Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🙏 致谢

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

📞 联系我们

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

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

5.9 KiB Raw Blame History Unescape Escape