# OmniCard AI (全球智能数字名片 & 移动微官网 SaaS)

> 面向全球商务出海的下一代 **AI 驱动型智能名片 + 移动微官网 + 访客雷达 CRM + NFC 实体卡管理** 一体化平台。

---

## 📚 规划与设计文档导航

- 📘 **[产品需求文档 (PRD)](./docs/PRODUCT_REQUIREMENTS_DOCUMENT.md)**
  - 核心商业定位与目标用户画像
  - 6大业务架构模块（微官网搭建系统、全球多语言引擎、AI 智能中枢、访客雷达 CRM、NFC 硬件中枢、企业团队管理）
  - 商业化分级订阅模型 (Free / Pro / Enterprise)
  - 阶段性演进实施路线图 (MVP 规划)

- 🎨 **[体验设计大师规范 (UI/UX Design Spec)](./docs/UI_UX_DESIGN_SPEC.md)**
  - “Touch & Spark” 零阻力触达设计哲学
  - Bento Grid (便当盒网格) 响应式美学
  - 全球化出海色彩系统与字体规范（包含阿语 RTL 镜像布局）
  - 关键页面组件字典（访客端主页、AI 顾问浮层、NFC 交互触感、CRM 销售看板）
  - 性能与首屏秒开体验预算 (FCP < 500ms)

---

## 🌟 核心价值亮点

1. **零摩擦触达**：访客无需注册、无需下载 App，NFC 触碰或扫码即可瞬间打开，一键导入手机通讯录 (`.vcf`)。
2. **多语言与智能出海**：支持英、西、阿 (RTL)、中、德、日等国际主流语种，AI 不仅支持翻译更提供地道商务润色。
3. **AI 24/7 数字化身**：名片内置基于企业/个人知识库的 AI 问答代表，全天候接待跨时区海外客商并智能留资。
4. **访客雷达与轻量 CRM**：实时掌握客户访问动态（国家定位、停留时长、阅读案例偏好），智能生成意向度评分与跟进话术。
5. **NFC 动态云端硬件管理**：实体卡一次购入，云端自由切换业务场景（商务展会模式 / 社交模式 / 纯通讯录模式），支持一键远程挂失。

---

## 🛠 正式技术栈选型与规范

详见核心开发指引：**[AGENTS.md](./AGENTS.md)**

- **后端服务 (`backend/`)**：[Cool-Admin (Node.js)](https://node.cool-admin.com/)（基于 Midway.js + TypeScript + TypeORM）
- **管理后台前端 (`admin/`)**：[Arco Design React](https://arco.design/react/docs/start)（字节跳动企业级设计系统）
- **用户多端应用 (`mpuniapp/`)**：[uni-app x](https://doc.dcloud.net.cn/uni-app-x/)（DCloud 原生强类型 uts 跨端引擎，兼顾 App 和 H5）
- **开发与交付原则**：严格 TDD 测试驱动开发、严格官方语法规范、组件高复用、极简干净代码。