diff --git a/app/Exports/CommonExport.php b/app/Exports/CommonExport.php index dfb7c41..97daf33 100755 --- a/app/Exports/CommonExport.php +++ b/app/Exports/CommonExport.php @@ -64,7 +64,7 @@ class CommonExport implements FromCollection } elseif (str_contains($field, 'partners')) { // 股东信息 $temp[$field] = $this->partners($info); - } elseif (str_contains($field, 'partners')) { + } elseif (str_contains($field, 'project_users')) { // 项目经理 $temp[$field] = $this->projectManager($info); } elseif (str_contains($field, 'users')) { @@ -156,7 +156,7 @@ class CommonExport implements FromCollection { $list = []; foreach ($data['project_users'] as $item) { - $list[] = $item['groupName'] . '-' . $item['userName'] ?? ''; + $list[] = $item['groupName'] . '-' . ($item['userName'] ?? '') . '-' . ($item['investDate'] ?? ''); } return implode("、\r\n", $list); } @@ -169,7 +169,11 @@ class CommonExport implements FromCollection { $list = []; foreach ($data['users'] as $item) { - $list[] = $item['username'] . '-' . $item['company_position'] . '-' . $item['mobile'] ?? ''; + $base = $item['no'] . '-' . $item['username'] . '-' . $item['is_schoolmate_text'] . '-' . $item['company_position'] . '-' . ($item['mobile'] ?? ''); + foreach ($item['course_signs'] as $i) { + $base .= '-' . $i['course']['name'] . '-' . ($i['created_at'] ?? ''); + } + $list[] = $base; } return implode("、\r\n", $list); } diff --git a/app/Http/Controllers/Admin/CalendarsController.php b/app/Http/Controllers/Admin/CalendarsController.php index 1f54e14..7130029 100644 --- a/app/Http/Controllers/Admin/CalendarsController.php +++ b/app/Http/Controllers/Admin/CalendarsController.php @@ -12,6 +12,7 @@ use App\Models\CourseContentEvaluationAsk; use App\Models\CourseContentEvaluationForm; use App\Models\CustomForm; use App\Models\CustomFormField; +use App\Models\HistoryCourse; use App\Models\SupplyDemand; use Illuminate\Support\Facades\DB; use Illuminate\Support\Facades\Validator; @@ -49,16 +50,13 @@ class CalendarsController extends BaseController public function index() { $all = \request()->all(); - $messages = [ - 'month.required' => '月份必填', - ]; - $validator = Validator::make($all, [ - 'month' => 'required', - ], $messages); - if ($validator->fails()) { - return $this->fail([ResponseCode::ERROR_PARAMETER, implode(',', $validator->errors()->all())]); - } - $list = Calendar::with('course', 'courseContent')->where('start_time', 'like', $all['month'] . '%')->orderBy('date')->get(); + $list = Calendar::with('course', 'courseContent') + ->where(function ($query) use ($all) { + if (isset($all['month'])) { + $query->where('start_time', 'like', $all['month'] . '%'); + } + })->orderBy('date') + ->get(); if (isset($all['is_export']) && $all['is_export'] == 1) { $list = $list->toArray(); return Excel::download(new CommonExport($list, $all['export_fields'] ?? ''), ($all['file_name'] ?? '') . date('YmdHis') . '.xlsx'); @@ -93,7 +91,7 @@ class CalendarsController extends BaseController if ($validator->fails()) { return $this->fail([ResponseCode::ERROR_PARAMETER, implode(',', $validator->errors()->all())]); } - $detail = $this->model->with('courseContent')->find($all['id']); + $detail = $this->model->with(['courseContent', 'historyCourses'])->find($all['id']); return $this->success($detail); } @@ -116,6 +114,7 @@ class CalendarsController extends BaseController * @OA\Parameter(name="is_publish", in="query", @OA\Schema(type="string"), required=true, description="是否向用户发布0否1是"), * @OA\Parameter(name="address", in="query", @OA\Schema(type="string"), required=true, description="地址"), * @OA\Parameter(name="days", in="query", @OA\Schema(type="string"), required=true, description="天数"), + * @OA\Parameter(name="history_courses", in="query", @OA\Schema(type="array", @OA\Items(type="object")), required=false, description="历史课程数组,每项包含:type(课程体系ID), course_name(课程名称), course_type_signs_pass(培养人数未去重), course_type_signs_pass_unique(培养人数去重), course_signs_pass(课程培养人数), start_time(开始时间), end_time(结束时间)"), * @OA\Parameter(name="token", in="query", @OA\Schema(type="string"), required=true, description="认证token"), * @OA\Response( * response="200", @@ -125,7 +124,39 @@ class CalendarsController extends BaseController */ public function save() { - return parent::save(); + $all = \request()->all(); + DB::beginTransaction(); + try { + if (isset($all['id'])) { + $model = $this->model->find($all['id']); + if (empty($model)) { + return $this->fail([ResponseCode::ERROR_BUSINESS, '数据不存在']); + } + } else { + $model = $this->model; + $all['admin_id'] = $this->getUserId(); + $all['department_id'] = $this->getUser()->department_id; + } + $original = $model->getOriginal(); + $model->fill($all); + $model->save(); + + // 处理历史课程数据 + if (isset($all['history_courses']) && is_array($all['history_courses'])) { + // 删除原有的历史课程数据 + $model->historyCourses()->delete(); + $model->historyCourses()->createMany($all['history_courses']); + } + DB::commit(); + // 记录日志 + $this->saveLogs($original, $model); + // 返回带有历史课程的数据 + $model->load('historyCourses'); + return $this->success($model); + } catch (\Exception $exception) { + DB::rollBack(); + return $this->fail([$exception->getCode(), $exception->getMessage()]); + } } /** @@ -144,7 +175,33 @@ class CalendarsController extends BaseController */ public function destroy() { - return parent::destroy(); + $all = \request()->all(); + $messages = [ + 'id.required' => 'Id必填', + ]; + $validator = Validator::make($all, [ + 'id' => 'required' + ], $messages); + if ($validator->fails()) { + return $this->fail([ResponseCode::ERROR_PARAMETER, implode(',', $validator->errors()->all())]); + } + + DB::beginTransaction(); + try { + $model = $this->model->find($all['id']); + if (empty($model)) { + return $this->fail([ResponseCode::ERROR_BUSINESS, '数据不存在']); + } + // 删除关联的历史课程数据 + $model->historyCourses()->delete(); + // 删除日历 + $model->delete(); + DB::commit(); + return $this->success([]); + } catch (\Exception $exception) { + DB::rollBack(); + return $this->fail([$exception->getCode(), $exception->getMessage()]); + } } } diff --git a/app/Http/Controllers/Admin/OtherController.php b/app/Http/Controllers/Admin/OtherController.php index 033f1f8..183f67e 100755 --- a/app/Http/Controllers/Admin/OtherController.php +++ b/app/Http/Controllers/Admin/OtherController.php @@ -230,10 +230,13 @@ class OtherController extends CommonController // 审核通过人数去重 $list['course_signs_pass_unique'] = CourseSign::courseSignsTotalByUnique($start_date, $end_date, 1, $courses->pluck('id'), null); // 开课场次 - $calendar = Calendar::whereIn('course_id', $courses->pluck('id'))->whereBetween('date', [$start_date, $end_date])->get(); - $list['course_total'] = $calendar->count(); + $calendar = Calendar::where(function ($query) use ($start_date, $end_date) { + $query->whereBetween('start_time', [$start_date, $end_date]) + ->orWhereBetween('end_time', [$start_date, $end_date]); + })->whereIn('course_id', $courses->pluck('id')); + $list['course_total'] = (clone $calendar)->count(); // 开课天数 - $list['course_day_total'] = $calendar->sum('days'); + $list['course_day_total'] = (clone $calendar)->sum('days'); // 上市公司数(所有上市公司) $list['company_market_total'] = Company::companyMarket($start_date, $end_date); @@ -248,6 +251,9 @@ class OtherController extends CommonController // 入学后上市公司数量(在指定时间范围内报名的学员所在公司中,在入学后上市的公司数量) $list['company_market_after_enrollment_total'] = CourseSign::companyMarketAfterEnrollment($start_date, $end_date, $course_ids); + // 入学后被投企业数量(在指定时间范围内报名的学员所在公司中,在入学后被投的公司数量) + $list['company_invested_after_enrollment_total'] = CourseSign::companyInvestedAfterEnrollment($start_date, $end_date, $course_ids); + // 元和员工参与企业 $list['company_join_total'] = CourseSign::companyJoin($start_date, $end_date, $course_ids); // 全市干部参与企业 @@ -307,7 +313,7 @@ class OtherController extends CommonController * tags={"其他"}, * summary="课程统计明细导出", * description="导出课程统计数据的明细", - * @OA\Parameter(name="export_type", in="query", @OA\Schema(type="string"), required=true, description="导出类型:course_signs_invested-被投企业明细, course_signs_total-报名人数明细, course_signs_pass-审核通过人数明细, course_signs_pass_unique-审核通过人数去重明细, courseTypesSum-课程分类明细, areas-区域明细, company_market_total-上市公司明细, ganbu_total-跟班学员明细, company_market_year_total-今年上市公司明细, company_market_after_enrollment_total-入学后上市公司明细, course_total-开课场次明细, course_day_total-开课天数明细, company_join_total-元和员工参与企业明细, company_ganbu_total-全市干部参与企业明细, cover_head_total-苏州头部企业明细, cover_rencai_total-高层次人才明细, cover_stock_total-重点上市公司明细"), + * @OA\Parameter(name="export_type", in="query", @OA\Schema(type="string"), required=true, description="导出类型:course_signs_invested-被投企业明细, course_signs_total-报名人数明细, course_signs_pass-审核通过人数明细, course_signs_pass_unique-审核通过人数去重明细, courseTypesSum-课程分类明细, areas-区域明细, company_market_total-上市公司明细, ganbu_total-跟班学员明细, company_market_year_total-今年上市公司明细, company_market_after_enrollment_total-入学后上市公司明细, company_invested_after_enrollment_total-入学后被投企业明细, course_total-开课场次明细, course_day_total-开课天数明细, company_join_total-元和员工参与企业明细, company_ganbu_total-全市干部参与企业明细, cover_head_total-苏州头部企业明细, cover_rencai_total-高层次人才明细, cover_stock_total-重点上市公司明细"), * @OA\Parameter(name="start_date", in="query", @OA\Schema(type="string"), required=false, description="开始日期"), * @OA\Parameter(name="end_date", in="query", @OA\Schema(type="string"), required=false, description="结束日期"), * @OA\Parameter(name="course_type_id", in="query", @OA\Schema(type="string"), required=false, description="课程体系id,多个英文逗号"), @@ -629,6 +635,39 @@ class OtherController extends CommonController $filename = '入学后上市公司明细'; break; + case 'company_invested_after_enrollment_total': + // 入学后被投企业明细 - 使用模型方法 + $companiesAfterEnrollment = CourseSign::companyInvestedAfterEnrollment($start_date, $end_date, $course_ids, true); + + foreach ($companiesAfterEnrollment as $item) { + $company = $item['company']; + $userNames = collect($item['users'])->pluck('name')->filter()->unique()->implode("\n\r"); + $data[] = [ + 'company_name' => $company->company_name, + 'company_legal_representative' => $company->company_legal_representative ?? '', + 'company_date' => $company->company_date ?? '', + 'invest_date' => $item['invest_date'] ?? '', + 'first_sign_date' => $item['first_sign_date'], + 'user_names' => $userNames, + 'company_address' => $company->company_address ?? '', + 'company_city' => $company->company_city ?? '', + 'company_area' => $company->company_area ?? '', + ]; + } + $fields = [ + 'company_name' => '企业名称', + 'company_legal_representative' => '法人', + 'company_date' => '成立时间', + 'invest_date' => '被投日期', + 'first_sign_date' => '首次报名时间', + 'user_names' => '学员姓名', + 'company_address' => '地址', + 'company_city' => '所在城市', + 'company_area' => '所在区域', + ]; + $filename = '入学后被投企业明细'; + break; + case 'course_total': // 开课场次明细 - 与coursesHome算法一致 $calendars = Calendar::whereIn('course_id', $course_ids) diff --git a/app/Models/Calendar.php b/app/Models/Calendar.php index 172b6ba..9cde227 100755 --- a/app/Models/Calendar.php +++ b/app/Models/Calendar.php @@ -9,7 +9,7 @@ use Illuminate\Support\Facades\Cache; class Calendar extends SoftDeletesModel { - protected $appends = ['is_publish_text','type_text']; + protected $appends = ['is_publish_text', 'type_text', 'is_count_days_text', 'is_count_people_text']; public function getIsPublishTextAttribute() { @@ -22,6 +22,16 @@ class Calendar extends SoftDeletesModel return $array[$this->attributes['type']] ?? ''; } + public function getIsCountDaysTextAttribute() + { + return ($this->attributes['is_count_days'] ?? 1) == 1 ? '是' : '否'; + } + + public function getIsCountPeopleTextAttribute() + { + return ($this->attributes['is_count_people'] ?? 1) == 1 ? '是' : '否'; + } + public function course() { return $this->hasOne(Course::class, 'id', 'course_id'); @@ -32,5 +42,10 @@ class Calendar extends SoftDeletesModel return $this->hasMany(CourseContent::class, 'id', 'course_content_id'); } + public function historyCourses() + { + return $this->hasMany(HistoryCourse::class, 'calendar_id', 'id'); + } + } diff --git a/app/Models/CourseSign.php b/app/Models/CourseSign.php index 317078b..2efc70f 100755 --- a/app/Models/CourseSign.php +++ b/app/Models/CourseSign.php @@ -223,6 +223,59 @@ class CourseSign extends SoftDeletesModel } } + /** + * 入学后被投企业数量(在指定时间范围内报名的学员所在公司中,在入学后被投的公司数量) + * @param string $start_date 开始日期 + * @param string $end_date 结束日期 + * @param array|null $course_ids 课程ID数组,不传则统计所有课程 + * @param bool $retList 是否返回列表,false返回数量,true返回列表 + * @return int|array + */ + public static function companyInvestedAfterEnrollment($start_date, $end_date, $course_ids = null, $retList = false) + { + $courseSignsQuery = self::getStudentList($start_date, $end_date, 1, $course_ids); + $courseSignsForInvest = $courseSignsQuery->with('user.company')->get(); + $companiesAfterEnrollment = []; + foreach ($courseSignsForInvest as $sign) { + if ($sign->user && $sign->user->company && $sign->user->company->is_yh_invested == 1) { + $signDate = \Carbon\Carbon::parse($sign->created_at)->format('Y-m-d'); + // 从 project_users 中获取最早的被投时间 + $projectUsers = $sign->user->company->project_users; + $investDate = null; + if (!empty($projectUsers) && is_array($projectUsers)) { + foreach ($projectUsers as $projectUser) { + if (!empty($projectUser['investDate'])) { + if ($investDate === null || $projectUser['investDate'] < $investDate) { + $investDate = $projectUser['investDate']; + } + } + } + } + // 被投时间 >= 报名时间,说明是入学后被投 + if ($investDate && $investDate >= $signDate) { + $companyId = $sign->user->company->id; + if (!isset($companiesAfterEnrollment[$companyId])) { + $companiesAfterEnrollment[$companyId] = [ + 'company' => $sign->user->company, + 'first_sign_date' => $signDate, + 'invest_date' => $investDate, + 'users' => [], + ]; + } + if ($retList) { + $companiesAfterEnrollment[$companyId]['users'][] = $sign->user; + } + } + } + } + + if ($retList) { + return $companiesAfterEnrollment; + } else { + return count($companiesAfterEnrollment); + } + } + /** * 区域统计 * @param string $start_date 开始日期 diff --git a/app/Models/HistoryCourse.php b/app/Models/HistoryCourse.php index 4eb14bf..8c5a203 100644 --- a/app/Models/HistoryCourse.php +++ b/app/Models/HistoryCourse.php @@ -9,5 +9,10 @@ class HistoryCourse extends SoftDeletesModel { return $this->hasOne(CourseType::class, 'id', 'type'); } + + public function calendar() + { + return $this->belongsTo(Calendar::class, 'calendar_id', 'id'); + } } diff --git a/coursesHome统计逻辑说明.md b/coursesHome统计逻辑说明.md deleted file mode 100644 index 03a264a..0000000 --- a/coursesHome统计逻辑说明.md +++ /dev/null @@ -1,306 +0,0 @@ -# 课程统计数据说明文档 - -## 一、文档说明 - -本文档用于说明课程统计系统中各项数据的含义和统计方式,帮助您更好地理解和使用统计数据。 - ---- - -## 二、如何查询统计数据 - -### 2.1 查询方式 - -通过系统后台的"课程统计"功能,您可以查询以下信息: - -- **时间范围**:选择需要统计的开始日期和结束日期 -- **课程类型**:可以选择全部课程类型,也可以选择特定的课程类型进行统计 - -### 2.2 统计时间说明 - -- 统计数据基于**报名记录的创建时间**,而不是课程开课时间 -- 例如:选择2024年1月1日到2024年12月31日,会统计在这个时间段内创建的所有报名记录 - ---- - -## 三、核心统计数据说明 - -### 3.1 被投企业数 - -**含义**:在统计时间段内,有多少家元禾已投资的企业有员工报名参加了课程。 - -**统计方式**: -- 统计所有在指定时间段内报名的用户 -- 查看这些用户所在的公司 -- 统计其中被元禾投资的公司数量 -- **重要**:如果一家公司有多个员工报名,这家公司只统计一次 - -**使用场景**:了解元禾投资企业的参与情况 - ---- - -### 3.2 报名人数 - -**含义**:在统计时间段内,总共有多少条报名记录。 - -**统计方式**: -- 统计所有在指定时间段内创建的报名记录 -- 包括所有状态的报名(待审核、审核通过、审核不通过等) -- 不包括已取消和主动放弃的报名 -- **重要**:如果同一个人报名了多个课程,会按报名次数分别计算 - -**使用场景**:了解课程的整体报名热度 - -**举例**: -- 张三报名了3个课程 → 统计为3人 -- 李四报名了1个课程 → 统计为1人 -- 总计:4人 - ---- - -### 3.3 审核通过人数 - -**含义**:在统计时间段内,有多少条报名记录通过了审核。 - -**统计方式**: -- 只统计状态为"审核通过"的报名记录 -- 不包括已取消和主动放弃的报名 -- **重要**:如果同一个人报名了多个课程且都通过了,会按通过次数分别计算 - -**使用场景**:了解实际可以参加课程的人数 - -**举例**: -- 张三报名了3个课程,都通过了 → 统计为3人 -- 李四报名了1个课程,通过了 → 统计为1人 -- 总计:4人 - ---- - -### 3.4 审核通过人数(去重) - -**含义**:在统计时间段内,有多少个不同的用户通过了审核。 - -**统计方式**: -- 只统计状态为"审核通过"的报名记录 -- 根据用户的手机号进行去重 -- 如果同一个手机号报名了多个课程,只统计一次 -- **重要**:这是真实的培养人数,不会重复计算同一个人 - -**使用场景**:了解实际培养了多少个不同的学员 - -**举例**: -- 张三(手机号13800138000)报名了3个课程,都通过了 → 统计为1人 -- 李四(手机号13900139000)报名了1个课程,通过了 → 统计为1人 -- 总计:2人(去重后) - ---- - -### 3.5 开课场次 - -**含义**:在统计时间段内,总共开了多少场课程。 - -**统计方式**: -- 统计指定课程类型下,在指定时间范围内的所有开课记录 -- 统计数据源来自于课程日历上的数据 -- **重要**:统计的是开课场次,不是课程数量 - -**使用场景**:了解课程开展的频率和规模 - - ---- - -### 3.6 开课天数 - -**含义**:在统计时间段内,所有课程总共开了多少天。 - -**统计方式**: -- 对每场课程计算开课天数(从开始日期到结束日期) -- 包含开始日期和结束日期 -- 将所有场次的天数加起来 -- 统计数据源来自于课程日历上的数据 - - -**使用场景**:了解课程的总时长 - -**举例**: -- 某场课程从2024年1月1日到1月3日 → 3天(包含1日、2日、3日) -- 某场课程从2024年2月10日到2月12日 → 3天 -- 总计:6天 - ---- - -## 四、课程分类明细统计说明 - -### 4.1 统计内容 - -系统会按照每个课程类型,详细统计以下信息: - -#### 课程类型名称 -显示课程体系的名称,例如:"高研班"、"初创班"等。 - -#### 培养人数(未去重,按课程类型) -**含义**:该课程类型下所有课程的审核通过报名人数总和。 - -**说明**: -- 如果同一个学员在该课程类型下报名了多个课程,会按报名次数分别计算 -- 例如:张三在"高研班"类型下报名了2个课程,都通过了 → 统计为2人 - -#### 培养人数(去重,按课程类型) -**含义**:该课程类型下有多少个不同的学员通过了审核。 - -**说明**: -- 根据学员的手机号去重 -- 同一个手机号在该课程类型下只统计一次 -- 例如:张三(手机号13800138000)在"高研班"类型下报名了2个课程,都通过了 → 统计为1人 - -#### 课程名称 -显示具体课程的名称,例如:"2024年第一期高研班"。 - -#### 培养人数(按单个课程) -**含义**:该单个课程的审核通过报名人数。 - -**说明**: -- 只统计该课程的审核通过人数 -- 不包括其他课程的数据 - ---- - -## 五、区域明细统计说明 - -### 5.1 统计内容 - -系统会按照每个区域,详细统计以下信息: - -#### 区域名称 -显示区域名称,例如:"工业园区"、"高新区"、"相城区"等。 - -**特殊区域**:"苏州市外"表示不在苏州所有区域内的用户。 - -#### 审核通过人数(未去重,按区域) -**含义**:该区域有多少条审核通过的报名记录。 - -**说明**: -- 根据学员所在公司的区域进行统计 -- 如果同一个学员在该区域报名了多个课程,会按报名次数分别计算 -- 例如:张三(公司位于工业园区)报名了2个课程,都通过了 → 统计为2人 - -#### 审核通过人数(去重,按区域) -**含义**:该区域有多少个不同的学员通过了审核。 - -**说明**: -- 根据学员的手机号去重 -- 同一个手机号在该区域只统计一次 -- 例如:张三(手机号13800138000,公司位于工业园区)报名了2个课程,都通过了 → 统计为1人 - ---- - - -## 七、数据关系说明 - -### 7.1 人数关系 - -通常情况下,数据之间存在以下关系: - -**报名人数** ≥ **审核通过人数** ≥ **审核通过人数(去重)** - -**解释**: -- 报名人数最多,因为包括所有状态的报名 -- 审核通过人数次之,因为只包括审核通过的 -- 去重人数最少,因为同一个学员只统计一次 - -**举例**: -- 报名人数:500人(包括待审核、审核通过、审核不通过等) -- 审核通过人数:450人(只包括审核通过的) -- 审核通过人数(去重):380人(同一个学员只统计一次) - -### 7.2 区域汇总与全局去重的关系 - -**区域汇总** 可能大于 **全局去重人数** - -**原因**: -- 区域汇总时,每个区域是分别统计的 -- 而全局去重是按所有区域统一去重的 - ---- - -## 八、报名状态说明 - -### 8.1 报名状态类型 - -报名记录有以下几种状态: - -| 状态名称 | 说明 | 是否参与统计 | -|---------|------|------------| -| 待审核 | 报名已提交,等待审核 | 参与"报名人数"统计,不参与"审核通过人数"统计 | -| 审核通过 | 报名已通过审核,可以参加课程 | 参与所有统计 | -| 审核不通过 | 报名未通过审核 | 参与"报名人数"统计,不参与"审核通过人数"统计 | -| 备选 | 报名作为备选 | 参与"报名人数"统计,不参与"审核通过人数"统计 | -| 已取消 | 报名已取消 | 不参与任何统计 | -| 主动放弃 | 学员主动放弃报名 | 不参与任何统计 | -| 黑名单 | 学员在黑名单中 | 参与"报名人数"统计,不参与"审核通过人数"统计 | - -### 8.2 统计规则 - -- **报名人数**:统计除"已取消"和"主动放弃"外的所有状态 -- **审核通过人数**:只统计"审核通过"状态的记录 -- **所有统计**:都不包括"已取消"和"主动放弃"的记录 - ---- - -## 九、常见问题解答 - -### Q1: 为什么"报名人数"比"审核通过人数"多? - -**A**: 因为"报名人数"包括所有状态的报名记录(待审核、审核通过、审核不通过、备选等),而"审核通过人数"只包括审核通过的记录。所以报名人数会更多。 - -### Q2: 为什么"审核通过人数"比"审核通过人数(去重)"多? - -**A**: 因为"审核通过人数"是报名记录数,如果同一个学员报名了多个课程,会按报名次数分别计算。而"审核通过人数(去重)"是按学员手机号去重的,同一个学员只统计一次。 - - -### Q4: "被投企业数"是如何统计的? - -**A**: 先统计所有报名的学员,然后查看这些学员所在的公司,统计其中被元禾投资的公司数量。如果一家公司有多个员工报名,这家公司只统计一次。 - -### Q5: "开课天数"是如何计算的? - -**A**: 对每场课程,计算从开始日期到结束日期的天数(包含开始日期和结束日期),然后将所有场次的天数加起来。例如:某场课程从1月1日到1月3日,算3天。 - -### Q6: 统计时间范围是什么意思? - -**A**: 统计时间范围是指报名记录的创建时间,不是课程的开课时间。例如:选择2024年1月1日到12月31日,会统计在这个时间段内创建的所有报名记录,即使这些课程可能在2025年才开课。 - -### Q7: 为什么选择不同的课程类型,统计数据会不同? - -**A**: 因为统计数据是基于选择的课程类型进行筛选的。如果选择全部课程类型,会统计所有课程的数据;如果选择特定的课程类型,只统计该类型下的课程数据。 - ---- - -## 十、使用建议 - -### 10.1 查看整体情况 - -- 使用"报名人数"了解课程的整体报名热度 -- 使用"审核通过人数(去重)"了解实际培养了多少个不同的学员 -- 使用"开课场次"和"开课天数"了解课程开展的频率和时长 - -### 10.2 查看分类情况 - -- 使用"课程分类明细统计"了解不同课程类型的培养情况 -- 使用"区域明细统计"了解不同区域的参与情况 - -### 10.3 数据对比 - -- 对比"报名人数"和"审核通过人数",了解审核通过率 -- 对比"审核通过人数"和"审核通过人数(去重)",了解学员的参与深度 -- 对比不同课程类型的数据,了解各类课程的受欢迎程度 - ---- - -## 十一、注意事项 - -1. **时间范围选择**:统计数据基于报名记录的创建时间,不是课程开课时间 -2. **去重逻辑**:去重统计使用学员的手机号作为依据 -3. **区域统计**:区域统计基于学员所在公司的区域 -4. **数据关系**:不同统计数据之间可能存在包含关系,请注意理解 -5. **汇总数据**:区域汇总可能包含跨区域的重复学员,请注意区分 - diff --git a/database/migrations/2025_11_26_100000_add_calendar_id_to_history_courses_table.php b/database/migrations/2025_11_26_100000_add_calendar_id_to_history_courses_table.php new file mode 100644 index 0000000..20aafa5 --- /dev/null +++ b/database/migrations/2025_11_26_100000_add_calendar_id_to_history_courses_table.php @@ -0,0 +1,34 @@ +unsignedBigInteger('calendar_id')->nullable()->after('id')->comment('日历ID'); + $table->index('calendar_id'); + }); + } + + /** + * Reverse the migrations. + * + * @return void + */ + public function down() + { + Schema::table('history_courses', function (Blueprint $table) { + $table->dropIndex(['calendar_id']); + $table->dropColumn('calendar_id'); + }); + } +}; + diff --git a/database/migrations/2025_11_26_100100_add_count_fields_to_calendars_table.php b/database/migrations/2025_11_26_100100_add_count_fields_to_calendars_table.php new file mode 100644 index 0000000..fe1df14 --- /dev/null +++ b/database/migrations/2025_11_26_100100_add_count_fields_to_calendars_table.php @@ -0,0 +1,33 @@ +tinyInteger('is_count_days')->default(1)->comment('是否统计天数 0否 1是'); + $table->tinyInteger('is_count_people')->default(1)->comment('是否统计人数 0否 1是'); + }); + } + + /** + * Reverse the migrations. + * + * @return void + */ + public function down() + { + Schema::table('calendars', function (Blueprint $table) { + $table->dropColumn(['is_count_days', 'is_count_people']); + }); + } +}; + diff --git a/课程统计说明文档.md b/课程统计说明文档.md new file mode 100644 index 0000000..371a734 --- /dev/null +++ b/课程统计说明文档.md @@ -0,0 +1,300 @@ +# 课程统计系统数据说明文档 + + +## 🎯 一、基础统计数据 + +### 1. 报名人数(course_signs_total) + +**简单理解**:就像学校统计有多少人报名了课程。 + +**统计方式**: +- 系统会查看在您选择的时间范围内,所有提交了报名申请的人数 +- 不管审核是否通过,只要提交了报名就算一个人 +- 如果同一个人报名了多门课程,会分别计算(比如张三报名了3门课,就算3个人次) + +**举个例子**: +- 时间范围:2024年1月1日 - 2024年12月31日 +- 张三报名了"企业管理"课程 → 算1人 +- 李四报名了"财务管理"和"市场营销"两门课程 → 算2人 +- 总计:3人次 + +--- + +### 2. 审核通过人数(course_signs_pass) + +**简单理解**:报名后,经过审核被批准参加课程的人数。 + +**统计方式**: +- 只统计审核状态为"审核通过"的报名记录 +- 同样,如果一个人通过了多门课程的审核,会分别计算 + +**与报名人数的区别**: +- 报名人数 = 所有提交申请的人(包括待审核、已通过、已拒绝) +- 审核通过人数 = 只有审核通过的人 + +**举个例子**: +- 100人报名,其中80人审核通过,20人待审核或未通过 +- 报名人数 = 100人 +- 审核通过人数 = 80人 + +--- + +### 3. 审核通过人数(去重)(course_signs_pass_unique) + +**简单理解**:这是"真实的人数",一个人不管报名了多少门课程,只算1个人。 + +**统计方式**: +- 系统会通过手机号来识别是否是同一个人 +- 如果同一个手机号报名了多门课程,只算1个人 +- 这样可以知道真正有多少个不同的学员参加了培训 + +**举个例子**: +- 张三用手机号13800138000报名了3门课程,都审核通过了 +- 李四用手机号13900139000报名了1门课程,审核通过了 +- 审核通过人数(不去重)= 4人次(3+1) +- 审核通过人数(去重)= 2人(张三1人 + 李四1人) + +**为什么需要去重?** +- 不去重:可以知道课程的总参与人次,了解课程的受欢迎程度 +- 去重:可以知道实际培养了多少个不同的学员,这是更准确的培养人数 + +--- + +### 4. 开课场次(course_total) + +**简单理解**:在指定时间范围内,实际开了多少次课。 + +**统计方式**: +- 系统会查看课程日历表,统计在您选择的时间范围内,有多少次课程安排 +- 每次课程安排算1场次 +- 比如一门课程在1月、2月、3月各开一次,就算3场次 + +**举个例子**: +- 时间范围:2024年第一季度 +- "企业管理"课程在1月15日、2月15日、3月15日各开一次 → 3场次 +- "财务管理"课程在1月20日、2月20日各开一次 → 2场次 +- 总计:5场次 + +--- + +### 5. 开课天数(course_day_total) + +**简单理解**:所有课程加起来,总共上了多少天课。 + +**统计方式**: +- 系统会统计每场课程持续的天数 +- 把所有场次的天数加起来 +- 比如一门课程持续3天,另一门持续2天,总计就是5天 + +**与开课场次的区别**: +- 开课场次 = 开了多少次课(不管每次上几天) +- 开课天数 = 总共上了多少天课 + +**举个例子**: +- "企业管理"课程开了3次,每次持续2天 → 6天 +- "财务管理"课程开了2次,每次持续1天 → 2天 +- 总计:8天 + +--- + +## 🏢 二、企业相关统计数据 + +### 6. 被投企业数(course_signs_invested) + +**简单理解**:参加培训的学员中,有多少人所在的企业是被我们投资的企业。 + +**统计方式**: +- 系统会查看每个学员所在的企业信息 +- 如果企业的"是否被投"标记为"是",就算1家企业 +- 如果多个学员来自同一家被投企业,只算1家企业(去重) + +**举个例子**: +- 张三、李四、王五都来自"元禾控股"这家被投企业 +- 虽然3个人都参加了培训,但只算1家被投企业 +- 如果还有赵六来自另一家被投企业"元禾原点",那就是2家被投企业 + +--- + +### 7. 上市公司数(company_market_total) + +**简单理解**:参加培训的学员中,有多少人所在的企业是上市公司。 + +**统计方式**: +- 系统会查看每个学员所在的企业信息 +- 如果企业的"是否上市公司"标记为"是",就算1家上市公司 +- 如果多个学员来自同一家上市公司,只算1家企业(去重) + +**举个例子**: +- 张三、李四都来自"苏州某上市公司" +- 虽然2个人都参加了培训,但只算1家上市公司 + +--- + +### 8. 今年上市公司数量(company_market_year_total) + +**简单理解**:在参加培训的学员所在企业中,有多少家是在今年(当前年份)上市的。 + +**统计方式**: +- 系统会查看每个学员所在的企业信息 +- 如果企业是上市公司,且上市日期(stock_date)在今年,就算1家 +- 如果多个学员来自同一家今年上市的公司,只算1家企业(去重) + +**举个例子**: +- 时间范围:2024年1月1日 - 2024年12月31日 +- 张三来自"A公司",A公司在2024年3月上市 → 算1家 +- 李四来自"B公司",B公司在2023年上市 → 不算(不是今年上市的) +- 总计:1家今年上市公司 + +--- + +### 9. 入学后上市公司数量(company_market_after_enrollment_total) + +**简单理解**:学员报名参加培训后,他所在的企业才上市的公司数量。 + +**统计方式**: +- 系统会比较学员的报名时间和企业上市时间 +- 如果企业上市时间 ≥ 学员报名时间,说明是"入学后上市" +- 如果多个学员来自同一家这样的公司,只算1家企业(去重) + +**举个例子**: +- 张三在2024年1月报名参加培训 +- 张三所在的企业在2024年6月上市 +- 因为上市时间(6月)晚于报名时间(1月),所以算1家"入学后上市公司" +- 这体现了培训对企业发展的促进作用 + +--- + +### 10. 元和员工参与企业(company_join_total) + +**简单理解**:参加培训的学员中,有多少人所在的企业名称中包含"元禾"相关关键词。 + +**统计方式**: +- 系统会检查企业名称,如果包含以下关键词之一,就算1家企业: + - 元禾控股、元禾原点、元禾厚望、元禾重元、元禾璞华、元禾谷风、元禾绿柳、元禾辰坤、元禾沙湖 + - 禾裕集团、苏州科服、信诚管理咨询 + - 集成电路公司、常州团队、国企元禾 +- 如果多个学员来自同一家这样的企业,只算1家企业(去重) + +**举个例子**: +- 张三来自"元禾控股有限公司" +- 李四来自"元禾原点投资公司" +- 虽然企业名称不同,但都包含"元禾",所以算2家企业 + +--- + +### 11. 全市干部参与企业(company_ganbu_total) + +**简单理解**:参加培训的学员中,有多少人的来源标记为"跟班学员"(通常是干部)。 + +**统计方式**: +- 系统会查看每个学员的"来源"字段 +- 如果来源是"跟班学员",就算1个人 +- 如果同一个人报名了多门课程,只算1个人(去重) + +**举个例子**: +- 张三的来源是"跟班学员",报名了2门课程 → 算1人 +- 李四的来源是"跟班学员",报名了1门课程 → 算1人 +- 总计:2人 + +--- + +### 12. 苏州头部企业(cover_head_total) + +**简单理解**:参加培训的学员中,有多少人所在的企业是苏州的头部企业(通常是高新技术企业)。 + +**统计方式**: +- 系统会查看企业信息中的"企业资质"字段 +- 如果企业资质中包含"高新技术企业",就算1家企业 +- 如果多个学员来自同一家这样的企业,只算1家企业(去重) + +**举个例子**: +- 张三、李四都来自"苏州某高新技术企业" +- 虽然2个人都参加了培训,但只算1家头部企业 + +--- + +### 13. 高层次人才(cover_rencai_total) + +**简单理解**:参加培训的学员中,有多少人报名的是"人才培训"类型的课程。 + +**统计方式**: +- 系统会查看学员报名的课程类型 +- 如果课程类型是"人才培训",就算1个人 +- 如果同一个人报名了多门"人才培训"课程,只算1个人(去重) + +**举个例子**: +- 张三报名了"人才培训"类型的课程 → 算1人 +- 李四报名了"企业管理"类型的课程 → 不算 +- 总计:1人 + +--- + +### 14. 重点上市公司(cover_stock_total) + +**简单理解**:参加培训的学员中,有多少人所在的企业是重点上市公司。 + +**统计方式**: +- 系统会查看企业信息中的"是否上市公司"字段 +- 如果标记为"是",就算1家企业 +- 如果多个学员来自同一家上市公司,只算1家企业(去重) + +**与"上市公司数"的区别**: +- 这个统计可能有额外的筛选条件(具体看业务需求) +- 通常"重点上市公司"是"上市公司"的一个子集 + +--- + +## 📊 三、明细统计数据 + +### 15. 课程分类明细统计(courseTypesSum) + +**简单理解**:按照不同的课程类型,分别统计每个类型和每门课程的培养人数。 + +**统计方式**: +- 系统会按照课程类型分组统计 +- 对于每个课程类型,会统计: + - 该类型所有课程的培养人数总和 + - 该类型所有课程的培养人数(去重) +- 对于每门具体课程,会统计该课程的培养人数 + +**举个例子**: +- 课程类型:"企业管理" + - 包含课程:"企业管理基础"、"企业管理进阶" + - 该类型培养人数:100人(两门课程加起来) + - 该类型培养人数(去重):80人(去除重复报名的人) + - "企业管理基础"课程培养人数:60人 + - "企业管理进阶"课程培养人数:40人 + +--- + +### 16. 区域明细统计(areas) + +**简单理解**:按照不同的区域,统计每个区域有多少学员参加了培训。 + +**统计方式**: +- 系统会按照学员所在企业的区域进行分组统计 +- 对于苏州市内的企业,会按照具体的区域(比如"工业园区"、"高新区"等)统计 +- 对于苏州市外的企业,统一归为"苏州市外" +- 每个区域会统计: + - 该区域的报名人数(不去重) + - 该区域的报名人数(去重,按手机号) + +**举个例子**: +- 工业园区:50人报名,去重后40人 +- 高新区:30人报名,去重后25人 +- 苏州市外:20人报名,去重后18人 + +--- + +## 🔍 四、统计的时间范围 + +所有统计数据都基于您选择的时间范围: + +- **开始日期**:统计从这个日期开始的报名或开课 +- **结束日期**:统计到这个日期为止的报名或开课 + +**重要说明**: +- 对于报名人数:看的是学员的报名时间是否在这个范围内 +- 对于开课场次:看的是课程的实际开课日期是否在这个范围内 +- 对于企业统计:看的是学员的报名时间是否在这个范围内 +