GINECHIP 架构蓝图

输入密码以查看项目架构
密码错误，请重试
账号: admin
密码: ginechip2026
GINECHIP™
Live Astro 6 + Vercel + WP 89 pages · 8 components · 40+ APIs

GINECHIP 架构全景图

每个功能模块、API、组件、脚本均已展开 · 半导体衬底 & 工艺服务 B2B 平台
更新于 · 展开全部 · 折叠全部

数据流向

用户请求 → Vercel Edge → Astro SSR → WordPress / WooCommerce → 响应

🌐 浏览器
HTTPS Request
→
▲ Vercel Edge
路由 / CDN
→
◆ Astro SSR
middleware.ts
→
⬡ WordPress
REST + WC API
→
◆ 页面渲染
SSR HTML
→
🌐 用户
HTML 页面
📄

页面路由层

src/pages/
89 个路由 · 9 个业务域▼
输入: URL → middleware 解析 locale → 输出: SSR HTML 或 API JSON · 依赖: wordpress.ts, BaseLayout, Components
🌐 系统路由
index.astro
首页 - HERO + 产品/服务/行业/文章 + CTA
[locale]/index.astro
多语言首页代理 (rewrite → /)
[locale]/[...slug].astro
多语言动态 slug (rewrite → WP 页面)
404.astro
404 页面
🛒 电商
shop.astro
商城首页
product-search.astro
产品搜索页
product/[slug].astro
产品详情（动态）
product-category/[slug].astro
产品分类（动态）
cart.astro
购物车页面
checkout.astro
结账页面
send-rfq.astro
发送询价
my-account.astro
我的账户
📡 Substrates · 基板产品
substrates.astro
基板总览页
silicon-wafer-substrate.astro
硅晶圆基板入口
silicon-wafer-substrate/prime-wafer.astro
Prime 级硅晶圆
silicon-wafer-substrate/test-monitor-wafer.astro
测试/监控晶圆
silicon-wafer-substrate/dummy-mechanical-wafer.astro
虚拟/机械晶圆
silicon-wafer-substrate/reclaimed-wafer.astro
再生晶圆
silicon-wafer-substrate/ultra-thin-taiko-wafer.astro
超薄 Taiko 晶圆
silicon-wafer-substrate/fz-high-resistivity-wafer.astro
FZ 高阻晶圆
silicon-wafer-substrate/soi-wafer.astro
SOI 晶圆
silicon-wafer-substrate/thermal-oxide-wafer.astro
热氧化硅晶圆
silicon-wafer-substrate/nitride-wafer.astro
氮化硅晶圆
silicon-wafer-substrate/epi-wafer.astro
外延硅晶圆
compound-semiconductors.astro
化合物半导体入口
compound-semiconductors/sic-wafer-substrate.astro
SiC 晶圆衬底
glass-substrates.astro
玻璃基板入口
coated-substrates.astro
镀膜基板入口
other-materials.astro
其他材料
ingots-bulk-sale.astro
晶锭批量销售
⚙️ Services · 制程服务
mems-process.astro
MEMS 制程总览
photolithography.astro
光刻服务
thin-film-coating-deposition.astro
薄膜镀膜沉积
wet-dry-etching-drie.astro
湿法/干法刻蚀 DRIE
wafer-bonding.astro
晶圆键合
polyimide-pi-processing.astro
聚酰亚胺 PI 加工
ion-implantation-doping.astro
离子注入掺杂
through-silicon-via-tsv.astro
TSV 硅通孔
wafer-bumping-ubm.astro
晶圆凸块 UBM
redistribution-layer-rdl.astro
重分布层 RDL
rdl-bump-wafer.astro
RDL 凸块晶圆
material-customization.astro
材料客制化
pattern-customization.astro
图案客制化
film-coating-customization.astro
镀膜客制化
daisy-chain-wafers.astro
菊链晶圆
dummy-die-fabrication.astro
虚拟芯片制造
reprocessing.astro
再生服务总览
wafer-reclaim.astro
晶圆回收再生
chemical-cleaning.astro
化学清洗
edge-grinding.astro
边缘研磨
wafer-resizing.astro
晶圆尺寸变更
laser-marking-re-id.astro
激光标记
flatness-re-certification.astro
平整度认证
ttv-bow-warp-measurement.astro
TTV/弓曲测量
particle-count-certification.astro
颗粒计数认证
custom-reclaim-protocols.astro
客制回收协议
🔧 Accessories · 配件耗材
accessories.astro
配件总览
wafer-cassettes-peek-esd.astro
PEEK/ESD 晶圆盒
wafer-frames-rings.astro
晶圆框架/环
shipping-boxes-carriers.astro
运输盒/载具
ic-die-boxes.astro
IC 芯片盒
lithography-masks-photomasks.astro
光刻掩模版
photoresists-chemicals.astro
光刻胶/化学品
low-yield-scrap-dies-wafers.astro
低良率/废料晶圆
🎯 Applications · 应用领域
applications.astro
应用领域总览
mems-sensors.astro
MEMS 传感器
rf-power-devices.astro
RF 功率器件
photonics-lidar.astro
光子学 / LiDAR
power-electronics-sic-gan.astro
功率电子 SiC/GaN
advanced-packaging.astro
先进封装
rd-prototyping.astro
研发原型
📚 Resources · 资源中心
resources.astro
资源总览
technical-articles.astro
技术文章
material-property-guide.astro
材料特性指南
process-selection-guide.astro
制程选择指南
semi-standards-reference.astro
SEMI 标准参考
blog.astro
博客首页
company-news.astro
公司新闻
product-updates.astro
产品更新
industry-insights.astro
行业洞察
exhibition-events.astro
展会活动
🏢 Company · 公司
about.astro
关于我们
contact.astro
联系我们
fab-to-fab-supply.astro
Fab-to-Fab 供应链
research-institution-support.astro
研究机构支持
startup-prototyping-kits.astro
初创原型套件
⚖️ Legal · 法律
terms.astro
服务条款
privacy-policy.astro
隐私政策
cookie-policy.astro
Cookie 政策
🔌 API 路由
api/contact.ts
联系表单 POST → WP 自定义端点
api/orders.ts
订单创建 POST → WooCommerce REST
api/orders-lookup.ts
订单查询 GET → WooCommerce REST
🧩

