ARTICLE · 1366152
JAVA AI算命AI测算运势系统源码支持小程序+公众号+H5
FORTUNE CALC / JAVA / UNI-APP 八字排盘 · 流年运势 · 姻缘配对 · 会员次数 AI算命测算系统支持三端录入档案、下单测算、报告交付,一套后台跑通 用户端:排盘 / 报告 / 会员 / 档案管理端:项目 / 订单 / 退款 / 次数流水 技术栈 用户端 uniapp(vue语法) 管理后台 vue+elementUi 后台服务 springboot+mybatisplus+mysql |
命理测算类产品看着简单,真正的工程量在两处:一是排盘算法的准确性——历法换算、节气分界、真太阳时,错一步整盘皆错;二是交易链路的可靠性——付费报告、会员次数、异步生成、失败退次,任何一环漏了都会变成客诉。
这套系统用Spring Boot + MyBatis-Plus + MySQL 做服务端,uni-app(Vue 语法) 一套代码发布微信小程序、微信公众号、H5 三端,管理后台用 Vue + ElementUI。算法引擎与业务系统解耦,报告生成走异步任务,扣次数与下单绑在同一个事务里。
文中截图均为演示数据,已对姓名、生辰、订单编号与出生地点做打码处理。九个功能按「建档 → 测算 → 交付 → 复购」的业务链路逐项拆开讲。
一、功能总览
九个功能分三层:内容层(八字排盘、五行测算、星盘测算、流年运势、姻缘配对、手相解析、周公解梦)、数据层(档案管理)、商业层(会员管理)。先各用一句话说明它们解决什么问题。
01 · BAZI 八字排盘 把出生年月日时换算成四柱干支,是所有测算的底座。 | 02 · WUXING 五行测算 统计金木水火土旺衰缺补,给出喜用方向。 | 03 · HOROSCOPE 星盘测算 按出生时间地点起本命盘,看行星与宫位相位。 |
04 · YEARLY 流年运势 大运叠加流年,输出年度分项与阶段节奏。 | 05 · MATCH 姻缘配对 双方档案合盘,给出匹配度与相处提示。 | 06 · PALM 手相解析 上传掌纹照片,分项解读主线与辅线。 |
07 · DREAM 周公解梦 梦境关键词检索词条,结合语境生成释梦文案。 | 08 · PROFILE 档案管理 生辰资料存一次,下单自动带入不重复填。 | 09 · MEMBER 会员管理 月/季/年卡发次数,免费测算与邀请奖励。 |
二、功能拆解:从建档到复购
下面按链路顺序拆解九个功能与交付闭环,每个环节标注输入、状态变化与输出。
01 档案管理:一次录入,处处复用
测算类产品的下单表单很长:姓名、性别、公历/农历、出生日期、出生时辰、出生地点。让用户每次测算都重填一遍,转化会被表单劝退。档案模块把这份「出生资料」做成用户级单例:建档一次,所有排盘项目共用。
这里有一条硬规则:姓名、生辰属于个人信息,手相照片接近生物特征,落库必须加密(表中 phone_enc 即密文列),展示层一律脱敏,第三方算法引擎只接收换算后的干支参数,不接收原始姓名与证件信息。
02 八字排盘:四柱只是输出的一半
八字排盘的输入是档案里的出生日期、时辰、地点与历法类型。服务端要做三件事:历法归一(农历先转公历)、节气分界(月柱以立春、惊蛰等节为界,不是初一)、真太阳时校正(按出生地经度与均时差修正时辰,跨时辰临界点直接影响时柱)。
输出分两层:排盘层给出年、月、日、时四柱与十神、大运起运;解读层把干支组合交给规则库或大模型生成文案。两层解耦后,换解读引擎不用动排盘内核。
![]() |
JAVA AI算命测算系统 实拍 01|首页测算入口、八字排盘详情与下单信息确认;截图数据为演示数据 |
03 五行测算:排盘的第一个下游
五行测算不单独采集输入,直接复用八字排盘的中间结果:统计四柱天干地支藏干中金、木、水、火、土的分布与旺衰,输出强弱排序与喜用方向。
实现上它是排盘结果的一个视图:同一次排盘计算完成后,五行分析、大运流年、格局标签从同一份干支数据派生,避免多个模块各自排盘导致口径不一致。
04 星盘测算:同一份档案,另一套算法
星盘走的是西方占星链路:输入同样是出生日期、时辰、地点,但计算内核换成星历表(ephemeris)——太阳、月亮及主要行星的黄经,加上宫位制划分十二宫。
工程要点是时区与经纬度:出生地点先地理编码成经纬度,再换算世界时;时辰缺失时星盘升降宫位不可信,产品上要明确降级为「太阳星座模式」,而不是硬算。
05 流年运势:把静态盘变成动态报告
流年运势的输入是「档案 + 目标年份」,在八字排盘的大运序列上叠加流年干支,输出事业、财运、感情、健康四个分项与阶段节奏。
这类报告是异步生成的:下单后订单进入生成中状态,算法任务完成后回写结果并推送。生成失败要自动退会员次数——截图里的「生成失败」状态与退次逻辑,对应后文的幂等回调代码。
06 姻缘配对:两份档案的合盘
姻缘配对要求双方各有一份完整档案。流程是发起方选自己的档案,再录入对方生辰(或邀请对方从自己的档案授权),服务端分别排盘后做合盘:日主关系、生肖三合六合、用神互补,输出匹配度区间与相处建议。
涉及他人信息就要格外克制:对方档案数据仅用于本次合盘,不留存可关联的明文;匹配度在产品文案里只作为娱乐化表达,不做「注定」「必分」这类断言。
07 手相解析:照片输入的合规线
手相解析的输入是手掌照片。链路为:上传 → 图像预处理(旋正、光照归一)→ 掌纹主线提取 → 规则映射生成生命线、智慧线、感情线的分项解读。
掌纹属于高敏感的生物特征类信息,合规上要做四件事:单独弹窗同意、只解析不长期存原图、解析完成即删或转特征码、支持一键撤回删除。这套系统把照片处理放在独立队列里,与业务库物理隔离,就是为这条线准备的。
08 周公解梦:轻决策入口
周公解梦是九个功能里唯一不需要生辰档案的:输入梦境关键词(蛇、掉牙、考试……),检索传统词条,再结合用户补充语境生成一段释梦文案,引导关注「近期状态」。
它的产品角色是低门槛引流位:免费或低价,用户量大,适合把流量导向八字、流年等付费项目。实现上词条库 + 模板渲染即可,不占排盘算力,独立接口限流即可扛量。
09 会员管理:次数是本账
会员中心卖月度(¥19.9)、季度(¥49.9)、年度(¥168)三档卡,权益是每月免费测算次数与邀请奖励次数,规则写明「次数未用完不结转」。
技术上次数就是一张带版本号的账本:发卡加额度、下单条件扣减、生成失败条件退回,每一步都写 ft_quota_log 流水。扣减必须用一条带余额条件的 UPDATE,先查后改的写法在并发下必然超扣——这正是后文代码块要解决的问题。
![]() |
JAVA AI算命测算系统 实拍 02|个人中心、出生档案与会员开通页;截图数据为演示数据 |
10 报告与订单:交付闭环
测算结果页分两个 Tab:文字摘要免费看,完整报告按项目解锁。订单列表提供查看报告、查看海报、再次测算、删除订单四个动作,状态覆盖待支付、已完成测算、待解锁报告、已退款。
「生成失败」不是终点而是事务的一个分支:失败订单自动退回会员次数,用户可原地再次测算。报告海报带分享标识,邀请奖励次数在会员中心可查明细,形成「测算 → 分享 → 拉新 → 再测算」的闭环。
![]() |
JAVA AI算命测算系统 实拍 03|完整报告、文字摘要与测算订单列表;截图数据为演示数据 |
三、技术架构:三端一套接口
服务端(Spring Boot + MyBatis-Plus + MySQL)持有全部业务规则:历法换算、排盘计算、订单状态机、次数账本、退款审核。这些逻辑一旦放前端,小程序与 H5 各写一份必然漂移。
用户端(uni-app,Vue 语法)负责展示与交互:表单收集、报告渲染、海报生成、支付调起。同一份代码通过条件编译输出微信小程序、微信公众号网页与 H5,登录方式按端适配:小程序走 wx.login 换 openid,公众号走网页授权拿 unionid,H5 走手机号验证码,账号在 unionid 层打通。
管理后台(Vue + ElementUI)面向运营:测算项目上下架与定价、订单查询与重试生成、退款审核、会员发卡、次数流水对账、报告模板与敏感词管理。
结论:命理类产品的护城河在「算法内核 + 交易可靠性」,三端只是同一套接口的三个壳。把排盘引擎做成独立模块(进程内或独立服务均可),业务侧只消费干支与星曜的结构化结果,后续换引擎、加项目、扩端都不伤筋动骨。
四、数据库与核心代码
先看五张核心表:档案、测算项目、订单、会员卡、次数流水。金额与次数全部整型,订单以 request_no 唯一键兜底幂等,流水以 biz_no 唯一键防重复退。
-- 出生档案:敏感字段加密落库,手机号/证件不存明文CREATE TABLE ft_user_profile ( id BIGINT PRIMARY KEY AUTO_INCREMENT, user_id BIGINT NOT NULL, real_name VARCHAR(60) NOT NULL DEFAULT '', gender TINYINT NOT NULL DEFAULT 0 COMMENT '0未知 1男 2女', calendar_type TINYINT NOT NULL DEFAULT 1 COMMENT '1公历 2农历', birth_date DATE DEFAULT NULL, birth_time VARCHAR(12) NOT NULL DEFAULT '', birth_place VARCHAR(100) NOT NULL DEFAULT '', remark VARCHAR(255) NOT NULL DEFAULT '', phone_enc VARCHAR(128) NOT NULL DEFAULT '', updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, UNIQUE KEY uk_user (user_id)) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;-- 测算项目:价格单位「分」,member_free=1 表示会员可用次数CREATE TABLE ft_calc_item ( id BIGINT PRIMARY KEY AUTO_INCREMENT, code VARCHAR(32) NOT NULL COMMENT 'bazi/liunian/hehun/xingpan', name VARCHAR(40) NOT NULL, price_cent INT NOT NULL, member_free TINYINT NOT NULL DEFAULT 1, status TINYINT NOT NULL DEFAULT 1, UNIQUE KEY uk_code (code)) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;-- 测算订单:request_no 唯一键做下单幂等;状态机由服务端维护CREATE TABLE ft_calc_order ( id BIGINT PRIMARY KEY AUTO_INCREMENT, order_no VARCHAR(32) NOT NULL, request_no VARCHAR(64) NOT NULL, user_id BIGINT NOT NULL, item_id BIGINT NOT NULL, profile_id BIGINT NOT NULL, price_cent INT NOT NULL, pay_channel TINYINT NOT NULL COMMENT '1微信 2会员次数 3次卡', status TINYINT NOT NULL DEFAULT 10, -- 10待支付 20生成中 30已完成 40生成失败 50已退款 result_id BIGINT NOT NULL DEFAULT 0, created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_order (order_no), UNIQUE KEY uk_request (request_no), KEY idx_user_status (user_id, status)) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;-- 会员卡:quota 为剩余测算次数,version 供乐观锁扣减CREATE TABLE ft_member_card ( id BIGINT PRIMARY KEY AUTO_INCREMENT, user_id BIGINT NOT NULL, card_type TINYINT NOT NULL COMMENT '1月度 2季度 3年度', quota_total INT NOT NULL, quota_used INT NOT NULL DEFAULT 0, version INT NOT NULL DEFAULT 0, expire_at DATETIME NOT NULL, status TINYINT NOT NULL DEFAULT 1, KEY idx_user (user_id, status, expire_at)) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;-- 次数流水:每次扣减/发放都留痕,可对账可回滚CREATE TABLE ft_quota_log ( id BIGINT PRIMARY KEY AUTO_INCREMENT, user_id BIGINT NOT NULL, card_id BIGINT NOT NULL, change_num INT NOT NULL COMMENT '正数发放 负数扣减', biz_no VARCHAR(64) NOT NULL COMMENT '关联 order_no', created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_biz (biz_no, card_id), KEY idx_user (user_id, created_at)) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; |
示例实现,生产环境需补充参数校验、权限、日志、监控、限流、支付验签等。
下面是会员次数下单的核心事务:扣次数、建订单、写流水三步同生共死;request_no 命中已有订单直接返回原单,网络重试不会双扣。
/** * 会员次数下单:扣次数与建订单必须同生共死。 * 扣减用条件 UPDATE(见下节),失败即抛异常回滚, * 不会出现「次数扣了、订单没落库」的半截状态。 */@Transactional(rollbackFor = Exception.class)public OrderVO createQuotaOrder(Long userId, Long itemId, Long profileId, String requestNo) { CalcItem item = itemMapper.selectActive(itemId); if (item == null || item.getMemberFree() != 1) { throw new BizException("该项目不支持会员次数"); } // 幂等:request_no 已存在直接返回原单,重试不双扣 CalcOrder exist = orderMapper.selectByRequestNo(requestNo); if (exist != null) { return OrderVO.of(exist); } MemberCard card = cardMapper.selectUsable(userId, LocalDateTime.now()); if (card == null) { throw new BizException("没有可用会员卡"); } int rows = cardMapper.deductQuota(card.getId(), card.getVersion()); if (rows == 0) { throw new BizException("次数不足或并发冲突,请重试"); } CalcOrder order = new CalcOrder(); order.setOrderNo(orderNoGenerator.next()); order.setRequestNo(requestNo); order.setUserId(userId); order.setItemId(itemId); order.setProfileId(profileId); order.setPriceCent(0); order.setPayChannel(PayChannel.MEMBER_QUOTA); order.setStatus(OrderStatus.GENERATING); orderMapper.insert(order); quotaLogMapper.insert(QuotaLog.consume(userId, card.getId(), order.getOrderNo())); return OrderVO.of(order);} |
示例实现,生产环境需补充参数校验、权限、日志、监控、限流、支付验签等。
扣减为什么必须写成一条条件 UPDATE?因为「先查后改」在并发下有竞态窗口:两个请求同时读到剩 1 次、双双扣减就超扣。条件 UPDATE 把余额校验压进同一条语句,版本号再挡住「同卡并发」。
/** * 并发安全扣减:一条 SQL 同时完成「校验余额 + 乐观锁」。 * 条件里带 quota_used + 1 <= quota_total, * 余额不足与版本冲突都会返回 0 行,由上层重试或拒绝。 */@Update("UPDATE ft_member_card " + "SET quota_used = quota_used + 1, version = version + 1 " + "WHERE id = #{cardId} AND version = #{version} " + " AND quota_used + 1 <= quota_total " + " AND status = 1 AND expire_at > NOW()")int deductQuota(@Param("cardId") Long cardId, @Param("version") Integer version);// 生成失败退次数:同样走条件更新,biz_no 唯一键防重复退@Insert("INSERT INTO ft_quota_log " + "(user_id, card_id, change_num, biz_no) " + "VALUES (#{userId}, #{cardId}, 1, #{bizNo}) " + "ON DUPLICATE KEY UPDATE id = id")int refundQuotaLog(@Param("userId") Long userId, @Param("cardId") Long cardId, @Param("bizNo") String bizNo); |
示例实现,生产环境需补充参数校验、权限、日志、监控、限流、支付验签等。
报告由算法引擎异步生成,回调可能重复。状态机条件更新(CAS)保证只有「生成中」能变「已完成」,重复回调第二次影响 0 行直接忽略;失败分支同步退次数并写流水。
/** * 报告生成回调幂等:排盘引擎异步回写结果时, * 用状态机条件更新保证「只有 生成中 能变 已完成」。 * 重复回调第二次影响 0 行,直接忽略。 */@Transactional(rollbackFor = Exception.class)public void onEngineFinished(String orderNo, Long resultId, boolean ok) { CalcOrder order = orderMapper.selectByOrderNoForUpdate(orderNo); if (order == null || order.getStatus() != OrderStatus.GENERATING) { return; // 已处理过或状态不对,幂等退出 } int to = ok ? OrderStatus.DONE : OrderStatus.FAILED; int rows = orderMapper.casStatus(order.getId(), OrderStatus.GENERATING, to, resultId); if (rows == 0) { return; } if (!ok && order.getPayChannel() == PayChannel.MEMBER_QUOTA) { // 失败即退次数,保证「次数未用完不结转」规则可审计 cardMapper.refundQuota(order.getUserId(), order.getOrderNo()); } notifyService.push(order.getUserId(), orderNo, to);} |
示例实现,生产环境需补充参数校验、权限、日志、监控、限流、支付验签等。
权限上,档案与订单接口只认 JWT 里的 userId,前端传参一律忽略,杜绝越权读取他人生辰档案。
/** * 权限收口:接口只信 JWT 里的 userId,不信前端传参。 * 档案、订单、次数查询一律以 token 主体过滤, * 越权访问他人生辰档案直接 403。 */@Componentpublic class AuthInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest req, HttpServletResponse resp, Object h) { String token = req.getHeader("Authorization"); Claims claims = jwtService.parse(token); // 验签 + 过期校验 if (claims == null) { resp.setStatus(401); return false; } Long userId = Long.valueOf(claims.getSubject()); if (h instanceof HandlerMethod) { // 路径里的资源归属必须等于当前用户 Long ownerId = PathOwnerResolver.resolve((HandlerMethod) h, req); if (ownerId != null && !ownerId.equals(userId)) { resp.setStatus(403); return false; } } UserContext.set(userId); // Service 层只从这里取用户 return true; }}@RestController@RequestMapping("/api/profile")public class ProfileController { @GetMapping public R<ProfileVO> mine() { // 只按 UserContext 查询,绝不接受前端 userId 参数 return R.ok(profileService.byUser(UserContext.require())); }} |
示例实现,生产环境需补充参数校验、权限、日志、监控、限流、支付验签等。
多端请求统一封装:401 触发一次静默续期,小程序与 H5 的登录差异收敛在条件编译里。
// uni-app 多端请求封装:三端共用一套服务端接口const BASE = 'https://api.example.com';let refreshing = null;export function request(path, opt = {}) { return new Promise((resolve, reject) => { uni.request({ url: BASE + path, method: opt.method || 'GET', data: opt.data, header: { Authorization: 'Bearer ' + uni.getStorageSync('token') }, success: async (res) => { if (res.statusCode === 401) { // 登录态过期:小程序走 wx 静默续期, // 公众号/H5 走 OAuth 跳转,统一在此收敛 await relogin(); return resolve(await request(path, opt)); } if (res.data && res.data.code === 0) resolve(res.data.data); else reject(new Error((res.data && res.data.msg) || '请求失败')); }, fail: reject }); });}function relogin() { if (refreshing) return refreshing; // 并发 401 只续期一次 refreshing = new Promise((done) => { // #ifdef MP-WEIXIN uni.login({ provider: 'weixin', success: (r) => exchangeCode(r.code, done) }); // #endif // #ifdef H5 location.href = '/oauth/wechat?redirect=' + encodeURIComponent(location.href); // #endif }); return refreshing;} |
示例实现,生产环境需补充参数校验、权限、日志、监控、限流、支付验签等。
后台订单表:分页、支付与状态标签、重试生成与退款审核操作,覆盖运营日常。
<template> <div> <el-table :data="rows" border stripe v-loading="loading"> <el-table-column prop="orderNo" label="订单号" min-width="150" /> <el-table-column prop="userName" label="用户" min-width="90" /> <el-table-column prop="itemName" label="项目" min-width="100" /> <el-table-column label="支付" width="90"> <template slot-scope="{ row }"> <el-tag size="mini" :type="row.payChannel === 2 ? 'warning' : 'success'"> {{ row.payChannel === 2 ? '会员次数' : '微信' }} </el-tag> </template> </el-table-column> <el-table-column label="状态" width="90"> <template slot-scope="{ row }"> <el-tag size="mini" :type="statusType(row.status)"> {{ statusText(row.status) }} </el-tag> </template> </el-table-column> <el-table-column label="操作" width="170" fixed="right"> <template slot-scope="{ row }"> <el-button v-if="row.status === 40" type="text" @click="retryGen(row)">重试生成</el-button> <el-button v-if="row.status === 30" type="text" @click="viewReport(row)">查看报告</el-button> <el-button v-if="row.status === 30" type="text" @click="refundAudit(row)">退款审核</el-button> </template> </el-table-column> </el-table> <el-pagination background layout="total, prev, pager, next" :total="total" :page-size="size" @current-change="load" /> </div></template> |
示例实现,生产环境需补充参数校验、权限、日志、监控、限流、支付验签等。
五、合规与上线检查
内容合规:命理测算属娱乐性质内容,全端文案需明示「仅供娱乐参考,不构成任何决策依据」;不得承诺改运、消灾、转运效果;报告文案避免疾病断言、投资指令与胁迫性婚恋表述。
个人信息:姓名、生辰、出生地、手相照片均为个人信息:采集前单独同意、落库加密、展示脱敏、支持删除与撤回;手相原图解析后即删,不留存生物特征明文。
虚拟支付:iOS 端对虚拟内容(报告、会员次数)的购买需按平台规则处理——常见做法是 iOS 隐藏购买入口或引导至 H5/安卓完成;微信支付回调必须验签、防重放。
未成年人:产品定位成年人娱乐;上线前接入实名认证或年龄门槛,拒绝未成年人付费测算。
上线检查清单:订单状态机全链路演练(支付成功/失败/退款/生成失败退次)、并发扣 100 单不超扣、request_no 重放幂等、三端登录态互通、后台退款双人复核、敏感词过滤覆盖全部报告文案。
六、适合谁
适合三类团队:一是命理内容工作室,需要把排盘、合盘、流年报告做成可售卖的产品;二是小程序/H5 开发者,想拿一套「算法 + 交易」完整、可二开的 Java 后端做行业方案;三是私域运营团队,用解梦、手相这类轻功能引流,用会员次数做复购。
不适合:把它当「稳赚」项目的人。这类产品的天花板在内容质量与合规运营,源码只解决工程问题,不解决生意问题。
七、常见问题
Q:农历生日怎么保证排盘准确?A:档案里历法类型是必填项,服务端先把农历按闰月规则转公历,再做节气分界与真太阳时校正;时辰不确定时可放宽为「大致时段」,报告会标注置信范围。
Q:会员次数能攒吗?A:不能。发卡规则写明「每月发放、未用完不结转」,流水表按月清零,可审计可对账。
Q:三端数据互通吗?A:互通。三端共用同一套账号体系(unionid 打通),档案、订单、次数在任何一端产生,其他端实时可见。
Q:排盘算法能换吗?A:能。业务侧只消费「干支 + 星曜」结构化结果,换算法引擎不动交易链路;接入大模型做文案层时,输出必须过敏感词过滤与免责模板。
结语
如果你正在做命理测算或泛娱乐工具类产品,想基于 Spring Boot + uni-app 这套栈拿一套可二开的「排盘 + 会员次数」系统,欢迎找我领取演示资料和部署说明。


















































































