OXYGENHUB
# 36e5a9c15a84 oxygenhub / crates / hub / src / web / projects.rs
20.7 KiB · Rust · last changed Proposal page: centred timeline with avatars, inline editing, labels and projects 1 month 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, 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
    projects: Vec<pdb::Project>,
53
    can_edit: bool,
54
    error: Option<String>,
55
}
56
57
pub async fn list(State(app): State<Shared>, viewer: Viewer, Path(owner): Path<String>) -> Result<Page<ProjectsPage>, Error> {
58
    let shell = Shell::new(&app, &format!("/projects/{owner}"), &viewer);
59
    let r = rights(&app, &shell, &viewer, &owner).await?;
60
    let projects = pdb::of_owner(&app.db, &owner)
61
        .await
62
        .map_err(|e| Error::from_db(shell.clone(), e))?
63
        .into_iter()
64
        .filter(|p| p.public || r.member)
65
        .collect();
66
    Ok(Page(ProjectsPage { shell, owner, projects, can_edit: r.edit, error: None }))
67
}
68
69
#[derive(Deserialize)]
70
pub struct NewProjectForm {
71
    #[serde(rename = "_csrf")]
72
    csrf_token: String,
73
    title: String,
74
    #[serde(default)]
75
    description: String,
76
    #[serde(default)]
77
    private: Option<String>,
78
}
79
80
pub async fn create(
81
    State(app): State<Shared>,
82
    viewer: Viewer,
83
    Path(owner): Path<String>,
84
    Form(f): Form<NewProjectForm>,
85
) -> Result<Response, Error> {
86
    let shell = Shell::new(&app, &format!("/projects/{owner}"), &viewer);
87
    csrf(&viewer, &f.csrf_token, &shell)?;
88
    let r = rights(&app, &shell, &viewer, &owner).await?;
89
    if !r.edit {
90
        return Err(Error::not_found(shell));
91
    }
92
    let title = f.title.trim();
93
    if title.is_empty() || title.len() > 100 {
94
        let projects = pdb::of_owner(&app.db, &owner).await.map_err(|e| Error::from_db(shell.clone(), e))?;
95
        return Ok(Page(ProjectsPage {
96
            shell,
97
            owner,
98
            projects,
99
            can_edit: true,
100
            error: Some("A project needs a title of up to 100 characters.".into()),
101
        })
102
        .into_response());
103
    }
104
    let p = pdb::create(&app.db, &owner, title, f.description.trim(), f.private.is_none())
105
        .await
106
        .map_err(|e| Error::from_db(shell.clone(), e))?;
107
    db::accounts::audit(&app.db, viewer.account(), "project.created", &format!("{owner}/{}", p.number), title).await.ok();
108
    Ok(Redirect::to(&format!("/projects/{owner}/{}", p.number)).into_response())
109
}
110
111
/// A card as the board shows it.
112
pub struct CardView {
113
    pub card: pdb::Card,
114
    /// `owner/name#N`, for issue and proposal cards.
115
    pub reference: String,
116
    pub url: String,
117
    pub title: String,
118
    /// `open`, `closed`, `landed`, `draft`… for issues and proposals.
119
    pub state: String,
120
}
121
122
pub struct ColumnView {
123
    pub column: pdb::Column,
124
    pub cards: Vec<CardView>,
125
}
126
127
#[derive(Template)]
128
#[template(path = "project.html")]
129
pub struct BoardPage {
130
    shell: Shell,
131
    project: pdb::Project,
132
    columns: Vec<ColumnView>,
133
    /// The owner's repositories the viewer can read, for adding cards.
134
    repos: Vec<String>,
135
    /// Changes cards and columns (an open project).
136
    can_edit: bool,
137
    /// Changes the settings (to reopen a closed project too).
138
    can_manage: bool,
139
    notice: Option<String>,
140
    error: Option<String>,
141
}
142
143
async fn board(
144
    app: &Shared,
145
    shell: Shell,
146
    viewer: &Viewer,
147
    owner: &str,
148
    number: i64,
149
    notice: Option<String>,
150
    error: Option<String>,
151
) -> Result<Page<BoardPage>, Error> {
152
    let e = |e| Error::from_db(shell.clone(), e);
153
    let r = rights(app, &shell, viewer, owner).await?;
154
    let project = pdb::get(&app.db, owner, number)
155
        .await
156
        .map_err(e)?
157
        .filter(|p| p.public || r.member)
158
        .ok_or_else(|| Error::not_found(shell.clone()))?;
159
    let (columns, repos) = board_columns(app, viewer.account(), owner, &project).await.map_err(e)?;
160
    let can_edit = r.edit && !project.closed;
161
    Ok(Page(BoardPage { shell, project, columns, repos, can_edit, can_manage: r.edit, notice, error }))
162
}
163
164
/// A project's columns with the cards `account` may see, and the owner's
165
/// repositories it can read (for adding cards).
166
pub async fn board_columns(
167
    app: &Shared,
168
    account: Option<&db::accounts::Account>,
169
    owner: &str,
170
    project: &pdb::Project,
171
) -> sqlx::Result<(Vec<ColumnView>, Vec<String>)> {
172
    let mut readable: std::collections::HashMap<i64, db::repos::RepoRow> = Default::default();
173
    for row in db::repos::list_by_owner(&app.db, owner).await? {
174
        let role = roles::role_for(&app.db, account, &row).await?;
175
        if roles::allows(role, Access::Read) {
176
            readable.insert(row.id, row);
177
        }
178
    }
179
    let cards = pdb::cards(&app.db, project.id).await?;
180
    let mut columns = Vec::new();
181
    for column in pdb::columns(&app.db, project.id).await? {
182
        let mut views = Vec::new();
183
        for card in cards.iter().filter(|c| c.column_id == column.id) {
184
            match (card.kind.as_str(), card.repo_id, card.number) {
185
                ("note", _, _) => views.push(CardView {
186
                    card: card.clone(),
187
                    reference: String::new(),
188
                    url: String::new(),
189
                    title: card.note.clone(),
190
                    state: String::new(),
191
                }),
192
                (kind, Some(rid), Some(n)) => {
193
                    // Cards of repositories the viewer cannot read are not shown at all.
194
                    let Some(row) = readable.get(&rid) else { continue };
195
                    let (title, state) = if kind == "issue" {
196
                        match db::issues::get(&app.db, rid, n).await? {
197
                            Some(i) => (i.title, i.state),
198
                            None => continue,
199
                        }
200
                    } else {
201
                        match db::proposals::get(&app.db, rid, n).await? {
202
                            Some(p) => (p.title, p.state),
203
                            None => continue,
204
                        }
205
                    };
206
                    let slug = format!("{}/{}", row.owner, row.name);
207
                    views.push(CardView {
208
                        card: card.clone(),
209
                        reference: format!("{slug}#{n}"),
210
                        url: format!("/{slug}/{kind}/{n}"),
211
                        title,
212
                        state,
213
                    });
214
                }
215
                _ => {}
216
            }
217
        }
218
        columns.push(ColumnView { column, cards: views });
219
    }
220
    let mut repos: Vec<String> = readable.values().map(|r| r.name.clone()).collect();
221
    repos.sort();
222
    Ok((columns, repos))
223
}
224
225
pub async fn show(State(app): State<Shared>, viewer: Viewer, Path((owner, number)): Path<(String, i64)>) -> Result<Page<BoardPage>, Error> {
226
    let shell = Shell::new(&app, &format!("/projects/{owner}/{number}"), &viewer);
227
    board(&app, shell, &viewer, &owner, number, None, None).await
228
}
229
230
#[derive(Deserialize)]
231
pub struct BoardForm {
232
    #[serde(rename = "_csrf")]
233
    csrf_token: String,
234
    action: String,
235
    #[serde(default)]
236
    card: Option<i64>,
237
    #[serde(default)]
238
    column: Option<i64>,
239
    #[serde(default)]
240
    name: String,
241
    /// `repo#12`, or `#12` with `repo`.
242
    #[serde(default)]
243
    reference: String,
244
    #[serde(default)]
245
    repo: String,
246
    #[serde(default)]
247
    note: String,
248
    #[serde(default)]
249
    title: String,
250
    #[serde(default)]
251
    description: String,
252
    #[serde(default)]
253
    private: Option<String>,
254
    #[serde(default)]
255
    closed: Option<String>,
256
}
257
258
/// `repo#12` or `#12` (with a repository chosen) to (repository, number).
259
fn parse_reference(reference: &str, repo: &str) -> Option<(String, i64)> {
260
    let r = reference.trim();
261
    let (name, n) = r.split_once('#')?;
262
    let name = if name.is_empty() { repo.trim() } else { name.trim() };
263
    let n: i64 = n.trim().parse().ok()?;
264
    (!name.is_empty() && n > 0 && !name.contains('/')).then(|| (name.to_string(), n))
265
}
266
267
/// Add a note, or the issue or proposal `reference` names (`repo#12`, or
268
/// `#12` with `repo`), to a column. `Ok(Err(why))` for what the caller
269
/// should be told: an unknown repository or number, or a card already there.
270
#[allow(clippy::too_many_arguments)]
271
pub async fn add_card(
272
    app: &Shared,
273
    account: Option<&db::accounts::Account>,
274
    owner: &str,
275
    project_id: i64,
276
    column_id: i64,
277
    reference: &str,
278
    repo: &str,
279
    note: &str,
280
    actor: &str,
281
) -> sqlx::Result<Result<pdb::Card, String>> {
282
    if !note.trim().is_empty() {
283
        let note: String = note.trim().chars().take(500).collect();
284
        pdb::add_card(
285
            &app.db,
286
            project_id,
287
            pdb::NewCard { column_id, kind: "note", repo_id: None, number: None, note: &note, added_by: actor },
288
        )
289
        .await?;
290
        return Ok(Ok(newest_card(app, project_id).await?));
291
    }
292
    let Some((repo, n)) = parse_reference(reference, repo) else {
293
        return Ok(Err("Name an issue or proposal as repo#12, or write a note.".into()));
294
    };
295
    let Some(row) = db::repos::get(&app.db, owner, &repo).await? else { return Ok(Err(format!("{owner} has no repository {repo}."))) };
296
    let role = roles::role_for(&app.db, account, &row).await?;
297
    let (issues, proposals) = db::issues::numbers(&app.db, row.id).await?;
298
    let kind = if issues.contains(&n) {
299
        "issue"
300
    } else if proposals.contains(&n) {
301
        "proposal"
302
    } else {
303
        return Ok(Err(format!("{repo} has no issue or proposal #{n}.")));
304
    };
305
    if !roles::allows(role, Access::Read) {
306
        return Ok(Err(format!("{repo} has no issue or proposal #{n}.")));
307
    }
308
    if !pdb::add_card(
309
        &app.db,
310
        project_id,
311
        pdb::NewCard { column_id, kind, repo_id: Some(row.id), number: Some(n), note: "", added_by: actor },
312
    )
313
    .await?
314
    {
315
        return Ok(Err(format!("{repo}#{n} is already on this project.")));
316
    }
317
    Ok(Ok(newest_card(app, project_id).await?))
318
}
319
320
async fn newest_card(app: &Shared, project_id: i64) -> sqlx::Result<pdb::Card> {
321
    sqlx::query_as("SELECT * FROM project_cards WHERE project_id = ? ORDER BY id DESC LIMIT 1").bind(project_id).fetch_one(&app.db).await
322
}
323
324
pub async fn act(
325
    State(app): State<Shared>,
326
    viewer: Viewer,
327
    Path((owner, number)): Path<(String, i64)>,
328
    Form(f): Form<BoardForm>,
329
) -> Result<Response, Error> {
330
    let shell = Shell::new(&app, &format!("/projects/{owner}/{number}"), &viewer);
331
    csrf(&viewer, &f.csrf_token, &shell)?;
332
    let r = rights(&app, &shell, &viewer, &owner).await?;
333
    let e = |e| Error::from_db(shell.clone(), e);
334
    let project = pdb::get(&app.db, &owner, number)
335
        .await
336
        .map_err(e)?
337
        .filter(|p| p.public || r.member)
338
        .ok_or_else(|| Error::not_found(shell.clone()))?;
339
    if !r.edit {
340
        return Err(Error::not_found(shell));
341
    }
342
    if project.closed && !matches!(f.action.as_str(), "settings" | "delete") {
343
        return Ok(board(&app, shell, &viewer, &owner, number, None, Some("This project is closed; reopen it to change it.".into()))
344
            .await?
345
            .into_response());
346
    }
347
    let actor = viewer.account().map(|a| a.username.clone()).unwrap_or_default();
348
    let columns = pdb::columns(&app.db, project.id).await.map_err(e)?;
349
    let column = f.column.filter(|c| columns.iter().any(|x| x.id == *c)).or(columns.first().map(|c| c.id));
350
    let mut notice = None;
351
    let mut error = None;
352
    match f.action.as_str() {
353
        "add" => {
354
            let Some(column_id) = column else { return Err(Error::bad(shell, "no column")) };
355
            if let Err(msg) =
356
                add_card(&app, viewer.account(), &owner, project.id, column_id, &f.reference, &f.repo, &f.note, &actor).await.map_err(e)?
357
            {
358
                error = Some(msg);
359
            }
360
        }
361
        "move" => {
362
            if let (Some(card), Some(col)) = (f.card, f.column) {
363
                pdb::move_card(&app.db, project.id, card, col).await.map_err(e)?;
364
            }
365
        }
366
        "up" | "down" => {
367
            if let Some(card) = f.card {
368
                pdb::shift_card(&app.db, project.id, card, if f.action == "up" { -1 } else { 1 }).await.map_err(e)?;
369
            }
370
        }
371
        "remove" => {
372
            if let Some(card) = f.card {
373
                pdb::remove_card(&app.db, project.id, card).await.map_err(e)?;
374
            }
375
        }
376
        "add_column" => {
377
            let name = f.name.trim();
378
            if name.is_empty() || name.len() > 40 {
379
                error = Some("A column has a name of up to 40 characters.".into());
380
            } else {
381
                pdb::add_column(&app.db, project.id, name).await.map_err(e)?;
382
            }
383
        }
384
        "rename_column" => {
385
            if let (Some(col), name) = (f.column, f.name.trim()) {
386
                if !name.is_empty() && name.len() <= 40 {
387
                    pdb::rename_column(&app.db, project.id, col, name).await.map_err(e)?;
388
                }
389
            }
390
        }
391
        "left" | "right" => {
392
            if let Some(col) = f.column {
393
                pdb::shift_column(&app.db, project.id, col, if f.action == "left" { -1 } else { 1 }).await.map_err(e)?;
394
            }
395
        }
396
        "remove_column" => {
397
            if let Some(col) = f.column {
398
                if !pdb::remove_column(&app.db, project.id, col).await.map_err(e)? {
399
                    error = Some("A project keeps at least one column.".into());
400
                }
401
            }
402
        }
403
        "settings" => {
404
            let title = if f.title.trim().is_empty() { project.title.clone() } else { f.title.trim().chars().take(100).collect() };
405
            pdb::set(&app.db, project.id, &title, f.description.trim(), f.private.is_none(), f.closed.is_some()).await.map_err(e)?;
406
            notice = Some("Saved.".into());
407
        }
408
        "delete" => {
409
            pdb::delete(&app.db, project.id).await.map_err(e)?;
410
            db::accounts::audit(&app.db, viewer.account(), "project.deleted", &format!("{owner}/{number}"), &project.title).await.ok();
411
            return Ok(Redirect::to(&format!("/projects/{owner}")).into_response());
412
        }
413
        _ => return Err(Error::bad(shell, "unknown action")),
414
    }
415
    if notice.is_none() && error.is_none() {
416
        // Back to the board, so a reload does not repeat the action.
417
        return Ok(Redirect::to(&format!("/projects/{owner}/{number}")).into_response());
418
    }
419
    Ok(board(&app, shell, &viewer, &owner, number, notice, error).await?.into_response())
420
}
421
422
/// The projects an issue or proposal is on that the viewer may see, with
423
/// their column.
424
pub async fn placements_for(app: &Shared, viewer: &Viewer, repo: &db::repos::RepoRow, number: i64) -> Vec<(pdb::Project, String)> {
425
    let Ok(all) = pdb::placements(&app.db, repo.id, number).await else { return vec![] };
426
    let mut out = Vec::new();
427
    for (p, col) in all {
428
        let visible = p.public
429
            || viewer.is_admin()
430
            || match viewer.account() {
431
                Some(v) if v.username == p.owner => true,
432
                Some(v) => match db::accounts::org_by_name(&app.db, &p.owner).await.ok().flatten() {
433
                    Some(o) => db::accounts::org_role(&app.db, o.id, v.id).await.ok().flatten().is_some(),
434
                    None => false,
435
                },
436
                None => false,
437
            };
438
        if visible {
439
            out.push((p, col));
440
        }
441
    }
442
    out
443
}
444
445
#[cfg(test)]
446
mod tests {
447
    use super::parse_reference;
448
449
    #[test]
450
    fn references() {
451
        assert_eq!(parse_reference("oxygen#12", ""), Some(("oxygen".into(), 12)));
452
        assert_eq!(parse_reference("#7", "hub"), Some(("hub".into(), 7)));
453
        assert_eq!(parse_reference(" hub # 3 ", ""), Some(("hub".into(), 3)));
454
        assert_eq!(parse_reference("#7", ""), None, "a repository is needed");
455
        assert_eq!(parse_reference("other/repo#1", ""), None, "only the owner's repositories");
456
        assert_eq!(parse_reference("hub#0", ""), None);
457
        assert_eq!(parse_reference("hub", ""), None);
458
    }
459
}
460
461
#[derive(Deserialize)]
462
pub struct PlaceForm {
463
    #[serde(rename = "_csrf")]
464
    csrf_token: String,
465
    /// The project's number among its owner's.
466
    project: i64,
467
    /// `add` or `remove`.
468
    action: String,
469
}
470
471
/// Put an issue or proposal on one of its repository owner's projects (in
472
/// the first column), or take it off, from its own page.
473
async fn place(
474
    app: Shared,
475
    viewer: Viewer,
476
    owner: String,
477
    name: String,
478
    kind: &'static str,
479
    number: i64,
480
    f: PlaceForm,
481
) -> Result<Response, Error> {
482
    let page = format!("/{owner}/{name}/{kind}/{number}");
483
    let shell = Shell::new(&app, &page, &viewer);
484
    csrf(&viewer, &f.csrf_token, &shell)?;
485
    let (_, row, _) = super::lookup(&app, &shell, &viewer, &owner, &name).await?;
486
    let r = rights(&app, &shell, &viewer, &row.owner).await?;
487
    if !r.edit {
488
        return Err(Error::not_found(shell));
489
    }
490
    let e = |e| Error::from_db(shell.clone(), e);
491
    let project = pdb::get(&app.db, &row.owner, f.project).await.map_err(e)?.ok_or_else(|| Error::not_found(shell.clone()))?;
492
    let actor = viewer.account().map(|a| a.username.clone()).unwrap_or_default();
493
    let mut error = None;
494
    match f.action.as_str() {
495
        "add" => {
496
            let columns = pdb::columns(&app.db, project.id).await.map_err(e)?;
497
            let Some(first) = columns.first() else { return Err(Error::bad(shell, "that project has no columns")) };
498
            if let Err(msg) =
499
                add_card(&app, viewer.account(), &row.owner, project.id, first.id, &format!("{}#{number}", row.name), &row.name, "", &actor)
500
                    .await
501
                    .map_err(e)?
502
            {
503
                error = Some(msg);
504
            }
505
        }
506
        "remove" => {
507
            for c in pdb::cards(&app.db, project.id).await.map_err(e)? {
508
                if c.repo_id == Some(row.id) && c.number == Some(number) {
509
                    pdb::remove_card(&app.db, project.id, c.id).await.map_err(e)?;
510
                }
511
            }
512
        }
513
        _ => return Err(Error::bad(shell, "add or remove")),
514
    }
515
    let to = match error {
516
        Some(m) => format!("{page}?error={}", super::settings::urlencode(&m)),
517
        None => page,
518
    };
519
    Ok(Redirect::to(&to).into_response())
520
}
521
522
/// `POST /{owner}/{name}/proposal/{number}/project`.
523
pub async fn place_proposal(
524
    State(app): State<Shared>,
525
    viewer: Viewer,
526
    Path((owner, name, number)): Path<(String, String, i64)>,
527
    Form(f): Form<PlaceForm>,
528
) -> Result<Response, Error> {
529
    place(app, viewer, owner, name, "proposal", number, f).await
530
}
531
532
/// `POST /{owner}/{name}/issue/{number}/project`.
533
pub async fn place_issue(
534
    State(app): State<Shared>,
535
    viewer: Viewer,
536
    Path((owner, name, number)): Path<(String, String, i64)>,
537
    Form(f): Form<PlaceForm>,
538
) -> Result<Response, Error> {
539
    place(app, viewer, owner, name, "issue", number, f).await
540
}
541
542
/// The owner's open projects `viewer` may add an item to that it is not on
543
/// yet; `None` when the viewer may not change the owner's projects at all.
544
pub async fn project_choices(
545
    app: &Shared,
546
    viewer: &Viewer,
547
    repo: &db::repos::RepoRow,
548
    placed: &[(pdb::Project, String)],
549
) -> Option<Vec<pdb::Project>> {
550
    let Ok(Some(r)) = rights_of(app, viewer.account(), &repo.owner).await else { return None };
551
    if !r.edit {
552
        return None;
553
    }
554
    Some(
555
        pdb::of_owner(&app.db, &repo.owner)
556
            .await
557
            .unwrap_or_default()
558
            .into_iter()
559
            .filter(|p| !p.closed && !placed.iter().any(|(q, _)| q.id == p.id))
560
            .collect(),
561
    )
562
}