组件层

src/components/ + src/layouts/
8 个组件 + 1 布局▼
输入: Astro.props, Astro.locals · 输出: 服务端渲染 HTML 片段 · 依赖: i18n/utils.ts, wordpress.ts (MiniCart)
Navbar.astro
顶部信息栏 + 6级Mega菜单 + 多语言切换 + 购物车 + 移动端抽屉
Footer.astro
五列页脚：品牌/产品/服务/应用+资源/公司+法律 · 社交链接 · ISO认证
BaseLayout.astro
根布局 · CSS设计系统 · Google Fonts · GA · SEO meta · OG · Navbar+Footer
LanguageSwitcher.astro
客户端6语言下拉切换 · 自动构建目标语言URL
PageHeader.astro
统一页面头部Banner · 背景图+渐变覆盖+标题描述
MiniCart.astro
购物车悬浮下拉面板 · 最多5件商品 · 小计 · WC API
CartToast.astro
全局购物车操作通知 · 成功/错误/信息 · 自动消失
ImageGallery.astro
产品图片画廊 · 2/3/4列网格 · hover动画
🔌

数据访问层

src/lib/wordpress.ts
40+ API 函数 · ~660行▼
上游: cms.ginechip.com (WP REST + WooCommerce REST) · 认证: HTTP Basic Auth / Consumer Key+Secret · 下游: 所有 SSR 页面和API路由
🔐 认证 & 工具函数
getWooCommerceAuth()生成 WC Basic Auth header
getFeaturedImage()从 _embedded 提取特色图片 URL + alt
stripHtml()去除 HTML 标签获取纯文本
getProductMeta()meta_data 数组 → Record<string,string>
getProductPrice()价格字符串解析为 number|null
📄 WP REST API · 页面/文章/产品
getPage(slug)按 slug 获取 WordPress 页面
getAllPages()获取所有页面 (最多100条)
getPost(slug)按 slug 获取文章
getPosts(page,perPage)分页获取文章列表
getProduct(slug)按 slug 获取 WP 产品
getProducts(page,perPage)分页获取 WP 产品
🛒 WooCommerce REST API · 产品
getWCProducts(params)WC产品列表 · 分页/分类/搜索/排序/SKU
getWCProduct(id)按 ID 获取单个 WC 产品
getWCProductBySlug(slug)按 slug 获取 WC 产品
getAllWCProducts()获取全部产品 (自动翻页, 最多1000条)
getWCProductCategories()WC 产品分类列表
getWCProductCategoryBySlug()按 slug 获取 WC 分类
updateProductMeta()PUT 更新产品 meta_data
findProductBySku()按 SKU 精确查找产品
📦 WooCommerce REST API · 订单
createWCOrder(order)创建 WC 订单 POST
getWCOrders(params)查询订单列表 · 分页/状态/客户/邮箱/时间
getWCOrder(id)获取单个订单详情
🏷️ 分类/标签/导航
getCategories() / getCategory()文章分类列表 / 按 slug 查找
getPostsByCategory()按分类ID获取文章
getTags() / getTag()标签列表 / 按 slug 查找
getPostsByTag()按标签ID获取文章
getProductCategories()WP 产品分类
getProductsByCategory()按分类获取 WP 产品
getNavMenu(slug)获取 WP 导航菜单项 (多层嵌套)
getAllSlugs()收集所有 slug (页面/文章/产品/分类/标签)
🖼️ 媒体上传
uploadMediaFromFile()从本地文件路径上传到 WP 媒体库
uploadMediaFromBuffer()从内存 Buffer 上传 (支持运行时生成)
🌍

