add-ideas/govoplan-mail
1
0
Fork 0
Code Issues 9 Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
govoplan-mail/AGENTS.md
Albrecht Degering 5371cb3ad4 Release v0.1.8
2026-07-11 16:49:03 +02:00

1.4 KiB
Raw Permalink Blame History

GovOPlaN Mail Codex Guide

Scope

This repository owns the mail module: SMTP/IMAP profiles, mail profile policy, encrypted mail credentials, SMTP sending, IMAP append and mailbox access, mock mail infrastructure, backend module manifest, and @govoplan/mail-webui.

Core owns auth, tenants, RBAC, database/session primitives, CSRF/API helpers, shared components, and shell layout. Campaign/files integrations must remain optional and go through core module metadata or capabilities.

Local Commands

Install and run through core:

cd /mnt/DATA/git/govoplan-core
./.venv/bin/python -m pip install -r requirements-dev.txt

Focused backend tests:

cd /mnt/DATA/git/govoplan-core
./.venv/bin/python -m unittest discover -s /mnt/DATA/git/govoplan-mail/tests

Focused WebUI tests:

cd /mnt/DATA/git/govoplan-mail/webui
PATH=/mnt/DATA/git/govoplan-core/webui/node_modules/.bin:/home/zemion/.nvm/versions/node/v22.22.3/bin:$PATH /home/zemion/.nvm/versions/node/v22.22.3/bin/npm run test:mail-ui

For combined checks, run:

cd /mnt/DATA/git/govoplan
tools/checks/check-focused.sh

Working Rules

  • Keep mail behavior in this module, not core.
  • Do not require campaign or files imports for mail-only startup.
  • Shared WebUI components belong in core; mail WebUI should consume them through @govoplan/core-webui.
  • Prefer mailbox/IMAP tests and targeted API smoke tests before full-suite runs.