How selfxplanatorium/delphee works
Delphee is an HTTP wrapper and browser interface for the Delphi student portal. A user signs in, receives a bearer token, and requests student data; the service authenticates to Delphi, parses its HTML into JSON, and may serve cached results. Major branches include academic records and plans, exams and sessions, fees and receipts, certificates, and student services. The README also documents an offline demo. Source excerpts establish the login, routing, session, and cache behavior; endpoint coverage is grouped by domain where implementation details were not excerpted.
Main entry points: api.ts Data API · routes.ts HTTP routes · sessions.ts Session registry · session-middleware.ts Session middleware
Components 21
HTTP and interface
- Browser UI
src/server/static/app.js - HTTP routes
src/server/routes.ts - Page shell
src/server/static/index.html.ts
Sessions and access
- Session middleware
src/server/session-middleware.ts - Session registry
src/server/sessions.ts - Delphi session
src/client/session.ts - Demo API
src/server/demo.ts
Portal data
- Data API
src/server/api.ts - Profile and career
src/client/endpoints/anagrafica.ts - Study plans
src/client/endpoints/piano.ts - Exams and sessions
src/client/endpoints/esami-search.ts - Fees and payments
src/client/endpoints/bollettini.ts - Services and codes
src/client/endpoints/servizi.ts - Certificates
src/client/endpoints/certificati.ts
Shared runtime
- HTTP fetcher
src/client/fetcher.ts - Cookie jar
src/client/cookie-jar.ts - Memory cache
src/cache/store.ts - Retry policy
src/utils/retry.ts - Runtime config
src/config.ts
Other components
- Student
- Delphi portal
Connections 25
- Student → Browser UI: uses
README.md - Browser UI → HTTP routes: requests
README.md - HTTP routes → Page shell: renders
src/server/routes.ts - HTTP routes → Session middleware: authenticates via
src/server/routes.ts - HTTP routes → Session registry: logs in through
src/server/routes.ts - Session middleware → Session registry: looks up session
src/server/session-middleware.ts - Session middleware → Data API: selects live API
src/server/session-middleware.ts - Session middleware → Demo API: selects demo API
src/server/session-middleware.ts - Session registry → Delphi session: creates and manages
src/server/sessions.ts - Session registry → Demo API: creates demo session
src/server/sessions.ts - Delphi session → HTTP fetcher: authenticates via
src/client/session.ts - HTTP fetcher → Cookie jar: maintains cookies
src/client/fetcher.ts - HTTP fetcher → Retry policy: retries transient errors
src/client/fetcher.ts - Data API → Delphi session: fetches authenticated pages
src/server/api.ts - Data API → Memory cache: reads and writes
src/server/api.ts - Data API → Profile and career: parses profile data
src/server/api.ts - Data API → Study plans: parses study plans
src/server/api.ts - Data API → Exams and sessions: parses exam data
src/server/api.ts - Data API → Fees and payments: parses payment data
src/server/api.ts - Data API → Services and codes: parses services
src/server/api.ts - Data API → Certificates: parses certificates
src/server/api.ts - HTTP fetcher → Delphi portal: requests portal pages
README.md - Data API → Delphi portal: proxies portal pages
README.md - Session registry → Memory cache: evicts account data
- HTTP routes → Runtime config: uses configuration
src/server/routes.ts