国际化 (i18n)

src/i18n/
6 语言 · 8 函数 · 辅助脚本▼
支持语言: en (English) · zh (繁體中文) · ja (日本語) · ru (Русский) · de (Deutsch) · he (עברית, RTL) · 输入: Astro.locals.locale · 输出: 翻译字符串, lang属性, dir方向
🧠 核心函数 (utils.ts)
t(locale, key, fallback?)核心翻译函数 · 支持点号嵌套查找 · 从 ui.ts 字典取值
isValidLocale(str)校验字符串是否为有效 locale
getLangFromLocale(locale)locale → HTML lang (zh→zh-Hant)
getDirFromLocale(locale)文字方向: he→rtl, 其他→ltr
getLocaleName(locale)locale 显示名称 (zh→繁體中文)
getLocaleFromUrl(url)从URL路径提取locale (/zh/about→zh)
locales常量: ['en','zh','ja','ru','de','he']
Locale (type)TypeScript 联合类型
📋 翻译字典 (ui.ts)
ui.ts所有 UI 文案的6语言翻译字典 · nav/footer/页面级翻译键
🔧 辅助脚本 (根目录)
_add_i18n_keys.py / _add_i18n_keys2.py / _add_i18n_keys3.py
批量向 Astro 页面注入 t() 调用
_gen_i18n.py / _gen_ui_ts.py
自动生成 ui.ts 翻译字典
_i18n_transform.py
Astro 文件 i18n 文本转换
_i18n-patch.mjs / _i18n-task-gen.mjs
i18n 补丁修复 / 翻译任务生成
translate-pages.mjs
批量翻译6语言字典 (scripts/)
⚙️

中间件

src/middleware.ts
请求级别 · 语言检测▼
触发: 每个 HTTP 请求 · 逻辑: ① URL 前缀 /zh|ja|ru|de|he/ → ② 查询参数 ?__locale=xx → ③ 默认 en · 下游: Astro.locals.locale
defineMiddleware(onRequest)
Astro 中间件入口
URL pathname regex
/^\/(zh|ja|ru|de|he)(\/|$)/ 匹配语言前缀
__locale query param
备选语言检测方式
context.locals.locale
写入检测到的 locale · 全局可用
🔧

构建 & 部署脚本

