cards.js 36 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558
  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. const newlabelIds = req.body.labelIds;
  1337. Cards.direct.update({
  1338. _id: paramCardId,
  1339. listId: paramListId,
  1340. boardId: paramBoardId,
  1341. archived: false,
  1342. }, {
  1343. $set: {
  1344. labelIds: newlabelIds,
  1345. },
  1346. });
  1347. }
  1348. if (req.body.hasOwnProperty('requestedBy')) {
  1349. const newrequestedBy = req.body.requestedBy;
  1350. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1351. {$set: {requestedBy: newrequestedBy}});
  1352. }
  1353. if (req.body.hasOwnProperty('assignedBy')) {
  1354. const newassignedBy = req.body.assignedBy;
  1355. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1356. {$set: {assignedBy: newassignedBy}});
  1357. }
  1358. if (req.body.hasOwnProperty('receivedAt')) {
  1359. const newreceivedAt = req.body.receivedAt;
  1360. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1361. {$set: {receivedAt: newreceivedAt}});
  1362. }
  1363. if (req.body.hasOwnProperty('startAt')) {
  1364. const newstartAt = req.body.startAt;
  1365. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1366. {$set: {startAt: newstartAt}});
  1367. }
  1368. if (req.body.hasOwnProperty('dueAt')) {
  1369. const newdueAt = req.body.dueAt;
  1370. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1371. {$set: {dueAt: newdueAt}});
  1372. }
  1373. if (req.body.hasOwnProperty('endAt')) {
  1374. const newendAt = req.body.endAt;
  1375. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1376. {$set: {endAt: newendAt}});
  1377. }
  1378. if (req.body.hasOwnProperty('spentTime')) {
  1379. const newspentTime = req.body.spentTime;
  1380. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1381. {$set: {spentTime: newspentTime}});
  1382. }
  1383. if (req.body.hasOwnProperty('isOverTime')) {
  1384. const newisOverTime = req.body.isOverTime;
  1385. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1386. {$set: {isOverTime: newisOverTime}});
  1387. }
  1388. if (req.body.hasOwnProperty('customFields')) {
  1389. const newcustomFields = req.body.customFields;
  1390. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1391. {$set: {customFields: newcustomFields}});
  1392. }
  1393. if (req.body.hasOwnProperty('members')) {
  1394. const newmembers = req.body.members;
  1395. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1396. {$set: {members: newmembers}});
  1397. }
  1398. if (req.body.hasOwnProperty('swimlaneId')) {
  1399. const newParamSwimlaneId = req.body.swimlaneId;
  1400. Cards.direct.update({_id: paramCardId, listId: paramListId, boardId: paramBoardId, archived: false},
  1401. {$set: {swimlaneId: newParamSwimlaneId}});
  1402. }
  1403. JsonRoutes.sendResult(res, {
  1404. code: 200,
  1405. data: {
  1406. _id: paramCardId,
  1407. },
  1408. });
  1409. });
  1410. JsonRoutes.add('DELETE', '/api/boards/:boardId/lists/:listId/cards/:cardId', function(req, res) {
  1411. Authentication.checkUserId(req.userId);
  1412. const paramBoardId = req.params.boardId;
  1413. const paramListId = req.params.listId;
  1414. const paramCardId = req.params.cardId;
  1415. Cards.direct.remove({
  1416. _id: paramCardId,
  1417. listId: paramListId,
  1418. boardId: paramBoardId,
  1419. });
  1420. const card = Cards.find({
  1421. _id: paramCardId,
  1422. });
  1423. cardRemover(req.body.authorId, card);
  1424. JsonRoutes.sendResult(res, {
  1425. code: 200,
  1426. data: {
  1427. _id: paramCardId,
  1428. },
  1429. });
  1430. });
  1431. }