Teepy × Theopy — my contribution (sanitized extract)

This repository is a sanitized extract of Teepy, Kozea's proprietary pharmacy-management ERP (private repository, years of work by a full team, confidential to Kozea and its clients).

It exists to show, publicly and without breaching confidentiality, the code I personally wrote to connect Teepy to Theopy, an AI assistant I built as part of my RNCP39583 "Experte en Développement Logiciel" certification.

Every file and folder from the real Teepy repository is present here, at its real path, so the overall structure of the application is visible — but only the files I personally authored keep their real content. Everything else has been emptied (zero bytes) on purpose. This repo carries no git history from the original: only Teepy's own private repository has that.

Where my contribution sits in the architecture

 ┌─────────────────────────────────────────────────────-─────────────────┐
 │  THEOPY  (public, separate repo)                                      │
 │  AI assistant — Gemini / Ollama brain, chat UI, login                 │
 └────────────────────────────────┬──────────────────────────────────────┘
                                  │  MCP protocol over SSE
                                  │  initialize → tools/list → tools/call
                                  ▼
┌──────────────────────────────────────────────────────────────────────┐
│  TEEPY  (this repo — sanitized)                                      │
│                                                                      │
│  ┌──────────────────────────────────────────────────────────────┐    │
│  │ mcp_server.py                                        ★ MINE  │    │
│  │ FastMCP entrypoint - boots the MCP server on :5001           │    │
│  └────────────────────────────┬─────────────────────────────────┘    │
│                               │                                      │
│  ┌────────────────────────────▼───────────────────────────────--─┐   │
│  │ mcp_tools/                                           ★ MINE   │   │
│  │  core.py       - identity resolution via MCP `meta`,          │   │
│  │                  requires_role() access control               │   │
│  │  invoices.py   - factures  (administrator/manager/commercial) │   │
│  │  customers.py  - clients   (administrator/manager/commercial) │   │
│  │  plannings.py  - plannings (administrator/manager/operator)   │   │
│  │  sessions.py   - sessions  (+ contractor)                     │   │
│  │  reminders.py  - relances  (administrator/manager/commercial) │   │
│  └────────────────────────────┬───────────────────────────────-──┘   │
│                               │  calls agent_* functions             │
│  ┌────────────────────────────▼──────────────────────────────-───┐   │
│  │ teepy/routes/theopy/                                 ★ MINE   │   │
│  │  base.py, customer.py, invoice.py, planning.py,               │   │
│  │  reminder.py, session.py                                      │   │
│  │  → agent-facing business logic, wrapping Teepy's existing     │   │
│  │    repositories/models                                        │   │
│  └────────────────────────────┬─────────────────────────────-────┘   │
│                               │                                      │
│  ┌────────────────────────────▼─────────────────────────-────────┐   │
│  │ teepy/routes/theopy_auth.py                          ★ MINE   │   │
│  │  POST /api/theopy/authenticate                                │   │
│  └────────────────────────────┬───────────────────────────────-──┘   │
│                               │  queries through                     │
│  ┌────────────────────────────▼─────────────────────────────-────┐   │
│  │ teepy/models/, teepy/repositories/, teepy/services/,          │   │
│  │ teepy/routes/ (rest), teepy/templates/, teepy/static/, ...    │   │
│  │                                        ○ PRE-EXISTING TEEPY   │   │
│  │        proprietary ERP - content redacted in this repo        │   │
│  └────────────────────────────┬───────────────────────────────-──┘   │
│                               │                                      │
│  ┌────────────────────────────▼────────────────────────────-─────┐   │
│  │ PostgreSQL (Teepy production database)                        │   │
│  └────────────────────────────────────────────────────────────--─┘   │
└────────────────────────────────────────────────────────────────--────┘

★ MINE = full, real content, kept as-is. ○ PRE-EXISTING TEEPY = real file/folder structure preserved, content emptied.

What's mine, in full

teepy/__init__.py is intentionally emptied too, even though I added 2 lines to it (registering the theopy_auth blueprint) - the file is overwhelmingly pre-existing Teepy bootstrap code, not mine, so it follows the same rule as everything else outside the list above.

Links

• Theopy (the AI assistant, fully public): https://github.com/SajedehAdelia/Theopy
• Teepy (the real repository, private - access on request): https://github.com/Kozea/teepy