Build and enable Slack invite/approval flow on the new website RC

未关闭
#521 14 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
15/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
活跃
技术栈
python

调研方向

Start with _docs/specs/slack-invite-approval.md on the intake branch, then read the listed app-boundary, Studio/admin API, security, and selective-CI documents. The issue spans application workflows, staff capabilities, Slack join monitoring, deployment, and independent browser verification; the listed acceptance criteria and scenarios define completion. Check provider capabilities and deployment prerequisites before implementation, and report any unavailable capabilities explicitly.

由索引模型根据 Issue 内容生成。

描述

auth enhancement integration P1 security

Owner intake: be517170-c46d-41db-ac10-d0a4ebdcc924, points 1–6 and all notes t2545u (vouch), t2546u (RC enablement correction), t2547u (monitoring). The earlier no-rollout wording is superseded only for prod.datatalks.club; current live signup remains untouched.

Normative design: _docs/specs/slack-invite-approval.md on the intake branch. Relevant boundaries: _docs/architecture/app-boundaries.md, _docs/specs/06-studio-and-admin-api.md, _docs/specs/07-security-privacy-operations.md, _docs/ci/change-selective-ci.md. The new design supersedes older automatic shared-link Slack onboarding specifications for the RC.

Scope: database-owned site application/questionnaire, member invite/vouch accountability, staff approval and course auto-approval, invite graph and cascade site-access bans, one-use site redirect, join invalidation and read-only bypass monitoring; enabled RC deployment and controlled end-to-end verification. No Slack posts, real-person test invites/emails, current signup-email changes, join.datatalks.club changes, Slack settings changes, or automatic moderation by the monitor. Tests use only [email protected] recipients.

Staff management belongs to the existing capability registry and Studio/admin API parity contract. Declare five registered capabilities: application list query, application decision command, cascade website-access revocation preview query, cascade revocation confirmation command, and join report query. The separate preview must show the exact affected scope/count before the guarded confirmation. Each calls the same service through canonical Studio HTML and admin API adapters. Applicant/vouch/member self-service remains separate from staff management.

Acceptance criteria:

  • Applicants enter who they are, where they work, and what they do and see private pending/approved/joined/rejected/banned status. Newsletter subscription remains separate.
  • Active verified existing Slack members can invite or vouch through a shareable request link. The vouch page explicitly warns that they take responsibility with their own reputation, will also be banned if the applicant is a spammer, and should only vouch for people they really know. Confirmation requires authenticated POST and acknowledgement; banned/self/unverified sponsors are denied.
  • Approval is on the site; authorized reviewers can approve/reject, course participants are auto-approved from actual course-domain evidence, and banned status overrides approval.
  • Five staff capabilities (application list, application decision, cascade revocation preview, cascade revocation confirmation, join report) are registered with stable metadata and reachable through matched canonical /studio/slack/ HTML and /api/v1/admin/slack/ adapters. Preview displays the affected scope/count; confirmation rejects changed state/scope/count. Positive/negative parity tests prove identical service behavior, explicit capability permissions, redacted audit, idempotency, concurrency, and applicable confirmation/session policy. The reviewed site_admin manifest includes the two Slack permissions and existing sync_studio_roles applies them without changing group members; no implicit superuser grant or owner waiver. Self-service/vouch routes do not acquire staff API authority.
  • Persist accountable inviter/voucher chains; a site ban revokes the member and all descendants atomically and blocks further sponsorship. Describe any actual Slack deactivation limitation honestly.
  • Only approved unbanned applicants can redeem a bound opaque site redirect once atomically; GET/HEAD previews do not consume it. Joining Slack invalidates outstanding links. Raw Slack destination stays out of domain data, HTML/email/JSON/logs/reports; document unavoidable redirect-header visibility.
  • Inspect actual existing dataops-managed token scopes and workspace plan without disclosing credentials. Programmatically ingest joins idempotently where current capabilities permit, retain observed inviter evidence when available, and report website-approved/outside/unresolved joins read-only. Preserve historical baseline separately. Document every plan/scope/provider restriction and whether ingestion/attribution are live; no automatic Slack action.
  • Focused automated coverage proves cascade ban, single-use link, approval, vouch warning/acknowledgement and monitoring classification/no side effects; private responses are no-store.
  • New management resource targets use stable UUIDs in both HTML/admin API adapters and OpenAPI, without integer-route fallbacks. GET/HEAD does not mutate application approval state; later course eligibility reconciles through an explicit CSRF-protected action or enrollment-owned mutation. New mutation forms use shared accessible fields/checks/actions, linked errors and error summary, with 44px control targets. Database-backed per-actor business limits return safe rate-limit responses, and repeated same-member vouch does not duplicate audit decisions.
  • Independent tester inspects application, vouch, approval/report and denial/empty/error states at desktop and mobile sizes with screenshots; PM accepts after tester pass.
  • PR checks are green on exact head before merge; deploy and verify enabled flow on prod.datatalks.club with a controlled test applicant. Preserve current join.datatalks.club, signup emails and workspace settings.
  • Report at ~/tmp/agent-reports/2026-11-16-slack-invite-approval.md includes precise PR/commit/check/deploy/live evidence, actual provider capabilities/limitations, open questions for Alexey, and placeholder for Orin's separate banned-account findings.

Browser scenarios: new applicant submits complete questionnaire and gets pending state; known member opens shared vouch URL, reads warning, explicitly acknowledges and confirms; banned/self sponsor gets safe denial; course participant gets approved without sponsorship; authorized reviewer approves/rejects pending request; approved applicant redeems once and replay fails; join observation invalidates unused link; operator sees outside-flow and unknown-inviter rows without monitor-driven moderation. Verify responsive layout at desktop/mobile and no private data/credential exposure.

Management scenarios: authorized staff reaches application list/decisions/report/revocation from Studio; corresponding bearer-scoped admin API operations produce matching results and safe denials. A principal lacking the capability cannot read private questionnaire/report data or mutate approvals/bans. Stale/replayed commands follow declared concurrency/idempotency policy and do not duplicate business side effects. Cascade confirmation shows expected scope; audit never contains raw questionnaire text, email or Slack destination.

Dependencies: existing verified account identity and current course-domain participation; existing provider credentials and deployment authority. Unavailable API capabilities must be reported as explicit gaps rather than guessed. Orin's analysis is independent and does not block bounded implementation.

主要语言
Python
星标
0
派生
0
平均合并
37 分钟
30 天内合并 PR
36

环境准备

  • 提供 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 没有贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

DataTalksClub/website 的其他 Issue

查看 DataTalksClub/website 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。