managarten/apps/contacts/.agent/memory.md

Contacts App - Memory

Auto-updated with learnings from code changes.

Recent Updates

No updates yet.

Known Issues

None documented.

Implementation Notes

• Backend runs on port 3015
• Web frontend runs on port 5184
• Database: PostgreSQL with Drizzle ORM
• Auth: Mana Core Auth (JWT EdDSA)
• Storage: MinIO (S3-compatible) for contact photos at localhost:9000
• OAuth: Google Contacts API integration for import/sync
• Database seeding available via pnpm --filter @contacts/backend db:seed

Key Features

• Full contact CRUD with rich profiles
• Google Contacts OAuth integration
• vCard and CSV import/export
• Tags, notes, and activity logging
• Photo storage via MinIO/S3
• Duplicate detection and merging
• Network visualization of contact relationships
• Team/organization sharing capabilities
• Search, filter, favorites, and archive

Data Model

• Contacts belong to users with optional organization/team association
• Many-to-many relationship between contacts and tags
• One-to-many for notes and activities
• Connected accounts table for OAuth tokens (encrypted)
• Visibility and sharing controlled via visibility field and shared_with JSONB array