aim-attachment-domain
CommunitySecurely manage message attachments end-to-end.
Authorhellopoisonx
Version1.0.0
Installs0
System Documentation
What problem does it solve?
It solves the complexity of handling user-uploaded attachments in a multi-service IM system—ensuring only authorized uploads/downloads and correct metadata propagation through internal gRPC boundaries.
Core Features & Use Cases
- Internal gRPC attachment domain: Provides AttachmentService (not public REST/WS) to gateway via internal calls for upload/download authorization and reference validation.
- Object storage integration: Creates context-aware SeaweedFS/S3 pre-signed requests, validates stored objects, and writes attachment metadata to PostgreSQL.
- Media vs file processing rules: Publishes
aim.attachment.uploadedfor media attachments (image/video/audio) while ordinaryfileattachments are marked parsed immediately and do not go to data parsing. - Correct eventing and trace propagation: Ensures the uploaded event payload includes
file_idand carries tracing context to support observability and debugging.
Quick Start
Ask the AI: “Summarize the attachment domain boundaries, gRPC contract change rules, and the media-upload event behavior for aim.attachment.uploaded in this repository.”
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: aim-attachment-domain Download link: https://github.com/hellopoisonx/aim/archive/main.zip#aim-attachment-domain Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.