blomios/IdeA
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
4de25d2bcea0970badd2945e66923d96c7622679
IdeA/.ideai/memory/issue-ticket-system-design.md
Blomios ebd992e41a docs(memory): notes projet tâches de fond, tickets V1 et checkpoints ticket #1 
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>
2026-07-04 00:21:43 +02:00

4.5 KiB
Raw Blame History

name, description, metadata
name description metadata
issue-ticket-system-design memory note issue-ticket-system-design
type
project

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.