How personicle/backend-data-api-v2 works
Personicle’s data-access API serves datastreams, events, and their metadata. A request is authorized against an external service, then the API queries PostgreSQL; datastream requests also consult a schema-matching service. The README names /request and /request/events, while the sampled implementation exposes /datastreams and /events. The excerpts do not show the full datastream query path, so that database relationship is marked unverified; unsampled implementation details are not inferred.
Main entry points: db_connection.py Database runtime · main.py Datastream endpoint · base_schema.py Data schemas · config.py Service configuration
Components 11
API routes
- Datastream endpoint
main.py - Events endpoint
main.py - Event metadata
main.py - Stream metadata
main.py
Data models
- Data schemas
base_schema.py
Persistence
- Database runtime
db_connection.py - PostgreSQL
External services
- Service configuration
config.py - Authorization service
- Schema service
Other components
- API client
Connections 17
- API client → Datastream endpoint: requests data
README.md - API client → Events endpoint: requests events
README.md - API client → Event metadata: requests metadata
- API client → Stream metadata: requests metadata
- Datastream endpoint → Authorization service: checks access
main.py - Events endpoint → Authorization service: checks access
main.py - Event metadata → Authorization service: checks access
main.py - Stream metadata → Authorization service: checks access
main.py - Datastream endpoint → Schema service: matches schema
main.py - Stream metadata → Schema service: looks up schema
main.py - Datastream endpoint → Database runtime: queries data
main.py - Events endpoint → Database runtime: fetches events
main.py - Event metadata → Database runtime: fetches metadata
main.py - Stream metadata → Database runtime: iterates metadata
main.py - Database runtime → PostgreSQL: connects to
db_connection.py - Database runtime → Service configuration: reads settings
db_connection.py - Datastream endpoint → Data schemas: imports schemas
main.py