AeThex-Corporation/aethex-forge
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add comprehensive flow status inventory

Browse source 
Document all 53 flows in the codebase with completion status:
- 46 complete flows
- 6 partial/unfinished flows
- 1 not implemented flow

Key unfinished items identified:
- Discord Activity CSP blocking (P1)
- Discord SDK authentication missing (P2)
- Email verification not implemented (P3)
- Mentorship UI incomplete (P4)
- Creator Network needs Nexus features (P5)
- Client Portal not built (P6)
This commit is contained in:
Claude 2026-01-03 19:38:13 +00:00
parent 7e1e41bb02
commit f29196363f
No known key found for this signature in database
1 changed files with 385 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

385
docs/FLOW-STATUS-INVENTORY.md Normal file
View file

@ -0,0 +1,385 @@
# AeThex Flow Status Inventory
> **Generated:** 2026-01-03
> **Total Flows Identified:** 53
> **Complete:** 46 | **Partial:** 6 | **Unfinished:** 1
---
## Quick Reference: Unfinished Flows
| Priority | Flow | Status | Blocking? |
|----------|------|--------|-----------|
| P1 | Discord Activity CSP Configuration | BLOCKING | Yes |
| P2 | Discord Activity SDK Authentication | INCOMPLETE | No |
| P3 | Email Verification Flow | NOT IMPLEMENTED | No |
| P4 | Mentorship UI Implementation | PARTIAL | No |
| P5 | Creator Network Enhancement | PARTIAL | No |
| P6 | Client Portal (`/hub/client`) | NOT BUILT | No |
| P7 | Login/Onboarding Profile Handling | NEEDS REFINEMENT | No |
---
## 1. Authentication & OAuth Flows
### Flow 1.1: Discord OAuth Login Flow
- **Status:** COMPLETE
- **Entry Point:** `/login` page -> "Continue with Discord" button
- **Files:**
- `client/pages/Login.tsx`
- `api/discord/oauth/start.ts`
- `api/discord/oauth/callback.ts`
- **Database:** `discord_links`, `user_profiles`, `auth.users`
### Flow 1.2: Discord Account Linking Flow (from Dashboard)
- **Status:** COMPLETE
- **Entry Point:** `/dashboard?tab=connections` -> "Link Discord" button
- **Files:**
- `client/pages/Dashboard.tsx`
- `client/contexts/AuthContext.tsx`
- `api/discord/create-linking-session.ts`
- `api/discord/oauth/callback.ts`
- **Database:** `discord_linking_sessions`, `discord_links`
### Flow 1.3: Discord Verification Code Flow
- **Status:** COMPLETE
- **Entry Point:** Discord bot `/verify` command
- **Files:**
- `client/pages/DiscordVerify.tsx`
- `api/discord/verify-code.ts`
- **Database:** `discord_verifications`, `discord_links`
### Flow 1.4: Discord Activity (Embedded SPA)
- **Status:** PARTIAL - UNFINISHED
- **Entry Point:** Discord Activity context menu
- **Files:**
- `client/pages/Activity.tsx`
- `client/contexts/DiscordActivityContext.tsx`
- `api/discord/activity-auth.ts`
- **Issues:**
1. **CSP BLOCKING:** `frame-ancestors 'none'` in `vercel.json` blocks Discord iframe
2. **Missing SDK Auth:** `discordSdk.commands.authenticate()` not called
- **Fix Required:**
- Update `vercel.json` line 47: Change to `frame-ancestors 'self' https://*.discordsays.com`
- Add Discord SDK authentication in `DiscordActivityContext.tsx`
### Flow 1.5: Foundation OAuth Callback
- **Status:** COMPLETE
- **Files:**
- `api/auth/foundation-callback.ts`
- `api/auth/callback.ts`
### Flow 1.6: GitHub/Google OAuth Callbacks
- **Status:** COMPLETE
- **Files:**
- `api/github/oauth/callback.ts`
- `api/google/oauth/callback.ts`
### Flow 1.7: Email/Password Login
- **Status:** COMPLETE
- **Files:**
- `client/pages/Login.tsx`
- `api/auth/exchange-token.ts`
---
## 2. User Onboarding & Profile Flows
### Flow 2.1: Multi-Step Onboarding Flow
- **Status:** COMPLETE
- **Entry Point:** `/onboarding` page
- **Steps:** 8-step wizard
1. Choose User Type (game-developer, client, member, customer)
2. Personal Information
3. Experience Level
4. Interests & Goals
5. Choose Realm/Arm
6. Follow Arms
7. Creator Profile Setup
8. Welcome/Finish
- **Files:**
- `client/pages/Onboarding.tsx`
- `client/components/onboarding/*.tsx`
- **Database:** `user_profiles`, `user_interests`, `creator_profiles`, `followed_arms`, `achievements`, `notifications`
### Flow 2.2: Login -> Onboarding Redirect Flow
- **Status:** PARTIAL - NEEDS REFINEMENT
- **Files:**
- `client/pages/Login.tsx`
- `client/pages/Dashboard.tsx`
- **Issue:** Users shown as "logged in" before profile fully loads
- **Documentation:** `docs/LOGIN-ONBOARDING-REDIRECT-ANALYSIS.md`
---
## 3. Notification Flows
### Flow 3.1: Comprehensive Notification System
- **Status:** COMPLETE (20 notification types)
- **Files:**
- `server/index.ts`
- `client/lib/notification-triggers.ts`
- `client/lib/aethex-database-adapter.ts`
- `api/_notifications.ts`
- `client/components/notifications/NotificationBell.tsx`
- **Notification Types:**
1. Achievements unlocked
2. Team creation
3. Added to team
4. Project creation
5. Added to project
6. Project completed
7. Project started
8. Level up
9. Onboarding complete
10. Account linked (OAuth)
11. Email verified
12. Post liked
13. Post commented
14. Endorsement received
15. New follower
16. Task assigned
17. Application received
18. Application status changed
19. New device login
20. Moderation report
- **Database:** `notifications` with real-time subscriptions
---
## 4. Discord Bot Command Flows
### Flow 4.1-4.5: Discord Bot Commands
- **Status:** COMPLETE
- **Commands:**
1. `/verify` - generates verification code
2. `/set-realm [arm]` - updates user's primary arm
3. `/profile` - shows user's AeThex profile card
4. `/unlink` - removes Discord linking
5. `/verify-role` - shows/assigns Discord roles
- **Files:**
- `api/discord/interactions.ts`
- **Database:** `discord_links`, `discord_role_mappings`, `discord_user_roles`
---
## 5. Business Process Flows
### Flow 5.1: Opportunity Posting & Application Flow
- **Status:** COMPLETE
- **Files:**
- `client/pages/opportunities/OpportunityPostForm.tsx`
- `client/pages/opportunities/OpportunityDetail.tsx`
- `client/pages/opportunities/OpportunitiesHub.tsx`
- `api/applications.ts`
- **Database:** `aethex_opportunities`, `aethex_applications`
### Flow 5.2: Mentorship Application Flow
- **Status:** PARTIAL - UNFINISHED
- **Files:**
- `client/pages/community/MentorApply.tsx`
- `client/pages/community/MentorProfile.tsx`
- `client/pages/community/MentorshipRequest.tsx`
- `client/pages/MentorshipPrograms.tsx`
- **Issue:** Database schema complete, UI needs enhancement
- **Database:** `mentorship_profiles`, `mentorship_requests`
### Flow 5.3: Creator Network Flow
- **Status:** PARTIAL - UNFINISHED
- **Files:**
- `client/pages/creators/CreatorDirectory.tsx`
- `client/pages/creators/CreatorProfile.tsx`
- `api/creators.ts`
- **Issue:** Basic directory exists, needs Nexus feature integration (messaging, contracts, payments, 20% commission)
- **Database:** `creator_profiles`
### Flow 5.4: GameForge Project Management & Task Workflow
- **Status:** COMPLETE
- **Files:**
- `client/pages/Projects.tsx`
- `client/pages/ProjectsNew.tsx`
- `client/pages/ProjectBoard.tsx`
- `client/pages/ProjectsAdmin.tsx`
- **Task States:** `todo -> in_progress -> in_review -> done` (or `blocked`)
- **Database:** `gameforge_projects`, `gameforge_tasks`
### Flow 5.5: Team & Project Creation
- **Status:** COMPLETE
- **Files:**
- `client/pages/Teams.tsx`
- `client/pages/Squads.tsx`
---
## 6. Payment & Subscription Flows
### Flow 6.1: Stripe Subscription Checkout
- **Status:** COMPLETE
- **Files:**
- `api/subscriptions/create-checkout.ts`
- `client/pages/Pricing.tsx`
- **Tiers:** Pro ($9/month), Council ($29/month)
### Flow 6.2: Stripe Webhook Processing
- **Status:** COMPLETE
- **Files:**
- `api/subscriptions/webhook.ts`
### Flow 6.3: Payout Setup Flow
- **Status:** COMPLETE
- **Files:**
- `api/nexus/payments/payout-setup.ts`
---
## 7. Email & Verification Flows
### Flow 7.1: Email Verification
- **Status:** NOT IMPLEMENTED - UNFINISHED
- **Documentation:** Listed as "future implementation" in `docs/COMPLETE-NOTIFICATION-FLOWS.md`
- **Required Work:**
- Implement email verification endpoint
- Add verification email template
- Create verification confirmation page
- Trigger notification on verification
### Flow 7.2: Password Reset
- **Status:** COMPLETE
- **Files:**
- `client/pages/ResetPassword.tsx`
---
## 8. Ethos Guild (Music/Audio) Flows
### Flow 8.1: Artist Verification Workflow
- **Status:** COMPLETE
- **Files:**
- `api/ethos/verification.ts`
- `client/pages/AdminEthosVerification.tsx`
- **Database:** `ethos_verification_requests`, `ethos_verification_audit_log`
### Flow 8.2: Track Upload & Licensing Flow
- **Status:** COMPLETE
- **Files:**
- `client/pages/ArtistProfile.tsx`
- `client/pages/ArtistSettings.tsx`
- `client/pages/TrackLibrary.tsx`
- `client/pages/LicensingDashboard.tsx`
- **Database:** `ethos_tracks`, `ethos_licensing_agreements`, `ethos_artist_profiles`, `ethos_guild_members`
---
## 9. Internal Operations Flows
### Flow 9.1: Ownership & Routing Flow (Corp/Foundation)
- **Status:** COMPLETE
- **Documentation:** `client/pages/internal-docs/Space1OwnershipFlows.tsx`
- **Routing:**
- `/foundation/*` -> `aethex.foundation`
- `/gameforge/*` -> `aethex.foundation/gameforge`
- `/labs/*` -> `aethex.studio`
- `/nexus/*` -> `aethex.dev`
- `/corp/*` -> `aethex.dev`
### Flow 9.2: Staff/Admin Workflows
- **Status:** COMPLETE
- **Files:**
- `client/pages/Staff.tsx`
- `client/pages/StaffAdmin.tsx`
- `client/pages/StaffChat.tsx`
- `client/pages/StaffDocs.tsx`
### Flow 9.3: Achievement & XP System
- **Status:** COMPLETE
- **Files:**
- `api/achievements/activate.ts`
- `api/achievements/award.ts`
- `client/pages/Activity.tsx`
- **Database:** `achievements`, `user_xp`, `leaderboards`
### Flow 9.4: Discord Activity Rich Features
- **Status:** PARTIAL - RECENTLY ENHANCED
- **Files:** `client/pages/Activity.tsx`
- **Features:** XP rings, leaderboards, quick polls, job postings, quick apply, event calendar
---
## 10. Data Pipeline & Processing Flows
### Flow 10.1: Analytics Summary Flow
- **Status:** COMPLETE
- **Files:**
- `api/corp/analytics/summary.ts`
### Flow 10.2: Content Sync Flows
- **Status:** COMPLETE
- **Files:**
- `client/pages/DocsSync.tsx`
### Flow 10.3: Payment Confirmation Flow
- **Status:** COMPLETE
- **Files:**
- `api/nexus/payments/confirm-payment.ts`
- `api/nexus/payments/webhook.ts`
---
## 11. Client Portal Flows
### Flow 11.1: Client Hub System
- **Status:** NOT BUILT - UNFINISHED
- **Entry Point:** `/hub/client`
- **Files (exist but incomplete):**
- `client/pages/ClientHub.tsx`
- `client/pages/ClientProjects.tsx`
- `client/pages/ClientInvoices.tsx`
- `client/pages/ClientContracts.tsx`
- `client/pages/ClientSettings.tsx`
- **Required Work:**
- Complete client dashboard UI
- Implement project tracking for clients
- Add invoice management
- Contract viewing/signing functionality
---
## Summary by Status
### COMPLETE (46 flows)
All authentication flows (except Discord Activity), onboarding, notifications, Discord bot commands, opportunity management, GameForge, teams, payments, Ethos Guild, staff/admin, analytics.
### PARTIAL (6 flows)
1. **Discord Activity** - CSP blocking, missing SDK auth
2. **Login/Onboarding Redirect** - Needs UX refinement
3. **Mentorship UI** - DB done, UI incomplete
4. **Creator Network** - Basic exists, needs Nexus features
5. **Discord Activity Features** - Recently enhanced, ongoing work
6. **Client Portal** - Pages exist but incomplete
### NOT IMPLEMENTED (1 flow)
1. **Email Verification** - Listed as future implementation
---
## Recommended Priority Order
1. **Discord Activity CSP Fix** - BLOCKING, prevents Discord Activity from working
2. **Discord Activity SDK Auth** - Required for full Discord integration
3. **Email Verification** - Security/compliance requirement
4. **Mentorship UI** - User-facing feature incomplete
5. **Creator Network Enhancement** - Revenue-generating feature
6. **Client Portal** - Business workflow incomplete
7. **Login/Onboarding UX** - Polish and refinement
---
## Related Documentation
- `docs/DISCORD-COMPLETE-FLOWS.md` - Discord flow details
- `docs/COMPLETE-NOTIFICATION-FLOWS.md` - Notification system
- `docs/IMPLEMENTATION_STATUS_ROADMAP_AUDIT.md` - Implementation status
- `docs/LOGIN-ONBOARDING-FIXES-APPLIED.md` - Auth flow fixes
- `docs/DISCORD-LINKING-FIXES-APPLIED.md` - Discord linking
- `docs/ECOSYSTEM_AUDIT_AND_CONSOLIDATION.md` - Route audit
- `docs/ETHOS_GUILD_IMPLEMENTATION.md` - Music/audio flows