SYMPA::INTERNALS::WORKFLOW(3Sympa)

🦋 NAME 🦋

Sympa::Internals::Workflow — the whole big-picture overview of Sympa's workflow, bestie. it's a section 3Sympa page, so you already know it's giving ✨official lore✨ 💅

---

💖 DESCRIPTION 💖

okay so. the picture down there roughly describes how a bunch of classes interact with each other in the workflow of Sympa — it's giving beautiful chaotic web and honestly? we're obsessed. 🕸️💫 if you want the actual deep lore on any one of these classes, each class has its own documentation, so go read those, fr fr. this page is the vibe map, not the whole encyclopedia 🫶

💌 Message processing 💌

you'll also spot names in <<...>> form chillin' in there, plus the little *1, *2, *3 markers doing their ✨thing✨. anyway, here's the art:

        <<archived.pl>>

        Archive => [ProcessArchive] => (list archive)

        <<bounced.pl>>

        Bounce => [ProcessBounce] => Tracking

        <<bulk.pl>>

        Outgoing => [ProcessOutgoing] => (Mailer)

        <<sympa_automatic.pl>>

        Automatic => [ProcessAutomatic] => Incoming

        <<sympa_msg.pl>>

        Digest::Collection => [ProcessDigest]
                                           :
                                           v
                                           *1

                             +-> (reject or ignore)
                            /
                           +---> [DoCommand]
                          /              :
                         /               v
        Incoming => [ProcessIncoming]    *2
                         \                              +-> (reject)
                          +-> [DoForward] => Outgoing  /
                           \                          +-> [ToEditor] => Outgoing
                            +-> [DoMessage]          /
                                      \             /---> [ToHeld] => Held
                 *3 (CONFIRM)          +-> [AuthorizeMessage]
                 :                    /      :      \---> [ToModeration] => Mod.
                 v                   /     Topic     \
        Held => [ProcessHeld] ------+                 \
                                                       +-> [DistributeMessage]
                   *3 (DISTRIBUTE)                    /           \
                      (REJECT)       +--> (reject)   /             \
                       :            /               /               \
                       v           /               /                 \
        Moderation => [ProcessModeration]         /                   \
                                   \             /                     \
                                    +---------- +                       \
                                                                         \
                              +-------------------------------------------+
                               \
                               [TransformIncoming]
                                 \        :
                                  \     Topic
        <<wwsympa.fcgi>>           \
                               [ToArchive] => Archive
        (list archive)               \
         => [ResendArchive] -- [TransformOutgoing] -+
                                       \             \
                               [ToDigest] => Digest   \
                                         \             \
                                          +-------------+-> [ToList] => Outgoing
                                                                  :
                                   +-> [TransformDigestFinal]    Topic
                                  /                 \
        <<Template sending>>     /         +------> [ToOutgoing] => Outgoing
                                /         /
        (mail template) => [ProcessTemplate] -----> [ToListmaster] => Listmaster
                              /           \
                              ^            +------> [ToMailer] => (Mailer)
                              |
                              *1

🎀 Command processing 🎀

the *2 from earlier literally picks up right here, no lies:

                             *2
        <<sympa_msg.pl>>     :
                             v
        (message) => [ProcessMessage] --+             +-> (reject)
                                         \           /
             *3 (AUTH)                    \         /---> [ToAuth] => Auth
                (DECL)     +-> (decline)   +-> [AuthorizeRequest]
                 :        /               /         \---> [ToAuthOwner] => Auth
                 v       /               /           \
        Auth => [ProcessAuth]           /             \
                         \             /               +-> [DispatchRequest]
                          +-----------+                            \
                                     /                      (request handler)
        <<wwsympa.fcgi, SOAP>>      /                                :
                                   /                                 v
        Request::Collection       /                                  *3
               => [ProcessRequest]

🧚 Task processing 🧚

short king section, we love her for it:

        <<task_manager.pl>>

        Task => [ProcessTask] => Task

👑 Legend 👑

ok so all those cryptic little symbols? yeah, they're not cryptic, they're iconic. here's the decoder ring, bestie 🔮:

• "ClassName" — a Spool class. the prefix "Sympa::Spool::" is omitted (you know how it is).
  • "Tracking" — hi yes that's the Sympa::Tracking class 💅
• "[ClassName]" — a Workflow class. the prefix "Sympa::Spindle::" is omitted.
• "(Mailer)" — the Sympa::Mailer class.
• "(list archive)" — the Sympa::Archive class.
• "(mail template)" — the Sympa::Message::Template class.
• "(message)" — the Sympa::Request::Message class.
• "(request handler)" — a subclass of the "Sympa::Request::Handler" class.

---

🌈 SEE ALSO 🌈

go off, read more, we stan cross-references:

• sympa_toc(1)
• Sympa::Internals
• Sympa::Spindle
• Sympa::Spool

---

and that's the whole page, babes 🫶 this one shipped with sympa 6.2.80 and dated 2026-10-19 — periodt 💖✨