Halatap
一个通过单一后台即可创建、分享并导出商务名片至邮件、二维码、vCard 和 Apple Wallet 的现代化名片平台。
Next.js 16
React 19
TypeScript
Convex
Tailwind CSS 4
Radix UI
Resend
概览
Halatap 旨在取代传统纸质名片，打造可随时保持最新状态的数字化名片。每位用户均可通过控制看板基于丰富模板制作名片，并根据当下场景随心分享：公开链接、二维码、电子邮件、可下载通讯录文件，或直接存入 Apple Wallet 的卡券凭证。这是一套基于 Next.js 和 Convex 构建的全栈应用，具备安全账户体系、实时数据同步能力，并原生支持英语与阿拉伯语。
问题
传统纸质名片的弊端日益凸显：职位或电话一旦变更信息立即失效，极易丢失，且局限于单一实体载体。而现状下的数字化分享体验同样支离破碎，信息散落在网址、PDF、二维码和各类即时通讯软件中，缺乏统一的数据维护入口。加之跨国用户往往需要多语言名片，团队用户也有批量制作名片而非单张录入的诉求。Halatap 正是为将所有这些需求收敛到一个系统中而打造。
我的角色与方法
这是一个团队协作项目，我作为核心开发者之一，参与了前端开发以及多项端到端功能的建设。工作内容涵盖名片编辑制作体验、控制看板交互、多样化分享链路，以及使名片脱离应用后依然可用的外部集成功能（Wallet 卡券、vCard 导出和邮件派送）。我们在架构上始终贯彻模块化理念：同一套模板系统既驱动编辑预览也负责公开名片渲染；同一套名片数据 Schema 既支撑单张创建也复用于批量导入，让各项功能在统一底层上高效复用而非各自为政。
技术栈
主要功能
图集
挑战与解决方案
权限访问控制必须在保持灵活的同时避免逻辑冗余。由于公开名片与私密名片遵循不同鉴权规则，我们通过与名片及收件人关联的专属分享表（shares 表）构建数据模型。仅当名片被明确标记为公开时才放行匿名访问，且该鉴权逻辑直接内嵌于名片查询语句中，避免逻辑散落于前端各处。
身份认证体系为自主研发构建而非全盘交由第三方，因此在安全性上做足了考量。密码通过 Web Crypto API 结合加盐 PBKDF2 算法进行哈希加密存储，杜绝明文风险；重置令牌具备严格的时间有效性并在使用后立即作废。其中最具技术挑战的是 Apple Wallet 卡券生成：需要基于证书签名、正确打包素材资源、嵌入二维码负载以及格式化本地化字段，且均需实时生成并以正确的 Content-Type 返回。此外，通过在常规创建流与 CSV 批量导入间复用统一名片 Schema，兼顾了个人与团队级使用场景。
成果
Halatap 实现了数字名片应有的核心价值：打造一个可实时编辑的数字身份，跨越网页、邮件、二维码、通讯录文件及 Apple Wallet 畅行分发，支持双语环境，赋能个人与团队。特别是电子卡券与批量导入能力，使其超越了普通的“个人主页”产品，真正满足了现实中多渠道连接与分发的商业需求。