OXYGENHUB
# 69e4f27c5633 oxygenhub / crates / hub / src / web / projects.rs
27.3 KiB · Rust · last changed Boards that keep growing stay readable (refs #293) 11 days ago source blame history raw
1
//! Projects (hub spec §8.2): boards of issues, proposals and notes across
2
//! the repositories of one person or organisation.
3
4
use super::settings::csrf;
5
use super::{filters, Error, Page, Shell};
6
use crate::auth::{roles, Access, Viewer};
7
use crate::db::{self, projects as pdb};
8
use crate::Shared;
9
use askama::Template;
10
use axum::extract::{Form, Path, Query, State};
11
use axum::response::{IntoResponse, Redirect, Response};
12
use serde::Deserialize;
13
14
/// What a caller may do with an owner's projects.
15
pub struct Rights {
16
    /// Sees private projects.
17
    pub member: bool,
18
    /// Creates and changes projects.
19
    pub edit: bool,
20
}
21
22
/// Rights of `account` (anonymous when `None`) over `owner`'s projects;
23
/// `None` when there is no such person or organisation.
24
pub async fn rights_of(app: &Shared, account: Option<&db::accounts::Account>, owner: &str) -> sqlx::Result<Option<Rights>> {
25
    let admin = account.is_some_and(|a| a.is_admin);
26
    if let Some(a) = db::accounts::account_by_name(&app.db, owner).await? {
27
        let me = account.is_some_and(|v| v.id == a.id);
28
        return Ok(Some(Rights { member: me || admin, edit: me || admin }));
29
    }
30
    if let Some(o) = db::accounts::org_by_name(&app.db, owner).await? {
31
        let member = match account {
32
            Some(v) => db::accounts::org_role(&app.db, o.id, v.id).await?.is_some(),
33
            None => false,
34
        };
35
        return Ok(Some(Rights { member: member || admin, edit: member || admin }));
36
    }
37
    Ok(None)
38
}
39
40
async fn rights(app: &Shared, shell: &Shell, viewer: &Viewer, owner: &str) -> Result<Rights, Error> {
41
    rights_of(app, viewer.account(), owner)
42
        .await
43
        .map_err(|e| Error::from_db(shell.clone(), e))?
44
        .ok_or_else(|| Error::not_found(shell.clone()))
45
}
46
47
#[derive(Template)]
48
#[template(path = "projects.html")]
49
pub struct ProjectsPage {
50
    shell: Shell,
51
    owner: String,
52
    /// The projects shown: open or closed as `closed` says, matching `q`.
53
    projects: Vec<pdb::Project>,
54
    can_edit: bool,
55
    error: Option<String>,
56
    /// On your own page, the organisations you belong to: their boards
57
    /// are one click away, and where a board for one is made (#119).
58
    orgs: Vec<String>,
59
    /// The title filter, and whether the closed ones are shown (#124).
60
    q: String,
61
    closed: bool,
62
    open_count: usize,
63
    closed_count: usize,
64
}
65
66
impl ProjectsPage {
67
    /// The page for `all` the projects the viewer may see: counted open
68
    /// and closed among those matching `q`, then the ones asked for.
69
    #[allow(clippy::too_many_arguments)]
70
    fn build(
71
        shell: Shell,
72
        owner: String,
73
        all: Vec<pdb::Project>,
74
        can_edit: bool,
75
        error: Option<String>,
76
        orgs: Vec<String>,
77
        q: Option<String>,
78
        closed: bool,
79
    ) -> ProjectsPage {
80
        let q = q.unwrap_or_default().trim().to_string();
81
        let needle = q.to_lowercase();
82
        let matching: Vec<pdb::Project> = all
83
            .into_iter()
84
            .filter(|p| needle.is_empty() || p.title.to_lowercase().contains(&needle) || p.description.to_lowercase().contains(&needle))
85
            .collect();
86
        let closed_count = matching.iter().filter(|p| p.closed).count();
87
        let open_count = matching.len() - closed_count;
88
        let projects = matching.into_iter().filter(|p| p.closed == closed).collect();
89
        ProjectsPage { shell, owner, projects, can_edit, error, orgs, q, closed, open_count, closed_count }
90
    }
91
}
92
93
/// `?q=TEXT&state=open|closed` on the Projects page (#124).
94
#[derive(Deserialize, Default)]
95
pub struct ProjectsQuery {
96
    #[serde(default)]
97
    q: Option<String>,
98
    #[serde(default)]
99
    state: Option<String>,
100
}
101
102
/// The organisations the viewer belongs to, when `owner` is the viewer.
103
async fn own_orgs(app: &Shared, viewer: &Viewer, owner: &str) -> Vec<String> {
104
    match viewer.account() {
105
        Some(a) if a.username == owner => {
106
            crate::db::accounts::orgs_of(&app.db, a.id).await.map(|v| v.into_iter().map(|(o, _)| o.name).collect()).unwrap_or_default()
107
        }
108
        _ => vec![],
109
    }
110
}
111
112
pub async fn list(
113
    State(app): State<Shared>,
114
    viewer: Viewer,
115
    Path(owner): Path<String>,
116
    Query(query): Query<ProjectsQuery>,
117
) -> Result<Page<ProjectsPage>, Error> {
118
    let shell = Shell::new(&app, &format!("/projects/{owner}"), &viewer);
119
    let r = rights(&app, &shell, &viewer, &owner).await?;
120
    let projects = pdb::of_owner(&app.db, &owner)
121
        .await
122
        .map_err(|e| Error::from_db(shell.clone(), e))?
123
        .into_iter()
124
        .filter(|p| p.public || r.member)
125
        .collect();
126
    let orgs = own_orgs(&app, &viewer, &owner).await;
127
    let closed = query.state.as_deref() == Some("closed");
128
    Ok(Page(ProjectsPage::build(shell, owner, projects, r.edit, None, orgs, query.q, closed)))
129
}
130
131
#[derive(Deserialize)]
132
pub struct NewProjectForm {
133
    #[serde(rename = "_csrf")]
134
    csrf_token: String,
135
    title: String,
136
    #[serde(default)]
137
    description: String,
138
    #[serde(default)]
139
    private: Option<String>,
140
}
141
142
pub async fn create(
143
    State(app): State<Shared>,
144
    viewer: Viewer,
145
    Path(owner): Path<String>,
146
    Form(f): Form<NewProjectForm>,
147
) -> Result<Response, Error> {
148
    let shell = Shell::new(&app, &format!("/projects/{owner}"), &viewer);
149
    csrf(&viewer, &f.csrf_token, &shell)?;
150
    let r = rights(&app, &shell, &viewer, &owner).await?;
151
    if !r.edit {
152
        return Err(Error::not_found(shell));
153
    }
154
    let title = f.title.trim();
155
    if title.is_empty() || title.len() > 100 {
156
        let projects = pdb::of_owner(&app.db, &owner).await.map_err(|e| Error::from_db(shell.clone(), e))?;
157
        let orgs = own_orgs(&app, &viewer, &owner).await;
158
        return Ok(Page(ProjectsPage::build(
159
            shell,
160
            owner,
161
            projects,
162
            true,
163
            Some("A project needs a title of up to 100 characters.".into()),
164
            orgs,
165
            None,
166
            false,
167
        ))
168
        .into_response());
169
    }
170
    let p = pdb::create(&app.db, &owner, title, f.description.trim(), f.private.is_none())
171
        .await
172
        .map_err(|e| Error::from_db(shell.clone(), e))?;
173
    db::accounts::audit(&app.db, viewer.account(), "project.created", &format!("{owner}/{}", p.number), title).await.ok();
174
    Ok(Redirect::to(&format!("/projects/{owner}/{}", p.number)).into_response())
175
}
176
177
/// A card as the board shows it.
178
pub struct CardView {
179
    pub card: pdb::Card,
180
    /// `owner/name#N`, for issue and proposal cards.
181
    pub reference: String,
182
    pub url: String,
183
    pub title: String,
184
    /// `open`, `closed`, `landed`, `draft`… for issues and proposals.
185
    pub state: String,
186
}
187
188
pub struct ColumnView {
189
    pub column: pdb::Column,
190
    pub cards: Vec<CardView>,
191
    /// Cards the page leaves out (#293): the oldest of a long column, or
192
    /// those a filter does not match; `total` is how many it holds.
193
    pub hidden: usize,
194
    pub total: usize,
195
}
196
197
/// A column longer than this shows its newest cards only, with "show all"
198
/// (#293): a board's Done column otherwise grows without end.
199
pub const COLUMN_SHOWN: usize = 30;
200
201
/// How the board page shows its cards (#293).
202
#[derive(Deserialize, Default)]
203
pub struct BoardQuery {
204
    /// The column shown whole.
205
    #[serde(default)]
206
    all: Option<i64>,
207
    /// Only cards whose title or reference holds this.
208
    #[serde(default)]
209
    q: Option<String>,
210
    /// Only cards in this state (`open`, `closed`, `landed`…).
211
    #[serde(default)]
212
    state: Option<String>,
213
}
214
215
impl BoardQuery {
216
    fn text(&self) -> String {
217
        self.q.as_deref().map(str::trim).unwrap_or("").to_string()
218
    }
219
    fn state(&self) -> String {
220
        self.state.as_deref().map(str::trim).unwrap_or("").to_ascii_lowercase()
221
    }
222
}
223
224
/// Filter and cut the columns as `view` says.
225
fn shape(columns: &mut [ColumnView], view: &BoardQuery) {
226
    let (q, state) = (view.text().to_lowercase(), view.state());
227
    for col in columns.iter_mut() {
228
        col.total = col.cards.len();
229
        if !q.is_empty() || !state.is_empty() {
230
            col.cards.retain(|c| {
231
                (q.is_empty() || c.title.to_lowercase().contains(&q) || c.reference.to_lowercase().contains(&q))
232
                    && (state.is_empty() || c.state.eq_ignore_ascii_case(&state))
233
            });
234
        } else if col.cards.len() > COLUMN_SHOWN && view.all != Some(col.column.id) {
235
            // Cards join a column at its end: the newest are the last.
236
            let cut = col.cards.len() - COLUMN_SHOWN;
237
            col.cards.drain(..cut);
238
        }
239
        col.hidden = col.total - col.cards.len();
240
    }
241
}
242
243
#[derive(Template)]
244
#[template(path = "project.html")]
245
pub struct BoardPage {
246
    shell: Shell,
247
    project: pdb::Project,
248
    columns: Vec<ColumnView>,
249
    /// The owner's repositories the viewer can read, for adding cards.
250
    repos: Vec<String>,
251
    /// Changes cards and columns (an open project).
252
    can_edit: bool,
253
    /// Changes the settings (to reopen a closed project too).
254
    can_manage: bool,
255
    notice: Option<String>,
256
    error: Option<String>,
257
    /// Owners the viewer may move the project to (#125): themselves and the
258
    /// organisations they belong to, but not its owner now.
259
    transfer_to: Vec<String>,
260
    /// The filter the page shows (#293), and whether one is set.
261
    q: String,
262
    state: String,
263
    filtered: bool,
264
}
265
266
#[allow(clippy::too_many_arguments)]
267
async fn board(
268
    app: &Shared,
269
    shell: Shell,
270
    viewer: &Viewer,
271
    owner: &str,
272
    number: i64,
273
    notice: Option<String>,
274
    error: Option<String>,
275
    view: &BoardQuery,
276
) -> Result<Page<BoardPage>, Error> {
277
    let e = |e| Error::from_db(shell.clone(), e);
278
    let r = rights(app, &shell, viewer, owner).await?;
279
    let project = pdb::get(&app.db, owner, number)
280
        .await
281
        .map_err(e)?
282
        .filter(|p| p.public || r.member)
283
        .ok_or_else(|| Error::not_found(shell.clone()))?;
284
    let (mut columns, repos) = board_columns(app, viewer.account(), owner, &project).await.map_err(e)?;
285
    shape(&mut columns, view);
286
    let can_edit = r.edit && !project.closed;
287
    let mut transfer_to = Vec::new();
288
    if let (true, Some(a)) = (r.edit, viewer.account()) {
289
        transfer_to.push(a.username.clone());
290
        let orgs = db::accounts::orgs_of(&app.db, a.id).await.map_err(e)?;
291
        transfer_to.extend(orgs.into_iter().map(|(o, _)| o.name));
292
        transfer_to.retain(|o| o != owner);
293
    }
294
    let (q, state) = (view.text(), view.state());
295
    let filtered = !q.is_empty() || !state.is_empty();
296
    Ok(Page(BoardPage { shell, project, columns, repos, can_edit, can_manage: r.edit, notice, error, transfer_to, q, state, filtered }))
297
}
298
299
/// A project's columns with the cards `account` may see, and the owner's
300
/// repositories it can read (for adding cards).
301
pub async fn board_columns(
302
    app: &Shared,
303
    account: Option<&db::accounts::Account>,
304
    owner: &str,
305
    project: &pdb::Project,
306
) -> sqlx::Result<(Vec<ColumnView>, Vec<String>)> {
307
    let mut readable: std::collections::HashMap<i64, db::repos::RepoRow> = Default::default();
308
    for row in db::repos::list_by_owner(&app.db, owner).await? {
309
        let role = roles::role_for(&app.db, account, &row).await?;
310
        if roles::allows(role, Access::Read) {
311
            readable.insert(row.id, row);
312
        }
313
    }
314
    let cards = pdb::cards(&app.db, project.id).await?;
315
    let mut columns = Vec::new();
316
    for column in pdb::columns(&app.db, project.id).await? {
317
        let mut views = Vec::new();
318
        for card in cards.iter().filter(|c| c.column_id == column.id) {
319
            match (card.kind.as_str(), card.repo_id, card.number) {
320
                ("note", _, _) => views.push(CardView {
321
                    card: card.clone(),
322
                    reference: String::new(),
323
                    url: String::new(),
324
                    title: card.note.clone(),
325
                    state: String::new(),
326
                }),
327
                (kind, Some(rid), Some(n)) => {
328
                    // Cards of repositories the viewer cannot read are not shown at all.
329
                    let Some(row) = readable.get(&rid) else { continue };
330
                    let (title, state) = if kind == "issue" {
331
                        match db::issues::get(&app.db, rid, n).await? {
332
                            Some(i) => (i.title, i.state),
333
                            None => continue,
334
                        }
335
                    } else {
336
                        match db::proposals::get(&app.db, rid, n).await? {
337
                            Some(p) => (p.title, p.state),
338
                            None => continue,
339
                        }
340
                    };
341
                    let slug = format!("{}/{}", row.owner, row.name);
342
                    views.push(CardView {
343
                        card: card.clone(),
344
                        reference: format!("{slug}#{n}"),
345
                        url: format!("/{slug}/{kind}/{n}"),
346
                        title,
347
                        state,
348
                    });
349
                }
350
                _ => {}
351
            }
352
        }
353
        let total = views.len();
354
        columns.push(ColumnView { column, cards: views, hidden: 0, total });
355
    }
356
    let mut repos: Vec<String> = readable.values().map(|r| r.name.clone()).collect();
357
    repos.sort();
358
    Ok((columns, repos))
359
}
360
361
pub async fn show(
362
    State(app): State<Shared>,
363
    viewer: Viewer,
364
    Path((owner, number)): Path<(String, i64)>,
365
    Query(view): Query<BoardQuery>,
366
) -> Result<Response, Error> {
367
    let shell = Shell::new(&app, &format!("/projects/{owner}/{number}"), &viewer);
368
    // A board transferred away (#125): its old address goes to its new one.
369
    let e = |e| Error::from_db(shell.clone(), e);
370
    if pdb::get(&app.db, &owner, number).await.map_err(e)?.is_none() {
371
        if let Some(p) = pdb::redirected(&app.db, &owner, number).await.map_err(e)? {
372
            return Ok(Redirect::permanent(&format!("/projects/{}/{}", p.owner, p.number)).into_response());
373
        }
374
    }
375
    Ok(board(&app, shell, &viewer, &owner, number, None, None, &view).await?.into_response())
376
}
377
378
#[derive(Deserialize)]
379
pub struct BoardForm {
380
    #[serde(rename = "_csrf")]
381
    csrf_token: String,
382
    action: String,
383
    #[serde(default)]
384
    card: Option<i64>,
385
    #[serde(default)]
386
    column: Option<i64>,
387
    #[serde(default)]
388
    name: String,
389
    /// `repo#12`, or `#12` with `repo`.
390
    #[serde(default)]
391
    reference: String,
392
    #[serde(default)]
393
    repo: String,
394
    #[serde(default)]
395
    note: String,
396
    #[serde(default)]
397
    title: String,
398
    #[serde(default)]
399
    description: String,
400
    #[serde(default)]
401
    private: Option<String>,
402
    #[serde(default)]
403
    closed: Option<String>,
404
    /// The owner to transfer the project to (#125).
405
    #[serde(default)]
406
    to: String,
407
}
408
409
/// `repo#12` or `#12` (with a repository chosen) to (repository, number).
410
fn parse_reference(reference: &str, repo: &str) -> Option<(String, i64)> {
411
    let r = reference.trim();
412
    let (name, n) = r.split_once('#')?;
413
    let name = if name.is_empty() { repo.trim() } else { name.trim() };
414
    let n: i64 = n.trim().parse().ok()?;
415
    (!name.is_empty() && n > 0 && !name.contains('/')).then(|| (name.to_string(), n))
416
}
417
418
/// Add a note, or the issue or proposal `reference` names (`repo#12`, or
419
/// `#12` with `repo`), to a column. `Ok(Err(why))` for what the caller
420
/// should be told: an unknown repository or number, or a card already there.
421
#[allow(clippy::too_many_arguments)]
422
pub async fn add_card(
423
    app: &Shared,
424
    account: Option<&db::accounts::Account>,
425
    owner: &str,
426
    project_id: i64,
427
    column_id: i64,
428
    reference: &str,
429
    repo: &str,
430
    note: &str,
431
    actor: &str,
432
) -> sqlx::Result<Result<pdb::Card, String>> {
433
    if !note.trim().is_empty() {
434
        let note: String = note.trim().chars().take(500).collect();
435
        pdb::add_card(
436
            &app.db,
437
            project_id,
438
            pdb::NewCard { column_id, kind: "note", repo_id: None, number: None, note: &note, added_by: actor },
439
        )
440
        .await?;
441
        return Ok(Ok(newest_card(app, project_id).await?));
442
    }
443
    let Some((repo, n)) = parse_reference(reference, repo) else {
444
        return Ok(Err("Name an issue or proposal as repo#12, or write a note.".into()));
445
    };
446
    let Some(row) = db::repos::get(&app.db, owner, &repo).await? else { return Ok(Err(format!("{owner} has no repository {repo}."))) };
447
    let role = roles::role_for(&app.db, account, &row).await?;
448
    let (issues, proposals) = db::issues::numbers(&app.db, row.id).await?;
449
    let kind = if issues.contains(&n) {
450
        "issue"
451
    } else if proposals.contains(&n) {
452
        "proposal"
453
    } else {
454
        return Ok(Err(format!("{repo} has no issue or proposal #{n}.")));
455
    };
456
    if !roles::allows(role, Access::Read) {
457
        return Ok(Err(format!("{repo} has no issue or proposal #{n}.")));
458
    }
459
    if !pdb::add_card(
460
        &app.db,
461
        project_id,
462
        pdb::NewCard { column_id, kind, repo_id: Some(row.id), number: Some(n), note: "", added_by: actor },
463
    )
464
    .await?
465
    {
466
        return Ok(Err(format!("{repo}#{n} is already on this project.")));
467
    }
468
    Ok(Ok(newest_card(app, project_id).await?))
469
}
470
471
async fn newest_card(app: &Shared, project_id: i64) -> sqlx::Result<pdb::Card> {
472
    sqlx::query_as("SELECT * FROM project_cards WHERE project_id = $1 ORDER BY id DESC LIMIT 1").bind(project_id).fetch_one(&app.db).await
473
}
474
475
pub async fn act(
476
    State(app): State<Shared>,
477
    viewer: Viewer,
478
    Path((owner, number)): Path<(String, i64)>,
479
    Form(f): Form<BoardForm>,
480
) -> Result<Response, Error> {
481
    let shell = Shell::new(&app, &format!("/projects/{owner}/{number}"), &viewer);
482
    csrf(&viewer, &f.csrf_token, &shell)?;
483
    let r = rights(&app, &shell, &viewer, &owner).await?;
484
    let e = |e| Error::from_db(shell.clone(), e);
485
    let project = pdb::get(&app.db, &owner, number)
486
        .await
487
        .map_err(e)?
488
        .filter(|p| p.public || r.member)
489
        .ok_or_else(|| Error::not_found(shell.clone()))?;
490
    if !r.edit {
491
        return Err(Error::not_found(shell));
492
    }
493
    if project.closed && !matches!(f.action.as_str(), "settings" | "delete" | "transfer") {
494
        return Ok(board(
495
            &app,
496
            shell,
497
            &viewer,
498
            &owner,
499
            number,
500
            None,
501
            Some("This project is closed; reopen it to change it.".into()),
502
            &BoardQuery::default(),
503
        )
504
        .await?
505
        .into_response());
506
    }
507
    let actor = viewer.account().map(|a| a.username.clone()).unwrap_or_default();
508
    let columns = pdb::columns(&app.db, project.id).await.map_err(e)?;
509
    let column = f.column.filter(|c| columns.iter().any(|x| x.id == *c)).or(columns.first().map(|c| c.id));
510
    let mut notice = None;
511
    let mut error = None;
512
    match f.action.as_str() {
513
        "add" => {
514
            let Some(column_id) = column else { return Err(Error::bad(shell, "no column")) };
515
            if let Err(msg) =
516
                add_card(&app, viewer.account(), &owner, project.id, column_id, &f.reference, &f.repo, &f.note, &actor).await.map_err(e)?
517
            {
518
                error = Some(msg);
519
            }
520
        }
521
        "move" => {
522
            if let (Some(card), Some(col)) = (f.card, f.column) {
523
                pdb::move_card(&app.db, project.id, card, col).await.map_err(e)?;
524
            }
525
        }
526
        "up" | "down" => {
527
            if let Some(card) = f.card {
528
                pdb::shift_card(&app.db, project.id, card, if f.action == "up" { -1 } else { 1 }).await.map_err(e)?;
529
            }
530
        }
531
        "remove" => {
532
            if let Some(card) = f.card {
533
                pdb::remove_card(&app.db, project.id, card).await.map_err(e)?;
534
            }
535
        }
536
        "add_column" => {
537
            let name = f.name.trim();
538
            if name.is_empty() || name.len() > 40 {
539
                error = Some("A column has a name of up to 40 characters.".into());
540
            } else {
541
                pdb::add_column(&app.db, project.id, name).await.map_err(e)?;
542
            }
543
        }
544
        "rename_column" => {
545
            if let (Some(col), name) = (f.column, f.name.trim()) {
546
                if !name.is_empty() && name.len() <= 40 {
547
                    pdb::rename_column(&app.db, project.id, col, name).await.map_err(e)?;
548
                }
549
            }
550
        }
551
        "left" | "right" => {
552
            if let Some(col) = f.column {
553
                pdb::shift_column(&app.db, project.id, col, if f.action == "left" { -1 } else { 1 }).await.map_err(e)?;
554
            }
555
        }
556
        "remove_column" => {
557
            if let Some(col) = f.column {
558
                if !pdb::remove_column(&app.db, project.id, col).await.map_err(e)? {
559
                    error = Some("A project keeps at least one column.".into());
560
                }
561
            }
562
        }
563
        "settings" => {
564
            let title = if f.title.trim().is_empty() { project.title.clone() } else { f.title.trim().chars().take(100).collect() };
565
            pdb::set(&app.db, project.id, &title, f.description.trim(), f.private.is_none(), f.closed.is_some()).await.map_err(e)?;
566
            notice = Some("Saved.".into());
567
        }
568
        "transfer" => {
569
            let to = f.to.trim();
570
            match rights_of(&app, viewer.account(), to).await.map_err(e)? {
571
                _ if to == owner => error = Some(format!("It is {owner}'s already.")),
572
                Some(t) if t.edit => {
573
                    let moved = pdb::transfer(&app.db, project.id, to).await.map_err(e)?;
574
                    let detail = format!("{owner}/{number} to {to}/{}", moved.number);
575
                    db::accounts::audit(&app.db, viewer.account(), "project.transferred", &detail, &project.title).await.ok();
576
                    return Ok(Redirect::to(&format!("/projects/{to}/{}", moved.number)).into_response());
577
                }
578
                _ => error = Some(format!("You cannot make projects under {to}, so you cannot move this one there.")),
579
            }
580
        }
581
        "delete" => {
582
            pdb::delete(&app.db, project.id).await.map_err(e)?;
583
            db::accounts::audit(&app.db, viewer.account(), "project.deleted", &format!("{owner}/{number}"), &project.title).await.ok();
584
            return Ok(Redirect::to(&format!("/projects/{owner}")).into_response());
585
        }
586
        _ => return Err(Error::bad(shell, "unknown action")),
587
    }
588
    if notice.is_none() && error.is_none() {
589
        // Back to the board, so a reload does not repeat the action.
590
        return Ok(Redirect::to(&format!("/projects/{owner}/{number}")).into_response());
591
    }
592
    Ok(board(&app, shell, &viewer, &owner, number, notice, error, &BoardQuery::default()).await?.into_response())
593
}
594
595
/// The projects an issue or proposal is on that the viewer may see, with
596
/// their column.
597
pub async fn placements_for(app: &Shared, viewer: &Viewer, repo: &db::repos::RepoRow, number: i64) -> Vec<(pdb::Project, String)> {
598
    let Ok(all) = pdb::placements(&app.db, repo.id, number).await else { return vec![] };
599
    let mut out = Vec::new();
600
    for (p, col) in all {
601
        let visible = p.public
602
            || viewer.is_admin()
603
            || match viewer.account() {
604
                Some(v) if v.username == p.owner => true,
605
                Some(v) => match db::accounts::org_by_name(&app.db, &p.owner).await.ok().flatten() {
606
                    Some(o) => db::accounts::org_role(&app.db, o.id, v.id).await.ok().flatten().is_some(),
607
                    None => false,
608
                },
609
                None => false,
610
            };
611
        if visible {
612
            out.push((p, col));
613
        }
614
    }
615
    out
616
}
617
618
#[cfg(test)]
619
mod tests {
620
    use super::parse_reference;
621
622
    #[test]
623
    fn references() {
624
        assert_eq!(parse_reference("oxygen#12", ""), Some(("oxygen".into(), 12)));
625
        assert_eq!(parse_reference("#7", "hub"), Some(("hub".into(), 7)));
626
        assert_eq!(parse_reference(" hub # 3 ", ""), Some(("hub".into(), 3)));
627
        assert_eq!(parse_reference("#7", ""), None, "a repository is needed");
628
        assert_eq!(parse_reference("other/repo#1", ""), None, "only the owner's repositories");
629
        assert_eq!(parse_reference("hub#0", ""), None);
630
        assert_eq!(parse_reference("hub", ""), None);
631
    }
632
}
633
634
#[derive(Deserialize)]
635
pub struct PlaceForm {
636
    #[serde(rename = "_csrf")]
637
    csrf_token: String,
638
    /// The project's number among its owner's.
639
    project: i64,
640
    /// `add` or `remove`.
641
    action: String,
642
}
643
644
/// Put an issue or proposal on one of its repository owner's projects (in
645
/// the first column), or take it off, from its own page.
646
async fn place(
647
    app: Shared,
648
    viewer: Viewer,
649
    owner: String,
650
    name: String,
651
    kind: &'static str,
652
    number: i64,
653
    f: PlaceForm,
654
) -> Result<Response, Error> {
655
    let page = format!("/{owner}/{name}/{kind}/{number}");
656
    let shell = Shell::new(&app, &page, &viewer);
657
    csrf(&viewer, &f.csrf_token, &shell)?;
658
    let (_, row, _) = super::lookup(&app, &shell, &viewer, &owner, &name).await?;
659
    let r = rights(&app, &shell, &viewer, &row.owner).await?;
660
    if !r.edit {
661
        return Err(Error::not_found(shell));
662
    }
663
    let e = |e| Error::from_db(shell.clone(), e);
664
    let project = pdb::get(&app.db, &row.owner, f.project).await.map_err(e)?.ok_or_else(|| Error::not_found(shell.clone()))?;
665
    let actor = viewer.account().map(|a| a.username.clone()).unwrap_or_default();
666
    let mut error = None;
667
    match f.action.as_str() {
668
        "add" => {
669
            let columns = pdb::columns(&app.db, project.id).await.map_err(e)?;
670
            let Some(first) = columns.first() else { return Err(Error::bad(shell, "that project has no columns")) };
671
            if let Err(msg) =
672
                add_card(&app, viewer.account(), &row.owner, project.id, first.id, &format!("{}#{number}", row.name), &row.name, "", &actor)
673
                    .await
674
                    .map_err(e)?
675
            {
676
                error = Some(msg);
677
            }
678
        }
679
        "remove" => {
680
            for c in pdb::cards(&app.db, project.id).await.map_err(e)? {
681
                if c.repo_id == Some(row.id) && c.number == Some(number) {
682
                    pdb::remove_card(&app.db, project.id, c.id).await.map_err(e)?;
683
                }
684
            }
685
        }
686
        _ => return Err(Error::bad(shell, "add or remove")),
687
    }
688
    let to = match error {
689
        Some(m) => format!("{page}?error={}", super::settings::urlencode(&m)),
690
        None => page,
691
    };
692
    Ok(Redirect::to(&to).into_response())
693
}
694
695
/// `POST /{owner}/{name}/proposal/{number}/project`.
696
pub async fn place_proposal(
697
    State(app): State<Shared>,
698
    viewer: Viewer,
699
    Path((owner, name, number)): Path<(String, String, i64)>,
700
    Form(f): Form<PlaceForm>,
701
) -> Result<Response, Error> {
702
    place(app, viewer, owner, name, "proposal", number, f).await
703
}
704
705
/// `POST /{owner}/{name}/issue/{number}/project`.
706
pub async fn place_issue(
707
    State(app): State<Shared>,
708
    viewer: Viewer,
709
    Path((owner, name, number)): Path<(String, String, i64)>,
710
    Form(f): Form<PlaceForm>,
711
) -> Result<Response, Error> {
712
    place(app, viewer, owner, name, "issue", number, f).await
713
}
714
715
/// The owner's open projects `viewer` may add an item to that it is not on
716
/// yet; `None` when the viewer may not change the owner's projects at all.
717
pub async fn project_choices(
718
    app: &Shared,
719
    viewer: &Viewer,
720
    repo: &db::repos::RepoRow,
721
    placed: &[(pdb::Project, String)],
722
) -> Option<Vec<pdb::Project>> {
723
    let Ok(Some(r)) = rights_of(app, viewer.account(), &repo.owner).await else { return None };
724
    if !r.edit {
725
        return None;
726
    }
727
    Some(
728
        pdb::of_owner(&app.db, &repo.owner)
729
            .await
730
            .unwrap_or_default()
731
            .into_iter()
732
            .filter(|p| !p.closed && !placed.iter().any(|(q, _)| q.id == p.id))
733
            .collect(),
734
    )
735
}