How ahmadyacine/spacepoint-portal works
SpacePoint Portal V2 manages a scholarship-to-instructor lifecycle: applicants register by invitation, complete phased submissions, receive reviews, and may advance to instructor status; instructors and facilitators then use training, resource, identity, and payment features. FastAPI routes are the principal workflow entry points, with SQLAlchemy models providing persistent domain state. The README documents dossier compilation and contract generation, but the supplied excerpts do not expose their exact implementation paths or calls; those capabilities are represented only where a supported component is identifiable. Edges rely on route registrations, source-index references, or README statements.
Main entry points: main.py FastAPI application · admin.py Admin review and control · auth.py Signup and login · applicant.py Applicant submissions
Components 27
Platform and access
- FastAPI application
backend/app/main.py - Portal settings
backend/app/core/config.py - Database session
backend/app/core/database.py - Signup and login
backend/app/routers/auth.py - Session authorization
backend/app/routers/deps.py - User accounts
backend/app/models/user.py
Applicant pipeline
- Invitation codes
backend/app/models/invitation.py - Applicant submissions
backend/app/routers/applicant.py - Phase submissions
backend/app/models/submission.py - Module checklists
backend/app/models/checklist.py
Review and administration
- Admin review and control
backend/app/routers/admin.py - Application reviews
backend/app/models/review.py - Email and contracts
backend/app/services/email_service.py
Instructor and facilitator
- Instructor portal API
backend/app/routers/instructor_api.py - Digital ID cards
backend/app/services/id_card_service.py - Facilitator management
backend/app/routers/facilitator_api.py - Training and library
backend/app/models/training.py - Resource library
backend/app/models/library.py
Payments and records
- Payment administration
backend/app/routers/payments_admin.py - Instructor payments
backend/app/routers/payments_instructor.py - Payment document service
backend/app/services/payment_service.py - Payment records
backend/app/models/payment.py
Other components
- Applicant
- Admin
- Instructor
- Facilitator
- SMTP email service
Connections 36
- FastAPI application → Signup and login: registers routes
backend/app/main.py - FastAPI application → Applicant submissions: registers routes
backend/app/main.py - FastAPI application → Admin review and control: registers routes
backend/app/main.py - FastAPI application → Instructor portal API: registers routes
backend/app/main.py - FastAPI application → Facilitator management: registers routes
backend/app/main.py - FastAPI application → Payment administration: registers routes
backend/app/main.py - FastAPI application → Instructor payments: registers routes
backend/app/main.py - Applicant → FastAPI application: uses portal
README.md - Admin → FastAPI application: uses portal
README.md - Instructor → FastAPI application: uses portal
README.md - Facilitator → FastAPI application: uses portal
README.md - Signup and login → Invitation codes: checks codes
backend/app/routers/auth.py - Signup and login → User accounts: creates accounts
backend/app/routers/auth.py - Signup and login → Portal settings: uses security settings
backend/app/routers/auth.py - Session authorization → User accounts: loads user
backend/app/routers/deps.py - Session authorization → Portal settings: validates tokens
backend/app/routers/deps.py - Applicant submissions → Phase submissions: stores submissions
backend/app/routers/applicant.py - Applicant submissions → Module checklists: updates checklist
backend/app/routers/applicant.py - Applicant submissions → Session authorization: requires identity
backend/app/routers/applicant.py - Admin review and control → Phase submissions: reviews submissions
backend/app/routers/admin.py - Admin review and control → Application reviews: updates decisions
backend/app/routers/admin.py - Admin review and control → Module checklists: reviews modules
backend/app/routers/admin.py - Admin review and control → Email and contracts: sends notices
backend/app/routers/admin.py - Email and contracts → SMTP email service: sends mail
backend/app/services/email_service.py - Instructor portal API → Digital ID cards: generates cards
backend/app/routers/instructor_api.py - Instructor portal API → Training and library: reads training
backend/app/routers/instructor_api.py - Instructor portal API → Resource library: reads resources
backend/app/routers/instructor_api.py - Facilitator management → Training and library: manages training
backend/app/routers/facilitator_api.py - Facilitator management → Resource library: manages resources
backend/app/routers/facilitator_api.py - Payment administration → Payment document service: uses payment service
backend/app/routers/payments_admin.py - Instructor payments → Payment document service: uses payment service
backend/app/routers/payments_instructor.py - Payment administration → Payment records: manages letters
backend/app/routers/payments_admin.py - Instructor payments → Payment records: reads payment records
backend/app/routers/payments_instructor.py - Payment administration → Email and contracts: sends notices
backend/app/routers/payments_admin.py - Instructor payments → Email and contracts: sends notices
backend/app/routers/payments_instructor.py - Database session → Portal settings: configures engine
backend/app/core/database.py