How alexalkhatib/alecsync-social-platform works
AlecSync is a Flask social network: members register or sign in, then discover and publish posts, interact with other members, and use private messaging. Domain blueprints handle those workflows through forms and shared SQLAlchemy models; server-rendered pages provide the core experience, with JSON endpoints and browser JavaScript enhancing selected interactions. The README documents capabilities beyond the sampled excerpts; links to those features are included only where documented, and unsampled implementation details are not inferred.
Main entry points: __init__.py App factory · models.py Domain models · posts.py Posts and replies · users.py Profiles and settings
Components 18
Web foundation
- App factory
app/__init__.py - Configuration
app/config.py - Flask extensions
app/extensions.py - Forms
app/forms.py - Relational database
- Domain models
app/models.py - Text and uploads
app/utils.py - Local media files
Social content
- Feed and discovery
app/main.py - Posts and replies
app/posts.py - Social JSON API
app/api.py
Member accounts
- Profiles and settings
app/users.py - Authentication
app/auth.py
Communication
- Private messaging
app/messages.py - Notifications
app/models.py
Web experience
- Page templates
app/templates - Browser interactions
app/static/js/app.js
Other components
- Member
Connections 32
- Member → App factory: uses site
README.md - App factory → Configuration: loads settings
app/__init__.py - App factory → Flask extensions: initializes
app/__init__.py - App factory → Authentication: registers routes
app/__init__.py - App factory → Feed and discovery: registers routes
app/__init__.py - App factory → Profiles and settings: registers routes
app/__init__.py - App factory → Posts and replies: registers routes
app/__init__.py - App factory → Private messaging: registers routes
app/__init__.py - App factory → Social JSON API: registers routes
app/__init__.py - Authentication → Forms: validates with
app/auth.py - Authentication → Domain models: reads and creates
app/auth.py - Authentication → Text and uploads: saves avatar
app/auth.py - Posts and replies → Forms: validates with
app/posts.py - Posts and replies → Domain models: creates and updates
app/posts.py - Posts and replies → Text and uploads: extracts mentions
app/posts.py - Social JSON API → Domain models: updates interactions
app/api.py - Feed and discovery → Domain models: queries content
README.md - Profiles and settings → Domain models: queries and updates
app/users.py - Profiles and settings → Forms: validates settings
app/users.py - Profiles and settings → Text and uploads: saves media
app/users.py - Private messaging → Forms: validates messages
app/messages.py - Private messaging → Domain models: reads and writes
app/messages.py - Notifications → Domain models: stored as
README.md - Domain models → Relational database: persists records
README.md - Feed and discovery → Page templates: renders pages
README.md - Posts and replies → Page templates: renders pages
README.md - Profiles and settings → Page templates: renders pages
README.md - Private messaging → Page templates: renders pages
app/messages.py - Browser interactions → Social JSON API: enhances interactions
README.md - Authentication → Local media files: stores avatar
README.md - Posts and replies → Local media files: stores images
README.md - Profiles and settings → Local media files: stores profile media
README.md