Xiaomi Vela JS 应用亲戚关系计算器

image-20250706131124824

一款基于快应用平台开发的亲戚关系计算工具，支持通过身份证输入快速解析身份信息并计算亲属关系，提供直观的用户界面和便捷的操作体验。

也欢迎大家一起参与共建，目前的 UI 并不是很满意。

✨ 核心功能

• 📱 身份证智能解析：支持 18 位身份证号码验证（含 X 结尾），自动提取出生日期、性别、籍贯等信息
• ⌨️ 定制输入键盘：优化身份证号输入体验，避免非法字符输入
• 👨‍👩‍👧‍👦 亲属关系计算：根据身份信息智能推算亲属关系图谱
• 📱 多设备适配：响应式布局设计，完美适配不同尺寸的智能设备
• ⚡ 高效验证算法：本地身份证校验算法，无需网络即可完成验证

🚀 快速开始

环境要求

• Node.js v8.10.0+
• npm v5.6.0+
• 快应用开发工具 hap-toolkit

安装步骤

1. 安装快应用开发环境

npm install -g hap-toolkit

1. 克隆项目并安装依赖

# 克隆仓库（示例命令）
git clone git@gitcode.com:nutpi/vela-RelativesCal.git
cd vela-RelativesCal

# 安装依赖
npm install

1. 开发调试

npm run start

启动后通过快应用调试器扫码预览

1. 构建打包

npm run build       # 构建生产版本
npm run release     # 生成发布包

⚙️ 项目结构

src/
├── app.ux               # 应用入口文件，配置全局样式和生命周期
├── idcard.js            # 身份证验证与处理核心逻辑
├── pages/
│   ├── index/           # 首页（结果展示页面）
│   └── detail/          # 详情页（身份证输入页面）
├── common/              # 公共资源（图片、全局样式等）
├── i18n/                # 国际化配置（多语言支持）
└── module/
    ├── data/            # 行政区划等基础数据
    └── method.js        # 身份证解析和亲属关系计算方法

📖 使用指南

基本操作流程

1. 在详情页通过自定义数字键盘输入 18 位身份证号码
2. 点击【验证】按钮提交
3. 系统自动跳转至首页并展示解析结果
   • 身份基本信息（类型、籍贯、出生日期、性别）
   • 身份证有效性验证结果
   • 亲属关系计算结果

输入规则

• 支持 0-9 数字和 X（末位校验码）
• 自动限制输入长度为 18 位
• 支持删除键回溯修改

🔧 开发规范

项目采用 ESLint、Prettier 和 StyleLint 进行代码规范化管理，确保代码质量：

初始化规范配置

# 关联Git仓库后执行（macOS/Linux）
sh husky.sh

# Windows系统
./husky.sh

代码检查与格式化

# 执行ESLint检查
npm run lint

# 自动格式化代码
npm run format

🤝 贡献指南

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 详见 LICENSE[1] 文件

📚 参考文档

• 快应用官方文档[2]
• 快应用开发指南[3]

项目地址：https://gitcode.com/nutpi/vela-RelativesCal

参考资料

[1]

LICENSE: LICENSE

[2]

快应用官方文档: https://iot.mi.com/vela/quickapp

[3]

快应用开发指南: https://doc.quickapp.cn/