27cfa9ac13
Collection Bruno (.bru text files, comme Postman mais file-based versionable) qui couvre l'API V1 actuelle. Open Collection → bruno/ → sélectionner l'environnement "local". Domaines couverts (22 requêtes) : - 00-Auth : Signup, Login, Logout - 01-Account : Get/Update profile - 02-Organizations : Get/Update my org - 03-Clients : List, List+stats, Search, Create, Create duplicate (409), Create without email (422), Get detail, Update - 04-Plans : List, Get by slug, Update (steps remplacés) - 05-Invoices : List, List+filters, Counts, Create, Get detail, Mark paid Environnement local (bruno/environments/local.bru) : - baseUrl, email/password/fullName en dur - token, userId, organizationId, clientId, invoiceId remplis automatiquement par les script:post-response Chaque requête a : - assertions Chai (statut, shape de la réponse) - bloc docs avec sémantique métier + erreurs typiques - inheritance auth Bearer via folder.bru pour ne pas répéter le header Mise à jour de docs/tech/dev-setup.md pour pointer vers la collection. Le parcours recommandé Signup → Update org → Create client → Create invoice → Mark paid couvre le happy path et permet de checker rubisCount qui s'incrémente.
36 lines
869 B
Plaintext
36 lines
869 B
Plaintext
meta {
|
|
name: 05 Get detail
|
|
type: http
|
|
seq: 5
|
|
}
|
|
|
|
get {
|
|
url: {{baseUrl}}/api/v1/invoices/{{invoiceId}}
|
|
body: none
|
|
auth: inherit
|
|
}
|
|
|
|
tests {
|
|
test("200 OK", function () {
|
|
expect(res.getStatus()).to.equal(200);
|
|
});
|
|
test("client preload present", function () {
|
|
expect(res.getBody().data.client).to.have.property("name");
|
|
});
|
|
test("timeline is array with `issued` event", function () {
|
|
const tl = res.getBody().data.timeline;
|
|
expect(tl).to.be.an("array");
|
|
expect(tl[0].state).to.equal("past");
|
|
});
|
|
}
|
|
|
|
docs {
|
|
GET /api/v1/invoices/:id
|
|
|
|
Détail enrichi : champs Invoice + `client` (Client préchargé) + `plan`
|
|
(Plan + steps préchargés) + `timeline` composée par le serveur.
|
|
|
|
La timeline calque les `plan.steps` sur `dueDate + offsetDays` et marque
|
|
chaque étape `past` / `current` / `future` selon l'horodatage courant.
|
|
}
|