59 lines
1.9 KiB
Markdown
59 lines
1.9 KiB
Markdown
# Neah Email Application
|
|
|
|
A modern email client built with Next.js, featuring email composition, viewing, and management capabilities.
|
|
|
|
## Email Processing Workflow
|
|
|
|
The application handles email processing through a centralized workflow:
|
|
|
|
1. **Email Fetching**: Emails are fetched through the `/api/courrier` endpoints using user credentials stored in the database.
|
|
|
|
2. **Email Parsing**: Raw email content is parsed using:
|
|
- Server-side: `simpleParser` from `mailparser` library via `/api/parse-email` API route
|
|
- Client-side: `decodeEmail` function in `lib/mail-parser-wrapper.ts`
|
|
|
|
3. **HTML Sanitization**: Email HTML content is sanitized and processed using:
|
|
- `cleanHtml` function in `lib/mail-parser-wrapper.ts` (centralized implementation)
|
|
- CSS styles are optionally preserved and scoped to prevent leakage
|
|
|
|
4. **Email Display**: Sanitized content is rendered in the UI with proper styling and security measures
|
|
|
|
5. **Email Composition**: The `ComposeEmail` component handles email creation, replying, and forwarding
|
|
- `initializeForwardedEmail` function prepares forwarded email content
|
|
- Email is sent through the `/api/courrier/send` endpoint
|
|
|
|
## Deprecated Functions
|
|
|
|
Several functions have been marked as deprecated in favor of centralized implementations:
|
|
|
|
- Check the `DEPRECATED_FUNCTIONS.md` file for a complete list of deprecated functions and their replacements.
|
|
|
|
## Project Structure
|
|
|
|
- `/app` - Main application routes and API endpoints
|
|
- `/components` - Reusable React components
|
|
- `/lib` - Utility functions and services
|
|
- `/services` - Domain-specific services, including email service
|
|
- `/server` - Server-side utilities
|
|
|
|
## Dependencies
|
|
|
|
- Next.js 15
|
|
- React 18
|
|
- ImapFlow for IMAP interactions
|
|
- Mailparser for email parsing
|
|
- Prisma for database interactions
|
|
- Tailwind CSS for styling
|
|
|
|
## Development
|
|
|
|
```bash
|
|
# Install dependencies
|
|
npm install
|
|
|
|
# Start the development server
|
|
npm run dev
|
|
|
|
# Build for production
|
|
npm run build
|
|
``` |