Loomix
文档中心开发者技术手册Loomix 系统全景架构与数据流转体系

Loomix 平台全局技术架构解析

基于现代化 Headless 彻底解耦的前沿电商架构，全面分离前端展现、商业订单中枢与 CMS 内容管理，各微服务通过 Docker 内部高速桥接网络深度协同。

商城前端展示层 (Next.js 16 Storefront)

基于 React 19 与 Next.js App Router 构建的现代商城前台，深度结合静态生成（SSG）与边缘缓存加速。

电商核心引擎层 (Medusa 2.0 Backend)

驱动整个商城的业务中枢：购物车结算、订单履约、商品管理、多渠道发货、支付网关及实时库存控制。

内容中台管理层 (Strapi v5 CMS)

直观的可视化内容中台，掌管首页排版、动态区块（Dynamic Zones）、营销横幅、官方博客及全站全局配置。

组件注册中心与可视化设计器 (Loomix Registry)

模块化扩展生态，赋能开发者和运营人员在零代码编写的前提下自由扩充商城区块与切换设计风格。

微服务之间的数据流转拓扑架构

  1. 终端用户浏览器通过 Caddy 反向代理网关发起请求，直达 Next.js 16 商城前台服务。
  2. Next.js 通过 Docker 高速内部网络，分别向 Strapi 调取页面区块布局，向 Medusa 调取商品及价格数据。
  3. Next.js 完成页面渲染并将 HTML 静态化缓存，以便为后续访问者提供毫秒级极速直出体验。
  4. 在后台管理中一旦修改发布内容，即刻触发 Webhook 并在数毫秒内重构局部缓存。
页面与动态区块数据获取 GraphQL/REST 查询范例
typescript
const homepageData = await getHomepageData();
const region = await getRegion(countryCode);
const searchResults = await queryMeilisearch({ color: "Red", price_range: [10, 50] });
 
return (
  <main>
    {homepageData.blocks.map((block, index) => (
      <BlockRenderer 
        key={block.id} 
        block={block} 
        region={region} 
        countryCode={countryCode} 
      />
    ))}
  </main>
);

Docker 容器集群的网络隔离与安全边界

Docker Compose 内部网络定义配置
bash
networks:
  internal-network:
    driver: bridge
    internal: true