Deepseath / hris · Files

<?php
/**
 * User.php
 * 用户接口 v2
 * @author Deepseath
 * @version $Id$
 */
namespace deepseath\hris\ApiV2;

class User
{
    /**
     * 基类服务对象
     * @var \deepseath\hris\Hris
     */
    protected $service = null;

    public function __construct(\deepseath\hris\Hris $service)
    {
        $this->service = $service;
    }

    /**
     * 员工基础信息
     * @desc 查询 HRIS 中的员工基础信息，参数为空返回所有成员
     * @param array $params
     * <pre>
     *      nameZH      按中文名模糊查询
     *      email       按邮箱查询
     * </pre>
     * @return array
     * <pre>
     *  list
     *   employeeId
     *   nameZH
     *   nameEN
     *   email
     *   wxUserId
     *   positionId
     *   remark1
     * </pre>
     */
    public function list(array $params = []) : array
    {
        $params = array_merge([
            //'nameZH' => '',
            //'email' => ''
        ], $params);

        $result = $this->service->apiRequest('get', 'employeeList', $params);
        return $result['employeeList'] ?? [];
    }

    /**
     * 新增员工
     * @desc 向HRIS中插入新用户
     * @param array $params
     * @return mixed
     */
    public function add(array $params) : mixed
    {
        if (!empty($params['email']) && preg_match('/@i\-click\.com$/is', $params['email'])) {
            // 如果是 i-click.com 邮箱则不处理
            throw new \Exception('i-click.com mail ignore', 4013);
        }
        $this->_fieldCheck($params);
        // $result;
        return $this->service->apiRequest('post', 'add_employee', $params);
    }

    /**
     * 更新员工
     * @desc 用户修改
     * @param array $params
     * @return mixed
     */
    public function update(array $params) : mixed
    {
        if (!empty($params['email']) && preg_match('/@i\-click\.com$/is', $params['email'])) {
            // 如果是 i-click.com 邮箱则不处理
            throw new \Exception('i-click.com mail ignore', 4013);
        }
        $this->_fieldCheck($params);
        return $this->service->apiRequest('post', 'edit_employee', $params);
    }

    /**
     * 更改邮箱专用接口
     *
     * @param array $params
     * <pre>
     * + employeeId
     * + email
     * + updateEmail
     * </pre>
     * @return mixed
     */
    public function email(array $params) : mixed
    {
        if (!empty($params['email']) && preg_match('/@i\-click\.com$/is', $params['email'])) {
            // 如果是 i-click.com 邮箱则不处理
            throw new \Exception('i-click.com mail ignore', 4013);
        }
        return $this->service->apiRequest('post', 'update_employee_email', $params);
    }

    /**
     * 员工离职
     * @param array $params
     * @param string $newEmail &离职后的 hris 成员邮箱
     * @return mixed
     */
    public function dismiss(array $params, &$newEmail = '') : mixed
    {
        if (!empty($params['email']) && preg_match('/@i\-click\.com$/is', $params['email'])) {
            // 如果是 i-click.com 邮箱则不处理
            throw new \Exception('i-click.com mail ignore', 4013);
        }
        if (isset($params['email']) && !preg_match('/dismiss_\d+_\d+/is', $params['email'])) {
            // 不是离职标识邮箱，则先更改邮箱
            $emailParams = [];
            if (!empty($params['email'])) {
                $emailParams['email'] = $params['email'];
            }
            if (empty($params['email'])) {
                $params['email'] = 'dismiss_'.date('Ymd') .'_' . mt_rand(100000, 999999).'@vchangyi.com';
            } else {
                $params['email'] = $params['email'] . '_' . 'dismiss_'.date('Ymd') .'_' . mt_rand(100000, 999999);
            }
            $newEmail = $params['email'];
            $emailParams['updateEmail'] = $params['email'];
            $this->email($emailParams);
        }

        $params = array_merge($params, [
            'employeeStatus' => self::STATUS_OFFLINE
        ]);
        return $this->service->apiRequest('post', 'edit_employee', $params);
    }

