How p1app/freelance works
Freelance Lite is a two-sided freelance marketplace: clients and freelancers discover projects, exchange proposals, form contracts, track milestones, communicate, and review completed work. The frontend provides marketplace and account screens; the FastAPI backend exposes domain routes and separates service logic from persistence. The tree documents these capabilities, but most domain handlers and frontend views were not sampled, so their internal call paths are not asserted. Shown edges are limited to router registration and sampled auth/review/notification relationships.
Main entry points: main.py FastAPI application · auth_service.py Authentication service · review_service.py Review service · repository Domain repositories
Components 20
Marketplace UI
- Vue application
frontend/src/App.vue - Marketplace screens
frontend/src/views - HTTP client modules
frontend/src/api
API and Identity
- FastAPI application
backend/src/main.py - Authentication routes
backend/src/routers/auth_router.py - Authentication service
backend/src/service/auth_service.py - Token and access control
backend/src/core/security.py
Project Workflow
- Projects and proposals
backend/src/service - Contracts and milestones
backend/src/service - Review routes
backend/src/routers/review_router.py - Review service
backend/src/service/review_service.py
Collaboration
- Chat and notifications
backend/src/service - WebSocket routes
backend/src/routers/ws_router.py - Notification manager
backend/src/websocket/notifications_manager.py
Persistence and Runtime
- Domain repositories
backend/src/repository - Domain models
backend/src/models/user_model.py - Relational database
backend/src/core/database.py - Redis token revocation
- Email delivery
Other components
- Marketplace user
Connections 19
- Marketplace user → Vue application: uses
- Vue application → Marketplace screens: renders
- Marketplace screens → HTTP client modules: requests data
- HTTP client modules → FastAPI application: HTTP requests
- FastAPI application → Authentication routes: registers
backend/src/main.py - FastAPI application → Review routes: registers
backend/src/main.py - FastAPI application → WebSocket routes: registers
backend/src/main.py - Authentication routes → Authentication service: delegates
backend/src/routers/auth_router.py - Authentication service → Domain repositories: queries users
backend/src/service/auth_service.py - Authentication service → Token and access control: creates tokens
backend/src/service/auth_service.py - Authentication service → Email delivery: queues email
backend/src/service/auth_service.py - Token and access control → Redis token revocation: checks revocation
backend/src/core/security.py - Review routes → Review service: delegates
backend/src/routers/review_router.py - Review service → Domain repositories: reads and writes
backend/src/service/review_service.py - Review service → Chat and notifications: creates notification
backend/src/service/review_service.py - WebSocket routes → Notification manager: uses manager
backend/src/routers/ws_router.py - Chat and notifications → Notification manager: pushes updates
backend/src/service/notification_service.py - Domain repositories → Domain models: queries
- Domain models → Relational database: maps tables
backend/src/models/user_model.py