Add detailed admin portal flow doc#8
Open
SheeladityaVinayKumar wants to merge 8 commits into
Open
Conversation
Document the V1 admin flow: login, full college setup (details + images), and managing student and alumni records. Capabilities tagged [V1] vs [Later]; open items kept as TODOs linked to research.md. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
SheeladityaVinayKumar
requested review from
ashutosh-pokhriyal23 and
pphulara
and removed request for
pphulara
June 12, 2026 09:53
Embed a GitHub-rendered flowchart at the top of the doc (login, college setup, manage alumni/student records). Keep the ASCII version in a collapsible details block as a text fallback. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
7 tasks
A student automatically becomes an alumnus when their batch/session completes; no manual admin step. Resolve the related TODO and update the roles table, flowchart, and open-questions list. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Admins do not self-register; the research team provisions each college and provides the admin login credentials for V1. Reflect this in both the Login section and the flowchart. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Drop the role-routing and tenant-existence branches (research team provisions the college, so it always exists at login). Redesign the flowchart with numbered phases, a legend, and rules baked into nodes so it reads on its own. Rewrite the Login section to match. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Add a title banner, switch slanted note shapes to rectangles so text no longer clips, label the entry Login / Signup, mark account creation as not-yet-decided (research team's work), and complete the batch-transition label. Align the Login section text to match. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Break the 'becomes an Alumnus' and 'Later' nodes onto multiple lines so the boxes grow taller and the full text shows instead of clipping. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Self-submitted student/alumni details now go through an admin review step (submit -> review -> live) instead of going live automatically. Mark the exact details/fields collected as not-yet-decided, pending research. Reflect both in the flowchart and the §4 text. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds
docs/admin-portal-flow.md— a detailed, step-by-step flow for the admin portal, the V1 primary surface (college / TPO is the primary V1 user perarchitecture.md).Contents
architecture.md.Conventions followed
[V1]vs[Later]tags throughout; open decisions kept asTODOs linked toresearch.md(auth, verification, data source, data model, student→alumni transition).docs/.🤖 Generated with Claude Code