# ahmadyacine/spacepoint-portal architecture

> Architecture diagram of the GitHub repository ahmadyacine/spacepoint-portal, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ahmadyacine/spacepoint-portal
- Repository: https://github.com/ahmadyacine/spacepoint-portal

## Overview

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: [`backend/app/main.py`](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/main.py) (FastAPI application), [`backend/app/routers/admin.py`](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/routers/admin.py) (Admin review and control), [`backend/app/routers/auth.py`](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/routers/auth.py) (Signup and login), [`backend/app/routers/applicant.py`](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/routers/applicant.py) (Applicant submissions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_platform["Platform and access"]
  node_api_app["FastAPI application<br/>[main.py]"]
  node_settings["Portal settings<br/>[config.py]"]
  node_sqlalchemy["Database session<br/>[database.py]"]
  node_auth_routes["Signup and login<br/>[auth.py]"]
  node_auth_deps["Session authorization<br/>[deps.py]"]
  node_user_records[("User accounts<br/>[user.py]")]
end

subgraph group_applicant["Applicant pipeline"]
  node_invite_records[("Invitation codes<br/>[invitation.py]")]
  node_applicant_routes["Applicant submissions<br/>[applicant.py]"]
  node_submission_records[("Phase submissions<br/>[submission.py]")]
  node_checklist_records[("Module checklists<br/>[checklist.py]")]
end

subgraph group_adjudication["Review and administration"]
  node_admin_routes["Admin review and control<br/>[admin.py]"]
  node_review_records[("Application reviews<br/>[review.py]")]
  node_email_docs["Email and contracts<br/>[email_service.py]"]
end

subgraph group_instructor["Instructor and facilitator"]
  node_instructor_routes["Instructor portal API<br/>[instructor_api.py]"]
  node_id_card["Digital ID cards<br/>[id_card_service.py]"]
  node_facilitator_routes["Facilitator management<br/>[facilitator_api.py]"]
  node_learning_records[("Training and library<br/>[training.py]")]
  node_library_records[("Resource library<br/>[library.py]")]
end

subgraph group_finance["Payments and records"]
  node_payment_admin["Payment administration<br/>[payments_admin.py]"]
  node_payment_instructor["Instructor payments"]
  node_payment_service["Payment document service<br/>[payment_service.py]"]
  node_payment_records[("Payment records<br/>[payment.py]")]
end

node_applicant_actor(("Applicant"))
node_admin_actor(("Admin"))
node_instructor_actor(("Instructor"))
node_facilitator_actor(("Facilitator"))
node_smtp_service(("SMTP email service"))

node_api_app -->|"registers routes"| node_auth_routes
node_api_app -->|"registers routes"| node_applicant_routes
node_api_app -->|"registers routes"| node_admin_routes
node_api_app -->|"registers routes"| node_instructor_routes
node_api_app -->|"registers routes"| node_facilitator_routes
node_api_app -->|"registers routes"| node_payment_admin
node_api_app -->|"registers routes"| node_payment_instructor
node_applicant_actor -->|"uses portal"| node_api_app
node_admin_actor -->|"uses portal"| node_api_app
node_instructor_actor -->|"uses portal"| node_api_app
node_facilitator_actor -->|"uses portal"| node_api_app
node_auth_routes -->|"checks codes"| node_invite_records
node_auth_routes -->|"creates accounts"| node_user_records
node_auth_routes -->|"uses security settings"| node_settings
node_auth_deps -->|"loads user"| node_user_records
node_auth_deps -->|"validates tokens"| node_settings
node_applicant_routes -->|"stores submissions"| node_submission_records
node_applicant_routes -->|"updates checklist"| node_checklist_records
node_applicant_routes -->|"requires identity"| node_auth_deps
node_admin_routes -->|"reviews submissions"| node_submission_records
node_admin_routes -->|"updates decisions"| node_review_records
node_admin_routes -->|"reviews modules"| node_checklist_records
node_admin_routes -->|"sends notices"| node_email_docs
node_email_docs -->|"sends mail"| node_smtp_service
node_instructor_routes -->|"generates cards"| node_id_card
node_instructor_routes -->|"reads training"| node_learning_records
node_instructor_routes -->|"reads resources"| node_library_records
node_facilitator_routes -->|"manages training"| node_learning_records
node_facilitator_routes -->|"manages resources"| node_library_records
node_payment_admin -->|"uses payment service"| node_payment_service
node_payment_instructor -->|"uses payment service"| node_payment_service
node_payment_admin -->|"manages letters"| node_payment_records
node_payment_instructor -->|"reads payment records"| node_payment_records
node_payment_admin -->|"sends notices"| node_email_docs
node_payment_instructor -->|"sends notices"| node_email_docs
node_sqlalchemy -->|"configures engine"| node_settings

click node_api_app "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/main.py"
click node_settings "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/core/config.py"
click node_sqlalchemy "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/core/database.py"
click node_auth_routes "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/routers/auth.py"
click node_auth_deps "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/routers/deps.py"
click node_user_records "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/models/user.py"
click node_invite_records "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/models/invitation.py"
click node_applicant_routes "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/routers/applicant.py"
click node_submission_records "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/models/submission.py"
click node_checklist_records "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/models/checklist.py"
click node_admin_routes "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/routers/admin.py"
click node_review_records "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/models/review.py"
click node_email_docs "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/services/email_service.py"
click node_instructor_routes "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/routers/instructor_api.py"
click node_id_card "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/services/id_card_service.py"
click node_facilitator_routes "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/routers/facilitator_api.py"
click node_learning_records "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/models/training.py"
click node_library_records "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/models/library.py"
click node_payment_admin "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/routers/payments_admin.py"
click node_payment_instructor "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/routers/payments_instructor.py"
click node_payment_service "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/services/payment_service.py"
click node_payment_records "https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/models/payment.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_api_app,node_settings,node_sqlalchemy,node_auth_routes,node_auth_deps,node_user_records toneBlue
class node_invite_records,node_applicant_routes,node_submission_records,node_checklist_records toneAmber
class node_admin_routes,node_review_records,node_email_docs toneMint
class node_instructor_routes,node_id_card,node_facilitator_routes,node_learning_records,node_library_records toneRose
class node_payment_admin,node_payment_instructor,node_payment_service,node_payment_records,node_applicant_actor,node_admin_actor,node_instructor_actor,node_facilitator_actor,node_smtp_service toneIndigo
```

## Components

### Platform and access

- [FastAPI application](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/main.py): `backend/app/main.py`
- [Portal settings](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/core/config.py): `backend/app/core/config.py`
- [Database session](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/core/database.py): `backend/app/core/database.py`
- [Signup and login](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/routers/auth.py): `backend/app/routers/auth.py`
- [Session authorization](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/routers/deps.py): `backend/app/routers/deps.py`
- [User accounts](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/models/user.py): `backend/app/models/user.py`

### Applicant pipeline

- [Invitation codes](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/models/invitation.py): `backend/app/models/invitation.py`
- [Applicant submissions](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/routers/applicant.py): `backend/app/routers/applicant.py`
- [Phase submissions](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/models/submission.py): `backend/app/models/submission.py`
- [Module checklists](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/models/checklist.py): `backend/app/models/checklist.py`

### Review and administration

- [Admin review and control](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/routers/admin.py): `backend/app/routers/admin.py`
- [Application reviews](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/models/review.py): `backend/app/models/review.py`
- [Email and contracts](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/services/email_service.py): `backend/app/services/email_service.py`

### Instructor and facilitator

- [Instructor portal API](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/routers/instructor_api.py): `backend/app/routers/instructor_api.py`
- [Digital ID cards](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/services/id_card_service.py): `backend/app/services/id_card_service.py`
- [Facilitator management](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/routers/facilitator_api.py): `backend/app/routers/facilitator_api.py`
- [Training and library](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/models/training.py): `backend/app/models/training.py`
- [Resource library](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/models/library.py): `backend/app/models/library.py`

### Payments and records

- [Payment administration](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/routers/payments_admin.py): `backend/app/routers/payments_admin.py`
- [Instructor payments](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/routers/payments_instructor.py): `backend/app/routers/payments_instructor.py`
- [Payment document service](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/services/payment_service.py): `backend/app/services/payment_service.py`
- [Payment records](https://github.com/ahmadyacine/spacepoint-portal/blob/main/backend/app/models/payment.py): `backend/app/models/payment.py`

### Other components

- **Applicant**
- **Admin**
- **Instructor**
- **Facilitator**
- **SMTP email service**

## Connections

- FastAPI application → Signup and login: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Applicant submissions: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Admin review and control: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Instructor portal API: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Facilitator management: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Payment administration: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Instructor payments: registers routes (evidence: `backend/app/main.py`)
- Applicant → FastAPI application: uses portal (evidence: `README.md`)
- Admin → FastAPI application: uses portal (evidence: `README.md`)
- Instructor → FastAPI application: uses portal (evidence: `README.md`)
- Facilitator → FastAPI application: uses portal (evidence: `README.md`)
- Signup and login → Invitation codes: checks codes (evidence: `backend/app/routers/auth.py`)
- Signup and login → User accounts: creates accounts (evidence: `backend/app/routers/auth.py`)
- Signup and login → Portal settings: uses security settings (evidence: `backend/app/routers/auth.py`)
- Session authorization → User accounts: loads user (evidence: `backend/app/routers/deps.py`)
- Session authorization → Portal settings: validates tokens (evidence: `backend/app/routers/deps.py`)
- Applicant submissions → Phase submissions: stores submissions (evidence: `backend/app/routers/applicant.py`)
- Applicant submissions → Module checklists: updates checklist (evidence: `backend/app/routers/applicant.py`)
- Applicant submissions → Session authorization: requires identity (evidence: `backend/app/routers/applicant.py`)
- Admin review and control → Phase submissions: reviews submissions (evidence: `backend/app/routers/admin.py`)
- Admin review and control → Application reviews: updates decisions (evidence: `backend/app/routers/admin.py`)
- Admin review and control → Module checklists: reviews modules (evidence: `backend/app/routers/admin.py`)
- Admin review and control → Email and contracts: sends notices (evidence: `backend/app/routers/admin.py`)
- Email and contracts → SMTP email service: sends mail (evidence: `backend/app/services/email_service.py`)
- Instructor portal API → Digital ID cards: generates cards (evidence: `backend/app/routers/instructor_api.py`)
- Instructor portal API → Training and library: reads training (evidence: `backend/app/routers/instructor_api.py`)
- Instructor portal API → Resource library: reads resources (evidence: `backend/app/routers/instructor_api.py`)
- Facilitator management → Training and library: manages training (evidence: `backend/app/routers/facilitator_api.py`)
- Facilitator management → Resource library: manages resources (evidence: `backend/app/routers/facilitator_api.py`)
- Payment administration → Payment document service: uses payment service (evidence: `backend/app/routers/payments_admin.py`)
- Instructor payments → Payment document service: uses payment service (evidence: `backend/app/routers/payments_instructor.py`)
- Payment administration → Payment records: manages letters (evidence: `backend/app/routers/payments_admin.py`)
- Instructor payments → Payment records: reads payment records (evidence: `backend/app/routers/payments_instructor.py`)
- Payment administration → Email and contracts: sends notices (evidence: `backend/app/routers/payments_admin.py`)
- Instructor payments → Email and contracts: sends notices (evidence: `backend/app/routers/payments_instructor.py`)
- Database session → Portal settings: configures engine (evidence: `backend/app/core/database.py`)