    /**
     * 删除成员
     * @param array $params
     * @param string $newEmail &删除后 hris 成员的邮箱
     * @return mixed
     */
    public function delete(array $params, &$newEmail = '') : mixed
    {
        if (!empty($params['email']) && preg_match('/@i\-click\.com$/is', $params['email'])) {
            // 如果是 i-click.com 邮箱则不处理
            throw new \Exception('i-click.com mail ignore', 4013);
        }
        if (isset($params['email']) && !preg_match('/delete_\d+_\d+/is', $params['email'])) {
            $emailParams = [];
            if (!empty($params['email'])) {
                $emailParams['email'] = $params['email'];
            }

            if (empty($params['email'])) {
                $params['email'] = 'delete_'.date('Ymd') .'_' . mt_rand(100000, 999999).'@vchangyi.com';
            } else {
                $params['email'] = $params['email'] . '_' . 'delete_'.date('Ymd') .'_' . mt_rand(100000, 999999);
            }
            $newEmail = $params['email'];
            $emailParams['updateEmail'] = $params['email'];

            $this->email($emailParams);
        }
        
        $params = array_merge($params, [
            'employeeStatus' => self::STATUS_OFFLINE,
            'deleted' => self::IS_DELETE
        ]);
        return $this->service->apiRequest('post', 'edit_employee', $params);
    }

    /**
     * 员工数据参数检查
     * @param array $params
     * @throws \Exception
     * @return bool
     */
    private function _fieldCheck(array $params) : bool
    {

        return true;
    }

    /**
     * 在职状态：在职
     */
    const STATUS_ON = '1';
    /**
     * 在职状态：离职
     */
    const STATUS_OFFLINE = '3';

    /**
     * 是否删除：确认删除
     */
    const IS_DELETE = 2;
    /**
     * 在职状态描述映射关系
     * @var array
     */
    const MAP_STATUS = [
        self::STATUS_ON => '在职',
        self::STATUS_OFFLINE => '离职'
    ];

    /**
     * 法务实体映射关系
     * @var array
     */
    const MAP_ENTOTY = [
        '157' => '畅移（上海）信息科技有限公司',
        '158' => '西安畅展信息科技有限公司',
    ];

    /**
     * 工作地映射关系
     * @var array
     */
    const MAP_LOCATION = [
        '65' => '上海',
        '116' => '西安',
    ];

    /**
     * 员工类型映射关系
     * @var array
     */
    const MAP_TYPE = [
        '0' => '请选择',
        '1' => 'Full Time Employee',// 全职
        '2' => 'Intern',// 实习生
        '3' => 'Consultant',// 顾问
        '4' => 'Others on Payroll',// 编外
        '5' => 'Temp',// 临时工
        '6' => 'Part Time Employee',// 兼职
        '7' => '其他',
    ];

    /**
     * 职级映射关系
     * @var array
     */
    const MAP_GRADE_ID = [
        '179' => ['E2', 'Sr. Executive'],
        '181' => ['E1', 'Executive'],
        '183' => ['M4', 'GM/VP'],
        '187' => ['M3', 'Director'],
        '189' => ['IC6', 'Director'],
        '191' => ['M2', 'Sr. Manager'],
        '193' => ['IC5', 'Sr. Manager'],
        '195' => ['M1', 'Manager'],
        '197' => ['IC4', 'Manager'],
        '199' => ['IC3', 'Associate Manager'],
        '201' => ['IC2', 'Sr. Specialist'],
        '203' => ['IC1', 'Specialist'],
        '205' => ['S2', 'Coordinator'],
        '207' => ['S1', 'Assistant'],
        '209' => ['E1', 'COO'],
        '213' => ['IC7', 'GM/VP'],
        '315' => ['E1', 'CFO'],
        '316' => ['E3', 'Chairman'],
        '319' => ['M5', 'GM/VP']
    ];

