weizhiqiang/superlink
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v1.0.27: 碎片处理中心(完整方案) - 完整度计算引擎(四表分层/阈值)+is_incomplete标记(写操作挂钩)+api/fragment八接口(统计/硬碎片列表详情转换废弃/软碎片列表详情补全)+fragment.html前端(指标卡+硬软碎片双区块)

Browse Source
This commit is contained in:
nanguaboss
2026-08-09 15:47:05 +08:00
parent b68232bff3
commit 76431c20ac
25 changed files with 1342 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files
api/common/completeness.php
+236
View File
@@ -0,0 +1,236 @@
<?php
/**
* 完整度计算引擎（碎片处理方案 v1.0.27）
* 公式：完整度 = 100 - (缺失核心字段数×20) - (缺失重要字段数×8) - (缺失补充字段数×2)，下限 0%
* 阈值：persons/companies ≥65%，social_accounts ≥60%，media_commercial_attributes ≥55%
* 说明：persons 的 phone/email 为虚拟字段（来自 social_accounts 关联记录）
*/
require_once __DIR__ . '/db.php';
/** 四表字段分层定义（key => 层级），threshold 为完整度阈值 */
const COMPLETENESS_LAYERS = [
'persons' => [
'core' => ['full_name'],
'important' => ['work_location'],
'supplementary' => ['gender', 'nationality', 'education', 'graduated_from', 'hometown', 'id_type', 'id_number'],
'virtual' => ['phone' => 'core', 'email' => 'important'], // 关联 social_accounts.platform
'threshold' => 65,
],
'companies' => [
'core' => ['display_name', 'industry'],
'important' => ['address', 'business_role', 'country'],
'supplementary' => ['name_zh', 'name_en', 'registration_number', 'legal_form', 'legal_representative',
'business_scope', 'established_date', 'registered_capital', 'industry_subdivision',
'latest_employee_count', 'latest_annual_revenue', 'is_listed', 'stock_code', 'website'],
'virtual' => [],
'threshold' => 65,
],
'social_accounts' => [
'core' => ['platform', 'account_id'],
'important' => ['is_primary'],
'supplementary' => ['profile_url', 'remark'],
'virtual' => [],
'threshold' => 60,
],
'media' => [
'core' => ['social_account_id', 'account_level'],
'important' => ['follower_count', 'content_categories'],
'supplementary' => ['certification_type', 'avg_read_count', 'special_requirements', 'media_remark'],
'virtual' => [],
'threshold' => 55,
],
];
/** 字段中文名（前端展示缺失字段用） */
const COMPLETENESS_LABELS = [
'full_name' => '姓名', 'phone' => '手机', 'email' => '邮箱', 'work_location' => '工作所在地',
'gender' => '性别', 'nationality' => '国籍', 'education' => '学历', 'graduated_from' => '毕业院校',
'hometown' => '家乡', 'id_type' => '证件类型', 'id_number' => '证件号码',
'display_name' => '名称', 'industry' => '行业', 'address' => '地址', 'business_role' => '业务类型',
'country' => '国家/地区', 'name_zh' => '中文名', 'name_en' => '英文名', 'registration_number' => '注册号',
'legal_form' => '企业类型', 'legal_representative' => '法定代表人', 'business_scope' => '经营范围',
'established_date' => '成立日期', 'registered_capital' => '注册资本', 'industry_subdivision' => '行业细分',
'latest_employee_count' => '员工数', 'latest_annual_revenue' => '年营收', 'is_listed' => '是否上市',
'stock_code' => '股票代码', 'website' => '官网',
'platform' => '平台', 'account_id' => '账号', 'is_primary' => '常用', 'profile_url' => '主页链接', 'remark' => '备注',
'social_account_id' => '关联账号', 'account_level' => '账号等级', 'follower_count' => '粉丝数',
'content_categories' => '内容领域', 'certification_type' => '认证类型', 'avg_read_count' => '平均阅读',
'special_requirements' => '特殊要求', 'media_remark' => '评估备注',
];
/** 字段是否缺失：null / 空串 / 纯空白 视为缺失（0 视为已填写） */
function completenessIsMissing($v)
{
return ($v === null) || (trim((string)$v) === '');
}
/**
* 根据分层定义计算完整度
* @param string $table persons|companies|social_accounts|media
* @param array $row 该表记录（persons 需已注入虚拟字段 phone/email）
* @return array { score:int, missing_core:[], missing_important:[], missing_supp:[], level:string }
*/
function completenessCalc($table, $row)
{
$layers = COMPLETENESS_LAYERS[$table] ?? null;
if (!$layers) {
return ['score' => 100, 'missing_core' => [], 'missing_important' => [], 'missing_supp' => [], 'level' => 'complete'];
}
$missing = ['core' => [], 'important' => [], 'supplementary' => []];
foreach (['core' => 'core', 'important' => 'important', 'supplementary' => 'supplementary'] as $layer => $bucket) {
foreach ($layers[$layer] as $field) {
if (completenessIsMissing($row[$field] ?? null)) {
$missing[$bucket][] = $field;
}
}
}
// 虚拟字段（如人员 phone/email）按配置的层级计入
foreach (($layers['virtual'] ?? []) as $field => $layer) {
if (completenessIsMissing($row[$field] ?? null)) {
$missing[$layer][] = $field;
}
}
$score = 100
- count($missing['core']) * 20
- count($missing['important']) * 8
- count($missing['supplementary']) * 2;
$score = max(0, $score);
$level = 'complete';
if (!empty($missing['core'])) {
$level = 'core'; // 缺核心（红）
} elseif (!empty($missing['important'])) {
$level = 'important'; // 缺重要（橙）
} elseif (!empty($missing['supplementary'])) {
$level = 'supplementary'; // 待补充（蓝）
}
return [
'score' => $score,
'missing_core' => $missing['core'],
'missing_important' => $missing['important'],
'missing_supp' => $missing['supplementary'],
'level' => $level,
];
}
/** 人员记录：注入虚拟字段 phone/email（来自 social_accounts） */
function personWithVirtualFields(PDO $pdo, array $row)
{
$stmt = $pdo->prepare(
"SELECT platform, account_id FROM social_accounts
WHERE owner_type = 'person' AND owner_id = ? AND is_active = 1 AND platform IN ('phone','email')
ORDER BY is_primary DESC, id ASC"
);
$stmt->execute([$row['id']]);
foreach ($stmt->fetchAll() as $acc) {
if (!isset($row[$acc['platform']])) {
$row[$acc['platform']] = $acc['account_id'];
}
}
return $row;
}
/**
* 计算某条记录的完整度信息
* @param PDO $pdo
* @param string $table persons|companies|social_accounts|media
* @param int $id
* @return array { row, score, missing_core, missing_important, missing_supp, level, threshold }
*/
function completenessInfo(PDO $pdo, $table, $id)
{
$row = null;
switch ($table) {
case 'persons':
$stmt = $pdo->prepare("SELECT * FROM persons WHERE id = ?");
$stmt->execute([$id]);
$row = $stmt->fetch();
if ($row) {
$row = personWithVirtualFields($pdo, $row);
}
break;
case 'companies':
$stmt = $pdo->prepare("SELECT * FROM companies WHERE id = ?");
$stmt->execute([$id]);
$row = $stmt->fetch();
break;
case 'social_accounts':
$stmt = $pdo->prepare("SELECT * FROM social_accounts WHERE id = ?");
$stmt->execute([$id]);
$row = $stmt->fetch();
break;
case 'media':
$stmt = $pdo->prepare("SELECT * FROM media_commercial_attributes WHERE social_account_id = ?");
$stmt->execute([$id]);
$row = $stmt->fetch();
if ($row) {
$row['id'] = $row['social_account_id'];
}
break;
}
if (!$row) {
return null;
}
$calc = completenessCalc($table, $row);
return [
'row' => $row,
'score' => $calc['score'],
'missing_core' => $calc['missing_core'],
'missing_important' => $calc['missing_important'],
'missing_supp' => $calc['missing_supp'],
'level' => $calc['level'],
'threshold' => COMPLETENESS_LAYERS[$table]['threshold'] ?? 65,
'is_complete' => $calc['score'] >= (COMPLETENESS_LAYERS[$table]['threshold'] ?? 65),
];
}
/**
* 更新某条记录的 is_incomplete 标记（完整度低于阈值 → 1）
* @param PDO $pdo
* @param string $table persons|companies|social_accounts|media
* @param int $id
* @return array|null completenessInfo 结果（记录不存在返回 null）
*/
function updateIncomplete(PDO $pdo, $table, $id)
{
$info = completenessInfo($pdo, $table, $id);
if (!$info) {
return null;
}
$flag = $info['is_complete'] ? 0 : 1;
switch ($table) {
case 'persons':
$pdo->prepare("UPDATE persons SET is_incomplete = ? WHERE id = ?")->execute([$flag, $id]);
break;
case 'companies':
$pdo->prepare("UPDATE companies SET is_incomplete = ? WHERE id = ?")->execute([$flag, $id]);
break;
case 'social_accounts':
$pdo->prepare("UPDATE social_accounts SET is_incomplete = ? WHERE id = ?")->execute([$flag, $id]);
break;
case 'media':
$pdo->prepare("UPDATE media_commercial_attributes SET is_incomplete = ? WHERE social_account_id = ?")->execute([$flag, $id]);
break;
}
return $info;
}
/** 更新某个归属方（人员/企业）全部 social_accounts 的 is_incomplete */
function updateAccountsIncomplete(PDO $pdo, $ownerType, $ownerId)
{
$stmt = $pdo->prepare("SELECT id FROM social_accounts WHERE owner_type = ? AND owner_id = ?");
$stmt->execute([$ownerType, $ownerId]);
foreach ($stmt->fetchAll() as $acc) {
updateIncomplete($pdo, 'social_accounts', (int)$acc['id']);
}
}
/** 更新媒体账号（social_accounts + 其商业属性）的 is_incomplete */
function updateMediaIncomplete(PDO $pdo, $socialAccountId)
{
updateIncomplete($pdo, 'social_accounts', $socialAccountId);
updateIncomplete($pdo, 'media', $socialAccountId);
}
api/company/add.php
+5
View File
@@ -8,6 +8,7 @@ require_once __DIR__ . '/../common/response.php';
require_once __DIR__ . '/../common/auth.php';
require_once __DIR__ . '/../common/logger.php';
require_once __DIR__ . '/../common/helpers.php';
require_once __DIR__ . '/../common/completeness.php';
checkAjax();
checkPermission('company');
@@ -61,5 +62,9 @@ if (array_key_exists('financials', $_POST) || array_key_exists('certifications',
}
}
// 完整度检查：企业主表 + 其 social_accounts
updateIncomplete($pdo, 'companies', $newId);
updateAccountsIncomplete($pdo, 'company', $newId);
logCurrent('add', 'company', 'companies', $newId, $data);
Response::success(['id' => $newId], '新增成功');
api/company/import.php
+3
View File
@@ -10,6 +10,7 @@ require_once __DIR__ . '/../common/db.php';
require_once __DIR__ . '/../common/response.php';
require_once __DIR__ . '/../common/auth.php';
require_once __DIR__ . '/../common/logger.php';
require_once __DIR__ . '/../common/completeness.php';
checkAjax();
checkPermission('company');
@@ -75,6 +76,8 @@ while (($row = fgetcsv($handle)) !== false) {
($rec['is_listed'] ?? 0) ? 1 : 0, $rec['stock_code'] ?? null,
$rec['source_channel'] ?? null, $rec['source_detail'] ?? null,
]);
// 完整度检查（导入每行入库后）
updateIncomplete($pdo, 'companies', (int)$pdo->lastInsertId());
$inserted++;
} catch (Exception $e) {
$failed++;
api/company/official_media_add.php
+5
View File
@@ -10,6 +10,7 @@ require_once __DIR__ . '/../common/response.php';
require_once __DIR__ . '/../common/auth.php';
require_once __DIR__ . '/../common/helpers.php';
require_once __DIR__ . '/../common/logger.php';
require_once __DIR__ . '/../common/completeness.php';
checkAjax();
checkPermission('company');
@@ -44,5 +45,9 @@ $ins->execute([
]);
$newId = (int)$pdo->lastInsertId();
// 完整度检查：新官媒账号 + 所属企业全部联系方式
updateIncomplete($pdo, 'social_accounts', $newId);
updateAccountsIncomplete($pdo, 'company', $companyId);
logCurrent('add', 'official_media', 'social_accounts', $newId, ['company_id' => $companyId, 'platform' => $platform, 'account_id' => $accountId]);
Response::success(['id' => $newId], '新增成功');
api/company/update.php
+5
View File
@@ -8,6 +8,7 @@ require_once __DIR__ . '/../common/response.php';
require_once __DIR__ . '/../common/auth.php';
require_once __DIR__ . '/../common/logger.php';
require_once __DIR__ . '/../common/helpers.php';
require_once __DIR__ . '/../common/completeness.php';
checkAjax();
checkPermission('company');
@@ -76,6 +77,10 @@ if ($hasFinancials || $hasCertifications || $hasAccounts) {
}
}
// 完整度检查：企业主表 + 其 social_accounts
updateIncomplete($pdo, 'companies', $id);
updateAccountsIncomplete($pdo, 'company', $id);
if (!empty($data)) {
logCurrent('update', 'company', 'companies', $id, ['before' => $old, 'after' => $data]);
}
api/fragment/hard_common.php
+56
View File
@@ -0,0 +1,56 @@
<?php
/**
* 硬碎片公共逻辑：字段分层 / 完整度计算 / 内容摘要
* 被 hard_list.php 与 hard_detail.php 共用
*/
/** 硬碎片字段分层（按 source_type） */
const HARD_LAYERS = [
'company' => ['core' => ['company_name', 'contact_phone'], 'important' => ['contact_email'], 'supplementary' => ['person_name', 'description', 'target_product_category']],
'person' => ['core' => ['person_name', 'contact_phone'], 'important' => ['contact_email'], 'supplementary' => ['company_name', 'description', 'target_product_category']],
'product' => ['core' => ['company_name', 'target_product_category'], 'important' => ['contact_phone', 'contact_email'], 'supplementary' => ['person_name', 'description']],
'need' => ['core' => ['company_name', 'target_product_category'], 'important' => ['contact_phone', 'contact_email'], 'supplementary' => ['person_name', 'description']],
'mixed' => ['core' => ['company_name', 'person_name'], 'important' => ['contact_phone', 'contact_email'], 'supplementary' => ['description', 'target_product_category']],
];
const HARD_LABELS = [
'company_name' => '公司名称', 'person_name' => '联系人', 'contact_phone' => '电话',
'contact_email' => '邮箱', 'target_product_category' => '产品品类', 'description' => '描述',
];
/** 计算硬碎片完整度与缺失层级 */
function hardCompleteness($row)
{
$layers = HARD_LAYERS[$row['source_type']] ?? HARD_LAYERS['mixed'];
$missing = ['core' => [], 'important' => [], 'supplementary' => []];
foreach (['core', 'important', 'supplementary'] as $layer) {
foreach ($layers[$layer] as $field) {
if ($row[$field] === null || trim((string)$row[$field]) === '') {
$missing[$layer][] = $field;
}
}
}
$score = 100 - count($missing['core']) * 20 - count($missing['important']) * 8 - count($missing['supplementary']) * 2;
$score = max(0, $score);
$level = 'complete';
if (!empty($missing['core'])) {
$level = 'core';
} elseif (!empty($missing['important'])) {
$level = 'important';
} elseif (!empty($missing['supplementary'])) {
$level = 'supplementary';
}
return ['score' => $score, 'level' => $level, 'missing' => $missing];
}
/** 内容摘要：拼接已有关键信息 */
function hardSummary($row)
{
$parts = [];
if (!empty($row['company_name'])) $parts[] = '公司:' . $row['company_name'];
if (!empty($row['person_name'])) $parts[] = '联系人:' . $row['person_name'];
if (!empty($row['contact_phone'])) $parts[] = '手机:' . $row['contact_phone'];
if (!empty($row['contact_email'])) $parts[] = '邮箱:' . $row['contact_email'];
if (!empty($row['target_product_category'])) $parts[] = '品类:' . $row['target_product_category'];
if (empty($parts) && !empty($row['description'])) $parts[] = '描述:' . mb_substr($row['description'], 0, 20);
return implode(' ', $parts);
}
api/fragment/hard_convert.php
+163
View File
@@ -0,0 +1,163 @@
<?php
/**
* 硬碎片转换为主表接口 POST /api/fragment/hard_convert.php
* 入参：id（硬碎片ID，必填）/ target_type（company|person|product|need，必填）/
* 补全字段：company_name, person_name, contact_phone, contact_email, target_product_category,
* description, industry, need_category, application_scenario, contact_person
* 逻辑：按目标类型写入主表（product/need 缺公司时自动建公司）→ 标记碎片已转换（converted_type/id, processed_at）
*/
require_once __DIR__ . '/../common/db.php';
require_once __DIR__ . '/../common/response.php';
require_once __DIR__ . '/../common/auth.php';
require_once __DIR__ . '/../common/logger.php';
require_once __DIR__ . '/../common/completeness.php';
checkAjax();
checkPermission('preliminary');
$id = (int)($_POST['id'] ?? 0);
$targetType = trim($_POST['target_type'] ?? '');
if ($id <= 0 || !in_array($targetType, ['company', 'person', 'product', 'need'], true)) {
Response::error('参数错误', 400);
}
$pdo = DB::getInstance()->getPdo();
$stmt = $pdo->prepare("SELECT * FROM preliminary_data WHERE id = ? AND is_active = 1");
$stmt->execute([$id]);
$frag = $stmt->fetch();
if (!$frag) {
Response::error('碎片不存在');
}
if (in_array($frag['status'], ['已转换', '已废弃'], true)) {
Response::error('该碎片已处理（' . $frag['status'] . '）');
}
$companyName = trim($_POST['company_name'] ?? ($frag['company_name'] ?? ''));
$personName = trim($_POST['person_name'] ?? ($frag['person_name'] ?? ''));
$phone = trim($_POST['contact_phone'] ?? ($frag['contact_phone'] ?? ''));
$email = trim($_POST['contact_email'] ?? ($frag['contact_email'] ?? ''));
$category = trim($_POST['target_product_category'] ?? ($frag['target_product_category'] ?? ''));
$description = trim($_POST['description'] ?? ($frag['description'] ?? ''));
$industry = trim($_POST['industry'] ?? '');
$sourceChannel = $frag['source_channel'] ?? null;
$convertedId = 0;
/** 创建 social_accounts（phone/email，常用） */
$saveContacts = function ($ownerType, $ownerId) use ($pdo, $phone, $email) {
if ($phone !== '') {
$pdo->prepare(
"INSERT INTO social_accounts (owner_type, owner_id, platform, account_id, is_primary, is_defult)
VALUES (?, ?, 'phone', ?, 1, 1)"
)->execute([$ownerType, $ownerId, $phone]);
}
if ($email !== '') {
$pdo->prepare(
"INSERT INTO social_accounts (owner_type, owner_id, platform, account_id, is_primary, is_defult)
VALUES (?, ?, 'email', ?, 1, 1)"
)->execute([$ownerType, $ownerId, $email]);
}
};
/** 按名称找公司，找不到则自动创建 */
$resolveCompany = function () use ($pdo, $companyName, $sourceChannel, $industry) {
$stmt = $pdo->prepare("SELECT id FROM companies WHERE display_name = ? AND is_active = 1 LIMIT 1");
$stmt->execute([$companyName]);
$cid = (int)$stmt->fetchColumn();
if ($cid > 0) {
return $cid;
}
$pdo->prepare(
"INSERT INTO companies (display_name, name_zh, industry, source_channel) VALUES (?, ?, ?, ?)"
)->execute([$companyName, $companyName, $industry !== '' ? $industry : null, $sourceChannel]);
return (int)$pdo->lastInsertId();
};
switch ($targetType) {
case 'company':
if ($companyName === '') {
Response::error('公司名称为必填项', 400);
}
$pdo->prepare(
"INSERT INTO companies (display_name, name_zh, industry, business_scope, source_channel, source_detail)
VALUES (?, ?, ?, ?, ?, ?)"
)->execute([
$companyName, $companyName,
$industry !== '' ? $industry : null,
$description !== '' ? $description : null,
$sourceChannel,
$frag['description'] ?? null,
]);
$convertedId = (int)$pdo->lastInsertId();
$saveContacts('company', $convertedId);
updateIncomplete($pdo, 'companies', $convertedId);
updateAccountsIncomplete($pdo, 'company', $convertedId);
break;
case 'person':
if ($personName === '') {
Response::error('联系人为必填项', 400);
}
$unionId = 'P' . date('YmdHis') . substr(uniqid(), -6);
$pdo->prepare(
"INSERT INTO persons (union_id, full_name, source_channel, source_detail) VALUES (?, ?, ?, ?)"
)->execute([$unionId, $personName, $sourceChannel, $frag['description'] ?? null]);
$convertedId = (int)$pdo->lastInsertId();
$saveContacts('person', $convertedId);
updateIncomplete($pdo, 'persons', $convertedId);
updateAccountsIncomplete($pdo, 'person', $convertedId);
break;
case 'product':
if ($companyName === '') {
Response::error('公司名称为必填项', 400);
}
if ($category === '') {
Response::error('产品品类为必填项', 400);
}
$companyId = $resolveCompany();
$pdo->prepare(
"INSERT INTO company_products (company_id, category_name, category_description)
VALUES (?, ?, ?)"
)->execute([$companyId, $category, $description !== '' ? $description : null]);
$convertedId = (int)$pdo->lastInsertId();
updateIncomplete($pdo, 'companies', $companyId);
break;
case 'need':
if ($companyName === '') {
Response::error('公司名称为必填项', 400);
}
$companyId = $resolveCompany();
$contactPerson = trim($_POST['contact_person'] ?? ($frag['person_name'] ?? ''));
$needCategory = trim($_POST['need_category'] ?? '');
$scenario = trim($_POST['application_scenario'] ?? '');
$pdo->prepare(
"INSERT INTO company_needs (company_id, contact_person, need_category, target_product_category, application_scenario, description)
VALUES (?, ?, ?, ?, ?, ?)"
)->execute([
$companyId,
$contactPerson !== '' ? $contactPerson : null,
$needCategory !== '' ? $needCategory : null,
$category !== '' ? $category : null,
$scenario !== '' ? $scenario : null,
$description !== '' ? $description : null,
]);
$convertedId = (int)$pdo->lastInsertId();
updateIncomplete($pdo, 'companies', $companyId);
break;
}
// 标记碎片已转换
$pdo->prepare(
"UPDATE preliminary_data SET status = '已转换', converted_type = ?, converted_id = ?, processed_at = NOW() WHERE id = ?"
)->execute([$targetType, $convertedId, $id]);
logCurrent('convert', 'fragment', 'preliminary_data', $id, [
'target_type' => $targetType,
'converted_id' => $convertedId,
'fields' => ['company_name' => $companyName, 'person_name' => $personName, 'phone' => $phone, 'email' => $email],
]);
Response::success(['converted_type' => $targetType, 'converted_id' => $convertedId], '转换成功');
api/fragment/hard_detail.php
+32
View File
@@ -0,0 +1,32 @@
<?php
/**
* 硬碎片详情接口 GET /api/fragment/hard_detail.php?id=1
*/
require_once __DIR__ . '/../common/db.php';
require_once __DIR__ . '/../common/response.php';
require_once __DIR__ . '/../common/auth.php';
require_once __DIR__ . '/hard_common.php';
checkPermission('preliminary');
$id = (int)($_REQUEST['id'] ?? 0);
if ($id <= 0) {
Response::error('参数错误', 400);
}
$pdo = DB::getInstance()->getPdo();
$stmt = $pdo->prepare("SELECT * FROM preliminary_data WHERE id = ?");
$stmt->execute([$id]);
$row = $stmt->fetch();
if (!$row) {
Response::error('碎片不存在');
}
$calc = hardCompleteness($row);
$row['completeness'] = $calc['score'];
$row['level'] = $calc['level'];
$row['missing'] = $calc['missing'];
$row['summary'] = hardSummary($row);
$row['source_type_label'] = ['company' => '企业', 'person' => '人员', 'product' => '产品', 'need' => '需求', 'mixed' => '混合'][$row['source_type']] ?? $row['source_type'];
Response::success($row);
api/fragment/hard_discard.php
+33
View File
@@ -0,0 +1,33 @@
<?php
/**
* 硬碎片废弃接口 POST /api/fragment/hard_discard.php
* 入参：id
*/
require_once __DIR__ . '/../common/db.php';
require_once __DIR__ . '/../common/response.php';
require_once __DIR__ . '/../common/auth.php';
require_once __DIR__ . '/../common/logger.php';
checkAjax();
checkPermission('preliminary');
$id = (int)($_POST['id'] ?? 0);
if ($id <= 0) {
Response::error('参数错误', 400);
}
$pdo = DB::getInstance()->getPdo();
$stmt = $pdo->prepare("SELECT id, status FROM preliminary_data WHERE id = ? AND is_active = 1");
$stmt->execute([$id]);
$frag = $stmt->fetch();
if (!$frag) {
Response::error('碎片不存在');
}
if (in_array($frag['status'], ['已转换', '已废弃'], true)) {
Response::error('该碎片已处理（' . $frag['status'] . '）');
}
$pdo->prepare("UPDATE preliminary_data SET status = '已废弃', processed_at = NOW() WHERE id = ?")->execute([$id]);
logCurrent('discard', 'fragment', 'preliminary_data', $id, ['status' => '已废弃']);
Response::success(null, '已废弃');
api/fragment/hard_list.php
+62
View File
@@ -0,0 +1,62 @@
<?php
/**
* 硬碎片列表接口 GET /api/fragment/hard_list.php
* 参数：page / limit / source_type / status / source_channel / keyword
* 返回：{ list, total, page, limit }，每行含完整度 score、缺失层级、内容摘要
*/
require_once __DIR__ . '/../common/db.php';
require_once __DIR__ . '/../common/response.php';
require_once __DIR__ . '/../common/auth.php';
require_once __DIR__ . '/hard_common.php';
checkPermission('preliminary');
[$page, $limit] = pageParams();
$keyword = trim($_REQUEST['keyword'] ?? '');
$status = trim($_REQUEST['status'] ?? '');
$sourceType = trim($_REQUEST['source_type'] ?? '');
$sourceChannel = trim($_REQUEST['source_channel'] ?? '');
$where = ["is_active = 1", "status NOT IN ('已转换','已废弃')"];
$params = [];
if ($keyword !== '') {
$where[] = '(company_name LIKE ? OR person_name LIKE ? OR contact_phone LIKE ? OR contact_email LIKE ? OR description LIKE ?)';
$like = "%$keyword%";
array_push($params, $like, $like, $like, $like, $like);
}
if ($status !== '') { $where[] = 'status = ?'; $params[] = $status; }
if ($sourceType !== '') { $where[] = 'source_type = ?'; $params[] = $sourceType; }
if ($sourceChannel !== '') { $where[] = 'source_channel = ?'; $params[] = $sourceChannel; }
$whereSql = implode(' AND ', $where);
$pdo = DB::getInstance()->getPdo();
$stmt = $pdo->prepare("SELECT COUNT(*) FROM preliminary_data WHERE $whereSql");
$stmt->execute($params);
$total = (int)$stmt->fetchColumn();
$offset = ($page - 1) * $limit;
$stmt = $pdo->prepare(
"SELECT id, source_type, company_name, person_name, contact_phone, contact_email,
target_product_category, description, status, source_channel, recorded_by,
follow_person, converted_type, converted_id, created_at, updated_at
FROM preliminary_data
WHERE $whereSql
ORDER BY id DESC
LIMIT $limit OFFSET $offset"
);
$stmt->execute($params);
$rows = $stmt->fetchAll();
$list = [];
foreach ($rows as $r) {
$calc = hardCompleteness($r);
$r['completeness'] = $calc['score'];
$r['level'] = $calc['level'];
$r['missing'] = $calc['missing'];
$r['summary'] = hardSummary($r);
$r['source_type_label'] = ['company' => '企业', 'person' => '人员', 'product' => '产品', 'need' => '需求', 'mixed' => '混合'][$r['source_type']] ?? $r['source_type'];
$list[] = $r;
}
Response::success(['list' => $list, 'total' => $total, 'page' => $page, 'limit' => $limit]);
api/fragment/soft_detail.php
+56
View File
@@ -0,0 +1,56 @@
<?php
/**
* 软碎片详情接口 GET /api/fragment/soft_detail.php?table=persons&id=1
* 返回：{ table, id, name, score, level, missing_core, missing_important, missing_supp, threshold, row }
*/
require_once __DIR__ . '/../common/db.php';
require_once __DIR__ . '/../common/response.php';
require_once __DIR__ . '/../common/auth.php';
require_once __DIR__ . '/../common/completeness.php';
checkPermission('preliminary');
$table = trim($_REQUEST['table'] ?? '');
$id = (int)($_REQUEST['id'] ?? 0);
if (!in_array($table, ['persons', 'companies', 'social_accounts', 'media'], true) || $id <= 0) {
Response::error('参数错误', 400);
}
$pdo = DB::getInstance()->getPdo();
$info = completenessInfo($pdo, $table, $id);
if (!$info) {
Response::error('记录不存在');
}
$tableLabels = ['persons' => '人员', 'companies' => '企业', 'social_accounts' => '联系方式', 'media' => '媒体'];
$name = '';
switch ($table) {
case 'persons':
$name = $info['row']['full_name'] ?? '';
break;
case 'companies':
$name = $info['row']['display_name'] ?? '';
break;
case 'social_accounts':
$name = $info['row']['account_id'] ?? '';
break;
case 'media':
$acc = $pdo->prepare("SELECT account_id FROM social_accounts WHERE id = ?");
$acc->execute([$id]);
$name = (string)$acc->fetchColumn();
break;
}
Response::success([
'table' => $table,
'table_label' => $tableLabels[$table],
'id' => $id,
'name' => $name ?: ('#' . $id),
'score' => $info['score'],
'level' => $info['level'],
'threshold' => $info['threshold'],
'missing_core' => array_map(function ($f) { return ['key' => $f, 'label' => COMPLETENESS_LABELS[$f] ?? $f]; }, $info['missing_core']),
'missing_important' => array_map(function ($f) { return ['key' => $f, 'label' => COMPLETENESS_LABELS[$f] ?? $f]; }, $info['missing_important']),
'missing_supp' => array_map(function ($f) { return ['key' => $f, 'label' => COMPLETENESS_LABELS[$f] ?? $f]; }, $info['missing_supp']),
'row' => $info['row'],
]);
api/fragment/soft_list.php
+83
View File
@@ -0,0 +1,83 @@
<?php
/**
* 软碎片列表接口 GET /api/fragment/soft_list.php
* 参数：page / limit / table（所属表 persons|companies|social_accounts|media）/ level（core|important|supplementary）/ keyword
* 返回：{ list, total, page, limit }，每行含 完整度 score、缺失层级标签、名称、缺失字段、所属表、录入时间
*/
require_once __DIR__ . '/../common/db.php';
require_once __DIR__ . '/../common/response.php';
require_once __DIR__ . '/../common/auth.php';
require_once __DIR__ . '/../common/completeness.php';
checkPermission('preliminary');
[$page, $limit] = pageParams();
$table = trim($_REQUEST['table'] ?? '');
$level = trim($_REQUEST['level'] ?? '');
$keyword = trim($_REQUEST['keyword'] ?? '');
$tableMap = [
'persons' => ['label' => '人员', 'name' => 'full_name'],
'companies' => ['label' => '企业', 'name' => 'display_name'],
'social_accounts' => ['label' => '联系方式', 'name' => 'account_id'],
'media' => ['label' => '媒体', 'name' => null], // media 需 JOIN social_accounts 取名
];
$pdo = DB::getInstance()->getPdo();
$all = [];
foreach ($tableMap as $t => $cfg) {
if ($table !== '' && $table !== $t) {
continue;
}
if ($t === 'media') {
$rows = $pdo->query(
"SELECT m.social_account_id AS id, sa.account_id AS name, m.updated_at AS created_at
FROM media_commercial_attributes m
LEFT JOIN social_accounts sa ON sa.id = m.social_account_id
WHERE m.is_incomplete = 1"
)->fetchAll();
} else {
$rows = $pdo->query("SELECT id, {$cfg['name']} AS name, created_at FROM `$t` WHERE is_incomplete = 1")->fetchAll();
}
foreach ($rows as $r) {
$info = completenessInfo($pdo, $t, (int)$r['id']);
if (!$info) {
continue;
}
if ($level !== '' && $info['level'] !== $level) {
continue;
}
$missingFields = array_merge($info['missing_core'], $info['missing_important'], $info['missing_supp']);
$all[] = [
'table' => $t,
'table_label' => $cfg['label'],
'id' => (int)$r['id'],
'name' => $r['name'] ?: ('#' . $r['id']),
'score' => $info['score'],
'level' => $info['level'],
'missing_fields' => array_map(function ($f) { return COMPLETENESS_LABELS[$f] ?? $f; }, $missingFields),
'created_at' => $r['created_at'] ?? null,
];
}
}
// 按完整度升序（最残缺的排前面），再按时间倒序
usort($all, function ($a, $b) {
if ($a['score'] !== $b['score']) {
return $a['score'] <=> $b['score'];
}
return strcmp($b['created_at'] ?? '', $a['created_at'] ?? '');
});
if ($keyword !== '') {
$all = array_values(array_filter($all, function ($r) use ($keyword) {
return mb_strpos($r['name'], $keyword) !== false;
}));
}
$total = count($all);
$offset = ($page - 1) * $limit;
$list = array_slice($all, $offset, $limit);
Response::success(['list' => $list, 'total' => $total, 'page' => $page, 'limit' => $limit]);
api/fragment/soft_update.php
+144
View File
@@ -0,0 +1,144 @@
<?php
/**
* 软碎片补全提交接口 POST /api/fragment/soft_update.php
* 入参：table（persons|companies|social_accounts|media）/ id / 需补全字段（各表白名单）
* 逻辑：更新主表字段 → 重新计算完整度 → 达标则 is_incomplete=0
* 特殊：persons 的 phone/email 写 social_accounts（platform=phone/email）
*/
require_once __DIR__ . '/../common/db.php';
require_once __DIR__ . '/../common/response.php';
require_once __DIR__ . '/../common/auth.php';
require_once __DIR__ . '/../common/logger.php';
require_once __DIR__ . '/../common/helpers.php';
require_once __DIR__ . '/../common/completeness.php';
checkAjax();
checkPermission('preliminary');
$table = trim($_POST['table'] ?? '');
$id = (int)($_POST['id'] ?? 0);
if (!in_array($table, ['persons', 'companies', 'social_accounts', 'media'], true) || $id <= 0) {
Response::error('参数错误', 400);
}
$pdo = DB::getInstance()->getPdo();
/** 按白名单收集 POST 字段 */
$fields = [];
$collect = function ($whitelist) use (&$fields) {
foreach ($whitelist as $k => $type) {
if (!isset($_POST[$k])) {
continue;
}
$v = trim((string)$_POST[$k]);
if ($v === '') {
$fields[$k] = null;
continue;
}
switch ($type) {
case 'i':
$fields[$k] = (int)$v;
break;
case 'd':
$fields[$k] = (strtotime($v) !== false) ? date('Y-m-d', strtotime($v)) : null;
break;
default:
$fields[$k] = $v;
}
}
};
$isComplete = false;
switch ($table) {
case 'persons':
$collect([
'full_name' => 's', 'gender' => 's', 'nationality' => 's', 'education' => 's',
'graduated_from' => 's', 'hometown' => 's', 'work_location' => 's',
'id_type' => 's', 'id_number' => 's', 'source_channel' => 's', 'source_detail' => 's',
]);
if (!empty($fields)) {
[$sets, $params] = buildUpdate($fields);
$params[] = $id;
$pdo->prepare("UPDATE persons SET $sets WHERE id = ?")->execute($params);
}
// phone/email 写 social_accounts（有则更新，无则插入）
foreach (['phone', 'email'] as $plat) {
if (!isset($_POST[$plat])) {
continue;
}
$v = trim((string)$_POST[$plat]);
$exist = $pdo->prepare("SELECT id FROM social_accounts WHERE owner_type = 'person' AND owner_id = ? AND platform = ?");
$exist->execute([$id, $plat]);
$accId = (int)$exist->fetchColumn();
if ($accId > 0) {
if ($v === '') {
$pdo->prepare("DELETE FROM social_accounts WHERE id = ?")->execute([$accId]);
} else {
$pdo->prepare("UPDATE social_accounts SET account_id = ? WHERE id = ?")->execute([$v, $accId]);
}
} elseif ($v !== '') {
$pdo->prepare(
"INSERT INTO social_accounts (owner_type, owner_id, platform, account_id, is_primary, is_defult)
VALUES ('person', ?, ?, ?, 1, 1)"
)->execute([$id, $plat, $v]);
}
}
$info = updateIncomplete($pdo, 'persons', $id);
updateAccountsIncomplete($pdo, 'person', $id);
break;
case 'companies':
$collect([
'display_name' => 's', 'name_zh' => 's', 'name_en' => 's', 'business_role' => 's',
'country' => 's', 'registration_number' => 's', 'address' => 's', 'legal_form' => 's',
'legal_representative' => 's', 'business_scope' => 's', 'established_date' => 'd',
'registered_capital' => 's', 'industry' => 's', 'industry_subdivision' => 's',
'latest_employee_count' => 'i', 'latest_annual_revenue' => 's', 'is_listed' => 'i',
'stock_code' => 's', 'website' => 's',
]);
if (!empty($fields)) {
[$sets, $params] = buildUpdate($fields);
$params[] = $id;
$pdo->prepare("UPDATE companies SET $sets WHERE id = ?")->execute($params);
}
$info = updateIncomplete($pdo, 'companies', $id);
break;
case 'social_accounts':
$collect([
'platform' => 's', 'account_id' => 's', 'is_primary' => 'i', 'profile_url' => 's', 'remark' => 's',
]);
if (!empty($fields)) {
[$sets, $params] = buildUpdate($fields);
$params[] = $id;
$pdo->prepare("UPDATE social_accounts SET $sets WHERE id = ?")->execute($params);
}
$info = updateIncomplete($pdo, 'social_accounts', $id);
break;
case 'media':
$collect([
'account_level' => 's', 'content_categories' => 's', 'follower_count' => 'i',
'avg_read_count' => 'i', 'certification_type' => 's', 'special_requirements' => 's', 'media_remark' => 's',
]);
if (!empty($fields)) {
[$sets, $params] = buildUpdate($fields);
$params[] = $id;
$pdo->prepare("UPDATE media_commercial_attributes SET $sets WHERE social_account_id = ?")->execute($params);
}
$info = updateIncomplete($pdo, 'media', $id);
updateIncomplete($pdo, 'social_accounts', $id);
break;
}
if (!$info) {
Response::error('记录不存在');
}
logCurrent('complete', 'fragment', $table, $id, ['fields' => array_keys($fields), 'score' => $info['score']]);
Response::success([
'score' => $info['score'],
'level' => $info['level'],
'is_complete' => $info['is_complete'],
], $info['is_complete'] ? '补全完成' : '已更新，完整度 ' . $info['score'] . '%');
api/fragment/stats_overview.php
+49
View File
@@ -0,0 +1,49 @@
<?php
/**
* 碎片处理中心 - 顶部指标卡接口 GET /api/fragment/stats_overview.php
* 返回：{ hard_total 硬碎片总数, soft_total 软碎片总数, month_new 本月新增,
* month_processed 本月处理, pending 待处理碎片 }
*/
require_once __DIR__ . '/../common/db.php';
require_once __DIR__ . '/../common/response.php';
require_once __DIR__ . '/../common/auth.php';
checkPermission('preliminary');
$pdo = DB::getInstance()->getPdo();
// 硬碎片：preliminary_data 中未终结（未转换/未废弃）的记录
$hardTotal = (int)$pdo->query(
"SELECT COUNT(*) FROM preliminary_data WHERE is_active = 1 AND status NOT IN ('已转换','已废弃')"
)->fetchColumn();
// 软碎片：四张主表 is_incomplete=1 之和
$softTotal = 0;
foreach (['companies', 'persons', 'social_accounts', 'media_commercial_attributes'] as $t) {
$softTotal += (int)$pdo->query("SELECT COUNT(*) FROM `$t` WHERE is_incomplete = 1")->fetchColumn();
}
// 本月新增（硬碎片按 created_at）
$monthNew = (int)$pdo->query(
"SELECT COUNT(*) FROM preliminary_data WHERE is_active = 1 AND created_at >= DATE_FORMAT(CURDATE(), '%Y-%m-01')"
)->fetchColumn();
// 本月处理（已转换/已废弃且 processed_at 在本月）
$monthProcessed = (int)$pdo->query(
"SELECT COUNT(*) FROM preliminary_data
WHERE is_active = 1 AND status IN ('已转换','已废弃')
AND processed_at >= DATE_FORMAT(CURDATE(), '%Y-%m-01')"
)->fetchColumn();
// 待处理碎片
$pending = (int)$pdo->query(
"SELECT COUNT(*) FROM preliminary_data WHERE is_active = 1 AND status = '待处理'"
)->fetchColumn();
Response::success([
'hard_total' => $hardTotal,
'soft_total' => $softTotal,
'month_new' => $monthNew,
'month_processed' => $monthProcessed,
'pending' => $pending,
]);
api/media/add.php
+4
View File
@@ -9,6 +9,7 @@ require_once __DIR__ . '/../common/response.php';
require_once __DIR__ . '/../common/auth.php';
require_once __DIR__ . '/../common/logger.php';
require_once __DIR__ . '/../common/helpers.php';
require_once __DIR__ . '/../common/completeness.php';
checkAjax();
checkPermission('media');
@@ -53,5 +54,8 @@ if (!empty($attr)) {
$pdo->prepare("INSERT INTO media_commercial_attributes $attrSql")->execute($attrParams);
}
// 完整度检查：媒体账号 + 商业属性
updateMediaIncomplete($pdo, $newId);
logCurrent('add', 'media', 'social_accounts', $newId, ['data' => $data, 'attr' => $attr]);
Response::success(['id' => $newId], '新增成功');
api/media/import.php
+3
View File
@@ -9,6 +9,7 @@ require_once __DIR__ . '/../common/db.php';
require_once __DIR__ . '/../common/response.php';
require_once __DIR__ . '/../common/auth.php';
require_once __DIR__ . '/../common/logger.php';
require_once __DIR__ . '/../common/completeness.php';
checkAjax();
checkPermission('media');
@@ -85,6 +86,8 @@ while (($row = fgetcsv($handle)) !== false) {
$rec['certification_type'] ?? null,
]);
}
// 完整度检查（导入每行入库后）
updateMediaIncomplete($pdo, $newId);
$inserted++;
} catch (Exception $e) {
$failed++;
api/media/update.php
+4
View File
@@ -8,6 +8,7 @@ require_once __DIR__ . '/../common/response.php';
require_once __DIR__ . '/../common/auth.php';
require_once __DIR__ . '/../common/logger.php';
require_once __DIR__ . '/../common/helpers.php';
require_once __DIR__ . '/../common/completeness.php';
checkAjax();
checkPermission('media');
@@ -50,5 +51,8 @@ if (!empty($attr)) {
}
}
// 完整度检查：媒体账号 + 商业属性
updateMediaIncomplete($pdo, $id);
logCurrent('update', 'media', 'social_accounts', $id, ['before' => $old, 'after' => $data, 'attr' => $attr]);
Response::success(null, '更新成功');
api/person/add.php
+5
View File
@@ -9,6 +9,7 @@ require_once __DIR__ . '/../common/response.php';
require_once __DIR__ . '/../common/auth.php';
require_once __DIR__ . '/../common/logger.php';
require_once __DIR__ . '/../common/helpers.php';
require_once __DIR__ . '/../common/completeness.php';
checkAjax();
checkPermission('person');
@@ -55,5 +56,9 @@ if (is_array($experiences)) {
savePersonExperiences($pdo, $newId, $experiences);
}
// 完整度检查：人员主表 + 其 social_accounts
updateIncomplete($pdo, 'persons', $newId);
updateAccountsIncomplete($pdo, 'person', $newId);
logCurrent('add', 'person', 'persons', $newId, ['data' => $data, 'contacts' => $contacts]);
Response::success(['id' => $newId], '新增成功');
api/person/import.php
+4
View File
@@ -9,6 +9,7 @@ require_once __DIR__ . '/../common/db.php';
require_once __DIR__ . '/../common/response.php';
require_once __DIR__ . '/../common/auth.php';
require_once __DIR__ . '/../common/logger.php';
require_once __DIR__ . '/../common/completeness.php';
checkAjax();
checkPermission('person');
@@ -72,6 +73,9 @@ while (($row = fgetcsv($handle)) !== false) {
if (!empty($rec['email'])) {
$insAccount->execute([$newId, 'email', $rec['email']]);
}
// 完整度检查（导入每行入库后）
updateIncomplete($pdo, 'persons', $newId);
updateAccountsIncomplete($pdo, 'person', $newId);
$inserted++;
} catch (Exception $e) {
$failed++;
api/person/update.php
+5
View File
@@ -8,6 +8,7 @@ require_once __DIR__ . '/../common/response.php';
require_once __DIR__ . '/../common/auth.php';
require_once __DIR__ . '/../common/logger.php';
require_once __DIR__ . '/../common/helpers.php';
require_once __DIR__ . '/../common/completeness.php';
checkAjax();
checkPermission('person');
@@ -63,5 +64,9 @@ if (array_key_exists('experiences', $_POST)) {
savePersonExperiences($pdo, $id, $experiences);
}
// 完整度检查：人员主表 + 其 social_accounts
updateIncomplete($pdo, 'persons', $id);
updateAccountsIncomplete($pdo, 'person', $id);
logCurrent('update', 'person', 'persons', $id, ['before' => $old, 'after' => $data, 'contacts_replaced' => $contactsChanged]);
Response::success(null, '更新成功');