scripts/
12 个脚本 · 3 大类别▼
触发: CLI 手动 / 构建钩子 · 环境: Node.js + Python · 输出: 生成图片、上传WP、翻译、路由修复
🎨 图片生成 + 上传
gen-v4.mjs
Pollinations AI 生成 v4 版设计图 (6张)
gen-v3.mjs
Pollinations AI 生成 v3 版 (抽象晶圆衍射图案)
gen-v2.mjs
Pollinations AI 生成 v2 版 (极简风格 7张)
gen-hero-v5.sh
Shell 脚本生成 hero-v5 图片
upload-to-wp.mjs
7张区域图片批量上传到 WP 媒体库
upload-v4.mjs
v4 版图片上传 WP
upload-v3.mjs
v3 版图片上传 WP
upload-v2.mjs
v2 版图片上传 WP
🚀 部署 & 翻译
fix-vercel-routes.mjs
修复 Vercel config.json 路由顺序 (动态路由→404前)
translate-pages.mjs
批量生成6语言翻译字典
🤖 Ralph 自动化框架
ralph/ralph.sh
自主 AI 代理循环 · 读取 prd.json → 逐条实现用户故事 → 提交代码
ralph/CLAUDE.md
Ralph Agent 指令 · PRD驱动开发流程
ralph/prompt.md
Agent 提示词
ralph/skills/prd/SKILL.md
PRD 技能定义
📊

数据表生成器

_datasheet-standalone/
5 个文件 · PDF管线▼
数据流: Google Sheets → Webhook/AI Agent → PDFKit 生成PDF → WordPress 媒体库 → WooCommerce meta _datasheet_pdf_url
datasheet-webhook.ts
Astro API 路由 · Webhook POST → 生成PDF → 上传WP → 更新 WC meta
pdf-datasheet.ts
PDFKit 核心库 · 读取 Google Sheets 按SKU生成含表格的PDF
gen-datasheet.mjs
CLI 独立脚本 · 按 SKU 生成单个 PDF
gen-datasheets-batch.mjs
CLI 批量脚本 · 遍历所有SKU逐行生成PDF+上传+更新meta
apps-script/webhook.gs
Google Apps Script · Sheet onEdit 触发器 → webhook 自动生成
⚡

配置层

根目录
5 个配置文件▼
astro.config.mjs
Astro 核心配置 · output: 'server' · adapter: vercel()
vercel.json
Vercel 部署配置 · 构建命令 · Git集成 · 静态路由
package.json
依赖: astro v6 + @astrojs/vercel · Node >=22.12.0 · dev/build/preview
tsconfig.json
TypeScript 配置 · 继承 astro/tsconfigs/strict
.gitignore
dist/ · .vercel/ · node_modules/ · .env
🖼️

静态资源

public/
50+ 图片 · 3 目录▼
images/banners/ (40+ 图)
业务领域 banner: silicon-wafer, sic-wafer, mems-sensor, photolithography 等
images/mega/ (6 图)
Mega Menu 分类图
images/hero-*.jpg
Hero 区域 v2~v5 版本图片
images/products-*.jpg
产品区 v2~v4 版本图片
images/services-*.jpg
服务区 v2~v4 版本图片
images/industries-*.jpg
行业区 v2~v4 版本图片
images/articles-*.jpg
文章区 v2~v4 版本图片
images/cta-*.jpg
CTA 区 v2~v4 版本图片
images/stats-*.jpg
统计数据区图片
hero-banner.jpg
Vercel 路由独立映射 (/hero-banner.jpg)
favicon.ico / favicon.svg
网站图标
89
页面路由
8
组件
40+
API 函数
6
语言
12
脚本
508
星级评分

文件树

完整目录结构一览

ginechipastro/
├── src/ ← 主源码
│   ├── middleware.ts ← 语言检测中间件
│   ├── components/
│   │   ├── Navbar.astro
│   │   ├── Footer.astro
│   │   ├── LanguageSwitcher.astro
│   │   ├── MiniCart.astro
│   │   ├── CartToast.astro
│   │   ├── PageHeader.astro
│   │   └── ImageGallery.astro
│   ├── layouts/
│   │   └── BaseLayout.astro ← CSS变量 + SEO + GA
│   ├── lib/
│   │   └── wordpress.ts ← WP + WC API 客户端
│   ├── i18n/
│   │   ├── ui.ts ← 翻译字典
│   │   └── utils.ts ← 翻译函数 + 语言工具
│   ├── pages/ ← 89 个路由
│   │   ├── index.astro
│   │   ├── about.astro
│   │   ├── [locale]/
│   │   └── api/
│   └── env.d.ts
├── scripts/ ← 构建 & 部署
├── _datasheet-standalone/ ← PDF数据表管线
├── public/ ← 静态资源
├── astro.config.mjs
├── vercel.json
├── package.json
└── tsconfig.json
核心文件 Astro 组件 脚本/工具 目录 API / 中间件