Files

T

congsh 3ae141ba56 fix: member status visibility, team creation improvements, join approval flow

- Fix other members' status not visible due to users collection viewRule restriction
- Fix empty status treated as 'away' instead of 'idle' in membersByStatus
- Auto-set creator to 'in_team' status when creating team session
- Filter current user from idle members invite list
- Fix group store isGroupOwner using pb.authStore instead of localStorage
- Add nginx no-cache headers for index.html
- Add join_requests collection migration and join approval flow
- Update groups collection rules and add requireApproval field
- Add Memory types for Phase 2 planning

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-04-18 10:42:11 +08:00

3.5 KiB

Raw Blame History

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

项目概述

Game Group V2 — 游戏组队管理平台。用户创建/加入群组，组队开黑，管理游戏库。

开发命令

# 前端开发（默认连接 localhost:8090 的 PocketBase）
cd frontend && npm run dev

# 前端开发环境（连接远程后端 192.168.1.14:8711，端口 7033）
cd frontend && npm run dev:dev

# 前端 UAT 环境（端口 7034）
cd frontend && npm run dev:uat

# 构建前端
cd frontend && npm run build

# 启动后端（PocketBase，端口 8711）
cd backend && docker-compose up -d

# 部署脚本（根目录）
./deploy-backend.sh   # 部署后端
./deploy-dev.sh       # 部署 Dev 前端
./deploy-uat.sh       # 部署 UAT 前端
./stop-all.sh         # 停止所有服务

技术栈

后端: PocketBase 0.22.4 (Docker, ghcr.io/muchobien/pocketbase) — 无自定义 JS hooks，业务逻辑全在前端
前端: Vue 3 + TypeScript + Pinia + Element Plus + Tailwind CSS + Vite
API 通信: PocketBase JS SDK (pocketbase npm 包)，cookie 认证
实时通信: PocketBase realtime subscriptions

架构

前端目录结构 (`frontend/src/`)

api/ — 每个领域一个文件（users.ts, groups.ts, sessions.ts, invitations.ts, games.ts），封装 PocketBase CRUD 和过滤逻辑。pocketbase.ts 初始化客户端并导出认证工具函数
stores/ — Pinia stores（user, group, team, notification），组合式 API 风格（defineStore('name', () => {...})）
composables/useRealtime.ts — 统一管理 PocketBase 实时订阅，组件卸载时自动清理
views/ — 页面级组件，路由懒加载
components/ — 按领域分子目录：common/, game/, group/, layout/, team/
types/index.ts — 所有 TypeScript 接口和类型定义集中在一个文件

数据模型（PocketBase Collections）

users — 用户，含状态（idle/working/in_team/away）、工作时间设定、积分
groups — 群组，owner + members 关系，支持审核加入（requireApproval）
team_sessions — 临时组队，关联 sourceGroup，状态流转：recruiting → playing → finished/dissolved
invitations — 组队邀请，from/to 用户，pending/accepted/rejected
games — 游戏库，归属 group，含平台、标签、封面
game_comments / game_favorites — 游戏评论和收藏
join_requests — 入群申请，pending/approved/rejected

关键模式

Vite 代理: 开发时 /api 代理到 PocketBase，路径重写去掉 /api 前缀（vite.config.ts）
认证流程: pocketbase.ts → cookie 持久化 → 路由守卫检查 isAuthenticated() → 未登录跳转 /login
实时订阅: 通过 useRealtime composable 和 subscribe* 函数订阅 PocketBase 变更事件，各 store 自行刷新数据
样式系统: 自定义 CSS 变量（design.css，--gg-* 前缀）+ Tailwind + Element Plus，主题色为绿色系

后端

PocketBase 数据迁移在 backend/pb_migrations/，由管理面板操作自动生成
backend/pb_hooks/main.js 为占位文件，当前镜像不支持 JS VM
所有业务逻辑（如入群审批、组队邀请）在前端 API 层实现

环境配置

前端通过 .env 文件配置：

VITE_PB_URL — PocketBase 地址（默认 window.location.origin）
VITE_PORT — 开发服务器端口

3.5 KiB Raw Blame History Unescape Escape