cards.js 36 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574
  1. Cards = new Mongo.Collection('cards');
  2. // XXX To improve pub/sub performances a card document should include a
  3. // de-normalized number of comments so we don't have to publish the whole list
  4. // of comments just to display the number of them in the board view.
  5. Cards.attachSchema(new SimpleSchema({
  6. title: {
  7. type: String,
  8. optional: true,
  9. defaultValue: '',
  10. },
  11. archived: {
  12. type: Boolean,
  13. autoValue() { // eslint-disable-line consistent-return
  14. if (this.isInsert && !this.isSet) {
  15. return false;
  16. }
  17. },
  18. },
  19. parentId: {
  20. type: String,
  21. optional: true,
  22. defaultValue: '',
  23. },
  24. listId: {
  25. type: String,
  26. optional: true,
  27. defaultValue: '',
  28. },
  29. swimlaneId: {
  30. type: String,
  31. },
  32. // The system could work without this `boardId` information (we could deduce
  33. // the board identifier from the card), but it would make the system more
  34. // difficult to manage and less efficient.
  35. boardId: {
  36. type: String,
  37. optional: true,
  38. defaultValue: '',
  39. },
  40. coverId: {
  41. type: String,
  42. optional: true,
  43. defaultValue: '',
  44. },
  45. createdAt: {
  46. type: Date,
  47. autoValue() { // eslint-disable-line consistent-return
  48. if (this.isInsert) {
  49. return new Date();
  50. } else {
  51. this.unset();
  52. }
  53. },
  54. },
  55. customFields: {
  56. type: [Object],
  57. optional: true,
  58. defaultValue: [],
  59. },
  60. 'customFields.$': {
  61. type: new SimpleSchema({
  62. _id: {
  63. type: String,
  64. optional: true,
  65. defaultValue: '',
  66. },
  67. value: {
  68. type: Match.OneOf(String, Number, Boolean, Date),
  69. optional: true,
  70. defaultValue: '',
  71. },
  72. }),
  73. },
  74. dateLastActivity: {
  75. type: Date,
  76. autoValue() {
  77. return new Date();
  78. },
  79. },
  80. description: {
  81. type: String,
  82. optional: true,
  83. defaultValue: '',
  84. },
  85. requestedBy: {
  86. type: String,
  87. optional: true,
  88. defaultValue: '',
  89. },
  90. assignedBy: {
  91. type: String,
  92. optional: true,
  93. defaultValue: '',
  94. },
  95. labelIds: {
  96. type: [String],
  97. optional: true,
  98. defaultValue: [],
  99. },
  100. members: {
  101. type: [String],
  102. optional: true,
  103. defaultValue: [],
  104. },
  105. receivedAt: {
  106. type: Date,
  107. optional: true,
  108. },
  109. startAt: {
  110. type: Date,
  111. optional: true,
  112. },
  113. dueAt: {
  114. type: Date,
  115. optional: true,
  116. },
  117. endAt: {
  118. type: Date,
  119. optional: true,
  120. },
  121. spentTime: {
  122. type: Number,
  123. decimal: true,
  124. optional: true,
  125. defaultValue: 0,
  126. },
  127. isOvertime: {
  128. type: Boolean,
  129. defaultValue: false,
  130. optional: true,
  131. },
  132. // XXX Should probably be called `authorId`. Is it even needed since we have
  133. // the `members` field?
  134. userId: {
  135. type: String,
  136. autoValue() { // eslint-disable-line consistent-return
  137. if (this.isInsert && !this.isSet) {
  138. return this.userId;
  139. }
  140. },
  141. },
  142. sort: {
  143. type: Number,
  144. decimal: true,
  145. defaultValue: '',
  146. },
  147. subtaskSort: {
  148. type: Number,
  149. decimal: true,
  150. defaultValue: -1,
  151. optional: true,
  152. },
  153. type: {
  154. type: String,
  155. defaultValue: '',
  156. },
  157. linkedId: {
  158. type: String,
  159. optional: true,
  160. defaultValue: '',
  161. },
  162. }));
  163. Cards.allow({
  164. insert(userId, doc) {
  165. return allowIsBoardMember(userId, Boards.findOne(doc.boardId));
  166. },
  167. update(userId, doc) {
  168. return allowIsBoardMember(userId, Boards.findOne(doc.boardId));
  169. },
  170. remove(userId, doc) {
  171. return allowIsBoardMember(userId, Boards.findOne(doc.boardId));
  172. },
  173. fetch: ['boardId'],
  174. });
  175. Cards.helpers({
  176. list() {
  177. return Lists.findOne(this.listId);
  178. },
  179. board() {
  180. return Boards.findOne(this.boardId);
  181. },
  182. labels() {
  183. const boardLabels = this.board().labels;
  184. const cardLabels = _.filter(boardLabels, (label) => {
  185. return _.contains(this.labelIds, label._id);
  186. });
  187. return cardLabels;
  188. },
  189. hasLabel(labelId) {
  190. return _.contains(this.labelIds, labelId);
  191. },
  192. user() {
  193. return Users.findOne(this.userId);
  194. },
  195. isAssigned(memberId) {
  196. return _.contains(this.getMembers(), memberId);
  197. },
  198. activities() {
  199. if (this.isLinkedCard()) {
  200. return Activities.find({cardId: this.linkedId}, {sort: {createdAt: -1}});
  201. } else if (this.isLinkedBoard()) {
  202. return Activities.find({boardId: this.linkedId}, {sort: {createdAt: -1}});
  203. } else {
  204. return Activities.find({cardId: this._id}, {sort: {createdAt: -1}});
  205. }
  206. },
  207. comments() {
  208. if (this.isLinkedCard()) {
  209. return CardComments.find({cardId: this.linkedId}, {sort: {createdAt: -1}});
  210. } else {
  211. return CardComments.find({cardId: this._id}, {sort: {createdAt: -1}});
  212. }
  213. },
  214. attachments() {
  215. if (this.isLinkedCard()) {
  216. return Attachments.find({cardId: this.linkedId}, {sort: {uploadedAt: -1}});
  217. } else {
  218. return Attachments.find({cardId: this._id}, {sort: {uploadedAt: -1}});
  219. }
  220. },
  221. cover() {
  222. const cover = Attachments.findOne(this.coverId);
  223. // if we return a cover before it is fully stored, we will get errors when we try to display it
  224. // todo XXX we could return a default "upload pending" image in the meantime?
  225. return cover && cover.url() && cover;
  226. },
  227. checklists() {
  228. if (this.isLinkedCard()) {
  229. return Checklists.find({cardId: this.linkedId}, {sort: { sort: 1 } });
  230. } else {
  231. return Checklists.find({cardId: this._id}, {sort: { sort: 1 } });
  232. }
  233. },
  234. checklistItemCount() {
  235. const checklists = this.checklists().fetch();
  236. return checklists.map((checklist) => {
  237. return checklist.itemCount();
  238. }).reduce((prev, next) => {
  239. return prev + next;
  240. }, 0);
  241. },
  242. checklistFinishedCount() {
  243. const checklists = this.checklists().fetch();
  244. return checklists.map((checklist) => {
  245. return checklist.finishedCount();
  246. }).reduce((prev, next) => {
  247. return prev + next;
  248. }, 0);
  249. },
  250. checklistFinished() {
  251. return this.hasChecklist() && this.checklistItemCount() === this.checklistFinishedCount();
  252. },
  253. hasChecklist() {
  254. return this.checklistItemCount() !== 0;
  255. },
  256. subtasks() {
  257. return Cards.find({
  258. parentId: this._id,
  259. archived: false,
  260. }, {
  261. sort: {
  262. sort: 1,
  263. },
  264. });
  265. },
  266. allSubtasks() {
  267. return Cards.find({
  268. parentId: this._id,
  269. archived: false,
  270. }, {
  271. sort: {
  272. sort: 1,
  273. },
  274. });
  275. },
  276. subtasksCount() {
  277. return Cards.find({
  278. parentId: this._id,
  279. archived: false,
  280. }).count();
  281. },
  282. subtasksFinishedCount() {
  283. return Cards.find({
  284. parentId: this._id,
  285. archived: true,
  286. }).count();
  287. },
  288. subtasksFinished() {
  289. const finishCount = this.subtasksFinishedCount();
  290. return finishCount > 0 && this.subtasksCount() === finishCount;
  291. },
  292. allowsSubtasks() {
  293. return this.subtasksCount() !== 0;
  294. },
  295. customFieldIndex(customFieldId) {
  296. return _.pluck(this.customFields, '_id').indexOf(customFieldId);
  297. },
  298. // customFields with definitions
  299. customFieldsWD() {
  300. // get all definitions
  301. const definitions = CustomFields.find({
  302. boardId: this.boardId,
  303. }).fetch();
  304. // match right definition to each field
  305. if (!this.customFields) return [];
  306. return this.customFields.map((customField) => {
  307. const definition = definitions.find((definition) => {
  308. return definition._id === customField._id;
  309. });
  310. //search for "True Value" which is for DropDowns other then the Value (which is the id)
  311. let trueValue = customField.value;
  312. if (definition.settings.dropdownItems && definition.settings.dropdownItems.length > 0) {
  313. for (let i = 0; i < definition.settings.dropdownItems.length; i++) {
  314. if (definition.settings.dropdownItems[i]._id === customField.value) {
  315. trueValue = definition.settings.dropdownItems[i].name;
  316. }
  317. }
  318. }
  319. return {
  320. _id: customField._id,
  321. value: customField.value,
  322. trueValue,
  323. definition,
  324. };
  325. });
  326. },
  327. absoluteUrl() {
  328. const board = this.board();
  329. return FlowRouter.url('card', {
  330. boardId: board._id,
  331. slug: board.slug,
  332. cardId: this._id,
  333. });
  334. },
  335. canBeRestored() {
  336. const list = Lists.findOne({
  337. _id: this.listId,
  338. });
  339. if (!list.getWipLimit('soft') && list.getWipLimit('enabled') && list.getWipLimit('value') === list.cards().count()) {
  340. return false;
  341. }
  342. return true;
  343. },
  344. parentCard() {
  345. if (this.parentId === '') {
  346. return null;
  347. }
  348. return Cards.findOne(this.parentId);
  349. },
  350. parentCardName() {
  351. let result = '';
  352. if (this.parentId !== '') {
  353. const card = Cards.findOne(this.parentId);
  354. if (card) {
  355. result = card.title;
  356. }
  357. }
  358. return result;
  359. },
  360. parentListId() {
  361. const result = [];
  362. let crtParentId = this.parentId;
  363. while (crtParentId !== '') {
  364. const crt = Cards.findOne(crtParentId);
  365. if ((crt === null) || (crt === undefined)) {
  366. // maybe it has been deleted
  367. break;
  368. }
  369. if (crtParentId in result) {
  370. // circular reference
  371. break;
  372. }
  373. result.unshift(crtParentId);
  374. crtParentId = crt.parentId;
  375. }
  376. return result;
  377. },
  378. parentList() {
  379. const resultId = [];
  380. const result = [];
  381. let crtParentId = this.parentId;
  382. while (crtParentId !== '') {
  383. const crt = Cards.findOne(crtParentId);
  384. if ((crt === null) || (crt === undefined)) {
  385. // maybe it has been deleted
  386. break;
  387. }
  388. if (crtParentId in resultId) {
  389. // circular reference
  390. break;
  391. }
  392. resultId.unshift(crtParentId);
  393. result.unshift(crt);
  394. crtParentId = crt.parentId;
  395. }
  396. return result;
  397. },
  398. parentString(sep) {
  399. return this.parentList().map(function(elem) {
  400. return elem.title;
  401. }).join(sep);
  402. },
  403. isTopLevel() {
  404. return this.parentId === '';
  405. },
  406. isLinkedCard() {
  407. return this.type === 'cardType-linkedCard';
  408. },
  409. isLinkedBoard() {
  410. return this.type === 'cardType-linkedBoard';
  411. },
  412. isLinked() {
  413. return this.isLinkedCard() || this.isLinkedBoard();
  414. },
  415. setDescription(description) {
  416. if (this.isLinkedCard()) {
  417. return Cards.update({_id: this.linkedId}, {$set: {description}});
  418. } else if (this.isLinkedBoard()) {
  419. return Boards.update({_id: this.linkedId}, {$set: {description}});
  420. } else {
  421. return Cards.update(
  422. {_id: this._id},
  423. {$set: {description}}
  424. );
  425. }
  426. },
  427. getDescription() {
  428. if (this.isLinkedCard()) {
  429. const card = Cards.findOne({_id: this.linkedId});
  430. if (card && card.description)
  431. return card.description;
  432. else
  433. return null;
  434. } else if (this.isLinkedBoard()) {
  435. const board = Boards.findOne({_id: this.linkedId});
  436. if (board && board.description)
  437. return board.description;
  438. else
  439. return null;
  440. } else if (this.description) {
  441. return this.description;
  442. } else {
  443. return null;
  444. }
  445. },
  446. getMembers() {
  447. if (this.isLinkedCard()) {
  448. const card = Cards.findOne({_id: this.linkedId});
  449. return card.members;
  450. } else if (this.isLinkedBoard()) {
  451. const board = Boards.findOne({_id: this.linkedId});
  452. return board.activeMembers().map((member) => {
  453. return member.userId;
  454. });
  455. } else {
  456. return this.members;
  457. }
  458. },
  459. assignMember(memberId) {
  460. if (this.isLinkedCard()) {
  461. return Cards.update(
  462. { _id: this.linkedId },
  463. { $addToSet: { members: memberId }}
  464. );
  465. } else if (this.isLinkedBoard()) {
  466. const board = Boards.findOne({_id: this.linkedId});
  467. return board.addMember(memberId);
  468. } else {
  469. return Cards.update(
  470. { _id: this._id },
  471. { $addToSet: { members: memberId}}
  472. );
  473. }
  474. },
  475. unassignMember(memberId) {
  476. if (this.isLinkedCard()) {
  477. return Cards.update(
  478. { _id: this.linkedId },
  479. { $pull: { members: memberId }}
  480. );
  481. } else if (this.isLinkedBoard()) {
  482. const board = Boards.findOne({_id: this.linkedId});
  483. return board.removeMember(memberId);
  484. } else {
  485. return Cards.update(
  486. { _id: this._id },
  487. { $pull: { members: memberId}}
  488. );
  489. }
  490. },
  491. toggleMember(memberId) {
  492. if (this.getMembers() && this.getMembers().indexOf(memberId) > -1) {
  493. return this.unassignMember(memberId);
  494. } else {
  495. return this.assignMember(memberId);
  496. }
  497. },
  498. getReceived() {
  499. if (this.isLinkedCard()) {
  500. const card = Cards.findOne({_id: this.linkedId});
  501. return card.receivedAt;
  502. } else {
  503. return this.receivedAt;
  504. }
  505. },
  506. setReceived(receivedAt) {
  507. if (this.isLinkedCard()) {
  508. return Cards.update(
  509. {_id: this.linkedId},
  510. {$set: {receivedAt}}
  511. );
  512. } else {
  513. return Cards.update(
  514. {_id: this._id},
  515. {$set: {receivedAt}}
  516. );
  517. }
  518. },
  519. getStart() {
  520. if (this.isLinkedCard()) {
  521. const card = Cards.findOne({_id: this.linkedId});
  522. return card.startAt;
  523. } else if (this.isLinkedBoard()) {
  524. const board = Boards.findOne({_id: this.linkedId});
  525. return board.startAt;
  526. } else {
  527. return this.startAt;
  528. }
  529. },
  530. setStart(startAt) {
  531. if (this.isLinkedCard()) {
  532. return Cards.update(
  533. { _id: this.linkedId },
  534. {$set: {startAt}}
  535. );
  536. } else if (this.isLinkedBoard()) {
  537. return Boards.update(
  538. {_id: this.linkedId},
  539. {$set: {startAt}}
  540. );
  541. } else {
  542. return Cards.update(
  543. {_id: this._id},
  544. {$set: {startAt}}
  545. );
  546. }
  547. },
  548. getDue() {
  549. if (this.isLinkedCard()) {
  550. const card = Cards.findOne({_id: this.linkedId});
  551. return card.dueAt;
  552. } else if (this.isLinkedBoard()) {
  553. const board = Boards.findOne({_id: this.linkedId});
  554. return board.dueAt;
  555. } else {
  556. return this.dueAt;
  557. }
  558. },
  559. setDue(dueAt) {
  560. if (this.isLinkedCard()) {
  561. return Cards.update(
  562. { _id: this.linkedId },
  563. {$set: {dueAt}}
  564. );
  565. } else if (this.isLinkedBoard()) {
  566. return Boards.update(
  567. {_id: this.linkedId},
  568. {$set: {dueAt}}
  569. );
  570. } else {
  571. return Cards.update(
  572. {_id: this._id},
  573. {$set: {dueAt}}
  574. );
  575. }
  576. },
  577. getEnd() {
  578. if (this.isLinkedCard()) {
  579. const card = Cards.findOne({_id: this.linkedId});
  580. return card.endAt;
  581. } else if (this.isLinkedBoard()) {
  582. const board = Boards.findOne({_id: this.linkedId});
  583. return board.endAt;
  584. } else {
  585. return this.endAt;
  586. }
  587. },
  588. setEnd(endAt) {
  589. if (this.isLinkedCard()) {
  590. return Cards.update(
  591. { _id: this.linkedId },
  592. {$set: {endAt}}
  593. );
  594. } else if (this.isLinkedBoard()) {
  595. return Boards.update(
  596. {_id: this.linkedId},
  597. {$set: {endAt}}
  598. );
  599. } else {
  600. return Cards.update(
  601. {_id: this._id},
  602. {$set: {endAt}}
  603. );
  604. }
  605. },
  606. getIsOvertime() {
  607. if (this.isLinkedCard()) {
  608. const card = Cards.findOne({ _id: this.linkedId });
  609. return card.isOvertime;
  610. } else if (this.isLinkedBoard()) {
  611. const board = Boards.findOne({ _id: this.linkedId});
  612. return board.isOvertime;
  613. } else {
  614. return this.isOvertime;
  615. }
  616. },
  617. setIsOvertime(isOvertime) {
  618. if (this.isLinkedCard()) {
  619. return Cards.update(
  620. { _id: this.linkedId },
  621. {$set: {isOvertime}}
  622. );
  623. } else if (this.isLinkedBoard()) {
  624. return Boards.update(
  625. {_id: this.linkedId},
  626. {$set: {isOvertime}}
  627. );
  628. } else {
  629. return Cards.update(
  630. {_id: this._id},
  631. {$set: {isOvertime}}
  632. );
  633. }
  634. },
  635. getSpentTime() {
  636. if (this.isLinkedCard()) {
  637. const card = Cards.findOne({ _id: this.linkedId });
  638. return card.spentTime;
  639. } else if (this.isLinkedBoard()) {
  640. const board = Boards.findOne({ _id: this.linkedId});
  641. return board.spentTime;
  642. } else {
  643. return this.spentTime;
  644. }
  645. },
  646. setSpentTime(spentTime) {
  647. if (this.isLinkedCard()) {
  648. return Cards.update(
  649. { _id: this.linkedId },
  650. {$set: {spentTime}}
  651. );
  652. } else if (this.isLinkedBoard()) {
  653. return Boards.update(
  654. {_id: this.linkedId},
  655. {$set: {spentTime}}
  656. );
  657. } else {
  658. return Cards.update(
  659. {_id: this._id},
  660. {$set: {spentTime}}
  661. );
  662. }
  663. },
  664. getId() {
  665. if (this.isLinked()) {
  666. return this.linkedId;
  667. } else {
  668. return this._id;
  669. }
  670. },
  671. getTitle() {
  672. if (this.isLinkedCard()) {
  673. const card = Cards.findOne({ _id: this.linkedId });
  674. return card.title;
  675. } else if (this.isLinkedBoard()) {
  676. const board = Boards.findOne({ _id: this.linkedId});
  677. return board.title;
  678. } else {
  679. return this.title;
  680. }
  681. },
  682. getBoardTitle() {
  683. if (this.isLinkedCard()) {
  684. const card = Cards.findOne({ _id: this.linkedId });
  685. const board = Boards.findOne({ _id: card.boardId });
  686. return board.title;
  687. } else if (this.isLinkedBoard()) {
  688. const board = Boards.findOne({ _id: this.linkedId});
  689. return board.title;
  690. } else {
  691. const board = Boards.findOne({ _id: this.boardId });
  692. return board.title;
  693. }
  694. },
  695. setTitle(title) {
  696. if (this.isLinkedCard()) {
  697. return Cards.update(
  698. { _id: this.linkedId },
  699. {$set: {title}}
  700. );
  701. } else if (this.isLinkedBoard()) {
  702. return Boards.update(
  703. {_id: this.linkedId},
  704. {$set: {title}}
  705. );
  706. } else {
  707. return Cards.update(
  708. {_id: this._id},
  709. {$set: {title}}
  710. );
  711. }
  712. },
  713. getArchived() {
  714. if (this.isLinkedCard()) {
  715. const card = Cards.findOne({ _id: this.linkedId });
  716. return card.archived;
  717. } else if (this.isLinkedBoard()) {
  718. const board = Boards.findOne({ _id: this.linkedId});
  719. return board.archived;
  720. } else {
  721. return this.archived;
  722. }
  723. },
  724. setRequestedBy(requestedBy) {
  725. if (this.isLinkedCard()) {
  726. return Cards.update(
  727. { _id: this.linkedId },
  728. {$set: {requestedBy}}
  729. );
  730. } else {
  731. return Cards.update(
  732. {_id: this._id},
  733. {$set: {requestedBy}}
  734. );
  735. }
  736. },
  737. getRequestedBy() {
  738. if (this.isLinkedCard()) {
  739. const card = Cards.findOne({ _id: this.linkedId });
  740. return card.requestedBy;
  741. } else {
  742. return this.requestedBy;
  743. }
  744. },
  745. setAssignedBy(assignedBy) {
  746. if (this.isLinkedCard()) {
  747. return Cards.update(
  748. { _id: this.linkedId },
  749. {$set: {assignedBy}}
  750. );
  751. } else {
  752. return Cards.update(
  753. {_id: this._id},
  754. {$set: {assignedBy}}
  755. );
  756. }
  757. },
  758. getAssignedBy() {
  759. if (this.isLinkedCard()) {
  760. const card = Cards.findOne({ _id: this.linkedId });
  761. return card.assignedBy;
  762. } else {
  763. return this.assignedBy;
  764. }
  765. },
  766. });
  767. Cards.mutations({
  768. applyToChildren(funct) {
  769. Cards.find({
  770. parentId: this._id,
  771. }).forEach((card) => {
  772. funct(card);
  773. });
  774. },
  775. archive() {
  776. this.applyToChildren((card) => {
  777. return card.archive();
  778. });
  779. return {
  780. $set: {
  781. archived: true,
  782. },
  783. };
  784. },
  785. restore() {
  786. this.applyToChildren((card) => {
  787. return card.restore();
  788. });
  789. return {
  790. $set: {
  791. archived: false,
  792. },
  793. };
  794. },
  795. setTitle(title) {
  796. return {
  797. $set: {
  798. title,
  799. },
  800. };
  801. },
  802. setDescription(description) {
  803. return {
  804. $set: {
  805. description,
  806. },
  807. };
  808. },
  809. setRequestedBy(requestedBy) {
  810. return {
  811. $set: {
  812. requestedBy,
  813. },
  814. };
  815. },
  816. setAssignedBy(assignedBy) {
  817. return {
  818. $set: {
  819. assignedBy,
  820. },
  821. };
  822. },
  823. move(swimlaneId, listId, sortIndex) {
  824. const list = Lists.findOne(listId);
  825. const mutatedFields = {
  826. swimlaneId,
  827. listId,
  828. boardId: list.boardId,
  829. sort: sortIndex,
  830. };
  831. return {
  832. $set: mutatedFields,
  833. };
  834. },
  835. addLabel(labelId) {
  836. return {
  837. $addToSet: {
  838. labelIds: labelId,
  839. },
  840. };
  841. },
  842. removeLabel(labelId) {
  843. return {
  844. $pull: {
  845. labelIds: labelId,
  846. },
  847. };
  848. },
  849. toggleLabel(labelId) {
  850. if (this.labelIds && this.labelIds.indexOf(labelId) > -1) {
  851. return this.removeLabel(labelId);
  852. } else {
  853. return this.addLabel(labelId);
  854. }
  855. },
  856. assignMember(memberId) {
  857. return {
  858. $addToSet: {
  859. members: memberId,
  860. },
  861. };
  862. },
  863. unassignMember(memberId) {
  864. return {
  865. $pull: {
  866. members: memberId,
  867. },
  868. };
  869. },
  870. toggleMember(memberId) {
  871. if (this.members && this.members.indexOf(memberId) > -1) {
  872. return this.unassignMember(memberId);
  873. } else {
  874. return this.assignMember(memberId);
  875. }
  876. },
  877. assignCustomField(customFieldId) {
  878. return {
  879. $addToSet: {
  880. customFields: {
  881. _id: customFieldId,
  882. value: null,
  883. },
  884. },
  885. };
  886. },
  887. unassignCustomField(customFieldId) {
  888. return {
  889. $pull: {
  890. customFields: {
  891. _id: customFieldId,
  892. },
  893. },
  894. };
  895. },
  896. toggleCustomField(customFieldId) {
  897. if (this.customFields && this.customFieldIndex(customFieldId) > -1) {
  898. return this.unassignCustomField(customFieldId);
  899. } else {
  900. return this.assignCustomField(customFieldId);
  901. }
  902. },
  903. setCustomField(customFieldId, value) {
  904. // todo
  905. const index = this.customFieldIndex(customFieldId);
  906. if (index > -1) {
  907. const update = {
  908. $set: {},
  909. };
  910. update.$set[`customFields.${index}.value`] = value;
  911. return update;
  912. }
  913. // TODO
  914. // Ignatz 18.05.2018: Return null to silence ESLint. No Idea if that is correct
  915. return null;
  916. },
  917. setCover(coverId) {
  918. return {
  919. $set: {
  920. coverId,
  921. },
  922. };
  923. },
  924. unsetCover() {
  925. return {
  926. $unset: {
  927. coverId: '',
  928. },
  929. };
  930. },
  931. setReceived(receivedAt) {
  932. return {
  933. $set: {
  934. receivedAt,
  935. },
  936. };
  937. },
  938. unsetReceived() {
  939. return {
  940. $unset: {
  941. receivedAt: '',
  942. },
  943. };
  944. },
  945. setStart(startAt) {
  946. return {
  947. $set: {
  948. startAt,
  949. },
  950. };
  951. },
  952. unsetStart() {
  953. return {
  954. $unset: {
  955. startAt: '',
  956. },
  957. };
  958. },
  959. setDue(dueAt) {
  960. return {
  961. $set: {
  962. dueAt,
  963. },
  964. };
  965. },
  966. unsetDue() {
  967. return {
  968. $unset: {
  969. dueAt: '',
  970. },
  971. };
  972. },
  973. setEnd(endAt) {
  974. return {
  975. $set: {
  976. endAt,
  977. },
  978. };
  979. },
  980. unsetEnd() {
  981. return {
  982. $unset: {
  983. endAt: '',
  984. },
  985. };
  986. },
  987. setOvertime(isOvertime) {
  988. return {
  989. $set: {
  990. isOvertime,
  991. },
  992. };
  993. },
  994. setSpentTime(spentTime) {
  995. return {
  996. $set: {
  997. spentTime,
  998. },
  999. };
  1000. },
  1001. unsetSpentTime() {
  1002. return {
  1003. $unset: {
  1004. spentTime: '',
  1005. isOvertime: false,
  1006. },
  1007. };
  1008. },
  1009. setParentId(parentId) {
  1010. return {
  1011. $set: {
  1012. parentId,
  1013. },
  1014. };
  1015. },
  1016. });
  1017. //FUNCTIONS FOR creation of Activities
  1018. function cardMove(userId, doc, fieldNames, oldListId, oldSwimlaneId) {
  1019. if ((_.contains(fieldNames, 'listId') && doc.listId !== oldListId) ||
  1020. (_.contains(fieldNames, 'swimlaneId') && doc.swimlaneId !== oldSwimlaneId)){
  1021. Activities.insert({
  1022. userId,
  1023. oldListId,
  1024. activityType: 'moveCard',
  1025. listName: Lists.findOne(doc.listId).title,
  1026. listId: doc.listId,
  1027. boardId: doc.boardId,
  1028. cardId: doc._id,
  1029. swimlaneId: doc.swimlaneId,
  1030. oldSwimlaneId,
  1031. });
  1032. }
  1033. }
  1034. function cardState(userId, doc, fieldNames) {
  1035. if (_.contains(fieldNames, 'archived')) {
  1036. if (doc.archived) {
  1037. Activities.insert({
  1038. userId,
  1039. activityType: 'archivedCard',
  1040. listName: Lists.findOne(doc.listId).title,
  1041. boardId: doc.boardId,
  1042. listId: doc.listId,
  1043. cardId: doc._id,
  1044. });
  1045. } else {
  1046. Activities.insert({
  1047. userId,
  1048. activityType: 'restoredCard',
  1049. boardId: doc.boardId,
  1050. listName: Lists.findOne(doc.listId).title,
  1051. listId: doc.listId,
  1052. cardId: doc._id,
  1053. });
  1054. }
  1055. }
  1056. }
  1057. function cardMembers(userId, doc, fieldNames, modifier) {
  1058. if (!_.contains(fieldNames, 'members'))
  1059. return;
  1060. let memberId;
  1061. // Say hello to the new member
  1062. if (modifier.$addToSet && modifier.$addToSet.members) {
  1063. memberId = modifier.$addToSet.members;
  1064. const username = Users.findOne(memberId).username;
  1065. if (!_.contains(doc.members, memberId)) {
  1066. Activities.insert({
  1067. userId,
  1068. username,
  1069. activityType: 'joinMember',
  1070. boardId: doc.boardId,
  1071. cardId: doc._id,
  1072. });
  1073. }
  1074. }
  1075. // Say goodbye to the former member
  1076. if (modifier.$pull && modifier.$pull.members) {
  1077. memberId = modifier.$pull.members;
  1078. const username = Users.findOne(memberId).username;
  1079. // Check that the former member is member of the card
  1080. if (_.contains(doc.members, memberId)) {
  1081. Activities.insert({
  1082. userId,
  1083. username,
  1084. activityType: 'unjoinMember',
  1085. boardId: doc.boardId,
  1086. cardId: doc._id,
  1087. });
  1088. }
  1089. }
  1090. }
  1091. function cardLabels(userId, doc, fieldNames, modifier) {
  1092. if (!_.contains(fieldNames, 'labelIds'))
  1093. return;
  1094. let labelId;
  1095. // Say hello to the new label
  1096. if (modifier.$addToSet && modifier.$addToSet.labelIds) {
  1097. labelId = modifier.$addToSet.labelIds;
  1098. if (!_.contains(doc.labelIds, labelId)) {
  1099. const act = {
  1100. userId,
  1101. labelId,
  1102. activityType: 'addedLabel',
  1103. boardId: doc.boardId,
  1104. cardId: doc._id,
  1105. };
  1106. Activities.insert(act);
  1107. }
  1108. }
  1109. // Say goodbye to the label
  1110. if (modifier.$pull && modifier.$pull.labelIds) {
  1111. labelId = modifier.$pull.labelIds;
  1112. // Check that the former member is member of the card
  1113. if (_.contains(doc.labelIds, labelId)) {
  1114. Activities.insert({
  1115. userId,
  1116. labelId,
  1117. activityType: 'removedLabel',
  1118. boardId: doc.boardId,
  1119. cardId: doc._id,
  1120. });
  1121. }
  1122. }
  1123. }
  1124. function cardCreation(userId, doc) {
  1125. Activities.insert({
  1126. userId,
  1127. activityType: 'createCard',
  1128. boardId: doc.boardId,
  1129. listName: Lists.findOne(doc.listId).title,
  1130. listId: doc.listId,
  1131. cardId: doc._id,
  1132. swimlaneId: doc.swimlaneId,
  1133. });
  1134. }
  1135. function cardRemover(userId, doc) {
  1136. Activities.remove({
  1137. cardId: doc._id,
  1138. });
  1139. Checklists.remove({
  1140. cardId: doc._id,
  1141. });
  1142. Subtasks.remove({
  1143. cardId: doc._id,
  1144. });
  1145. CardComments.remove({
  1146. cardId: doc._id,
  1147. });
  1148. Attachments.remove({
  1149. cardId: doc._id,
  1150. });
  1151. }
  1152. if (Meteor.isServer) {
  1153. // Cards are often fetched within a board, so we create an index to make these
  1154. // queries more efficient.
  1155. Meteor.startup(() => {
  1156. Cards._collection._ensureIndex({boardId: 1, createdAt: -1});
  1157. // https://github.com/wekan/wekan/issues/1863
  1158. // Swimlane added a new field in the cards collection of mongodb named parentId.
  1159. // When loading a board, mongodb is searching for every cards, the id of the parent (in the swinglanes collection).
  1160. // With a huge database, this result in a very slow app and high CPU on the mongodb side.
  1161. // To correct it, add Index to parentId:
  1162. Cards._collection._ensureIndex({parentId: 1});
  1163. });
  1164. Cards.after.insert((userId, doc) => {
  1165. cardCreation(userId, doc);
  1166. });
  1167. // New activity for card (un)archivage
  1168. Cards.after.update((userId, doc, fieldNames) => {
  1169. cardState(userId, doc, fieldNames);
  1170. });
  1171. //New activity for card moves
  1172. Cards.after.update(function(userId, doc, fieldNames) {
  1173. const oldListId = this.previous.listId;
  1174. const oldSwimlaneId = this.previous.swimlaneId;
  1175. cardMove(userId, doc, fieldNames, oldListId, oldSwimlaneId);
  1176. });
  1177. // Add a new activity if we add or remove a member to the card
  1178. Cards.before.update((userId, doc, fieldNames, modifier) => {
  1179. cardMembers(userId, doc, fieldNames, modifier);
  1180. });
  1181. // Add a new activity if we add or remove a label to the card
  1182. Cards.before.update((userId, doc, fieldNames, modifier) => {
  1183. cardLabels(userId, doc, fieldNames, modifier);
  1184. });
  1185. // Remove all activities associated with a card if we remove the card
  1186. // Remove also card_comments / checklists / attachments
  1187. Cards.after.remove((userId, doc) => {
  1188. cardRemover(userId, doc);
  1189. });
  1190. }
  1191. //SWIMLANES REST API
  1192. if (Meteor.isServer) {
  1193. JsonRoutes.add('GET', '/api/boards/:boardId/swimlanes/:swimlaneId/cards', function(req, res) {
  1194. const paramBoardId = req.params.boardId;
  1195. const paramSwimlaneId = req.params.swimlaneId;
  1196. Authentication.checkBoardAccess(req.userId, paramBoardId);
  1197. JsonRoutes.sendResult(res, {
  1198. code: 200,
  1199. data: Cards.find({
  1200. boardId: paramBoardId,
  1201. swimlaneId: paramSwimlaneId,
  1202. archived: false,
  1203. }).map(function(doc) {
  1204. return {
  1205. _id: doc._id,
  1206. title: doc.title,
  1207. description: doc.description,
  1208. listId: doc.listId,
  1209. };
  1210. }),
  1211. });
  1212. });
  1213. }
  1214. //LISTS REST API
  1215. if (Meteor.isServer) {
  1216. JsonRoutes.add('GET', '/api/boards/:boardId/lists/:listId/cards', function(req, res) {
  1217. const paramBoardId = req.params.boardId;
  1218. const paramListId = req.params.listId;
  1219. Authentication.checkBoardAccess(req.userId, paramBoardId);
  1220. JsonRoutes.sendResult(res, {
  1221. code: 200,
  1222. data: Cards.find({
  1223. boardId: paramBoardId,
  1224. listId: paramListId,
  1225. archived: false,
  1226. }).map(function(doc) {
  1227. return {
  1228. _id: doc._id,
  1229. title: doc.title,
  1230. description: doc.description,
  1231. };
  1232. }),
  1233. });
  1234. });
  1235. JsonRoutes.add('GET', '/api/boards/:boardId/lists/:listId/cards/:cardId', function(req, res) {
  1236. const paramBoardId = req.params.boardId;
  1237. const paramListId = req.params.listId;
  1238. const paramCardId = req.params.cardId;
  1239. Authentication.checkBoardAccess(req.userId, paramBoardId);
  1240. JsonRoutes.sendResult(res, {
  1241. code: 200,
  1242. data: Cards.findOne({
  1243. _id: paramCardId,
  1244. listId: paramListId,
  1245. boardId: paramBoardId,
  1246. archived: false,
  1247. }),
  1248. });
  1249. });
  1250. JsonRoutes.add('POST', '/api/boards/:boardId/lists/:listId/cards', function(req, res) {
  1251. Authentication.checkUserId(req.userId);
  1252. const paramBoardId = req.params.boardId;
  1253. const paramListId = req.params.listId;
  1254. const check = Users.findOne({
  1255. _id: req.body.authorId,
  1256. });
  1257. const members = req.body.members || [req.body.authorId];
  1258. if (typeof check !== 'undefined') {
  1259. const id = Cards.direct.insert({
  1260. title: req.body.title,
  1261. boardId: paramBoardId,
  1262. listId: paramListId,
  1263. description: req.body.description,
  1264. userId: req.body.authorId,
  1265. swimlaneId: req.body.swimlaneId,
  1266. sort: 0,
  1267. members,
  1268. });
  1269. JsonRoutes.sendResult(res, {
  1270. code: 200,
  1271. data: {
  1272. _id: id,
  1273. },
  1274. });
  1275. const card = Cards.findOne({
  1276. _id: id,
  1277. });
  1278. cardCreation(req.body.authorId, card);
  1279. } else {
  1280. JsonRoutes.sendResult(res, {
  1281. code: 401,
  1282. });
  1283. }
  1284. });
  1285. JsonRoutes.add('PUT', '/api/boards/:boardId/lists/:listId/cards/:cardId', function(req, res) {
  1286. Authentication.checkUserId(req.userId);
  1287. const paramBoardId = req.params.boardId;
  1288. const paramCardId = req.params.cardId;
  1289. const paramListId = req.params.listId;
  1290. if (req.body.hasOwnProperty('title')) {
  1291. const newTitle = req.body.title;
  1292. Cards.direct.update({
  1293. _id: paramCardId,
  1294. listId: paramListId,
  1295. boardId: paramBoardId,
  1296. archived: false,
  1297. }, {
  1298. $set: {
  1299. title: newTitle,
  1300. },
  1301. });
  1302. }
  1303. if (req.body.hasOwnProperty('listId')) {
  1304. const newParamListId = req.body.listId;
  1305. Cards.direct.update({
  1306. _id: paramCardId,
  1307. listId: paramListId,
  1308. boardId: paramBoardId,
  1309. archived: false,
  1310. }, {
  1311. $set: {
  1312. listId: newParamListId,
  1313. },
  1314. });
  1315. const card = Cards.findOne({
  1316. _id: paramCardId,
  1317. });
  1318. cardMove(req.body.authorId, card, {
  1319. fieldName: 'listId',
  1320. }, paramListId);
  1321. }
  1322. if (req.body.hasOwnProperty('description')) {
  1323. const newDescription = req.body.description;
  1324. Cards.direct.update({
  1325. _id: paramCardId,
  1326. listId: paramListId,
  1327. boardId: paramBoardId,
  1328. archived: false,
  1329. }, {
  1330. $set: {
  1331. description: newDescription,
  1332. },
  1333. });
  1334. }
  1335. if (req.body.hasOwnProperty('labelIds')) {
  1336. let newlabelIds = req.body.labelIds;
  1337. if (_.isString(newlabelIds)) {
  1338. if (newlabelIds === '') {
  1339. newlabelIds = null;
  1340. }
  1341. else {
  1342. newlabelIds = [newlabelIds];
  1343. }
  1344. }
  1345. Cards.direct.update({
  1346. _id: paramCardId,
  1347. listId: paramListId,
  1348. boardId: paramBoardId,
  1349. archived: false,
  1350. }, {
  1351. $set: {
  1352. labelIds: newlabelIds,
  1353. },
  1354. });
  1355. }
  1356. if (req.body.hasOwnProperty('requestedBy')) {
  1357. const newrequestedBy = req.body.requestedBy;
  1358. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1359. {$set: {requestedBy: newrequestedBy}});
  1360. }
  1361. if (req.body.hasOwnProperty('assignedBy')) {
  1362. const newassignedBy = req.body.assignedBy;
  1363. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1364. {$set: {assignedBy: newassignedBy}});
  1365. }
  1366. if (req.body.hasOwnProperty('receivedAt')) {
  1367. const newreceivedAt = req.body.receivedAt;
  1368. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1369. {$set: {receivedAt: newreceivedAt}});
  1370. }
  1371. if (req.body.hasOwnProperty('startAt')) {
  1372. const newstartAt = req.body.startAt;
  1373. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1374. {$set: {startAt: newstartAt}});
  1375. }
  1376. if (req.body.hasOwnProperty('dueAt')) {
  1377. const newdueAt = req.body.dueAt;
  1378. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1379. {$set: {dueAt: newdueAt}});
  1380. }
  1381. if (req.body.hasOwnProperty('endAt')) {
  1382. const newendAt = req.body.endAt;
  1383. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1384. {$set: {endAt: newendAt}});
  1385. }
  1386. if (req.body.hasOwnProperty('spentTime')) {
  1387. const newspentTime = req.body.spentTime;
  1388. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1389. {$set: {spentTime: newspentTime}});
  1390. }
  1391. if (req.body.hasOwnProperty('isOverTime')) {
  1392. const newisOverTime = req.body.isOverTime;
  1393. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1394. {$set: {isOverTime: newisOverTime}});
  1395. }
  1396. if (req.body.hasOwnProperty('customFields')) {
  1397. const newcustomFields = req.body.customFields;
  1398. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1399. {$set: {customFields: newcustomFields}});
  1400. }
  1401. if (req.body.hasOwnProperty('members')) {
  1402. let newmembers = req.body.members;
  1403. if (_.isString(newmembers)) {
  1404. if (newmembers === '') {
  1405. newmembers = null;
  1406. }
  1407. else {
  1408. newmembers = [newmembers];
  1409. }
  1410. }
  1411. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1412. {$set: {members: newmembers}});
  1413. }
  1414. if (req.body.hasOwnProperty('swimlaneId')) {
  1415. const newParamSwimlaneId = req.body.swimlaneId;
  1416. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1417. {$set: {swimlaneId: newParamSwimlaneId}});
  1418. }
  1419. JsonRoutes.sendResult(res, {
  1420. code: 200,
  1421. data: {
  1422. _id: paramCardId,
  1423. },
  1424. });
  1425. });
  1426. JsonRoutes.add('DELETE', '/api/boards/:boardId/lists/:listId/cards/:cardId', function(req, res) {
  1427. Authentication.checkUserId(req.userId);
  1428. const paramBoardId = req.params.boardId;
  1429. const paramListId = req.params.listId;
  1430. const paramCardId = req.params.cardId;
  1431. Cards.direct.remove({
  1432. _id: paramCardId,
  1433. listId: paramListId,
  1434. boardId: paramBoardId,
  1435. });
  1436. const card = Cards.find({
  1437. _id: paramCardId,
  1438. });
  1439. cardRemover(req.body.authorId, card);
  1440. JsonRoutes.sendResult(res, {
  1441. code: 200,
  1442. data: {
  1443. _id: paramCardId,
  1444. },
  1445. });
  1446. });
  1447. }