AI 智能订阅平台

技术文档中心

操作帮助

集中展示平台所有模块的技术文档，包括架构设计、实现细节、代码统计等技术信息。

操作步骤

浏览文档列表

查看所有可用的技术文档卡片，了解各模块概况。

搜索文档

使用搜索框快速查找特定模块的技术文档。

查看文档详情

点击文档卡片进入详情页，查看完整技术说明。

使用技巧

技术文档仅超级管理员可见，用于团队内部技术交流

文档中的代码统计数据基于最新版本自动生成

常见问题

概述

本平台采用全栈 TypeScript 单体仓库（Monorepo）架构，前后端共享类型定义，确保端到端的类型安全。基于 tRPC 实现前后端通信，无需手动维护 API 文档，类型变更自动同步。

技术栈

前端框架：React 18 + TypeScript

UI 组件库：shadcn/ui + Radix UI + Tailwind CSS 4

前端路由：wouter（轻量级路由）

状态管理：TanStack React Query + tRPC

后端框架：Express + tRPC

数据库：MySQL + Drizzle ORM

认证：OAuth2 + JWT

支付：Stripe / 微信支付 / 支付宝

目录结构

online-subscription-platform/
├── client/                  # 前端代码
│   └── src/
│       ├── components/      # 通用组件（Layout、UI）
│       ├── pages/           # 页面组件（按路由组织）
│       ├── micro-app/       # 微应用注册中心
│       ├── data/            # 静态数据和配置
│       └── lib/             # 工具函数和 tRPC 客户端
├── server/                  # 后端代码
│   ├── _core/               # 核心服务（认证、tRPC、LLM）
│   ├── micro-app/           # 微应用后端注册中心
│   ├── stripe/              # 支付集成
│   └── routers.ts           # API 路由定义
├── drizzle/                 # 数据库 Schema
├── shared/                  # 前后端共享类型
├── scripts/                 # CI/CD 和工具脚本
└── templates/               # 微应用脚手架模板

角色权限体系

角色	标识	权限范围
普通用户	`user`	使用 AI 应用，管理个人积分和订单
管理员	`admin`	管理用户、订单、应用配置、系统设置
超级管理员	`super_admin`	全部权限，含平台级配置、SSO 管理
企业管理员	`enterprise_admin`	管理企业成员、积分分配、应用授权
部门经理	`department_manager`	管理部门成员和部门积分
企业员工	`employee`	使用企业授权的 AI 应用