ai-proj-helper/plugins/enjoysa-plugin/skills/SKILL.md

name, description

name	description
enjoysa	EnjoySA 畅游南澳旅游平台开发。用于前端页面开发、组件开发、i18n国际化。当用户提到 enjoysa、畅游南澳、旅游平台、供应商后台相关任务时自动激活。

EnjoySA 开发技能

畅游南澳旅游平台，面向 C 端游客和 B 端供应商的在线旅游服务系统。

项目信息

项目	值
本地路径	/Users/donglinlai/coding/qiudl/enjoysa
Git 仓库	https://gitea.pipexerp.com/qiudl/enjoysa.git
主分支	main
技术栈	Vite + React 18 + TypeScript + CSS Modules
部署服务器	singapore (43.134.28.147:6066)
访问地址	http://43.134.28.147:6066

---

架构概览

enjoysa/
├── web/                          # React 前端
│   ├── src/
│   │   ├── components/           # 通用组件
│   │   │   ├── Common/           # Header, Footer, LanguageSwitcher
│   │   │   ├── Auth/             # LoginForm, RegisterForm
│   │   │   └── Supplier/         # SupplierLoginForm, SupplierRegisterForm
│   │   ├── pages/                # 页面组件
│   │   │   ├── LoginPage/        # C端用户登录
│   │   │   ├── SupplierLoginPage/# B端供应商登录
│   │   │   ├── AdminLoginPage/   # 平台管理员登录
│   │   │   ├── TermsPage/        # 服务条款
│   │   │   ├── PrivacyPage/      # 隐私政策
│   │   │   └── Supplier/         # 供应商后台模块
│   │   ├── i18n/                 # 国际化
│   │   │   └── locales/          # 翻译文件
│   │   │       ├── zh-CN.json
│   │   │       └── en-US.json
│   │   └── types/                # 类型定义
│   ├── scripts/                  # 部署脚本
│   └── dist/                     # 构建产物
├── backend/                      # Go 后端 (规划中)
└── docs/                         # 文档

---

页面路由

C 端 (游客)

路由	页面	说明
/	HomePage	首页
/login	LoginPage	用户登录/注册
/terms	TermsPage	服务条款
/privacy	PrivacyPage	隐私政策

B 端 (供应商)

路由	页面	说明
/supplier/login	SupplierLoginPage	供应商登录
/supplier/register	SupplierRegisterPage	供应商入驻申请
/supplier	SupplierDashboard	供应商仪表盘
/supplier/products	SupplierProducts	产品管理
/supplier/orders	SupplierOrders	订单处理
/supplier/finance	SupplierFinance	财务结算

管理端

路由	页面	说明
/admin/login	AdminLoginPage	管理员登录

---

i18n 国际化

翻译文件位置

web/src/i18n/locales/
├── zh-CN.json    # 简体中文
└── en-US.json    # 英文

命名空间规范

命名空间	用途	示例
brand.*	品牌信息	brand.name, brand.tagline
auth.*	登录注册	auth.loginTitle, auth.emailPlaceholder
terms.*	服务条款	terms.title, terms.sections.*
privacy.*	隐私政策	privacy.title, privacy.sections.*
supplier.*	供应商模块	supplier.login., supplier.dashboard.
admin.*	管理员模块	admin.login., admin.dashboard.
common.*	通用文本	common.submit, common.cancel
footer.*	页脚	footer.supplierEntry, footer.copyright

添加新翻译步骤

1. 在 zh-CN.json 和 en-US.json 中同时添加新 key
2. 使用 useTranslation() hook 获取 t 函数
3. 使用 t('namespace.key') 获取翻译文本

import { useTranslation } from 'react-i18next';

const MyComponent = () => {
  const { t } = useTranslation();
  return <h1>{t('brand.name')}</h1>;
};

注意事项

• 禁止硬编码中文/英文，所有用户可见文本必须使用 i18n
• 长文本内容（如条款、政策）使用 \n 分段
• JSON 中避免使用中文引号 "" ''，使用 「」 或英文引号

---

组件规范

Common 组件

组件	用途	文件
Header	顶部导航栏	components/Common/Header/
Footer	页脚（含供应商入口）	components/Common/Footer/
LanguageSwitcher	语言切换器	components/Common/LanguageSwitcher/

Auth 组件

组件	用途	文件
LoginForm	C端登录表单	components/Auth/LoginForm/
RegisterForm	C端注册表单	components/Auth/RegisterForm/

Supplier 组件

组件	用途	文件
SupplierLoginForm	供应商登录表单	components/Supplier/SupplierLoginForm/
SupplierRegisterForm	供应商入驻申请表单	components/Supplier/SupplierRegisterForm/

---

本地开发

启动前端

cd /Users/donglinlai/coding/qiudl/enjoysa/web
npm install
npm run dev

构建

npm run build

部署

./scripts/deploy.sh

或手动部署：

scp -r web/dist/* singapore:/opt/enjoysa/

---

供应商类型

系统支持以下供应商类型：

类型	说明
travel_agency	旅行社
hotel	酒店
attraction	景区
restaurant	餐厅
car_rental	租车公司

---

相关技能

• enjoysa-deploy - 部署到新加坡服务器
• frontend-design - 前端界面设计
• dev-coding - 软件编码开发

---

版本历史

版本	日期	变更
1.0.0	2026-01-31	初始版本，包含项目结构、页面路由、i18n规范