How skygod07/tale-s_of_goa works
Tales of Goa is a face-identification and social-post verification product, available through a web UI and a CLI. Its main workflow accepts a face image, searches for public social content, verifies candidate faces, then commits a hash and reads back the on-chain proof. The backend also supports direct face operations, an enrolled identity gallery, teaching, and feedback/calibration. The graph includes documented capabilities whose implementation was not sampled; edges are limited to shown calls, imports, endpoint mappings, or README statements.
Main entry points: social.py Social endpoints · social_search.py Social pipeline · face_processor.py Face processing · face.py Face endpoints
Components 21
Web interface
- Web application
frontend/src/app/page.tsx - Discovery workflow UI
frontend/src/components/SocialDiscoveryPipeline.tsx - Progress stages
frontend/src/components/PipelineStages.tsx - API client
frontend/src/services/api.ts
API and orchestration
- FastAPI app
backend/app/main.py - Face endpoints
backend/app/routes/face.py - Social endpoints
backend/app/routes/social.py - Verification endpoints
backend/app/routes/verification.py - Face API schemas
backend/app/schemas/face.py - Pipeline CLI
backend/run_pipeline.py
Face identity
- Face processing
backend/app/services/face_processor.py - Identity gallery
backend/app/services/gallery.py - Identity naming
backend/app/services/naming.py
Discovery and learning
- Face-driven search
backend/app/services/face_search.py - Social pipeline
backend/app/services/social_search.py - Identity teaching
backend/app/services/teach.py - Feedback calibration
backend/app/services/feedback.py
Blockchain proof
- Record hashing
backend/app/services/hashing.py - Chain integration
backend/app/services/blockchain.py
Other components
- Operator
- EVM network
Connections 43
- Operator → Web application: uses
README.md - Web application → API client: requests
frontend/src/app/page.tsx - Web application → Discovery workflow UI: renders
frontend/src/app/page.tsx - Discovery workflow UI → API client: runs search
frontend/src/components/SocialDiscoveryPipeline.tsx - Discovery workflow UI → Progress stages: renders progress
frontend/src/components/SocialDiscoveryPipeline.tsx - API client → Face endpoints: calls face API
frontend/src/services/api.ts - API client → Social endpoints: calls search API
frontend/src/services/api.ts - API client → Verification endpoints: queries proof
frontend/src/services/api.ts - FastAPI app → Face endpoints: registers
backend/app/main.py - FastAPI app → Social endpoints: registers
backend/app/main.py - FastAPI app → Verification endpoints: registers
backend/app/main.py - Face endpoints → Face processing: processes faces
backend/app/routes/face.py - Face endpoints → Record hashing: hashes records
backend/app/routes/face.py - Face endpoints → Chain integration: records proof
backend/app/routes/face.py - Face endpoints → Face API schemas: uses schemas
backend/app/routes/face.py - Verification endpoints → Chain integration: queries chain
backend/app/routes/verification.py - Verification endpoints → Face API schemas: uses schemas
backend/app/routes/verification.py - Social endpoints → Social pipeline: runs pipeline
backend/app/routes/social.py - Social endpoints → Face-driven search: uses search
backend/app/routes/social.py - Social endpoints → Face processing: processes faces
backend/app/routes/social.py - Social endpoints → Identity gallery: uses gallery
backend/app/routes/social.py - Social endpoints → Identity teaching: teaches identity
backend/app/routes/social.py - Social endpoints → Feedback calibration: records feedback
backend/app/routes/social.py - Face-driven search → Face processing: uses embeddings
backend/app/services/face_search.py - Face-driven search → Identity naming: uses names
backend/app/services/face_search.py - Face-driven search → Feedback calibration: uses calibration
backend/app/services/face_search.py - Social pipeline → Face-driven search: uses discovery
backend/app/services/social_search.py - Social pipeline → Face processing: verifies faces
backend/app/services/social_search.py - Social pipeline → Identity gallery: uses gallery
backend/app/services/social_search.py - Social pipeline → Record hashing: hashes record
backend/app/services/social_search.py - Social pipeline → Chain integration: commits proof
backend/app/services/social_search.py - Identity teaching → Face processing: encodes faces
backend/app/services/teach.py - Identity teaching → Identity gallery: enrolls identity
backend/app/services/teach.py - Identity teaching → Identity naming: resolves name
backend/app/services/teach.py - Feedback calibration → Face processing: evaluates faces
backend/app/services/feedback.py - Feedback calibration → Record hashing: hashes feedback
backend/app/services/feedback.py - Feedback calibration → Chain integration: records evidence
backend/app/services/feedback.py - Chain integration → EVM network: submits and reads
README.md - Operator → Pipeline CLI: runs pipeline
README.md - Pipeline CLI → Social pipeline: runs discovery
backend/run_pipeline.py - Pipeline CLI → Face processing: encodes input
backend/run_pipeline.py - Pipeline CLI → Face-driven search: searches faces
backend/run_pipeline.py - Pipeline CLI → Chain integration: commits proof
backend/run_pipeline.py