Mal for prosjektbeskrivelse: Få sammenlignbare tilbud fra selskaper som utfører kodrevisjon av Python

Redigert av redaksjonen for Python-kodrevisjon · Bevis kontrollert: · Slik fungerer rangeringen

Hvorfor et felles oppdragsgrunnlag gjør tilbud sammenlignbare

Når fem selskaper svarer på fem ulike samtaler, kan ikke tilbudene stilles opp side ved side: én priser et fast avgrenset omfang, en annen priser et team for et kvartal, og en tredje forutsetter at ditt team står for utrullingen. Et skriftlig oppdragsgrunnlag stiller de samme spørsmålene til alle som byr. Det tvinger deg også til å bestemme omfang, samarbeidsmodell og beslutningskriterier før noen gir pris, og det er den delen de fleste innkjøpere hopper over.

Slik bruker du malen

  1. Velg ut tre til fem selskaper fra katalogen; sjekk bevispoengsummen og kundecasene bak den for hvert selskap før du skriver.
  2. Kopier avsnittene nedenfor inn i et dokument du eier. Slett avsnitt som ikke er relevante, og si det i følgebrevet, slik at tilbyderne ikke må gjette.
  3. Fyll ut alle felt som er merket som dine (kontekst, omfang, budsjettintervall, tidsplan). La feltene for tilbyder stå tomme – det er dem du ber om.
  4. Send det identiske dokumentet til alle tilbydere, med samme frist og samme instruks om format og lengde.
  5. Be hver tilbyder svare skriftlig på de obligatoriske spørsmålene før eventuelle samtaler, slik at samtalene handler om forskjeller og ikke om det grunnleggende.
  6. Poengsett svarene mot sammenligningstabellen til slutt før du forhandler med noen.

Malen

Kontekst for selskap og produkt

Felt Hva du skal skrive Eksempel
Hva produktet gjør To eller tre setninger som en ikke-spesialist kan følge «En bookingplattform for uavhengige klinikker; pasienter booker, klinikkene administrerer timeplanene.»
Forretningsfase og begrensninger Finansieringsfase, vekstpress, regulatorisk kontekst – bare det som påvirker arbeidet «Etter lansering, voksende brukerbase, ingen backend-utvikler internt.»
Kodebasens alder og historikk Når den ble startet, hvor mange team som har jobbet med den, kjente problemområder «Startet for tre år siden av et byrå, deretter vedlikeholdt av to innleide utviklere etter hverandre.»
Hvorfor nå Det som utløser revisjonen «Vi forbereder teknisk due diligence før en finansieringsrunde.»

Omfang og mål

Felt Hva du skal skrive Eksempel
Type arbeid Kode- og arkitekturgjennomgang, teknisk due diligence, vurdering av teknisk gjeld, ytelsesgjennomgang, sikkerhetsgjennomgang – eller en kombinasjon «Kode- og arkitekturgjennomgang med en prioritert utbedringsplan.»
Hva som er med i omfanget Repositorier, tjenester, miljøer, dokumentasjon «To Django-tjenester og det delte biblioteket; utrullingsskript; ingen frontend.»
Hva som er utenfor omfanget Si det eksplisitt, særlig alt som er et separat kjøp «Ingen penetrasjonstest og ingen samsvarserklæring – det er separate kjøp.»
Leveranser Artefaktene du forventer å motta «Skriftlig rapport, prioritert liste over funn, gjennomgangssesjon med teamet vårt.»
Definisjon av ferdig Hvordan du vil vurdere at arbeidet er ferdig «Hvert funn har en alvorlighetsgrad, en plassering og en anbefalt handling.»
Hvem som gjør utbedringene Ditt team, tilbyderen eller en senere beslutning «Funn først; utbedringsarbeid kan lyses ut separat.»

Samarbeidsmodell

Felt Hva du skal skrive Eksempel
Foretrukket modell Staff augmentation (bemanningsforsterkning), dedikert team eller prosjekt med fast omfang «Prosjekt med fast omfang for gjennomgangen; dedikert team bare hvis utbedringer følger.»
Modeller du vil vurdere Si om alternativer er akseptable og hvordan de vil bli sammenlignet «Vi vil vurdere en gjennomgang på medgått tid og materialer hvis omfanget er klart avgrenset.»
Din involvering Hvor mye av teamets tid er tilgjengelig «Vår ledende utvikler er tilgjengelig to timer per uke.»
Tilgang og miljø Hvordan tilbyderen får tilgang til kode og systemer «Skrivebeskyttet tilgang til repositoriet; testmiljø på forespørsel.»

