Allowing setting user status

Summary:
I will use it for highlighting users which are not currently available.

Maybe I will also use it in the nagging tool.

I don't plan creating a UI for it as API is currently enough for us.
Maybe I will visualize it at /calendar/ later.

I plan creating `user.deletestatus` method when this one will be done.

Test Plan:
`storage upgrade`
Call Conduit `user.addstatus`.
Verify DB.

Reviewers: epriestley

Reviewed By: epriestley

CC: aran, Koolvin

Differential Revision: https://secure.phabricator.com/D2382

resources/sql/patches/userstatus.sql

···
+CREATE TABLE {$NAMESPACE}_user.user_status (
+  `id` int unsigned NOT NULL AUTO_INCREMENT,
+  `userPHID` varchar(64) NOT NULL,
+  `dateFrom` int unsigned NOT NULL,
+  `dateTo` int unsigned NOT NULL,
+  `status` tinyint unsigned NOT NULL,
+  `dateCreated` int unsigned NOT NULL,
+  `dateModified` int unsigned NOT NULL,
+  PRIMARY KEY (`id`),
+  INDEX `userPHID_dateFrom` (`userPHID`, `dateTo`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8;

src/__phutil_library_map__.php

···
     'ConduitAPI_remarkup_process_Method' => 'applications/conduit/method/remarkup/process',
     'ConduitAPI_slowvote_info_Method' => 'applications/conduit/method/slowvote/info',
     'ConduitAPI_user_Method' => 'applications/conduit/method/user/base',
+    'ConduitAPI_user_addstatus_Method' => 'applications/conduit/method/user/addstatus',
     'ConduitAPI_user_find_Method' => 'applications/conduit/method/user/find',
     'ConduitAPI_user_info_Method' => 'applications/conduit/method/user/info',
     'ConduitAPI_user_whoami_Method' => 'applications/conduit/method/user/whoami',
···
     'PhabricatorUserSearchSettingsPanelController' => 'applications/people/controller/settings/panels/search',
     'PhabricatorUserSettingsController' => 'applications/people/controller/settings',
     'PhabricatorUserSettingsPanelController' => 'applications/people/controller/settings/panels/base',
+    'PhabricatorUserStatus' => 'applications/people/storage/userstatus',
     'PhabricatorUserTestCase' => 'applications/people/storage/user/__tests__',
     'PhabricatorWorker' => 'infrastructure/daemon/workers/worker',
     'PhabricatorWorkerDAO' => 'infrastructure/daemon/workers/storage/base',
···
     'ConduitAPI_remarkup_process_Method' => 'ConduitAPIMethod',
     'ConduitAPI_slowvote_info_Method' => 'ConduitAPIMethod',
     'ConduitAPI_user_Method' => 'ConduitAPIMethod',
+    'ConduitAPI_user_addstatus_Method' => 'ConduitAPI_user_Method',
     'ConduitAPI_user_find_Method' => 'ConduitAPI_user_Method',
     'ConduitAPI_user_info_Method' => 'ConduitAPI_user_Method',
     'ConduitAPI_user_whoami_Method' => 'ConduitAPI_user_Method',
···
     'PhabricatorUserSearchSettingsPanelController' => 'PhabricatorUserSettingsPanelController',
     'PhabricatorUserSettingsController' => 'PhabricatorPeopleController',
     'PhabricatorUserSettingsPanelController' => 'PhabricatorPeopleController',
+    'PhabricatorUserStatus' => 'PhabricatorUserDAO',
     'PhabricatorUserTestCase' => 'PhabricatorTestCase',
     'PhabricatorWorkerDAO' => 'PhabricatorLiskDAO',
     'PhabricatorWorkerTask' => 'PhabricatorWorkerDAO',

src/applications/conduit/method/user/addstatus/ConduitAPI_user_addstatus_Method.php

···
+<?php
+
+/*
+ * Copyright 2012 Facebook, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @group conduit
+ */
+final class ConduitAPI_user_addstatus_Method extends ConduitAPI_user_Method {
+
+  public function getMethodDescription() {
+    return "Add status information to the logged-in user.";
+  }
+
+  public function defineParamTypes() {
+    return array(
+      'fromEpoch' => 'required int',
+      'toEpoch' => 'required int',
+      'status' => 'required enum<away, sporadic>',
+    );
+  }
+
+  public function defineReturnType() {
+    return 'void';
+  }
+
+  public function defineErrorTypes() {
+    return array(
+      'ERR-BAD-EPOCH' => "'toEpoch' must be bigger than 'fromEpoch'.",
+      'ERR-OVERLAP' =>
+        'There must be no status in any part of the specified epoch.',
+    );
+  }
+
+  protected function execute(ConduitAPIRequest $request) {
+    $userPHID = $request->getUser()->getPHID();
+    $from = $request->getValue('fromEpoch');
+    $to = $request->getValue('toEpoch');
+
+    if ($to <= $from) {
+      throw new ConduitException('ERR-BAD-EPOCH');
+    }
+
+    // TODO: This SELECT should have LOCK IN SHARE MODE and be in transaction
+    // with the next INSERT.
+    $overlap = id(new PhabricatorUserStatus())->loadAllWhere(
+      'userPHID = %s AND dateFrom < %d AND dateTo > %d',
+      $userPHID,
+      $to,
+      $from);
+    if ($overlap) {
+      throw new ConduitException('ERR-OVERLAP');
+    }
+
+    switch ($request->getValue('status')) {
+      case 'sporadic':
+        $status = PhabricatorUserStatus::STATUS_SPORADIC;
+        break;
+      default:
+        $status = PhabricatorUserStatus::STATUS_AWAY;
+        break;
+    }
+    id(new PhabricatorUserStatus())
+      ->setUserPHID($userPHID)
+      ->setDateFrom($from)
+      ->setDateTo($to)
+      ->setStatus($status)
+      ->save();
+  }
+
+}

src/applications/conduit/method/user/addstatus/__init__.php

···
+<?php
+/**
+ * This file is automatically generated. Lint this module to rebuild it.
+ * @generated
+ */
+
+
+
+phutil_require_module('phabricator', 'applications/conduit/method/user/base');
+phutil_require_module('phabricator', 'applications/conduit/protocol/exception');
+phutil_require_module('phabricator', 'applications/people/storage/userstatus');
+
+phutil_require_module('phutil', 'utils');
+
+
+phutil_require_source('ConduitAPI_user_addstatus_Method.php');

src/applications/people/storage/userstatus/PhabricatorUserStatus.php

···
+<?php
+
+/*
+ * Copyright 2012 Facebook, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+final class PhabricatorUserStatus extends PhabricatorUserDAO {
+
+  const STATUS_AWAY = 1;
+  const STATUS_SPORADIC = 2;
+
+  protected $userPHID;
+  protected $dateFrom;
+  protected $dateTo;
+  protected $status;
+
+}

src/applications/people/storage/userstatus/__init__.php

···
+<?php
+/**
+ * This file is automatically generated. Lint this module to rebuild it.
+ * @generated
+ */
+
+
+
+phutil_require_module('phabricator', 'applications/people/storage/base');
+
+
+phutil_require_source('PhabricatorUserStatus.php');

src/infrastructure/setup/sql/phabricator/PhabricatorBuiltinPatchList.php

···
         'type'    => 'sql',
         'name'    => $this->getPatchPath('holidays.sql'),
       ),
+      'userstatus.sql' => array(
+        'type'    => 'sql',
+        'name'    => $this->getPatchPath('userstatus.sql'),
+      ),
     );
   }