快速开始

5 分钟启动开发环境，开始使用 TSystems 开发你的产品。

最小环境要求

• Node.js：v22.18.0+（原生支持 TypeScript，无需编译）
• 数据库：MySQL / MariaDB 数据库

1. 克隆项目

git clone <仓库地址>
cd systems

2. 配置环境变量

项目根目录下有以下环境文件：

文件	用途
.env	基础环境变量（数据库、密钥等）
.env.int	集成环境配置
.env.pre	预发布环境配置
.env.production	生产环境配置

确保 .env 中的数据库配置正确：

# 数据库配置示例
DB_HOST=localhost
DB_PORT=3306
DB_USER=root
DB_PASSWORD=your_password
DB_NAME=systems

3. 安装依赖

npm run ready

4. 创建你的第一个产品 SPA 应用

1. 在 apps/ 下创建新的 SPA 应用（假定目录名为 example）
2. 执行 npm run dev，然后本地访问 http://localhost:9000/example 即可访问到新建的 SPA 应用。
3. 在 src/models/ 中定义数据表结构
4. 在 typings/ 中定义类型
5. 在 migrations/ 中创建数据库迁移文件
6. 在 src/services/ 中编写业务逻辑
7. 在 src/controllers/ 中创建控制器
8. 在 src/routes/ 中注册新路由
9. 执行 npm run lint 进行代码检测
10. 执行 npm run buildAndDeploy 发布到正式环境
11. 访问 https://www.<你的域名.com>/example 即可访问 SPA 应用

5. 创建产品落地页应用

1. 在 apps-home/ 目录下创建同名（这里是 example）的产品落地页 SSG 应用；可使用 Nuxt、VitePress 或配置 output: "export" 的 Next.js
2. 执行 cross-env TASKS=ssg:example node --run dev 开始开发
3. 执行 npm run lint 进行代码检测
4. Next.js 应用将静态资源输出到 apps-home/example/out；Nuxt 应用输出到 apps-home/example/dist
5. Next.js SSG 由根级构建脚本显式使用 Webpack，避免直接使用默认 next build 触发当前 Next 16 Turbopack 的内部构建错误
6. 执行 npm run buildAndDeploy:ssg 发布落地页应用
7. 访问 https://example.<你的域名.com> 即可访问到产品落地页 SSG 应用（需要对应的域名解析）

6. 创建实时渲染导航类应用

1. 在 apps-home/ 下创建 Nuxt 应用，并在 generateNuxtConfig 中启用 isSsr: true 与 useCdn: false
2. 将应用加入 STANDALONE_SSR_APPS，为 Nitro 分配监听端口
3. 执行 cross-env TASKS=ssr:example node --run dev 本地开发
4. 构建时使用 nuxt build，部署脚本上传 Nitro .output 并由 PM2 启动 server/index.mjs
5. Nginx 将站点根路径代理到 Nitro，并将 /api/ 代理到 Express；需要共享登录态时将会话 Cookie 的域设置为父域