cross module documentatie
Code-naamgeving Conventies
Samenvatting
In WATCH worden projecten, medewerkers, relaties en andere entiteiten geïdentificeerd met een code. Een goede naamgeving maakt het systeem overzichtelijk en voorkomt verwarring. Dit artikel beschrijft aanbevolen conventies.
Technische regels
- Maximaal 50 tekens per code
- Toegestaan: letters, cijfers, underscore (
_) en koppelteken (-) - Geen spaties toegestaan
- Codes moeten uniek zijn per entiteit
Vuistregels
- Kort en leesbaar — maximaal 15-20 tekens in de praktijk
- Consistent — kies een format en houd je eraan
- Herkenbaar — gebruik
ANWB_FOLDERin plaats van0034 - De code = de identiteit — medewerkercode is tevens de inlognaam en verschijnt in alle rapportages
Aanbevolen formats per entiteit
Projectcodes
| Strategie | Format | Voorbeeld | Geschikt voor |
|---|---|---|---|
| Klant + omschrijving | KLANT_PROJECT |
ACME_WEBSITE |
Kleine organisaties |
| Klant + jaar | KLANT_PROJECT_JAAR |
ACME_WEBSITE_2026 |
Jaarlijks terugkerende projecten |
| Volgnummer + klant | JJJJNNN_KLANT |
2026001_ACME |
Grote organisaties met veel projecten |
| Afkorting + type | TYPE_KLANT_NR |
ADV_ACME_001 |
Organisaties met projecttypes |
Tip: Begin het projectnummer met een jaartal (bijv.
2026001) zodat projecten automatisch chronologisch sorteren.
Projectonderdeelcodes
| Strategie | Voorbeeld | Toelichting |
|---|---|---|
| Activiteit | ANALYSE, ONTWERP, BOUW, TEST |
Per fase/activiteit |
| Functioneel | HOMEPAGE, BACKEND, DATABASE |
Per deliverable |
| Tarief | SENIOR_CONSULTANCY, JUNIOR_CONSULTANCY |
Bij verschillende uurtarieven |
| Combinatie | FASE1_ANALYSE, FASE2_BOUW |
Bij grote projecten |
Medewerkcodes
| Strategie | Format | Voorbeeld |
|---|---|---|
| Initialen + achternaam | j.jansen |
Kleine organisatie |
| Personeelsnummer | MDW001 |
Grote organisatie |
| Voornaam | JAN, MARIEKE |
ZZP / zeer klein |
Relatiecodes (klanten)
| Strategie | Format | Voorbeeld |
|---|---|---|
| Bedrijfsnaam | ACME_BV |
Standaard |
| Afkorting | ACM |
Bij lange namen |
| Klantnummer | KL_00234 |
Grote klantenbestanden |
Automatische code-generatie (V6.7+)
Sinds versie 6.7 kan WATCH codes automatisch genereren uit namen:
| Mechanisme | Wat het doet |
|---|---|
| Spatie → underscore | Bij plakken van een naam in een codeveld worden spaties automatisch vervangen door underscores |
| Optioneel: hoofdletters | Tekst wordt automatisch naar hoofdletters geconverteerd |
Instelling: Configureerbaar via systeeminstellingen.
Standaardprojecten met jaarlijkse indexering
Gebruik standaardprojecten als sjabloon. Bij jaarlijkse tariefwijziging maak je een nieuw standaardproject:
CONSULTANCY_2026
├── SENIOR_CONSULTANCY_2026 (€150/uur)
├── JUNIOR_CONSULTANCY_2026 (€110/uur)
└── ADMINISTRATIEF_2026 (€70/uur)
CONSULTANCY_2027
├── SENIOR_CONSULTANCY_2027 (€160/uur)
├── JUNIOR_CONSULTANCY_2027 (€115/uur)
└── ADMINISTRATIEF_2027 (€75/uur)WATCH herkent projectonderdelen met dezelfde naam maar ander jaartal en kan bestaande automatisch sluiten bij het aanmaken van nieuwe.
Factuurnummering
WATCH genereert automatisch volgnummers. Aanbevolen format:
2026001, 2026002, 2026003, ...Begin het jaar met het eerste nummer (bijv. 2026001) en de applicatie genereert de rest automatisch. Dit zorgt voor chronologische en alfabetische ordening.