组织介绍

全球流动(Global Flow)工作空间

本工作空间包含全球流动(Global Flow)业务的核心工程和分支功能工程。它们分别独立成仓,放在同一目录下便于联调、需求沉淀和跨项目改动。

项目一览

目录 项目 说明
summer_academy_app/ 微信小程序端 面向用户的产品入口,提供夏校、国际学校、海外项目、内容资讯、会员、订单、申请表和顾问咨询等功能。
summer_academy_admin/ 管理后台 面向运营和管理员的 Web 后台,负责产品、订单、用户、内容运营、海外项目和国际学校情报管理。
summer_academy_server/ 后端服务 Node.js + Express + MySQL API 服务,承载小程序、管理后台、开放接口、支付、上传和定时任务。
school_intelligence_platform/ 国际学校情报分支功能 全球流动(Global Flow)的一部分,用于学校官网采集、图片资源管理、AI 翻译、草稿审核和发布链路。
summer_academy_ai/ AI 协作知识库 存放需求分析、功能设计、工程说明和 AI 编程规范,用于统一产品语境与开发约束。

推荐启动顺序

  1. 启动后端服务:
cd summer_academy_server
npm install
cp .env.example .env
npm run dev

默认服务地址为 http://localhost:3000,接口前缀为 /api,Swagger 文档为 http://localhost:3000/api-docs

  1. 启动管理后台:
cd ../summer_academy_admin
pnpm install
pnpm dev

开发服务默认端口为 9527。测试环境接口配置见 summer_academy_admin/.env.test

  1. 打开小程序端:

使用 HBuilderX 打开 summer_academy_app/,运行到微信开发者工具;或使用 uni-app CLI 构建微信小程序。接口域名配置见 config.jsconfig/api.js

  1. 查阅 AI 协作文档:
cd ../summer_academy_ai

优先阅读 README.mdAI.mdprojects/specs/

联调关系

  • 小程序端调用 summer_academy_server/api/app/*、旧版兼容接口、支付接口和配置接口。
  • 管理后台调用 summer_academy_server/api/admin/*、产品、订单、用户、内容运营、海外项目等接口。
  • 管理后台的国际学校情报模块对接 school_intelligence_platform,开发环境变量为 VITE_SCHOOL_INTELLIGENCE_BASE_URL
  • summer_academy_ai 不参与运行时链路,但应作为需求、设计和 AI 代码生成约束的来源。

文档入口

开发约定

  • 涉及需求、接口、数据模型或页面规范时,先查看 summer_academy_ai/specs/ 和相关功能设计文档。
  • 涉及数据库结构变更时,同步维护全量脚本和增量脚本,增量脚本应具备重复执行的幂等性。
  • 涉及小程序审核体验时,关注后端 REQUIRE_LOGIN 与小程序 /api/config/login 的联动。
  • 涉及文件上传和图片展示时,确认后端 COS 配置、小程序 COS 域名和后台上传接口保持一致。
成就
0
Star
0
Fork
成员(1)
5251171 xh jing 1586505769
XH_jing

搜索帮助