Team og roller

Felt Hva du skal skrive Eksempel
Roller du forventer Oppgi rollene, ikke personene «Én senior gjennomgår, én ingeniør bistår.»
Hvem som gjør arbeidet Spør hvem som faktisk skal gjennomgå koden, kontra hvem som selger og styrer «Oppgi navnet på gjennomgåreren som skal lese koden, og vedkommendes relevante erfaring.»
Kontinuitet Hva som skjer hvis en navngitt person slutter «Fortell oss hvordan utskiftninger håndteres midt i oppdraget.»
Deres side Hvem på teamet ditt er motparten «Vår CTO er beslutningstaker; den ledende utvikleren er teknisk kontaktperson.»

Teknisk miljø

Felt Hva du skal skrive Eksempel
Python-versjon og rammeverk Nøyaktige versjoner der det er kjent «Python 3.11, Django, Django REST Framework.»
Datastack Database, cache, kø, søk «PostgreSQL, Redis for caching, Celery for bakgrunnsjobber.»
Sky og infrastruktur Hosting, containere, infrastruktur som kode «Containere på en administrert skyplattform; infrastruktur definert i kode.»
Repositorier og CI Hvor koden ligger, og hva som kjøres ved hver endring «Monorepo; tester og linting kjøres i CI ved hver pull request.»
Kjente problemområder Det du allerede mistenker, slik at tilbyderne ikke bruker budsjettet på å oppdage det på nytt «Treg rapporteringsspørringer; ujevn testdekning mellom appene.»

Arbeidsmåter

Felt Hva du skal skrive Eksempel
Overlapp i tidssoner Minste overlapp du trenger for samtaler «Minst tre timers overlapp med vår arbeidsdag.»
Sprintrytme Hvor ofte du forventer sjekkpunkter «Ukentlig skriftlig oppdatering, gjennomgangssjekkpunkt ved midtveis.»
Rapportering Format og mottakere «Kort skriftlig statusnotat til CTO; funnlogg deles fortløpende.»
Kommunikasjonsverktøy Hvor arbeidet diskuteres «Delt kanal for spørsmål; skriftlige funn i vårt sakssystem.»

Sikkerhet, immaterielle rettigheter og etterlevelse

Felt Hva du skal skrive Eksempel
Data tilbyderen vil se Klassifiser det tydelig «Produksjonslignende data med personopplysninger; anonymisert der det er mulig.»
Tilgangskontroll Hvordan tilgang gis og trekkes tilbake «Navngitte kontoer, tilgang fjernet ved oppdragets slutt.»
Konfidensialitet og immaterielle rettigheter Hva du krever i kontrakten «Signert konfidensialitetsavtale; alle funn og artefakter eies av oss.»
Samsvarskontekst Bare det som påvirker arbeidet «Vi behandler helsedata; gjennomgangen må følge våre regler for databehandling.»

Kommersielle vilkår

Felt Hva du skal skrive Eksempel
Prismodell Be om modellen og enheten «Oppgi om dere priser fast omfang, per dag eller per personmåned.»
Budsjettintervall Ditt intervall, fylt ut av deg — la det stå tomt til du har bestemt deg «Budsjettintervall: [fylles ut av kjøper].»
Betalingsvilkår Dine standardvilkår «Faktureres månedlig mot avtalte milepæler.»
Oppsigelsesfrist Hva som gjelder hvis oppdraget avsluttes tidlig «Oppgi oppsigelsesfristen for å avslutte oppdraget.»
Hva prisen inkluderer Be tilbydere skille mellom gjennomgang, rapportering og eventuelt utbedringsarbeid «Pris gjennomgangen og gjennomgangsmøtet separat fra eventuelt utbedringsarbeid.»

Utvelgelsesprosess og tidsplan

Felt Hva du skal skrive Eksempel
Frist for tilbud Én dato og ett klokkeslett, med tidssone «Tilbud innen oppgitt dato og klokkeslett i vår tidssone.»
Format Lengde og struktur du vil lese «Skriftlig tilbud som følger disse avsnittene; ingen presentasjoner.»
Trinn etter innsending Hva som skjer og når «Kortliste, én samtale per tilbyder på kortlisten, beslutning innen to uker.»
Beslutningskriterier Vis tilbydere til sammenligningstabellen «Svarene vurderes etter kriteriene i vedlagte tabell.»

