123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722 |
- Boards = new Mongo.Collection('boards');
- /**
- * This is a Board.
- */
- Boards.attachSchema(
- new SimpleSchema({
- title: {
- /**
- * The title of the board
- */
- type: String,
- },
- slug: {
- /**
- * The title slugified.
- */
- type: String,
- // eslint-disable-next-line consistent-return
- autoValue() {
- // XXX We need to improve slug management. Only the id should be necessary
- // to identify a board in the code.
- // XXX If the board title is updated, the slug should also be updated.
- // In some cases (Chinese and Japanese for instance) the `getSlug` function
- // return an empty string. This is causes bugs in our application so we set
- // a default slug in this case.
- if (this.isInsert && !this.isSet) {
- let slug = 'board';
- const title = this.field('title');
- if (title.isSet) {
- slug = getSlug(title.value) || slug;
- }
- return slug;
- }
- },
- },
- archived: {
- /**
- * Is the board archived?
- */
- type: Boolean,
- // eslint-disable-next-line consistent-return
- autoValue() {
- if (this.isInsert && !this.isSet) {
- return false;
- }
- },
- },
- createdAt: {
- /**
- * Creation time of the board
- */
- type: Date,
- // eslint-disable-next-line consistent-return
- autoValue() {
- if (this.isInsert) {
- return new Date();
- } else if (this.isUpsert) {
- return { $setOnInsert: new Date() };
- } else {
- this.unset();
- }
- },
- },
- // XXX Inconsistent field naming
- modifiedAt: {
- /**
- * Last modification time of the board
- */
- type: Date,
- optional: true,
- // eslint-disable-next-line consistent-return
- autoValue() {
- if (this.isInsert || this.isUpsert || this.isUpdate) {
- return new Date();
- } else {
- this.unset();
- }
- },
- },
- // De-normalized number of users that have starred this board
- stars: {
- /**
- * How many stars the board has
- */
- type: Number,
- // eslint-disable-next-line consistent-return
- autoValue() {
- if (this.isInsert) {
- return 0;
- }
- },
- },
- // De-normalized label system
- labels: {
- /**
- * List of labels attached to a board
- */
- type: [Object],
- // eslint-disable-next-line consistent-return
- autoValue() {
- if (this.isInsert && !this.isSet) {
- const colors = Boards.simpleSchema()._schema['labels.$.color']
- .allowedValues;
- const defaultLabelsColors = _.clone(colors).splice(0, 6);
- return defaultLabelsColors.map(color => ({
- color,
- _id: Random.id(6),
- name: '',
- }));
- }
- },
- },
- 'labels.$._id': {
- /**
- * Unique id of a label
- */
- // We don't specify that this field must be unique in the board because that
- // will cause performance penalties and is not necessary since this field is
- // always set on the server.
- // XXX Actually if we create a new label, the `_id` is set on the client
- // without being overwritten by the server, could it be a problem?
- type: String,
- },
- 'labels.$.name': {
- /**
- * Name of a label
- */
- type: String,
- optional: true,
- },
- 'labels.$.color': {
- /**
- * color of a label.
- *
- * Can be amongst `green`, `yellow`, `orange`, `red`, `purple`,
- * `blue`, `sky`, `lime`, `pink`, `black`,
- * `silver`, `peachpuff`, `crimson`, `plum`, `darkgreen`,
- * `slateblue`, `magenta`, `gold`, `navy`, `gray`,
- * `saddlebrown`, `paleturquoise`, `mistyrose`, `indigo`
- */
- type: String,
- allowedValues: [
- 'green',
- 'yellow',
- 'orange',
- 'red',
- 'purple',
- 'blue',
- 'sky',
- 'lime',
- 'pink',
- 'black',
- 'silver',
- 'peachpuff',
- 'crimson',
- 'plum',
- 'darkgreen',
- 'slateblue',
- 'magenta',
- 'gold',
- 'navy',
- 'gray',
- 'saddlebrown',
- 'paleturquoise',
- 'mistyrose',
- 'indigo',
- ],
- },
- // XXX We might want to maintain more informations under the member sub-
- // documents like de-normalized meta-data (the date the member joined the
- // board, the number of contributions, etc.).
- members: {
- /**
- * List of members of a board
- */
- type: [Object],
- // eslint-disable-next-line consistent-return
- autoValue() {
- if (this.isInsert && !this.isSet) {
- return [
- {
- userId: this.userId,
- isAdmin: true,
- isActive: true,
- isNoComments: false,
- isCommentOnly: false,
- isWorker: false,
- },
- ];
- }
- },
- },
- 'members.$.userId': {
- /**
- * The uniq ID of the member
- */
- type: String,
- },
- 'members.$.isAdmin': {
- /**
- * Is the member an admin of the board?
- */
- type: Boolean,
- },
- 'members.$.isActive': {
- /**
- * Is the member active?
- */
- type: Boolean,
- },
- 'members.$.isNoComments': {
- /**
- * Is the member not allowed to make comments
- */
- type: Boolean,
- optional: true,
- },
- 'members.$.isCommentOnly': {
- /**
- * Is the member only allowed to comment on the board
- */
- type: Boolean,
- optional: true,
- },
- 'members.$.isWorker': {
- /**
- * Is the member only allowed to move card, assign himself to card and comment
- */
- type: Boolean,
- optional: true,
- },
- permission: {
- /**
- * visibility of the board
- */
- type: String,
- allowedValues: ['public', 'private'],
- },
- color: {
- /**
- * The color of the board.
- */
- type: String,
- allowedValues: [
- 'belize',
- 'nephritis',
- 'pomegranate',
- 'pumpkin',
- 'wisteria',
- 'moderatepink',
- 'strongcyan',
- 'limegreen',
- 'midnight',
- 'dark',
- 'relax',
- 'corteza',
- ],
- // eslint-disable-next-line consistent-return
- autoValue() {
- if (this.isInsert && !this.isSet) {
- return Boards.simpleSchema()._schema.color.allowedValues[0];
- }
- },
- },
- description: {
- /**
- * The description of the board
- */
- type: String,
- optional: true,
- },
- subtasksDefaultBoardId: {
- /**
- * The default board ID assigned to subtasks.
- */
- type: String,
- optional: true,
- defaultValue: null,
- },
- subtasksDefaultListId: {
- /**
- * The default List ID assigned to subtasks.
- */
- type: String,
- optional: true,
- defaultValue: null,
- },
- dateSettingsDefaultBoardId: {
- type: String,
- optional: true,
- defaultValue: null,
- },
- dateSettingsDefaultListId: {
- type: String,
- optional: true,
- defaultValue: null,
- },
- allowsSubtasks: {
- /**
- * Does the board allows subtasks?
- */
- type: Boolean,
- defaultValue: true,
- },
- allowsAttachments: {
- /**
- * Does the board allows attachments?
- */
- type: Boolean,
- defaultValue: true,
- },
- allowsChecklists: {
- /**
- * Does the board allows checklists?
- */
- type: Boolean,
- defaultValue: true,
- },
- allowsComments: {
- /**
- * Does the board allows comments?
- */
- type: Boolean,
- defaultValue: true,
- },
- allowsDescriptionTitle: {
- /**
- * Does the board allows description title?
- */
- type: Boolean,
- defaultValue: true,
- },
- allowsDescriptionText: {
- /**
- * Does the board allows description text?
- */
- type: Boolean,
- defaultValue: true,
- },
- allowsActivities: {
- /**
- * Does the board allows comments?
- */
- type: Boolean,
- defaultValue: true,
- },
- allowsLabels: {
- /**
- * Does the board allows labels?
- */
- type: Boolean,
- defaultValue: true,
- },
- allowsAssignee: {
- /**
- * Does the board allows assignee?
- */
- type: Boolean,
- defaultValue: true,
- },
- allowsMembers: {
- /**
- * Does the board allows members?
- */
- type: Boolean,
- defaultValue: true,
- },
- allowsRequestedBy: {
- /**
- * Does the board allows requested by?
- */
- type: Boolean,
- defaultValue: true,
- },
- allowsAssignedBy: {
- /**
- * Does the board allows requested by?
- */
- type: Boolean,
- defaultValue: true,
- },
- allowsReceivedDate: {
- /**
- * Does the board allows received date?
- */
- type: Boolean,
- defaultValue: true,
- },
- allowsStartDate: {
- /**
- * Does the board allows start date?
- */
- type: Boolean,
- defaultValue: true,
- },
- allowsEndDate: {
- /**
- * Does the board allows end date?
- */
- type: Boolean,
- defaultValue: true,
- },
- allowsDueDate: {
- /**
- * Does the board allows due date?
- */
- type: Boolean,
- defaultValue: true,
- },
- presentParentTask: {
- /**
- * Controls how to present the parent task:
- *
- * - `prefix-with-full-path`: add a prefix with the full path
- * - `prefix-with-parent`: add a prefisx with the parent name
- * - `subtext-with-full-path`: add a subtext with the full path
- * - `subtext-with-parent`: add a subtext with the parent name
- * - `no-parent`: does not show the parent at all
- */
- type: String,
- allowedValues: [
- 'prefix-with-full-path',
- 'prefix-with-parent',
- 'subtext-with-full-path',
- 'subtext-with-parent',
- 'no-parent',
- ],
- optional: true,
- defaultValue: 'no-parent',
- },
- startAt: {
- /**
- * Starting date of the board.
- */
- type: Date,
- optional: true,
- },
- dueAt: {
- /**
- * Due date of the board.
- */
- type: Date,
- optional: true,
- },
- endAt: {
- /**
- * End date of the board.
- */
- type: Date,
- optional: true,
- },
- spentTime: {
- /**
- * Time spent in the board.
- */
- type: Number,
- decimal: true,
- optional: true,
- },
- isOvertime: {
- /**
- * Is the board overtimed?
- */
- type: Boolean,
- defaultValue: false,
- optional: true,
- },
- type: {
- /**
- * The type of board
- */
- type: String,
- defaultValue: 'board',
- },
- }),
- );
- Boards.helpers({
- copy() {
- const oldId = this._id;
- delete this._id;
- const _id = Boards.insert(this);
- // Copy all swimlanes in board
- Swimlanes.find({
- boardId: oldId,
- archived: false,
- }).forEach(swimlane => {
- swimlane.type = 'swimlane';
- swimlane.copy(_id);
- });
- },
- /**
- * Is supplied user authorized to view this board?
- */
- isVisibleBy(user) {
- if (this.isPublic()) {
- // public boards are visible to everyone
- return true;
- } else {
- // otherwise you have to be logged-in and active member
- return user && this.isActiveMember(user._id);
- }
- },
- /**
- * Is the user one of the active members of the board?
- *
- * @param userId
- * @returns {boolean} the member that matches, or undefined/false
- */
- isActiveMember(userId) {
- if (userId) {
- return this.members.find(
- member => member.userId === userId && member.isActive,
- );
- } else {
- return false;
- }
- },
- isPublic() {
- return this.permission === 'public';
- },
- cards() {
- return Cards.find(
- { boardId: this._id, archived: false },
- { sort: { title: 1 } },
- );
- },
- lists() {
- //currentUser = Meteor.user();
- //if (currentUser) {
- // enabled = Meteor.user().hasSortBy();
- //}
- //return enabled ? this.newestLists() : this.draggableLists();
- return this.draggableLists();
- },
- newestLists() {
- // sorted lists from newest to the oldest, by its creation date or its cards' last modification date
- const value = Meteor.user()._getListSortBy();
- const sortKey = { starred: -1, [value[0]]: value[1] }; // [["starred",-1],value];
- return Lists.find(
- {
- boardId: this._id,
- archived: false,
- },
- { sort: sortKey },
- );
- },
- draggableLists() {
- return Lists.find({ boardId: this._id }, { sort: { sort: 1 } });
- },
- nullSortLists() {
- return Lists.find({
- boardId: this._id,
- archived: false,
- sort: { $eq: null },
- });
- },
- swimlanes() {
- return Swimlanes.find(
- { boardId: this._id, archived: false },
- { sort: { sort: 1 } },
- );
- },
- nextSwimlane(swimlane) {
- return Swimlanes.findOne(
- {
- boardId: this._id,
- archived: false,
- sort: { $gte: swimlane.sort },
- _id: { $ne: swimlane._id },
- },
- {
- sort: { sort: 1 },
- },
- );
- },
- nullSortSwimlanes() {
- return Swimlanes.find({
- boardId: this._id,
- archived: false,
- sort: { $eq: null },
- });
- },
- hasOvertimeCards() {
- const card = Cards.findOne({
- isOvertime: true,
- boardId: this._id,
- archived: false,
- });
- return card !== undefined;
- },
- hasSpentTimeCards() {
- const card = Cards.findOne({
- spentTime: { $gt: 0 },
- boardId: this._id,
- archived: false,
- });
- return card !== undefined;
- },
- activities() {
- return Activities.find({ boardId: this._id }, { sort: { createdAt: -1 } });
- },
- activeMembers() {
- return _.where(this.members, { isActive: true });
- },
- activeAdmins() {
- return _.where(this.members, { isActive: true, isAdmin: true });
- },
- memberUsers() {
- return Users.find({ _id: { $in: _.pluck(this.members, 'userId') } });
- },
- getLabel(name, color) {
- return _.findWhere(this.labels, { name, color });
- },
- getLabelById(labelId) {
- return _.findWhere(this.labels, { _id: labelId });
- },
- labelIndex(labelId) {
- return _.pluck(this.labels, '_id').indexOf(labelId);
- },
- memberIndex(memberId) {
- return _.pluck(this.members, 'userId').indexOf(memberId);
- },
- hasMember(memberId) {
- return !!_.findWhere(this.members, { userId: memberId, isActive: true });
- },
- hasAdmin(memberId) {
- return !!_.findWhere(this.members, {
- userId: memberId,
- isActive: true,
- isAdmin: true,
- });
- },
- hasNoComments(memberId) {
- return !!_.findWhere(this.members, {
- userId: memberId,
- isActive: true,
- isAdmin: false,
- isNoComments: true,
- isWorker: false,
- });
- },
- hasCommentOnly(memberId) {
- return !!_.findWhere(this.members, {
- userId: memberId,
- isActive: true,
- isAdmin: false,
- isCommentOnly: true,
- isWorker: false,
- });
- },
- hasWorker(memberId) {
- return !!_.findWhere(this.members, {
- userId: memberId,
- isActive: true,
- isAdmin: false,
- isCommentOnly: false,
- isWorker: true,
- });
- },
- absoluteUrl() {
- return FlowRouter.url('board', { id: this._id, slug: this.slug });
- },
- colorClass() {
- return `board-color-${this.color}`;
- },
- customFields() {
- return CustomFields.find(
- { boardIds: { $in: [this._id] } },
- { sort: { name: 1 } },
- );
- },
- // XXX currently mutations return no value so we have an issue when using addLabel in import
- // XXX waiting on https://github.com/mquandalle/meteor-collection-mutations/issues/1 to remove...
- pushLabel(name, color) {
- const _id = Random.id(6);
- Boards.direct.update(this._id, { $push: { labels: { _id, name, color } } });
- return _id;
- },
- searchBoards(term) {
- check(term, Match.OneOf(String, null, undefined));
- const query = { boardId: this._id };
- query.type = 'cardType-linkedBoard';
- query.archived = false;
- const projection = { limit: 10, sort: { createdAt: -1 } };
- if (term) {
- const regex = new RegExp(term, 'i');
- query.$or = [{ title: regex }, { description: regex }];
- }
- return Cards.find(query, projection);
- },
- searchSwimlanes(term) {
- check(term, Match.OneOf(String, null, undefined));
- const query = { boardId: this._id };
- if (this.isTemplatesBoard()) {
- query.type = 'template-swimlane';
- query.archived = false;
- } else {
- query.type = { $nin: ['template-swimlane'] };
- }
- const projection = { limit: 10, sort: { createdAt: -1 } };
- if (term) {
- const regex = new RegExp(term, 'i');
- query.$or = [{ title: regex }, { description: regex }];
- }
- return Swimlanes.find(query, projection);
- },
- searchLists(term) {
- check(term, Match.OneOf(String, null, undefined));
- const query = { boardId: this._id };
- if (this.isTemplatesBoard()) {
- query.type = 'template-list';
- query.archived = false;
- } else {
- query.type = { $nin: ['template-list'] };
- }
- const projection = { limit: 10, sort: { createdAt: -1 } };
- if (term) {
- const regex = new RegExp(term, 'i');
- query.$or = [{ title: regex }, { description: regex }];
- }
- return Lists.find(query, projection);
- },
- searchCards(term, excludeLinked) {
- check(term, Match.OneOf(String, null, undefined));
- const query = { boardId: this._id };
- if (excludeLinked) {
- query.linkedId = null;
- }
- if (this.isTemplatesBoard()) {
- query.type = 'template-card';
- query.archived = false;
- } else {
- query.type = { $nin: ['template-card'] };
- }
- const projection = { limit: 10, sort: { createdAt: -1 } };
- if (term) {
- const regex = new RegExp(term, 'i');
- query.$or = [
- { title: regex },
- { description: regex },
- { customFields: { $elemMatch: { value: regex } } },
- ];
- }
- return Cards.find(query, projection);
- },
- // A board alwasy has another board where it deposits subtasks of thasks
- // that belong to itself.
- getDefaultSubtasksBoardId() {
- if (
- this.subtasksDefaultBoardId === null ||
- this.subtasksDefaultBoardId === undefined
- ) {
- this.subtasksDefaultBoardId = Boards.insert({
- title: `^${this.title}^`,
- permission: this.permission,
- members: this.members,
- color: this.color,
- description: TAPi18n.__('default-subtasks-board', {
- board: this.title,
- }),
- });
- Swimlanes.insert({
- title: TAPi18n.__('default'),
- boardId: this.subtasksDefaultBoardId,
- });
- Boards.update(this._id, {
- $set: {
- subtasksDefaultBoardId: this.subtasksDefaultBoardId,
- },
- });
- }
- return this.subtasksDefaultBoardId;
- },
- getDefaultSubtasksBoard() {
- return Boards.findOne(this.getDefaultSubtasksBoardId());
- },
- //Date Settings option such as received date, start date and so on.
- getDefaultDateSettingsBoardId() {
- if (
- this.dateSettingsDefaultBoardId === null ||
- this.dateSettingsDefaultBoardId === undefined
- ) {
- this.dateSettingsDefaultBoardId = Boards.insert({
- title: `^${this.title}^`,
- permission: this.permission,
- members: this.members,
- color: this.color,
- description: TAPi18n.__('default-dates-board', {
- board: this.title,
- }),
- });
- Swimlanes.insert({
- title: TAPi18n.__('default'),
- boardId: this.dateSettingsDefaultBoardId,
- });
- Boards.update(this._id, {
- $set: {
- dateSettingsDefaultBoardId: this.dateSettingsDefaultBoardId,
- },
- });
- }
- return this.dateSettingsDefaultBoardId;
- },
- getDefaultDateSettingsBoard() {
- return Boards.findOne(this.getDefaultDateSettingsBoardId());
- },
- getDefaultSubtasksListId() {
- if (
- this.subtasksDefaultListId === null ||
- this.subtasksDefaultListId === undefined
- ) {
- this.subtasksDefaultListId = Lists.insert({
- title: TAPi18n.__('queue'),
- boardId: this._id,
- });
- this.setSubtasksDefaultListId(this.subtasksDefaultListId);
- }
- return this.subtasksDefaultListId;
- },
- getDefaultSubtasksList() {
- return Lists.findOne(this.getDefaultSubtasksListId());
- },
- getDefaultDateSettingsListId() {
- if (
- this.dateSettingsDefaultListId === null ||
- this.dateSettingsDefaultListId === undefined
- ) {
- this.dateSettingsDefaultListId = Lists.insert({
- title: TAPi18n.__('queue'),
- boardId: this._id,
- });
- this.setDateSettingsDefaultListId(this.dateSettingsDefaultListId);
- }
- return this.dateSettingsDefaultListId;
- },
- getDefaultDateSettingsList() {
- return Lists.findOne(this.getDefaultDateSettingsListId());
- },
- getDefaultSwimline() {
- let result = Swimlanes.findOne({ boardId: this._id });
- if (result === undefined) {
- Swimlanes.insert({
- title: TAPi18n.__('default'),
- boardId: this._id,
- });
- result = Swimlanes.findOne({ boardId: this._id });
- }
- return result;
- },
- cardsDueInBetween(start, end) {
- return Cards.find({
- boardId: this._id,
- dueAt: { $gte: start, $lte: end },
- });
- },
- cardsInInterval(start, end) {
- return Cards.find({
- boardId: this._id,
- $or: [
- {
- startAt: {
- $lte: start,
- },
- endAt: {
- $gte: start,
- },
- },
- {
- startAt: {
- $lte: end,
- },
- endAt: {
- $gte: end,
- },
- },
- {
- startAt: {
- $gte: start,
- },
- endAt: {
- $lte: end,
- },
- },
- ],
- });
- },
- isTemplateBoard() {
- return this.type === 'template-board';
- },
- isTemplatesBoard() {
- return this.type === 'template-container';
- },
- });
- Boards.mutations({
- archive() {
- return { $set: { archived: true } };
- },
- restore() {
- return { $set: { archived: false } };
- },
- rename(title) {
- return { $set: { title } };
- },
- setDescription(description) {
- return { $set: { description } };
- },
- setColor(color) {
- return { $set: { color } };
- },
- setVisibility(visibility) {
- return { $set: { permission: visibility } };
- },
- addLabel(name, color) {
- // If label with the same name and color already exists we don't want to
- // create another one because they would be indistinguishable in the UI
- // (they would still have different `_id` but that is not exposed to the
- // user).
- if (!this.getLabel(name, color)) {
- const _id = Random.id(6);
- return { $push: { labels: { _id, name, color } } };
- }
- return {};
- },
- editLabel(labelId, name, color) {
- if (!this.getLabel(name, color)) {
- const labelIndex = this.labelIndex(labelId);
- return {
- $set: {
- [`labels.${labelIndex}.name`]: name,
- [`labels.${labelIndex}.color`]: color,
- },
- };
- }
- return {};
- },
- removeLabel(labelId) {
- return { $pull: { labels: { _id: labelId } } };
- },
- changeOwnership(fromId, toId) {
- const memberIndex = this.memberIndex(fromId);
- return {
- $set: {
- [`members.${memberIndex}.userId`]: toId,
- },
- };
- },
- addMember(memberId) {
- const memberIndex = this.memberIndex(memberId);
- if (memberIndex >= 0) {
- return {
- $set: {
- [`members.${memberIndex}.isActive`]: true,
- },
- };
- }
- return {
- $push: {
- members: {
- userId: memberId,
- isAdmin: false,
- isActive: true,
- isNoComments: false,
- isCommentOnly: false,
- isWorker: false,
- },
- },
- };
- },
- removeMember(memberId) {
- const memberIndex = this.memberIndex(memberId);
- // we do not allow the only one admin to be removed
- const allowRemove =
- !this.members[memberIndex].isAdmin || this.activeAdmins().length > 1;
- if (!allowRemove) {
- return {
- $set: {
- [`members.${memberIndex}.isActive`]: true,
- },
- };
- }
- return {
- $set: {
- [`members.${memberIndex}.isActive`]: false,
- [`members.${memberIndex}.isAdmin`]: false,
- },
- };
- },
- setMemberPermission(
- memberId,
- isAdmin,
- isNoComments,
- isCommentOnly,
- isWorker,
- currentUserId = Meteor.userId(),
- ) {
- const memberIndex = this.memberIndex(memberId);
- // do not allow change permission of self
- if (memberId === currentUserId) {
- isAdmin = this.members[memberIndex].isAdmin;
- }
- return {
- $set: {
- [`members.${memberIndex}.isAdmin`]: isAdmin,
- [`members.${memberIndex}.isNoComments`]: isNoComments,
- [`members.${memberIndex}.isCommentOnly`]: isCommentOnly,
- [`members.${memberIndex}.isWorker`]: isWorker,
- },
- };
- },
- setAllowsSubtasks(allowsSubtasks) {
- return { $set: { allowsSubtasks } };
- },
- setAllowsMembers(allowsMembers) {
- return { $set: { allowsMembers } };
- },
- setAllowsChecklists(allowsChecklists) {
- return { $set: { allowsChecklists } };
- },
- setAllowsAssignee(allowsAssignee) {
- return { $set: { allowsAssignee } };
- },
- setAllowsAssignedBy(allowsAssignedBy) {
- return { $set: { allowsAssignedBy } };
- },
- setAllowsRequestedBy(allowsRequestedBy) {
- return { $set: { allowsRequestedBy } };
- },
- setAllowsAttachments(allowsAttachments) {
- return { $set: { allowsAttachments } };
- },
- setAllowsLabels(allowsLabels) {
- return { $set: { allowsLabels } };
- },
- setAllowsComments(allowsComments) {
- return { $set: { allowsComments } };
- },
- setAllowsDescriptionTitle(allowsDescriptionTitle) {
- return { $set: { allowsDescriptionTitle } };
- },
- setAllowsDescriptionText(allowsDescriptionText) {
- return { $set: { allowsDescriptionText } };
- },
- setAllowsActivities(allowsActivities) {
- return { $set: { allowsActivities } };
- },
- setAllowsReceivedDate(allowsReceivedDate) {
- return { $set: { allowsReceivedDate } };
- },
- setAllowsStartDate(allowsStartDate) {
- return { $set: { allowsStartDate } };
- },
- setAllowsEndDate(allowsEndDate) {
- return { $set: { allowsEndDate } };
- },
- setAllowsDueDate(allowsDueDate) {
- return { $set: { allowsDueDate } };
- },
- setSubtasksDefaultBoardId(subtasksDefaultBoardId) {
- return { $set: { subtasksDefaultBoardId } };
- },
- setSubtasksDefaultListId(subtasksDefaultListId) {
- return { $set: { subtasksDefaultListId } };
- },
- setPresentParentTask(presentParentTask) {
- return { $set: { presentParentTask } };
- },
- });
- function boardRemover(userId, doc) {
- [Cards, Lists, Swimlanes, Integrations, Rules, Activities].forEach(
- element => {
- element.remove({ boardId: doc._id });
- },
- );
- }
- if (Meteor.isServer) {
- Boards.allow({
- insert: Meteor.userId,
- update: allowIsBoardAdmin,
- remove: allowIsBoardAdmin,
- fetch: ['members'],
- });
- // The number of users that have starred this board is managed by trusted code
- // and the user is not allowed to update it
- Boards.deny({
- update(userId, board, fieldNames) {
- return _.contains(fieldNames, 'stars');
- },
- fetch: [],
- });
- // We can't remove a member if it is the last administrator
- Boards.deny({
- update(userId, doc, fieldNames, modifier) {
- if (!_.contains(fieldNames, 'members')) return false;
- // We only care in case of a $pull operation, ie remove a member
- if (!_.isObject(modifier.$pull && modifier.$pull.members)) return false;
- // If there is more than one admin, it's ok to remove anyone
- const nbAdmins = _.where(doc.members, { isActive: true, isAdmin: true })
- .length;
- if (nbAdmins > 1) return false;
- // If all the previous conditions were verified, we can't remove
- // a user if it's an admin
- const removedMemberId = modifier.$pull.members.userId;
- return Boolean(
- _.findWhere(doc.members, {
- userId: removedMemberId,
- isAdmin: true,
- }),
- );
- },
- fetch: ['members'],
- });
- Meteor.methods({
- quitBoard(boardId) {
- check(boardId, String);
- const board = Boards.findOne(boardId);
- if (board) {
- const userId = Meteor.userId();
- const index = board.memberIndex(userId);
- if (index >= 0) {
- board.removeMember(userId);
- return true;
- } else throw new Meteor.Error('error-board-notAMember');
- } else throw new Meteor.Error('error-board-doesNotExist');
- },
- acceptInvite(boardId) {
- check(boardId, String);
- const board = Boards.findOne(boardId);
- if (!board) {
- throw new Meteor.Error('error-board-doesNotExist');
- }
- Meteor.users.update(Meteor.userId(), {
- $pull: {
- 'profile.invitedBoards': boardId,
- },
- });
- },
- });
- Meteor.methods({
- archiveBoard(boardId) {
- check(boardId, String);
- const board = Boards.findOne(boardId);
- if (board) {
- const userId = Meteor.userId();
- const index = board.memberIndex(userId);
- if (index >= 0) {
- board.archive();
- return true;
- } else throw new Meteor.Error('error-board-notAMember');
- } else throw new Meteor.Error('error-board-doesNotExist');
- },
- });
- }
- if (Meteor.isServer) {
- // Let MongoDB ensure that a member is not included twice in the same board
- Meteor.startup(() => {
- Boards._collection._ensureIndex({ modifiedAt: -1 });
- Boards._collection._ensureIndex(
- {
- _id: 1,
- 'members.userId': 1,
- },
- { unique: true },
- );
- Boards._collection._ensureIndex({ 'members.userId': 1 });
- });
- // Genesis: the first activity of the newly created board
- Boards.after.insert((userId, doc) => {
- Activities.insert({
- userId,
- type: 'board',
- activityTypeId: doc._id,
- activityType: 'createBoard',
- boardId: doc._id,
- });
- });
- // If the user remove one label from a board, we cant to remove reference of
- // this label in any card of this board.
- Boards.after.update((userId, doc, fieldNames, modifier) => {
- if (
- !_.contains(fieldNames, 'labels') ||
- !modifier.$pull ||
- !modifier.$pull.labels ||
- !modifier.$pull.labels._id
- ) {
- return;
- }
- const removedLabelId = modifier.$pull.labels._id;
- Cards.update(
- { boardId: doc._id },
- {
- $pull: {
- labelIds: removedLabelId,
- },
- },
- { multi: true },
- );
- });
- const foreachRemovedMember = (doc, modifier, callback) => {
- Object.keys(modifier).forEach(set => {
- if (modifier[set] !== false) {
- return;
- }
- const parts = set.split('.');
- if (
- parts.length === 3 &&
- parts[0] === 'members' &&
- parts[2] === 'isActive'
- ) {
- callback(doc.members[parts[1]].userId);
- }
- });
- };
- // Remove a member from all objects of the board before leaving the board
- Boards.before.update((userId, doc, fieldNames, modifier) => {
- if (!_.contains(fieldNames, 'members')) {
- return;
- }
- if (modifier.$set) {
- const boardId = doc._id;
- foreachRemovedMember(doc, modifier.$set, memberId => {
- Cards.update(
- { boardId },
- {
- $pull: {
- members: memberId,
- watchers: memberId,
- },
- },
- { multi: true },
- );
- Lists.update(
- { boardId },
- {
- $pull: {
- watchers: memberId,
- },
- },
- { multi: true },
- );
- const board = Boards._transform(doc);
- board.setWatcher(memberId, false);
- // Remove board from users starred list
- if (!board.isPublic()) {
- Users.update(memberId, {
- $pull: {
- 'profile.starredBoards': boardId,
- },
- });
- }
- });
- }
- });
- Boards.before.remove((userId, doc) => {
- boardRemover(userId, doc);
- // Add removeBoard activity to keep it
- Activities.insert({
- userId,
- type: 'board',
- activityTypeId: doc._id,
- activityType: 'removeBoard',
- boardId: doc._id,
- });
- });
- // Add a new activity if we add or remove a member to the board
- Boards.after.update((userId, doc, fieldNames, modifier) => {
- if (!_.contains(fieldNames, 'members')) {
- return;
- }
- // Say hello to the new member
- if (modifier.$push && modifier.$push.members) {
- const memberId = modifier.$push.members.userId;
- Activities.insert({
- userId,
- memberId,
- type: 'member',
- activityType: 'addBoardMember',
- boardId: doc._id,
- });
- }
- // Say goodbye to the former member
- if (modifier.$set) {
- foreachRemovedMember(doc, modifier.$set, memberId => {
- Activities.insert({
- userId,
- memberId,
- type: 'member',
- activityType: 'removeBoardMember',
- boardId: doc._id,
- });
- });
- }
- });
- }
- //BOARDS REST API
- if (Meteor.isServer) {
- /**
- * @operation get_boards_from_user
- * @summary Get all boards attached to a user
- *
- * @param {string} userId the ID of the user to retrieve the data
- * @return_type [{_id: string,
- title: string}]
- */
- JsonRoutes.add('GET', '/api/users/:userId/boards', function(req, res) {
- try {
- Authentication.checkLoggedIn(req.userId);
- const paramUserId = req.params.userId;
- // A normal user should be able to see their own boards,
- // admins can access boards of any user
- Authentication.checkAdminOrCondition(
- req.userId,
- req.userId === paramUserId,
- );
- const data = Boards.find(
- {
- archived: false,
- 'members.userId': paramUserId,
- },
- {
- sort: ['title'],
- },
- ).map(function(board) {
- return {
- _id: board._id,
- title: board.title,
- };
- });
- JsonRoutes.sendResult(res, { code: 200, data });
- } catch (error) {
- JsonRoutes.sendResult(res, {
- code: 200,
- data: error,
- });
- }
- });
- /**
- * @operation get_public_boards
- * @summary Get all public boards
- *
- * @return_type [{_id: string,
- title: string}]
- */
- JsonRoutes.add('GET', '/api/boards', function(req, res) {
- try {
- Authentication.checkUserId(req.userId);
- JsonRoutes.sendResult(res, {
- code: 200,
- data: Boards.find({ permission: 'public' }).map(function(doc) {
- return {
- _id: doc._id,
- title: doc.title,
- };
- }),
- });
- } catch (error) {
- JsonRoutes.sendResult(res, {
- code: 200,
- data: error,
- });
- }
- });
- /**
- * @operation get_board
- * @summary Get the board with that particular ID
- *
- * @param {string} boardId the ID of the board to retrieve the data
- * @return_type Boards
- */
- JsonRoutes.add('GET', '/api/boards/:boardId', function(req, res) {
- try {
- const id = req.params.boardId;
- Authentication.checkBoardAccess(req.userId, id);
- JsonRoutes.sendResult(res, {
- code: 200,
- data: Boards.findOne({ _id: id }),
- });
- } catch (error) {
- JsonRoutes.sendResult(res, {
- code: 200,
- data: error,
- });
- }
- });
- /**
- * @operation new_board
- * @summary Create a board
- *
- * @description This allows to create a board.
- *
- * The color has to be chosen between `belize`, `nephritis`, `pomegranate`,
- * `pumpkin`, `wisteria`, `moderatepink`, `strongcyan`,
- * `limegreen`, `midnight`, `dark`, `relax`, `corteza`:
- *
- * <img src="https://wekan.github.io/board-colors.png" width="40%" alt="Wekan logo" />
- *
- * @param {string} title the new title of the board
- * @param {string} owner "ABCDE12345" <= User ID in Wekan.
- * (Not username or email)
- * @param {boolean} [isAdmin] is the owner an admin of the board (default true)
- * @param {boolean} [isActive] is the board active (default true)
- * @param {boolean} [isNoComments] disable comments (default false)
- * @param {boolean} [isCommentOnly] only enable comments (default false)
- * @param {boolean} [isWorker] only move cards, assign himself to card and comment (default false)
- * @param {string} [permission] "private" board <== Set to "public" if you
- * want public Wekan board
- * @param {string} [color] the color of the board
- *
- * @return_type {_id: string,
- defaultSwimlaneId: string}
- */
- JsonRoutes.add('POST', '/api/boards', function(req, res) {
- try {
- Authentication.checkUserId(req.userId);
- const id = Boards.insert({
- title: req.body.title,
- members: [
- {
- userId: req.body.owner,
- isAdmin: req.body.isAdmin || true,
- isActive: req.body.isActive || true,
- isNoComments: req.body.isNoComments || false,
- isCommentOnly: req.body.isCommentOnly || false,
- isWorker: req.body.isWorker || false,
- },
- ],
- permission: req.body.permission || 'private',
- color: req.body.color || 'belize',
- });
- const swimlaneId = Swimlanes.insert({
- title: TAPi18n.__('default'),
- boardId: id,
- });
- JsonRoutes.sendResult(res, {
- code: 200,
- data: {
- _id: id,
- defaultSwimlaneId: swimlaneId,
- },
- });
- } catch (error) {
- JsonRoutes.sendResult(res, {
- code: 200,
- data: error,
- });
- }
- });
- /**
- * @operation delete_board
- * @summary Delete a board
- *
- * @param {string} boardId the ID of the board
- */
- JsonRoutes.add('DELETE', '/api/boards/:boardId', function(req, res) {
- try {
- Authentication.checkUserId(req.userId);
- const id = req.params.boardId;
- Boards.remove({ _id: id });
- JsonRoutes.sendResult(res, {
- code: 200,
- data: {
- _id: id,
- },
- });
- } catch (error) {
- JsonRoutes.sendResult(res, {
- code: 200,
- data: error,
- });
- }
- });
- /**
- * @operation add_board_label
- * @summary Add a label to a board
- *
- * @description If the board doesn't have the name/color label, this function
- * adds the label to the board.
- *
- * @param {string} boardId the board
- * @param {string} color the color of the new label
- * @param {string} name the name of the new label
- *
- * @return_type string
- */
- JsonRoutes.add('PUT', '/api/boards/:boardId/labels', function(req, res) {
- Authentication.checkUserId(req.userId);
- const id = req.params.boardId;
- try {
- if (req.body.hasOwnProperty('label')) {
- const board = Boards.findOne({ _id: id });
- const color = req.body.label.color;
- const name = req.body.label.name;
- const labelId = Random.id(6);
- if (!board.getLabel(name, color)) {
- Boards.direct.update(
- { _id: id },
- { $push: { labels: { _id: labelId, name, color } } },
- );
- JsonRoutes.sendResult(res, {
- code: 200,
- data: labelId,
- });
- } else {
- JsonRoutes.sendResult(res, {
- code: 200,
- });
- }
- }
- } catch (error) {
- JsonRoutes.sendResult(res, {
- data: error,
- });
- }
- });
- /**
- * @operation set_board_member_permission
- * @tag Users
- * @summary Change the permission of a member of a board
- *
- * @param {string} boardId the ID of the board that we are changing
- * @param {string} memberId the ID of the user to change permissions
- * @param {boolean} isAdmin admin capability
- * @param {boolean} isNoComments NoComments capability
- * @param {boolean} isCommentOnly CommentsOnly capability
- * @param {boolean} isWorker Worker capability
- */
- JsonRoutes.add('POST', '/api/boards/:boardId/members/:memberId', function(
- req,
- res,
- ) {
- try {
- const boardId = req.params.boardId;
- const memberId = req.params.memberId;
- const { isAdmin, isNoComments, isCommentOnly, isWorker } = req.body;
- Authentication.checkBoardAccess(req.userId, boardId);
- const board = Boards.findOne({ _id: boardId });
- function isTrue(data) {
- try {
- return data.toLowerCase() === 'true';
- } catch (error) {
- return data;
- }
- }
- const query = board.setMemberPermission(
- memberId,
- isTrue(isAdmin),
- isTrue(isNoComments),
- isTrue(isCommentOnly),
- isTrue(isWorker),
- req.userId,
- );
- JsonRoutes.sendResult(res, {
- code: 200,
- data: query,
- });
- } catch (error) {
- JsonRoutes.sendResult(res, {
- code: 200,
- data: error,
- });
- }
- });
- }
- export default Boards;
|