yison/saytu-new
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
10 commits 2 branches 0 tags 12 MiB
  • JavaScript 39.6%
  • TypeScript 28.2%
  • Vue 24%
  • CSS 5.3%
  • SCSS 2.6%
  • Other 0.3%
Find a file
Exact
Inlyliao 630333c1af feat: 实现多组别赛事详情功能，包括主导航梯形样式、渐变背景等
2026-01-13 23:46:09 +08:00
db-structure save 2025-12-26 13:34:39 +08:00
docs save 2026-01-12 11:37:55 +08:00
old-admin save 2025-12-29 14:53:56 +08:00
old-server save 2025-12-29 14:50:05 +08:00
server save 2026-01-12 23:38:08 +08:00
taro-style-datetimepicker save 2026-01-12 11:37:55 +08:00
weapp feat: 实现多组别赛事详情功能，包括主导航梯形样式、渐变背景等 2026-01-13 23:46:09 +08:00
.gitignore save 2026-01-12 11:37:55 +08:00
DATABASE_ARCHITECTURE.md save 2026-01-12 11:37:55 +08:00
DEVELOPMENT_PLAN.md save 2026-01-12 11:37:55 +08:00
git-pull.sh save 2026-01-12 11:39:26 +08:00
git-push.sh save 2026-01-12 11:37:55 +08:00
project.config.json save 2026-01-12 11:37:55 +08:00
PROJECT_ANALYSIS.md save 2026-01-12 11:37:55 +08:00
QUICK_START.md save 2026-01-12 11:37:55 +08:00
README.md save 2026-01-12 11:37:55 +08:00

README.md

赛图项目 (Saytu New)

📋 项目简介

赛图是一个赛事管理平台，支持赛事创建、报名、支付、队伍管理等功能。本项目是新版本，采用现代化的技术栈重新实现。

🏗️ 项目结构

saytu-new/
├── weapp/          # 前端：Taro 3 + React + TypeScript 微信小程序
├── server/         # 后端：Express + TypeScript + Prisma
├── db-structure/   # 数据库结构文件
├── old-admin/      # 旧管理后台（Vue 3，仅参考，不修改）
└── old-server/     # 旧后端（ThinkJS，仅参考，不修改）

🚀 快速开始

1. 查看文档

2. 启动后端

cd server
npm install
cp .env.example .env
# 编辑 .env 配置数据库
npm run prisma:generate
npm run prisma:migrate
npm run dev

后端服务：http://192.168.2.25:8361 API文档：http://192.168.2.25:8361/api-docs

3. 启动前端

cd weapp
npm install
npm run dev:weapp

在微信开发者工具中打开 weapp/dist 目录。

📚 技术栈

前端 (weapp)

  • 框架: Taro 3.4.10
  • UI框架: React 18.3.0
  • 语言: TypeScript 5.4.0
  • 样式: SCSS
  • 构建工具: Webpack 5

后端 (server)

  • 框架: Express.js 4.19.2
  • 语言: TypeScript 5.5.4
  • ORM: Prisma 5.19.0
  • 数据库: MySQL
  • 认证: JWT
  • 验证: Zod
  • API文档: Swagger/OpenAPI 3.0

📊 项目状态

后端 ✅

  • ✅ 8个核心业务模块（35+ 接口）
  • ✅ 完整的数据库模型
  • ✅ API文档（Swagger）
  • ✅ 认证和授权
  • ✅ 错误处理和验证
  • ⚠️ 支付SDK集成（框架已完成）

前端 🚧

  • ✅ 20+ 页面结构完成
  • ✅ 核心组件完成
  • ✅ UI和交互完成
  • ❌ API对接（待完成）
  • ❌ 状态管理（待评估）

整体进度

  • 后端成熟度: 90%
  • 前端成熟度: 60%
  • 整体成熟度: 75%

🎯 当前任务

优先级 P0（立即执行）

  1. ✅ 创建前端API请求工具
  2. ✅ 配置API基础URL
  3. ✅ 实现用户登录对接
  4. ✅ 实现基础数据获取

优先级 P1（本周完成）

  1. 对接核心业务接口（赛事、队伍、报名）
  2. 实现状态管理（如需要）
  3. 统一错误处理
  4. 实现加载状态

详细任务请查看 开发计划

📖 文档目录

项目文档

后端文档

前端文档

🔧 开发规范

代码规范

  • 使用TypeScript严格模式
  • 遵循ESLint规则
  • 统一命名规范（文件：kebab-case，变量：camelCase，类型：PascalCase）

Git规范

  • 主分支：main（生产环境）
  • 开发分支：develop
  • 功能分支：feature/xxx
  • 修复分支：fix/xxx

API对接规范

  • 统一使用service层
  • 统一错误处理
  • 统一数据格式

详细规范请查看 开发计划

⚠️ 重要提示

  1. 不要修改old-admin和old-server

    • 这两个目录仅作参考，不要修改

  2. API路径

    • 后端API路径：/api/v2
    • 前端需要统一使用该路径

  3. 环境配置

    • 开发环境和生产环境配置要分开
    • 敏感信息不要提交到代码仓库

📞 获取帮助

  1. 查看项目文档
  2. 查看后端API文档（Swagger）：http://localhost:8361/api-docs
  3. 查看代码注释
  4. 参考old-server和old-admin（仅参考）

📝 更新日志

2025-01-XX

  • ✅ 完成项目全面分析
  • ✅ 制定工程化开发计划
  • ✅ 创建快速开始指南
  • ✅ 更新项目README

项目维护者: 开发团队 最后更新: 2025-01-XX