Spørsmål hver tilbyder må svare på

Felt Hva du skal skrive Eksempel
Sammenlignbart arbeid Be om ett eller to revisjonsoppdrag på Python-kodebaser, med hva som ble funnet og hva som ble endret «Beskriv en revisjon dere utførte på en Django-kodebase: omfang, funn, resultat.»
Hvem som går gjennom koden Navngitt gjennomganger og dennes rolle «Hvem skal lese koden, og hva har vedkommende gjennomgått tidligere?»
Metode Hvordan funn produseres, rangeres og leveres «Hvordan prioriterer dere funn, og i hvilken form mottar vi dem?»
Avgrensninger Hva tilbyderen ikke vil gjøre «Bekreft hva som faller utenfor deres ansvarsområde, for eksempel penetrasjonstesting.»
Forutsetninger Hva tilbyderen forutsetter om teamet ditt og tilgang «List opp alle forutsetninger tilbudet ditt bygger på.»
Risiko Hva som kan få oppdraget til å mislykkes «Hva trenger dere fra oss for å unngå en forsinket eller overfladisk gjennomgang?»

Slik sammenligner du svarene

Gi hvert svar poeng etter de samme kriteriene og vektingene du satte før du leste dem. Vektingen velger du selv; poenget er at alle tilbydere vurderes på samme skala.

Kriterium Hva du vurderer Vekting (du setter) Poeng (du setter)
Relevant revisjonserfaring Sammenlignbart Python- og Django-arbeid, beskrevet konkret
Kvaliteten på den som reviderer Hvem som leser koden, og hva de har gjennomgått før
Metode og leveranser Tydelig prosess, prioriterte funn, brukbar rapport
Samsvar med oppdraget Svarer på din bestilling i stedet for et generisk tilbud
Forutsetninger og risiko Ærlig om hva som kan gå galt
Kommersiell klarhet Prismodell, hva som er inkludert og hva som er ekskludert, er entydig
Praktisk samarbeid Overlapp, møterytme og rapportering passer teamet ditt

Vanlige feil i bestillinger

Feil Konsekvens Rettelse
Å la samarbeidsmodellen være åpen Tilbudene priser ulike ting og kan ikke sammenlignes Oppgi ønsket modell og hvordan alternativer vil bli vurdert
Ingen prisramme Tilbyderne gjetter, og noen takker nei Fyll inn rammen din før du sender
Uklart omfang Vide forutsetninger, oppblåste anslag List opp repositorier, tjenester og ekskluderinger
Å pakke en penetrasjonstest inn i revisjonen Tilbyderne gir pris på arbeid de ikke utfører, eller hopper over spørsmålet Nevn det som et eget kjøp
Ulike spørsmål til hver tilbyder Svarene kan ikke poengsettes på én skala Send det samme dokumentet til alle
Ingen beslutningskriterier Det mest høylytte tilbudet vinner Legg ved sammenligningstabellen med vektingen din

Vanlige spørsmål

Bør bestillingen ta med de kodeproblemene vi allerede har?

Ja. Når du navngir det du allerede mistenker – trege spørringer, tynn testdekning, et område ingen vil ta i – slipper tilbyderne å bruke budsjettet ditt på å oppdage det på nytt, og du ser hvordan de håndterer kjente problemer. Hold det faktabasert, og ikke still diagnosen selv.

Hvor mange selskaper bør få bestillingen?

Tre til fem er nok til å sammenligne tilnærminger uten at prosessen blir en anskaffelsesøvelse. Færre enn tre gir deg lite å sammenligne; mange flere gjør poengsetting og oppfølgingssamtaler uhåndterlig.

Kan vi be tilbyderne om å utbedre funnene i tillegg til å rapportere dem?

Det kan du, men hold de to beslutningene atskilt i bestillingen. Be om gjennomgangen først, og avgjør deretter hvem som gjør utbedringene – selskapet som fant problemene, ditt eget team eller en annen leverandør. Tilbydere som vet at utbedring kan følge, beskriver ofte hvordan de overlater arbeid, og det er nyttig i seg selv.

Hva om en tilbyder ikke vil svare skriftlig på de obligatoriske spørsmålene?

Behandle det som et signal. De skriftlige svarene er det som gjør tilbudene sammenlignbare, og en tilbyder som ikke vil sette metode, forutsetninger og omfangsgrenser skriftlig før kontrakten, blir neppe tydeligere når arbeidet først er i gang.

Få en kortliste

Python-kodrevisjon