Blomios
ebd992e41a
Capitalise la mémoire projet accumulée pendant les chantiers B7/B8 (tâches de fond first-class), le système de tickets V1 et le ticket #1 : design, cadrages d'archi, checkpoints d'avancement et verdicts QA/frontend. Mise à jour de l'index MEMORY.md. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
78 lines
4.5 KiB
Markdown
78 lines
4.5 KiB
Markdown
---
|
|
name: issue-ticket-system-design
|
|
description: memory note issue-ticket-system-design
|
|
metadata:
|
|
type: project
|
|
---
|
|
---
|
|
name: issue-ticket-system-design
|
|
description: Cadrage figé (Architect+Main, 2026-07-02) du système de tickets IdeA façon Jira — domaine `Issue` par projet, exposé « ticket » côté UI/MCP, Carnet éditable, #N séquentiel. Fait autorité pour les lots T1-T6/F1-F7.
|
|
metadata:
|
|
type: reference
|
|
---
|
|
# Système de tickets IdeA (domaine `Issue`) — CADRAGE FIGÉ 2026-07-02
|
|
|
|
## Décisions produit verrouillées (utilisateur)
|
|
- **Portée PAR PROJET** : stockage dans `.ideai/tickets/` du projet (pas de backlog global).
|
|
- **Identifiant court `#42`** : compteur séquentiel par projet, parlable à l'oral (poignée
|
|
partagée humain↔agent, y compris dans une délégation `idea_ask_agent`).
|
|
- **Champ de connaissances éditable = « Carnet »** (PAS « mémoire » — évite collision avec la
|
|
mémoire projet). Markdown éditable/réorganisable, scoped ticket, pas append-only.
|
|
- **Stockage Markdown + frontmatter**, un DOSSIER par ticket.
|
|
- **V1 SANS attachments** : livrer T1-T5 + F1-F5 + F7 ; attachments (T6/F6) en fast-follow.
|
|
|
|
## Nommage (collision évitée avec le TicketId de délégation)
|
|
Domaine/code = **`Issue`** (`IssueId`, `IssueNumber`, `IssueRef("#42")`, `IssueStore`,
|
|
modules `domain::issue`/`application::issues`/`infrastructure::issues`). UI + MCP public =
|
|
« ticket » (`idea_ticket_*`, DTO camelCase). Ne JAMAIS nommer `Ticket` en code (réservé à la
|
|
délégation inter-agent).
|
|
|
|
## Frontière Carnet vs mémoire projet
|
|
Carnet = savoir DU ticket (décisions locales, hypothèses, investigation, contraintes). Mémoire
|
|
projet = savoir transverse durable. Règle : si l'info doit survivre à la fermeture du ticket et
|
|
guider d'autres travaux → mémoire projet ; sinon → carnet.
|
|
|
|
## Modèle domaine
|
|
`Issue { id(uuid), number(u64), title, description(md), status, priority, carnet, links,
|
|
agent_refs, attachments, created_by/updated_by(IssueActor: User|Agent|System),
|
|
created_at/updated_at, version(optimistic) }`.
|
|
- `IssueStatus`: Open | InProgress | Qa | Closed (DTO: open|inProgress|QA|closed).
|
|
- `IssuePriority`: Low | Medium | High | Critical.
|
|
- `IssueLinkKind`: RelatesTo | Blocks | BlockedBy | Duplicates | DependsOn.
|
|
- `AgentIssueRef { agent_id, role: Assigned|Mentioned|Reviewer|Owner }`.
|
|
Invariants : number>0 unique/projet ; IssueRef = `#<u64>` ; titre non vide ; pas de self-link ;
|
|
assignation → AgentId connu du manifeste ; toute écriture incrémente version ; attachments sous
|
|
le dossier du ticket, pas de `..`/symlink/chemin absolu.
|
|
|
|
## Ports
|
|
`IssueStore` (create/get_by_ref/list(filter)/update(expected_version)/read_carnet/
|
|
write_carnet(expected_version)) ; `IssueNumberAllocator` (allocate_next, atomique via
|
|
counter.json + counter.lock + rename, jamais de réutilisation de numéro) ; `IssueAttachmentStore`
|
|
(add/remove/list — lot attachments). Adapters : `FsIssueStore`, `FsIssueNumberAllocator`,
|
|
`FsIssueAttachmentStore`, `McpIssueTools`, `TauriIssueCommands`, `TauriIssueEventRelay`.
|
|
|
|
## Surface MCP (agents)
|
|
`idea_ticket_create/read/list/update/update_status/update_priority/read_carnet/update_carnet/
|
|
link/unlink` (+ `idea_ticket_attachment_*` au lot attachments). DTO camelCase ; `TicketRef` =
|
|
`#${number}` ; concurrence via `expectedVersion` sur chaque écriture.
|
|
|
|
## Events domaine (→ projection UI, même modèle events→front B-series)
|
|
IssueCreated/Updated/StatusChanged/PriorityChanged/CarnetUpdated/Linked/Unlinked/
|
|
AgentAssigned/AgentUnassigned/AttachmentAdded/Removed/StorageConflictDetected.
|
|
|
|
## Layout stockage
|
|
`.ideai/tickets/{counter.json, index.json(projection reconstructible), <N>/{issue.md(frontmatter
|
|
+description), carnet.md, attachments/}}`. Attachments versionnés git par défaut (warning >5MiB,
|
|
refus configurable >25MiB, pointeur URI pour les gros).
|
|
|
|
## Lots
|
|
Backend : T1 domaine Issue · T2 store FS Markdown (+allocator) · T3 use cases (Create/Read/List/
|
|
Update/UpdateCarnet/Link/AssignAgent, optimistic concurrency) · T4 surface MCP `idea_ticket_*` ·
|
|
T5 commands Tauri + relay events · T6 attachments (fast-follow).
|
|
Frontend : F1 gateway UI (`IssueGateway`, pas d'invoke direct) · F2 liste filtrable · F3 détail/
|
|
édition (gestion conflits expectedVersion) · F4 éditeur Carnet Markdown · F5 liens & assignations ·
|
|
F6 attachments (fast-follow) · F7 `#42` cliquable + pré-remplissage délégation.
|
|
Réutilise : store FS par projet façon `FsBackgroundTaskStore`/`AppLiveStateProvider`, EventBus +
|
|
TauriEventRelay, pattern gateway UI.
|
|
|
|
Lien : [[background-tasks-first-class-design]], [[agent-context-memory-and-profile-handoff]]. |