docs: 同步设计Token约束至AGENTS.md并添加根目录gitignore规范

.gitignore

@@ -0,0 +1,30 @@
+# 依赖与打包产物
+node_modules/
+dist/
+build/
+.temp/
+.cache/
+
+# 环境与本地配置
+.env
+.env.local
+.env.*.local
+
+# 日志与临时文件
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+*.log
+
+# 编辑器与系统文件
+.DS_Store
+Thumbs.db
+.idea/
+.vscode/
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?

AGENTS.md

@@ -82,6 +82,7 @@
    - 文件与多媒体存储：直接复用官方 OSS/COS/Local 插件，严禁手写底层上传流。
    - 缓存与任务：复用 Cool-Admin 官方 Redis 缓存装饰器与 Task 定时任务引擎。
    - 支付与通讯：涉及第三方支付或短信通知，优先复用官方插件。
+   - 数据库 crmmpdata
 
 ### 4.2 管理后台前端 Arco Design (React) 最大化复用清单
 1. **官方模板与中后台骨架复用**：
@@ -135,3 +136,109 @@
    - 保证推送到远端的代码干净无杂质（严禁提交临时调试文件、无用日志打印或未验证代码）。
 6. **全局中文交流与文档**：
    - 团队内部交互、设计文档、代码注释及任务汇报均统一采用中文描述。
+
+
+更新版，已把**风格约束**一起并入 AI Coding 约束。可直接放入 `.cursorrules` / `CLAUDE.md`。
+
+```md
+# NexaCard AI — AI Coding 约束
+
+## 风格定位
+- 瑞士国际主义 + 现代 SaaS + 编辑感
+- 内容优先，留白即品牌，AI 隐形，CRM 无感，NFC 轻量
+- 全球商务、中性、可信、克制
+- 禁止炫技、拟物、霓虹、玻璃拟态、重装饰
+- 一屏只允许 1 个主 CTA
+
+## 技术栈
+- Next.js + TypeScript + Tailwind + shadcn/ui
+- 移动端：Expo / React Native
+- 状态：Zustand + TanStack Query
+- 表单：react-hook-form + zod
+- 国际化：next-intl
+- 测试：Vitest + Playwright
+
+## 设计 Token（必须引用，禁止硬编码）
+颜色 Light / Dark：
+- primary: #0B5CFF / #4D8DFF
+- primary-soft: #EAF1FF / #102A4D
+- ai: #7C5CFF / #9B8CFF
+- bg: #FFFFFF / #0B0D10
+- surface: #F7F8FA / #12151A
+- border: #E3E7ED / #262B33
+- text: #101828 / #F2F4F7
+- text-2: #667085 / #98A2B3
+- success: #12B76A / #32D583
+- warning: #F79009 / #FDB022
+- error: #F04438 / #F97066
+
+间距：4 / 8 / 12 / 16 / 24 / 32 / 48 / 64
+圆角：按钮 12px，卡片 16px，模态 20px
+阴影：0 1px 2px rgba(16,24,40,0.04)
+字体：Inter, Noto Sans SC, Noto Sans Arabic, Noto Sans JP, Noto Sans KR
+字号：12 / 14 / 16 / 20 / 24 / 32 / 40
+行高：正文 1.6，标题 1.25，阿语 1.7
+最大宽度：内容 1200px，文章 720px
+行宽：45–75 字符
+
+## 配色规则
+- 中性色占 80–90%，品牌色占 10–20%
+- 品牌主色只用单一钴蓝
+- 语义色只用于状态，不做装饰
+- 禁止红、绿、黄作为品牌主色
+- AI 渐变只允许小面积，面积 <5%
+- NFC 用主色 20% 透明脉冲，一次 400ms，不循环
+
+## 组件规则
+- 按钮高 40 / 44 / 48，触控区 ≥44×44
+- 输入框高 44，标签在上，错误在下
+- 卡片 1px 边框，圆角 16，无重阴影
+- 卡片最多两层嵌套，优先用分隔线
+- 图标线性 1.5px，20 / 24px
+- 焦点环 2px primary，offset 2，必须可见
+- 加载优先骨架屏
+- 空状态：一句话 + 一个主 CTA
+- 悬停仅 2–4% 明暗变化，不放大
+
+## 动效
+- 微交互 150ms，抽屉 250ms，页面 400ms
+- 缓动：cubic-bezier(0.2, 0.8, 0.2, 1)
+- 支持 prefers-reduced-motion
+- AI 用微光，不用打字机作为唯一反馈
+- NFC 用一次脉冲，不循环
+
+## 代码规范
+- 严格 TypeScript，禁止 any
+- 组件 PascalCase，函数式
+- 样式只用 Tailwind，禁止内联 style
+- 所有文案走 i18n key，禁止硬编码
+- 颜色 / 间距 / 字体必须用 token，禁止魔法值
+- 支持暗色模式，用 CSS 变量
+- 支持 RTL，用 logical properties（ms / me / ps / pe）
+- 语义化标签 + aria + 键盘可达
+- 动效必须支持 reduced-motion
+
+## 国际化
+- next-intl，默认 en
+- 独立 URL：/en /es /fr
+- hreflang + sitemap
+- 日期 / 货币 / 时区本地化
+- 按钮和标签预留 30% 文本扩展
+- 社交适配：WhatsApp、LinkedIn、Telegram、Line、KakaoTalk、微信
+- 支付：Stripe、PayPal
+- GDPR、CCPA、Cookie 同意、数据导出 / 删除
+- WCAG 2.2 AA，正文对比度 ≥ 4.5:1
+- 不强制登录看名片，不自动播放声音
+
+## 禁止
+- 纯黑 #000
+- 超过 3 种字体
+- 大面积渐变 / 重阴影 / 霓虹
+- 硬编码文案或颜色
+- 固定宽度按钮
+- 强制登录看名片
+- 自动播放声音
+- 一屏多个主按钮
+- 装饰性插画 / 拟物图标 / 文化特定符号
+- 禁止使用emoji
+```