    /**
     * 身份证件类型映射关系
     * @var array
     */
    const MP_CERTIFICATE_TYPE = [
        '0' => '请选择',
        '1' => '身份证',
        '2' => '护照',
        '3' => '台胞证',
        '4' => '身份证（香港）',
        '5' => '身份证（新加坡）',
        '6' => '港澳通行证',
    ];

    /**
     * 婚姻状态映射关系
     * @var array
     */
    const MP_MARITAL_STATUS = [
        '0' => '请选择',
        '1' => '未婚',
        '2' => '已婚',
    ];

    /**
     * 最高学历映射关系
     * @var array
     */
    const MAP_HIGHEST_EDUCATION = [
        '0' => ['请选择', ''],
        '95' => ['PhD', '博士'],
        '97' => ['Master', '硕士'],
        '99' => ['Bachelor', '本科'],
        '103' => ['Senior High', '高中'],
        '105' => ['Junior High', '初中'],
        '107' => ['Diploma', '大专'],
        '109' => ['Associate Degree', '大学肆业'],
        '111' => ['Advanced Diploma', '高级文凭'],
        '113' => ['Higher Diploma', '高级文凭'],
        '115' => ['Juris Doctor', '法学博士'],
        '117' => ['Certificate', '证书'],
        '119' => ['Secondary ', '中专'],
        '121' => ['F.5', 'F.5'],
    ];

    /**
     * 民族映射关系
     * @var array
     */
    const NATION = [
        '0' => '请选择',
        '1' => '汉族',
        '10' => '瑶族',
        '11' => '锡伯族',
        '12' => '苗族',
        '2' => '蒙古族',
        '3' => '土家族',
        '4' => '满族',
        '5' => '壮族',
        '6' => '仫佬族',
        '7' => '回族',
        '8' => '英国',
        '9' => '维吾尔族',
    ];

    /**
     * 国籍映射关系
     * @var array
     */
    const MAP_NATION_NALITY = [
        '0' => '请选择',
        '1' => '中国',
        '2' => '美国',
        '3' => '新加坡',
        '5' => '加拿大',
        '7' => '英国',
        '9' => '泰国',
        '11' => '日本',
        '13' => '韩国',
        '15' => '法国',
        '17' => '香港',
        '19' => '台湾',
        '21' => '澳大利亚',
        '23' => '菲律宾',
        '24' => '德国',
        '25' => '意大利',
        '26' => '马来西亚',
        '27' => '新西兰',
        '28' => '西班牙',
        '29' => '其他',
    ];

    /**
     * 角色映射关系
     * @var array
     */
    const MAP_JOB_ROLE = [
        '0' => '请选择',
        '10' => 'Engineering',
        '12' => 'Finance',
        '14' => 'Human Resources',
        '16' => 'Management',
        '17' => 'Marketing',
        '18' => 'Media',
        '19' => 'Optimization',
        '20' => 'Product Management',
        '21' => 'Project Management',
        '23' => 'Sales',
        '28' => 'Creative Design',
        '29' => 'Legal',
        '3' => 'Account Management',
        '30' => 'Product Marketing',
        '31' => 'Product Trainer',
        '32' => 'Sales Operations',
        '37' => 'Solution Planning',
        '4' => 'Accounting',
        '40' => 'Biz Planning & Operations',
        '41' => 'Solution Development',
        '43' => 'Product Operations',
        '44' => 'User Experience Design',
        '45' => 'Public Relations',
        '46' => 'Data Analysis',
        '47' => 'Kol Operations',
        '48' => 'Content Operations',
        '49' => 'Creative',
        '5' => 'Ad. Operations',
        '6' => 'Administration',
        '8' => 'Biz Development',
        '9' => 'Biz Intelligence',
    ];

    /**
     * 性别映射关系
     * @var array
     */
    const MAP_GENDER = [
        '0' => '未填写',
        '1' => '先生',
        '2' => '女士'
    ];
}