docs/UI_UX_DESIGN_SPEC.md

@@ -1,106 +0,0 @@
-# OmniCard AI 体验设计大师规范 (UI/UX Design Specification)
-
----
-
-### 一、 设计原则与设计语言 (Design Philosophy)
-
-1. **“Touch & Spark” 零阻力触达**：
-   - 访客端无需注册、无需下载 App，通过 NFC 碰触或扫码，800ms 内完成首屏渲染与语言适配。
-   - 核心商业动作（一键保存到手机通讯录、发起 WhatsApp/邮件、预约日程）在 1 次点击内触达。
-2. **Bento Grid 模块化美学**：
-   - 采用类似 Apple / Linear 风格的便当盒网格设计，不同维度的内容（身份、案例、文章、社交矩阵、视频）作为独立的响应式磁贴（Tiles）。
-3. **全球化包容设计 (Universal Inclusivity)**：
-   - 全语种排版适配：支持 LTR（左至右如英文、中文）和 RTL（右至左如阿拉伯文、希伯来文）的镜像翻转布局。
-   - 国际网络容错：弱网离线缓存联系人，高清媒体图片智能懒加载及 WebP 压缩。
-
----
-
-### 二、 视觉与设计系统 (Design System Tokens)
-
-#### 2.1 颜色系统 (Color Tokens)
-- **品牌底色与质感**：
-  - `Dark Canvas`: `#090D16`（深邃黑曜石，减少夜间眩光，提升 OLED 屏质感）
-  - `Surface High`: `#131B2E`（卡片表面）
-  - `Surface Border`: `rgba(255, 255, 255, 0.08)`（1px 微光渐变描边）
-  - `Light Canvas`: `#F8FAFC`（纯净极简浅色自适应）
-- **功能性高光色 (Accent & Semantics)**：
-  - `Electric Blue`: `#2563EB` / `#3B82F6`（国际商务与科技，主行动按钮）
-  - `Emerald Radar`: `#10B981`（高意向访客状态、活跃在线指示灯）
-  - `Sunset Amber`: `#F59E0B`（重点案例、VIP标签）
-  - `Arabic Gold`: `#D97706`（中东/奢华定制版主题点缀）
-
-#### 2.2 排版与跨语言排版规范 (Typography)
-- **字体栈**：
-  - 西文字体：`Inter`, `-apple-system`, `BlinkMacSystemFont`, `sans-serif`
-  - 中文字体：`PingFang SC`, `MiSans`, `Microsoft YaHei`
-  - 阿拉伯文：`IBM Plex Sans Arabic`, `Tajawal`
-  - 数字/统计指标：`JetBrains Mono`, `DIN Next LT Pro`
-- **RTL 镜像规则**：
-  - 当语言切换为阿拉伯语 (ar) 时，整体 UI 自动启用 `dir="rtl"`，左右边距、图标箭头方向、返回按钮自动镜像对调。
-
----
-
-### 三、 核心页面与界面构件字典 (Interface Components)
-
-#### 3.1 移动微官网主页（访客端）
-1. **Header 状态栏与语言选择器**：
-   - 左上角：品牌轻量水印或企业域名。
-   - 右上角：全球语言切换胶囊按钮（如 `🌐 EN ▾`），点击弹出丝滑毛玻璃底部抽屉，快速切换语言。
-2. **Hero 个人/企业身份卡 (Hero Bento Tile)**：
-   - 3D 浮雕/圆角头像，支持微动态呼吸光圈（代表在线状态或当前处于工作时间）。
-   - 姓名旁带有 **[发音播报按钮 🔊]**，解决跨国商务交流中姓名发音不标准的尴尬痛点。
-   - 所在地与时区标签：`📍 Singapore (GMT+8, 14:30 PM - Working hours)`。
-   - 快速连接矩阵：横向轻滑的社交图标群（WhatsApp、LinkedIn、WeChat、X 等）。
-3. **主行动号召栏 (Fixed Bottom Action Bar)**：
-   - 页面底部悬浮毛玻璃栏（Glassmorphism Dock）：
-     - **按钮 A【保存通讯录 (Save Contact)】**：一键触发 Safari / Chrome 的 vCard 导入通道。
-     - **按钮 B【互换名片 (Exchange)】**：快速弹出双向留资卡。
-     - **按钮 C【AI 顾问 💬】**：气泡呼吸动效，提示“Ask anything about our company”。
-4. **精选案例磁贴 (Portfolio Bento Tiles)**：
-   - 2x2 或 2x1 变宽卡片，封面采用高品质大图，下方展示项目成效（如：`+240% ROI`、`$1.2M 签约`）。
-   - 点击展开沉浸式全屏详情页，支持图文排版与多媒体播放。
-5. **深度洞察文章 (Insights & Articles)**：
-   - 简约瀑布流/横滑卡片，显示阅读预估时间（如 `3 min read`）和标签分类，支持一键生成适合分享到朋友圈/LinkedIn 的精美图文分享海报。
-
-#### 3.2 名片内置 AI 助理浮层 (Interactive AI Concierge)
-- **触发形式**：轻量级半屏抽屉式展开（Bottom Sheet），不遮挡主名片背景，保持轻快感。
-- **预设快捷提问泡泡 (Quick Prompt Chips)**：
-  - *“你们提供哪些服务？”*
-  - *“有针对欧洲市场的合作案例吗？”*
-  - *“如何预约 1 对 1 线上会议？”*
-- **留资转化钩子**：AI 回答完毕后，智能挂载下一步操作卡片（如发送产品白皮书至邮箱、直接呼起 WhatsApp 对话）。
-
-#### 3.3 NFC 实体卡互动触感与管理
-1. **触碰微交互**：
-   - 访客手机感应到 NFC 时，页面首先展现轻量加载光环动效，伴随平滑过渡淡入名片。
-2. **App 端 NFC 绑定中心**：
-   - 3D 拟真卡片视图，展示当前绑定的名片样式与绑定的实时短链。
-   - **一键切换模式 (Scene Switcher)**：
-     - `商务会展模式 (Business)`：跳转多语言微官网。
-     - `直接通讯录模式 (Direct vCard)`：触碰直接弹出新建联系人。
-     - `社交主页模式 (Social Hub)`：聚合个人社媒矩阵。
-   - **挂失状态**：一键切换为红灰色不可用状态，若有人刷卡，显示“此卡已由所有者临时挂失”的安全页。
-
-#### 3.4 销售工作台与 CRM 访客雷达
-1. **实时雷达推送卡片 (Radar Live Feed)**：
-   - 卡片式瀑布流：按时间倒序展示每一次名片被访问的事件。
-   - 视觉标识：国旗图标（如 🇦🇪 阿联酋、🇺🇸 美国）、访问来源（NFC 碰触 / 微信转发 / LinkedIn 外部链接）、阅读深度进度条（已阅读 80% 案例）。
-2. **潜在客户看板 (Lead Kanban)**：
-   - 依据 AI 意向度评分（Intention Score）分为：
-     - 🔥 **热意向 (High)**：停留时长 > 2分钟，查看了价格或案例详情，甚至尝试与 AI 助手对话。
-     - ⚡ **常规意向 (Medium)**：浏览了主页并点击了社交链接。
-     - ❄️ **低活跃 (Cold)**：仅打开主页后秒退。
-   - 销售人员在移动端可左滑标记跟进、右滑生成“AI 推荐跟进邮件/WhatsApp 开场白”。
-
----
-
-### 四、 性能体验与交付指标 (Performance & Quality Budget)
-
-1. **秒开加载预算**：
-   - 访客首屏 (FCP - First Contentful Paint) < 500ms（全球 CDN 边缘节点缓存）。
-   - 可交互时间 (TTI - Time to Interactive) < 1.0s。
-   - 核心 Web 体验指标 (Core Web Vitals) 全绿 (LCP < 1.5s, CLS < 0.05)。
-2. **跨平台兼容矩阵**：
-   - iOS: Safari 14+, 适配 Dynamic Island (灵动岛) 及安全区域。
-   - Android: Chrome / Samsung Internet，深度支持 Web NFC API。
-   - 桌面端：大屏自适应为居中手机样机预览（Phone Mockup）+ 侧边交互区，兼具优雅展示效果。